OpenTP1 Version 7 Operation

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

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 ID Description Output destination
KFCA10350-I mcftlssg command has been entered. Standard output
KFCA10353-W Input format is invalid. Standard error output
KFCA10354-E Memory is inadequate. Standard error output
KFCA10355-W Specification of an argument is invalid. Standard error output
KFCA10356-E Overtime occurred during process. Standard error output
KFCA10357-E Overtime occurred in MCF. Standard error output
KFCA10358-E Error occurred in an internal function. Standard error output
KFCA10359-W Response to mcftlssg command input source failed. Message log file or standard error output
KFCA10360-I Status display has started. Standard output
KFCA10367-I See the output format section above. Standard output
KFCA10369-I Status display has terminated. Standard output
KFCA10373-E mcftlssg command terminated abnormally. Standard error output
KFCA10380-E Retrieval of remote process failed. Standard error output
KFCA10383-E Specified service group has not been cataloged. Standard error output
KFCA10515-I Help message Standard output
KFCA16402-E RPC 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.