OpenTP1 Version 7 Operation
mcfstats (Output MCF statistics)
Format
mcfstats [-k output-type] [-u output-target] [-o output-file-name] [-f output-file-size] [-s time-interval] [-t output-count] [-r] |
Function
Outputs the MCF statistics to a file at the specified time interval.
Specifying the -r option terminates output of the MCF statistics.
Options
-k output-type~<<all>>
Specifies an output type.
-u output-target
Specifies a service group name, a logical terminal name, or an MCF communication process identifier to output the statistics.
Specifies the following items depending on the specification of the -k option.
all specified in the -k option: Omits this option.
in specified in the -k option: Service group name
out specified in the -k option: Logical terminal name
cn specified in the -k option: MCF communication process identifier
If you specify in, out, or cn in the -k option, be sure to specify this option. Specifying all in the -k option invalidates the specification of this option.
You cannot specify more than one service group name, logical terminal name, or MCF communication process identifier.
You can make a batch specification using an asterisk (*) in this option. You can make only one batch specification. You cannot make a batch specification together with an item which is included in the batch specification. For the batch specification, enclose the output target in double quotation marks (").
-o output-file-name~<path name, 1-35 characters> <<mcfstc>>
Specifies the output file name. If you specify only a file name, the file is created under $DCDIR/spool. If you specify an absolute path name, the file is created under the specified directory. However, if you specify a non-existing directory, the directory is not created. You cannot specify an existing file name.
If you omit this option, the statistics are output to $DCDIR/spool/mcfstc.
-f output-file-size~<unsigned integer> ((1-1000)) <<10>> (unit: megabytes)
Specifies the size (in megabytes) of the file to which the MCF statistics are output. Use the following expressions to calculate the file size.
For a service group: (64 + A) x output count/(1024 x 1024)
For a logical terminal: (64 + B) x output count/(1024 x 1024)
For an MCF communication process: (64 + C) x output count/(1024x1024)
For all MCF statistics: (64 + (A + B + C)) x output count/(1024 x 1024)
: Rounded up to an integer.
A: 96 x total number of service groups
B: 64 x 4 x total number of logical terminals
C: 64 x total number of MCF communication processes
-s time-interval~<unsigned integer> ((1-43200)) <<60>> (unit: seconds)
Specifies the time interval (in seconds) to output the MCF statistics to a file.
If you omit this specification, the time interval is 60 seconds.
-t output-count~<unsigned integer> ((1-65535)) (unit: count)
Specifies the output count.
If you omit this option, the statistics are output until "mcfstats -r" is executed, MCF stops or the file size specified by the -f option is exceeded. When the specified output count is reached, output of the statistics terminates.
If the file size specified by the -f option is exceeded, output of the MCF statistics terminates even if the specified output count is not reached.
-r
Terminates output of the MCF statistics.
Specifying this option invalidates all other options.
Output messages
Message ID | Description | Output destination |
---|---|---|
KFCA19700-E | An error occurred while the internal function is being processed. | Standard output, message log file |
KFCA19701-W | The MCF statistics cannot be acquired due to insufficient shared memory. | Standard error output, message log file |
KFCA19702-I | Starts outputting the MCF statistics to a file. | Standard output, message log file |
KFCA19703-I | Terminates outputting the MCF statistics to a file. | Standard output, message log file |
KFCA19704-W | Acquisition of the MCF statistics is not started. | Standard error output |
KFCA19705-W | Output of the MCF statistics is not started. | Standard error output |
KFCA19706-I | Terminates outputting the MCF statistics to a file because the file size is exceeded. | Standard output, message log file |
KFCA19707-E | An error occurred while the MCF statistics is being output to a file. | Standard error output, message log file |
KFCA19708-W | The command cannot be accepted because output of the MCF statistics to a file has been started. | Standard error output |
KFCA19709-W | The specified file has already exist. | Standard error output |
KFCA19710-E | Preparation to output the MCF statistics to a file failed. | Standard error output |
KFCA19711-E | The file could not be opened. | Standard error output |
Notes
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.