ctmstop (terminate CTM daemon)

Format

ctmstop  [-h] [-CTMDomain CTM-domain-name] [-CTMID CTM-identifier]
         [-CTMMyHost host-name-or-IP-address]
         [-CTMForce [-CTMDebugInfo]]

To Page Top

Function

This command terminates a CTM daemon for scheduling requests.

To Page Top

Arguments

-h

Displays how to use the command.

-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 and underscores (_). Do not specify a character string that begins with CTM or ctm. If this argument is omitted, CTMDOMAIN is set.

-CTMID CTM-identifier

Specifies the CTM identifier of the CTM daemon, as 1 to 31 alphanumeric characters, periods (.), and underscores (_). Do not specify a CTM identifier that begins with CTM or ctm. Period (.) can only be specified in IP addresses.

If this argument is omitted, an IP address is set to the CTM identifier. For example, if the IP address of the host is 172.17.112.43, the character string 172.17.112.43 is assumed as the CTM identifier.

-CTMMyHost host-name-or-IP-address

Specifies the host name or IP address used by CTM in a node switching environment where a multi-homed host or IP address is inherited. You can specify a character string of 1 to 64 characters. If this argument is omitted, the host name acquired by the hostname command is set.

If you omit the -CTMID option and specify the -CTMMyHost option, the IP address specified for the -CTMMyHost option is assumed as the default CTM identifier.

-CTMForce

Forcibly terminates the CTM daemon.

-CTMDebugInfo

Acquires a shared memory dump and core files as debug information when the CTM daemon is terminated forcibly.

The -CTMDebugInfo option is valid only when the -CTMForce option is specified.

To Page Top

Return values

0:

The command is terminated normally.

Other than 0:

The command terminated abnormally because an error occurred during command processing. Take the corrective action indicated in the output message, and then re-execute the command.

To Page Top

Notes

For normal termination of the CTM daemon, the command waits until all requests are executed. Therefore, note that if a communication error occurs for an EJB business request that has an infinite timeout wait (default) specified, the CTM daemon cannot terminate normally.

To Page Top