mcftlsle (Display status of logical terminals)

Format

mcftlsle [-s MCF-communication-process-identifier]
        [-c connection-ID] -l logical-terminal-name [-q]

Function

The mcftlsle command outputs to the standard output the status of logical terminals.

Options

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

Specifies the MCF communication process identifier of the MCF communication service controlling the target logical terminal. No more than one MCF communication process identifier can be specified.

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

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

-c connection-ID~<identifier, 1-8 characters>

Specifies the connection ID corresponding to a logical terminal whose status is to be displayed.

Neither more than one connection ID nor ID of a group of connections can be specified.

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

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

If the -c option is specified, the logical terminal name corresponding to the specified connection ID must be specified.

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 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. 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 status of all logical terminals is to be displayed.
character-string*
Specifies leading characters of a logical terminal name when the status of all logical terminals with names beginning with the specified character string is to be displayed.
<Example of specifying more than one logical terminal>
To specify len1, len2, and len3, code: -l "len1[Figure]len2[Figure]len3"
<Example of specifying a group of logical terminals>
To specify all logical terminals beginning with len, code: -l "len*"

-q

Displays the held status of output queues for the specified logical terminal. When this option is omitted, the held status of output queues for the specified logical terminal is not displayed.

Output format

mmm llllllll sss [tttt]
   aaaaa bbbbbbbb
   SYNC xxxxxxxxxx yyyyyyyyyy zzzzzzzzzz
     IO     :        :        :
   PRIO     :        :        :
   NORM     :        :        :
   iii ooo

mmm
MCF identifier
llllllll
Logical terminal name
sss
Status of the logical terminal:
ACT: Shutdown released status
DCT: Shutdown status
tttt
Logical terminal test mode (displayed only when TP1/Message Control/Tester is used)
TEST: Test mode
(Blank) Non-test mode
aaaaa
Type of alternate sending (displayed when alternate sending is used)
ALT_F: Logical terminal of alternate origin
ALT_T: Logical terminal of alternate destination
bbbbbbbb
Logical terminal name (displayed only when alternate sending is used)
If the applicable logical terminal is a terminal of alternate origin, the name of the logical terminal of alternate destination is displayed. In this case, ALT_T is displayed in aaaaa.
SYNC
Synchronous-type message
IO
Asynchronous-type inquiry-response message
PRIO
Asynchronous-type one-way sent message (priority)
NORM
Asynchronous-type one-way sent message (normal)
xxxxxxxxxx
Number of unsent messages (displayable up to the upper limit of unsigned short)
yyyyyyyyyy
Lowest serial number of unsent messages (displayable up to the upper limit of int)
zzzzzzzzzz
Highest serial number of unsent messages (displayable up to the upper limit of int)
iii
Held status of the input of output queues (displayed only when the -q option is specified)
NOH: Held status is released.
HLD: Held.
ooo
Held status of the scheduling of output queues (displayed only when the -q option is specified)
NOH: Held status is released.
HLD: Held.

Output messages

Message IDDescriptionOutput destination
KFCA10350-Imcftlsle command has been entered.Standard output
KFCA10351-EMCF startup processing is underway.Standard error output
KFCA10352-EMCF termination processing is underway.Standard error output
KFCA10353-WInput format is invalid.Standard error output
KFCA10354-EMemory is inadequate.Standard error output
KFCA10355-WSpecification of an argument is invalid.Standard error output
KFCA10356-EOvertime occurred during process.Standard error output
KFCA10357-EOvertime occurred in MCF.Standard error output
KFCA10358-EError occurred in an internal function.Standard error output
KFCA10359-WResponse to mcftlsle command input source failed.Message log file
KFCA10360-IStatus display has started.Standard output
KFCA10364-ISee the output format section above.Standard output
KFCA10365-ISee the output format section above.Standard output
KFCA10369-IStatus display has terminated.Standard output
KFCA10373-Emcftlsle command terminated abnormally.Standard error output
KFCA10380-ERetrieval of remote process failed.Standard error output
KFCA10381-EA specified connection ID has not been cataloged.Standard error output
KFCA10382-EA specified logical terminal has not been cataloged.Standard error output
KFCA10390-ECorrespondence between specified connection ID and logical terminal name is invalid.Standard error output
KFCA10391-Emcftlsle command is not supported.Standard error output
KFCA10395-EThe name of an unconnected logical terminal is specified in specified connection.Standard error output
KFCA10505-IHelp messageStandard output
KFCA16402-ERPC error occurred during command processing.Standard error output