ctmstsstart (start acquisition of statistics)

Format

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

Function

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

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

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.

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.

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.