ctmstsstart (start acquisition of statistics)

Format

ctmstsstart [-h]|[[-CTMDomain CTM-domain-name] [-CTMID CTM-identifier]
            [-CTMInterval time-interval] [-CTMCheckInterval time-interval]]

To Page Top

Function

This command starts the acquisition of information to a statistics file.

Executing this command before a CTM daemon starts causes an error.

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 domain manager 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 for which to start acquisition of information to a statistics file. 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 command is used in a multi-homed host environment, the -CTMID option cannot be omitted.

If this argument is omitted, an IP address is set to the CTM identifier.

-CTMInterval time-interval

Specifies the time interval (in minutes) for acquiring information to a statistics file. You can specify an integer in the range from 1 to 1440. If this argument is omitted, 1 (minute) is set.

-CTMCheckInterval time-interval

Specifies the time interval (in seconds) for acquiring connection information. You can specify an integer in the range from 1 to 60. The more connections, the longer the time to acquire connection information. Therefore, if there are many connections, specify a large value. If this argument is omitted, 60 (seconds) is set.

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

If you execute the ctmstsstart command, information is not always output to a statistics file at the moment when the time specified for the -CTMInterval option has elapsed. This is because the acquisition of statistics starts at XX (hour):YY (minute):00 (second) (X and Y: unsigned integer) immediately after execution of the ctmstsstart command. When the time specified for the -CTMInterval option has elapsed since the acquisition started, information is output to the statistics file.

For example, if the ctmstsstart command with -CTMInterval 1 specified is executed at 18:10:30, the acquisition of statistics starts at 18:11:00, and the statistics file is output at 18:12:00.

To Page Top