ctmtscgwd (start OTM gateway)

Format

ctmtscgwd [-h] |
          [-CTMDomain CTM-domain-name]
          [-CTMID CTM-identifier]
          [-CTMPort port-number]
          [-CTMMyHost host-name-or-IP-address]
          [-CTMClientConnectCount maximum-number-of-client-connections]
          [-CTMTPool]

To Page Top

Function

This command starts a gateway process for processing OTM client requests by CTM. Start an OTM gateway on the host on which the CTM daemon is running. Note that you cannot directly start the OTM gateway.

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. You can specify 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.

-CTMPort port-number

Specifies the port number that the OTM client uses to search for a new connection with the OTM gateway. You can specify an integer in the range from 5001 to 65535. If this argument is omitted, the port number automatically allocated by the OS is used.

-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.

-CTMClientConnectCount maximum-number-of-client-connections

Specifies the number of connections that can be established from the OTM client to the OTM gateway. You can specify an integer in the range from 1 to 32767. If this argument is omitted, 64 is set.

-CTMTPool

Runs the OTM gateway with the thread pooling (ThreadPool) model. If this argument is omitted, the OTM gateway runs with the thread per session (ThreadSession) model.

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

• After the OTM gateway has started, it moves the current directory. Therefore, the output destination of the core file is different from the directory of the executable file in the following cases:

  • The OTM gateway is forcibly terminated by, for example, ctmdmstop -CTMForce -CTMDebugInfo or a kill command.

  • The OTM gateway terminated abnormally.

• The following shows the location to which the current directory is moved:

  • In Windows

    %CTMSPOOL%\adm\CTM-identifier\tgwd\current-directory-ID\

  • In UNIX

    $CTMSPOOL/adm/CTM-identifier/tgwd/current-directory-ID/

    For current-directory-ID, see the KFCT70606-I message.

To Page Top