disable service

Disables specified global services.

Syntax

disable service [-gdspool gdspool_name]
                [-service service_name_list]
                [-database db_name |[-override -connect conn_str [-pwd password]]]

Options

Table 2-46 GDSCTL disable service Options

Syntax Description
-connect conn_str

An Oracle Net connect descriptor or net service name that resolves to a connect descriptor for the database (or shard).

-database db_name

Specify the name of the database on which to the service is located. If you do not specify this option, then the service is disabled, globally.

-gdspool gdspool_name

Specify the database pool in which the services are located. If not specified and there is only one gdspool with access granted to the user, then this one is used as the default gdspool.

-override

Skip the GDS catalog (used when the GDS catalog is not available).

-pwd

The GSMUSER password.

-service service_name_list

Specify a comma-delimited list of global service names. If you do not use -service to specify an individual global service or to specify a list of global services, then all the services in the database pool are disabled.

Usage Notes

You must connect to the catalog database as a user with the pool administrator privileges, using the connect command before running this command

A running service cannot be disabled. If -override is specified, the command is executed without going to the GDS catalog. Use this option when the GDS catalog is unavailable. It is not recommended for use under normal operation.

Example

Disable and stop the service G_SALES_REPORT on all databases in the database pool READERFARM.

GDSCTL> disable service -gdspool readerfarm -service g_sales_report -database db1