mcfstats [-k output-type] [-u output-target] [-o output-file-name] [-f output-file-size] [-s time-interval] [-t output-count] [-r]

Outputs the MCF statistics to a file at the specified time interval.

Specifying the -r option terminates output of the MCF statistics.

-k output-type~<<all>>

Specifies an output type.

all: Outputs all the statistics.

in: Outputs the statistics of receive messages.

out: Outputs the statistics of send messages.

cn: Outputs the connection wait statistics.

-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 (").

*

Outputs the statistics of all the service groups, logical terminals or MCF communication processes.

prefix-character-string*

Outputs the statistics of all the service groups or logical terminals whose names start with the prefix character string. You cannot make this specification for the MCF communication processes.

<Example of the batch specification>

To specify service groups starting with "abc"

-u "abc*"

-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

Note

The maximum value with an asterisk (*) specified in the -u option is assumed for these expressions.

If the specified file size is exceeded, output of the statistics terminates.

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

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

• If you specify an invalid output target, the system assumes that no statistics of the target are acquired. Therefore, the system does not output an error message.
• If you delete the file to which the statistics are being output, the subsequent operation of OpenTP1 is not guaranteed.
• If you specify a too short output time interval, the interval may extend depending on the MCF operation status.