OpenTP1 Version 7 Operation

[Contents][Index][Back][Next]

mcftlstrd (Display the status of multi-processing of messages)

Format

mcftlstrd -s MCF-communication-process-identifier

Function

The mcftlstrd command displays the status of the multi-processing of messages.

The MCF communication process can simultaneously handle messages it receives from multiple connections at the same time and messages that a user application program requests to send to multiple connections at the same time. You can change the limit of multiplicity, which allows parallel processing of messages, in the maximum processing multiplicity definition (mcfttred -m). However, even if a high traffic level is enabled, parallel processing may not be executed up to the value specified in the definition depending on the system environment. In this case, local memory is used inefficiently, negatively influencing the performance (as you increase the value specified in the maximum processing multiplicity definition by 1, the MCF communication process uses additional 32 kilobytes of local memory).

Use the mcftlstrd command to check the status of multi-processing and tune the value in the maximum processing multiplicity definition. For example, if the result of executing this command several times during peak traffic indicates:

  1. "running" is always smaller than the current value specified in the processing multiplicity definition (number of connections if the value specified in the processing multiplicity definition is greater than the number of connections) and,
  2. "waiting" is always greater than 0, you cannot expect multi-processing exceeding "running".

Change the value specified in the processing multiplicity definition to "running + [Figure]". ([Figure]is a safety margin. The recommended value is 3.) The result of the command can indicate that "running" equals the current value specified in the processing multiplicity definition (number of connections if the value specified in the processing multiplicity definition is greater than the number of connections). If that occurs and "waiting" is greater than 0, you may be able to increase the multiplicity. Consider a new multiplicity value based on the amount of memory and your performance requirements, such as the current throughput and the turnaround time.

To determine the processing status, obtain the MCF statistics.

Options

-s MCF-communication-process-identifier

Specifies the MCF communication process identifier which is the target of the command.

This option is mandatory.

You can specify only one MCF communication process identifier. You cannot specify a group name using *.

Output format

KFCA16430-I aaa running=bbbb waiting=cccc limit=dddd

Output messages

Message ID Description Output destination
KFCA10350-I The mcftlstrd command is entered. Standard output
KFCA10351-E The MCF is being started. Standard error output
KFCA10352-E The MCF is being terminated. Standard error output
KFCA10353-W The input format is incorrect. Standard error output
KFCA10354-E Memory is insufficient. Standard error output
KFCA10355-W The argument is specified incorrectly. Standard error output
KFCA10356-E A timeout occurred between processes. Standard error output
KFCA10357-E A timeout occurred in the MCF. Standard error output
KFCA10358-E An error occurred in the internal function. Standard error output
KFCA10372-E The mcftlstrd command is terminated abnormally. Standard error output
KFCA10380-E Searching for the destination process failed. Standard error output
KFCA10555-I Help message Standard output
KFCA16402-E An RPC error occurred during command processing. Standard error output
KFCA16430-I See the output format section above. Standard output