ctmstopgw (terminate the ORB gateway)

Format

ctmstopgw [-h] |
          -CTMGWID gateway-identifier
          [-CTMDomain CTM-domain-name]
          [-CTMID CTM-identifier]
          [-CTMMyHost host-name-or-IP-address]
          [-CTMForce [-CTMDebugInfo]]

To Page Top

Function

This command terminates the gateway process that was started to enable CTM to handle requests from the ORB client.

To Page Top

Arguments

-h

Displays how to use the command.

-CTMGWID gateway-identifier

Specifies the gateway identifier of the ORB gateway to be terminated. You can specify 1 to 32 alphanumeric characters. Specify a value that can identify only one gateway under the CTM node that is specified by using the -CTMDomain and -CTMID options.

-CTMDomain CTM-domain-name

Specifies the name of the CTM domain to which the CTM daemon belongs. You can specify 1 to 31 alphanumeric characters. Do not specify a string that begins with CTM or ctm. If no value is specified, the command assumes that CTMDOMAIN is specified.

-CTMID CTM-identifier

Specifies the CTM identifier of the CTM daemon. You can specify 1 to 31 alphanumeric characters and periods (.). Do not specify a CTM identifier that begins with CTM or ctm. You can use periods (.) only when you specify an IP address.

If no value is specified, an IP address is set as a CTM identifier. For example, if the IP address of the host is 172.17.112.43, the string 172.17.112.43 is set as a CTM identifier.

-CTMMyHost host-name-or-IP-address

Specifies the host name or IP address used by CTM in a multihomed host environment or a node-switching environment in which both nodes share the same IP address. The specified value can consist of 1 to 64 characters. If no value is specified, the command assumes that the host name acquired by the hostname command is specified.

If you specify the -CTMMyHost option without specifying the -CTMID option, the IP address specified for the -CTMMyHost option is used as the default CTM identifier.

-CTMForce

Forcibly terminates the ORB gateway.

-CTMDebugInfo

Acquires a shared memory dump and core files as debug information when the ORB gateway is terminated forcibly. The -CTMDebugInfo option is valid only when the -CTMForce option is specified.

To Page Top

Return values

0:

The command ended normally.

Other than 0:

The command terminated abnormally due to an error that occurred during command processing. Take measures as indicated in the message that is output, and then re-execute the command.

To Page Top