mcftlsutm (Display user timer monitoring status)

Format

mcftlsutm [-s MCF-communication-process-identifier]
{ -a application-name | -l logical-terminal-name }

Function

The mcftlsutm command displays the status of user timer monitoring.

Options

-s MCF-communication-process-identifier~<numerals (0-9), a-f> ((01-ef))

Specifies an MCF communication process identifier. No more than one MCF communication process identifier can be specified.

If this option is omitted, the mcftlsutm command is executed on all MCFs. This means that the overhead required to search for the MCF communication processes is added to the processing load of the operation commands.

If you want to have a configuration that includes many MCF communication processes or if you want to use many operation commands, use the -s option to specify an MCF communication process identifier.

-a application-name~<identifier, 1-8 characters>

Specifies the name of an application whose information is to be displayed.

A maximum of eight application names can be specified. When you enter large numbers of inputs for the operation, specify more than one application or specify a group of applications, as described below, to increase the number of applications processed in parallel by one command and to reduce the number of commands to be entered.

To specify multiple application names, separate them by a space and enclose the entire string of application names in double quotation marks ("). The same application name cannot be duplicated when specified.

The asterisk (*) can be used in the specification to indicate a group of applications. Only one group can be specified. The name of a group of applications cannot coexist with the names of applications for which no group is specified. A group name must be enclosed in double quotation marks (").

<Example of specifying more than one application>
To specify apl1, apl2, and apl3:
-a "apl1[Figure]apl2[Figure]apl3"
<Example of specifying a group of applications>
To specify all applications beginning with apl:
-a "apl*"

-l logical-terminal-name~<identifier, 1-8 characters>

Specifies the name of a logical terminal whose information is to be displayed.

A maximum of eight logical terminal names can be specified. When entering large amounts of inputs for the operation, specify more than one logical terminal or specify a group of logical terminals, as described below, to increase the number of logical terminals to be processed in parallel by one command while reducing the number of commands to be entered.

To specify multiple logical terminal names, separate them by a space and enclose the entire string of logical terminal names in double quotation marks ("). The same logical terminal name cannot be duplicated when specified.

The asterisk (*) can be used in the specification to indicate a group of logical terminal names. Only one group can be specified. The name of a group of logical terminals cannot coexist with the names of logical terminals for which no grouping is specified. A group name must be enclosed in double quotation marks (").

<Example of specifying more than one logical terminal>
To specify len1, len2, and len3:
-l "len1[Figure]len2[Figure]len3"
<Example of specifying a group of logical terminals>
To specify all logical terminals beginning with len:
-l "len*"

Output format

KFCA10360-I Starts status display of UTM.
KFCA16433-I mmm aaaaa(bbbbb) ccccc
KFCA16434-I mmm dd...dd ee...ee ff...ff gg...gg hh...hh
KFCA16434-I mmm dd...dd ee...ee ff...ff gg...gg hh...hh
KFCA10369-I Terminates status display of UTM.

Display examples

[Figure]When user timers are registered in the communication process:

KFCA10360-I Starts status display of UTM.
KFCA16433-I A01 30(100) 10000
KFCA16434-I A01 ap001    05:00:59 lec00101 00000001  00:00:50
KFCA16434-I A01 ap001    23:59:59 lec001  00000002  99:00:00
KFCA16434-I A01 ap001001 00:01:20 lec00101 00003600 100:00:00
KFCA10369-I Terminates status display of UTM.

[Figure]When user timers are not registered in the communication process:

KFCA10360-I Starts status display of UTM.
KFCA16433-I A01 30(100) 10000
KFCA16435-I A01 User timer specified by MCF operation command is not registered. command-name = mcftlsutm
KFCA10369-I Terminates status display of UTM.

[Figure]When user timers are not registered in the communication process:

KFCA10360-I Starts status display of UTM.
KFCA16438-E A01 MCF operation command cannot be used. command-name = mcftlsutm
KFCA10369-I Terminates status display of UTM.

Output messages

Message IDDescriptionOutput destination
KFCA10350-IThe mcftlsutm command has been entered.Standard output
KFCA10351-EMCF startup processing is underway. Wait for the startup processing to be completed, and then re-enter the command.Standard error output
KFCA10352-EMCF termination processing is underway.Standard error output
KFCA10353-WInput format is invalid. Correct the input format and re-enter the command.Standard error output
KFCA10354-EMemory is inadequate. If the same result occurs when the command is re-entered, check the system environment.Standard error output
KFCA10355-WSpecification of an argument is invalid. Check the specification of the MCF communication process identifier, the application names, and the logical terminal names, make corrections, and then re-enter the command.Standard error output
KFCA10356-ETimeout occurred during a process. See the message that was output to a log before this message.Standard error output
KFCA10357-ETimeout occurred in the MCF. See the message that was output to a log before this message.Standard error output
KFCA10358-EError occurred in an internal function.Standard error output
KFCA10359-WResponse to mcftlsutm command input source failed.Message log file
KFCA10360-IStatus display is starting.Standard output
KFCA10369-IStatus display is terminating.Standard output
KFCA10372-EThe mcftlsutm command terminated abnormally. See the message that was output to a log before this message.Standard error output
KFCA10380-ERetrieval of a remote process failed. Check the MCF communication process identifier and re-enter the command.Standard error output
KFCA10562-IHelp messageStandard output
KFCA16402-ERPC error occurred during command processing. Take the corrective action indicated by the reason code.Standard error output
KFCA16433-ISee the above output format.Standard output
KFCA16434-ISee the above output format.Standard output
KFCA16435-IEither no user timers are registered for the application names or logical terminal names specified in the mcftlsutm command, or a specified application name or logical terminal name is invalid. Check that user timers are registered or that the specified application names or logical terminal names are valid.Standard output
KFCA16438-EThe mcftlsutm command cannot be used in this environment. The setting that does not permit use of the user timer monitoring facility (mcfttim usertime=no) is specified in the timer definition of the MCF communication configuration definition. Check that the communication process specified in the command is valid. If it is valid, change to the setting that permits use of the user timer monitoring facility (mcfttim usertime=yes).Standard error output