modify gsm

Modifies the configuration parameters of the global service manager. The changes take effect after the global service manager is restarted.

Syntax

modify gsm -gsm gsm_name
          [-catalog connect_id [-pwd password]]
          [-region region_name]
          [-localons ons_port]
          [-remoteons ons_port]
          [-endpoint gmsendpoint [-remote_endpoint remote_endpoint]]
          [-listener listener_port]
          [-wpwd wallet_password]
          [-encryption encryption]
          [-timeout timeout]

Options

Table 2-60 GDSCTL modify gsm Options

Option	Description
`-catalog connect_id`	Specify the connect identifier for the Global Data Services catalog database. If a network service name is specified, it must be resolvable by the local naming method to a connect descriptor that allows the global service manager being modified to connect to the catalog database.
`-endpoint gsmendpoint`	Specify the protocol address that the global services manager listens on for client connection requests. If you use this option, the value you specify overrides the default endpoint.
`-gsm gsm_name`	Enter the name of the global service manager that you want to modify. If you do not specify a name, then the current global service manager name for the session (specified with the set gsm command) is used.
`-listener listener_port`	Specify the new listener port.
`-localons ons_port`	Specify the new local ONS port.
`-pwd password`	Specify the password for the `GSMCATUSER` account. If you do not specify a password, then you are prompted to enter one.
`-region region_name`	Specify the region to which the global service manager belongs.
`-remote_endpoint remote_endpoint`	Specify the protocol address that is used by the global service manager to receive database registration requests and communicate with other global service managers in the configuration. If you use this option, the value you specify overrides the default endpoint.
`-remoteons ons_port`	Specify the new remote ONS port.
`-wpwd`	Specify the password for the global service manager wallet.
`-encryption`	Encryption protocol for Advanced Network Option (ANO) used between GSM, GDSCTL and databases. OFF means that ANO is disabled. ( AES256 \| AES192 \| OFF).
`-timeout`	Restart timeout

Usage Notes

You must run this command locally on the computer where you want to modify the global service manager.
This command can be run only by the operating system user who started the global service manager.
When you run this command, GDSCTL connects to the Global Data Services catalog as the GSMCATUSER user and prompts you for the GSMCATUSER password.

Example

Modify the global service manager named gsm1 so that it is in the EAST region.

GDSCTL> modify gsm -gsm gsm1 -region east

Parent topic: Global Data Services Control Utility (GDSCTL) Command Reference