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

The mcftlsutm command displays the status of user timer monitoring.

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

• *: Specifies that the user timer monitoring status of all applications is displayed.
• character-string*: Specifies leading characters of an application name when the display is limited to the user timer monitoring status of applications whose names begin with the specified character string.

<Example of specifying more than one application>

To specify apl1, apl2, and apl3:

-a "apl1apl2apl3"

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

• *: Specifies that the user timer monitoring status of all logical terminals is to be displayed.
• character-string*: Specifies leading characters of a logical terminal name when the display is to be limited to the user timer monitoring status of logical terminals whose names begin with the specified character string.

<Example of specifying more than one logical terminal>

To specify len1, len2, and len3:

-l "len1len2len3"

<Example of specifying a group of logical terminals>

To specify all logical terminals beginning with len:

-l "len*"

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.
 

• UTM: User timer monitoring
• mmm: MCF identifier
• aaaaa: Number of registered user timers (5 digits)
• bbbbb: Maximum number of registered user timers from when the communication process was started normally or restarted until the current time (5 digits)
• ccccc: Maximum number of user timers that can be monitored concurrently (5 digits)
• dd...dd: Application name specified during user timer registration (8 digits)
• ee...ee: Time at which the user timer was registered (hh:mm:ss)
• ff...ff: Logical terminal name specified during the user timer registration (8 digits)
• gg...gg: Timer request identifier specified during the user timer registration (8 digits (hexadecimal))
• hh...hh: Start time specified during the user timer registration (hh:mm:ss)
  If 360000 is specified, 100:00:00 is displayed.
  

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.
 

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.
 

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.

Message ID	Description	Output destination
KFCA10350-I	The mcftlsutm command has been entered.	Standard output
KFCA10351-E	MCF startup processing is underway. Wait for the startup processing to be completed, and then re-enter the command.	Standard error output
KFCA10352-E	MCF termination processing is underway.	Standard error output
KFCA10353-W	Input format is invalid. Correct the input format and re-enter the command.	Standard error output
KFCA10354-E	Memory is inadequate. If the same result occurs when the command is re-entered, check the system environment.	Standard error output
KFCA10355-W	Specification 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-E	Timeout occurred during a process. See the message that was output to a log before this message.	Standard error output
KFCA10357-E	Timeout occurred in the MCF. See the message that was output to a log before this message.	Standard error output
KFCA10358-E	Error occurred in an internal function.	Standard error output
KFCA10359-W	Response to mcftlsutm command input source failed.	Message log file
KFCA10360-I	Status display is starting.	Standard output
KFCA10369-I	Status display is terminating.	Standard output
KFCA10372-E	The mcftlsutm command terminated abnormally. See the message that was output to a log before this message.	Standard error output
KFCA10380-E	Retrieval of a remote process failed. Check the MCF communication process identifier and re-enter the command.	Standard error output
KFCA10562-I	Help message	Standard output
KFCA16402-E	RPC error occurred during command processing. Take the corrective action indicated by the reason code.	Standard error output
KFCA16433-I	See the above output format.	Standard output
KFCA16434-I	See the above output format.	Standard output
KFCA16435-I	Either 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-E	The 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