quels (Display status of queue groups)

Format

quels [-f] [-q message-queue-service-name] [queue-group-ID]

Function

The quels command outputs to the standard output the status of the physical files and queue files for specified queue groups. The message queue service must have already been started when the quels command is entered.

Options

-f

Specifies that queue file status is to be displayed for each queue group.

When this option is omitted, only the physical file status is displayed.

-q message-queue-service-name~<identifier> <<que>>

Specifies the name of the message queue service that manages the queue group IDs displaying status.

Command arguments

queue-group-ID~<identifier>

Specifies the ID of a queue group whose file status is to be displayed.

When this command argument is omitted, the status of all queue groups is displayed.

Output format

[Figure]

1. When the -f option is specified, this information is displayed as many times as there are queue files.
aaaaaaaa
Queue group ID
bbbb
Record length of the physical file
cccc
Number of records in the physical file
dddd
Number of records in use
eeee
Number of unused records
ff...ff
Physical file path name
gg
Ratio of the number of records in the queue file to the number of records in the physical file (%) (rounded down)
hhhh
Number of messages retained in the queue file
iii
Number of messages in the queue file waiting for retrieval
jjj
Number of messages in the queue file being processed
kk
Number of messages in the queue file on READY status
llllllll
Queue file name

Output messages

Message IDDescriptionOutput destination
KFCA01323-ESpecification of a command argument is invalid.Standard error output
KFCA01324-EFormat of queue group ID is invalid.Standard error output
KFCA01325-ESpecified queue group ID was not found.Standard error output
KFCA01326-EMemory is inadequate.Standard error output
KFCA01329-IHelp messageStandard output, standard error output
KFCA01339-ESpecification of the message queue service name is invalid.Standard error output
KFCA01360-EError occurred in the program.Standard error output, message log file
KFCA01361-ENo execution environment has been set up.Standard error output