mcftlssg (Display status of service groups)

Format

mcftlssg -g service-group-name [-q][-m]

Function

The mcftlssg command displays the status of service groups and the numbers of received messages currently queued.

Options

-g service-group-name~<identifier, 1-31 characters>

Specifies the name of a service group whose status is to be displayed.

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

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

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

*
Specifies that the status of all service groups is to be displayed.
character-string*
Specifies leading characters of a service group name when the status of all service groups with names beginning with the specified character string is to be displayed.
<Example of specifying more than one service>
To specify seg1, seg2, and seg3, code: -l "seg1[Figure]seg2[Figure]seg3"
<Example of specifying a group of services>
To specify all services beginning with seg, code: -l "seg*"

-q

Displays the held status of input queues for the specified service group. When this option is omitted, the held status of input queues for the service group is not displayed.

-m

Displays the maximum number of unprocessed receive messages from when OpenTP1 was started normally or restarted until the current time.

Output format

aaaaaaaaaaa bbb cc...cc ddd eee fff[(mmm)] [tttt]
aaaaaaaaaaa    iii ooo

aaaaaaaaaaa
Message ID
bbb
MCF identifier
cc...cc
Service group name
ddd
Status of the service group (input):
ACT: Shutdown released status
DCT: Shutdown status
***: Displayed for SPP service groups.
eee
Status of the service group (scheduling):
ACT: Shutdown released status
DCT: Shutdown status
fff
Number of unprocessed receive messages in the input queue corresponding to the applicable service group (displayable up to the upper limit of int)
mmm
Maximum number of unprocessed receive messages in the input queue corresponding to the applicable service group (displayed only when the -m option is specified; displayable up to the upper limit of int)
tttt
Test mode status of service group (displayed only when TP1/Message Control/Tester is used)
TEST: Test mode
(Blank): Non-test mode
iii
Held status of the input of input queues (displayed only when the -q option is specified)
NOH: Held status is released.
HLD: Held.
***: Displayed for application service groups
ooo
Held status of the scheduling of input queues (displayed only when the -q option is specified)
NOH: Held status is released.
HLD: Held.
***: Displayed for application service groups

Output messages

Message IDDescriptionOutput destination
KFCA10350-Imcftlssg command has been entered.Standard 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 mcftlssg command input source failed.Message log file or standard error output
KFCA10360-IStatus display has started.Standard output
KFCA10367-ISee the output format section above.Standard output
KFCA10369-IStatus display has terminated.Standard output
KFCA10373-Emcftlssg command terminated abnormally.Standard error output
KFCA10380-ERetrieval of remote process failed.Standard error output
KFCA10383-ESpecified service group has not been cataloged.Standard error output
KFCA10515-IHelp messageStandard output
KFCA16402-ERPC error occurred during command processing.Standard error output

Note

When a disk queue is used for the input queue and unprocessed receive messages remain prior to an OpenTP1 restart, the number of unprocessed receive messages becomes the maximum number of unprocessed receive messages during the OpenTP1 restart.