The QUEUE command displays DCALGOL queues. Either QUE or Q is an acceptable abbreviation.
Syntax
── QUEUE ─┬───────────────────────────┬─┬────────┬─<output option>─────┤ ├─<queue set specification>─┘ └─ BUSY ─┤ └─<single queue specification>─────────┘
<queue set specification>
──┬─<number>─┬─ - ──<number>───────────────┬───────────────────────────┤ │ └─ TO ──<number>──────────────┤ ├─ FOR ──<MCS specification>─────────────┤ ├─ CURRENT ─┬────────────────────────────┤ │ └─ FOR ──<MCS specification>─┤ ├─ INTERCOM ─────────────────────────────┤ ├─ PRIMARY ──────────────────────────────┤ ├─ FILE ─┬───────────────────────────────┤ │ ├─<file number>─────────────────┤ │ ├─ INPUT ───────────────────────┤ │ └─ OUTPUT ──────────────────────┤ └─ LSN ──<decimal number>────────────────┘
<single queue specification>
──┬─<number>───────────────────────────────┬───────────────────────────┤ ├─ INTERCOM ── FOR ──<MCS specification>─┤ └─ PRIMARY ── FOR ──<MCS specification>──┘
<MCS specification>
──┬─ " ──<MCS name>── " ─┬─────────────────────────────────────────────┤ └─<MCS number>─────────┘
<file number>
──┬─<number>────────────────┬──────────────────────────────────────────┤ └─ VIA ── FRSN ──<number>─┘
<output option>
──┬──────────────────────────┬─────────────────────────────────────────┤
├─ BRIEF ──────────────────┤
├─ RAW ────────────────────┤
├────────┬─┬───────────────┤
└─ FULL ─┘ └─ MSG ─┬───────┤
└─ ALL ─┘Explanation
The following text describes the meaning of each construct. Refer to “Basic Constructs” earlier in this section for information about the <number> and <decimal number> constructs.
QUEUE <output option>
Selects all DCALGOL queues. The output depends on the output option that you select. If you do not select an output option, DUMPANALYZER uses the BRIEF option.
QUEUE BUSY <output option>
Selects all DCALGOL queues that have messages. The output depends on the output option that you select. If you do not select an output option, DUMPANALYZER uses the BRIEF option.
QUEUE <queue set specification> <output option>
Selects the specified set of queues. The output depends on the output option that you select. If you do not select an output option, DUMPANALYZER uses the BRIEF option.
QUEUE <queue set specification> BUSY <output option>
Selects all queues in the specified set of queues that have messages. The output depends on the output option that you select. If you do not select an output option, DUMPANALYZER uses the BRIEF option.
QUEUE <single queue specification> <output option>
Selects the specified queue. The output depends on the output option that you select. If you do not select an output option, DUMPANALYZER uses the FULL option.
<queue set specification>
This option selects a set of queues, subject to qualification by the BUSY parameter, if it is present. Queue Set Specifications describes the various queue set specifications.
Table 16. Queue Set Specifications
|
Specify . . . |
To select . . . |
|---|---|
|
<number> - <number> <number> TO <number> |
The queues that are in the specified range, inclusive. |
|
FOR <MCS specification> |
The intercom queue, the primary queue, and any current queue for the specified MCS. |
|
CURRENT |
All current queues. |
|
CURRENT FOR <MCS specification> |
Any current queues for the specified MCS. |
|
INTERCOM |
All intercom queues. |
|
PRIMARY |
All primary queues. |
|
FILE |
Input and output queues of all remote files. |
|
FILE <file number> |
The input and output queue of the specified remote file. |
|
FILE INPUT |
All remote file input queues. |
|
FILE OUTPUT |
All remote file output queues. |
|
LSN <decimal number> |
The primary, current, remote file input, and remote file output queues for the station specified by the decimal number. |
<single queue specification>
Use this option to select one queue. Single Queue Specification shows the single queue specification options.
Table 17. Single Queue Specification
|
Select . . . |
To specify . . . |
|---|---|
|
<number> |
The queue indicated by the number. |
|
INTERCOM FOR <MCS specification> |
The intercom queue for the specified MCS. |
|
PRIMARY FOR <MCS specification> |
The primary queue for the specified MCS. |
<MCS specification>
Use this option to specify an MCS. MCS Specification shows the MCS specifications.
Table 18. MCS Specification
|
Select . . . |
To Specify . . . |
|
"<MCS name>" |
The MCS with the code file title enclosed in quotation marks ("). CONTROLLER is also an acceptable name. Do not include a family name. |
|
<MCS number> |
The MCS assigned the decimal number in the MCS table. Use the number 0 (zero) to specify the CONTROLLER. |
<file number>
Use this option to specify a file. File Number Specification shows the file number specifications.
Table 19. File Number Specification
|
Select . . . |
To Specify . . . |
|---|---|
|
<number> |
The file identified by this number. |
|
VIA FRSN <number> |
The file corresponding to the file relative station number (FRSN). The FRSN is in the first word of some DCWRITE messages. An FRSN is a 24–bit field in which the first 10 bits specify the file number. |
<output option>
Use this option to specify the amount of output to be printed for each queue selected. The output option specifies the kind of information and the amount of information for each queue header printed.
If you do not enter an output option, and you do specify a single queue specification, the FULL option is the default; otherwise, the BRIEF option is the default.
Output Options shows the output options.
Table 20. Output Options
|
Select . . . |
To Display . . . |
|---|---|
|
BRIEF |
Information about the queue in brief format, which means that zero-filled queue structures are suppressed. When the BRIEF option is in effect, the following header line is displayed: BRIEF OUTPUT OPTION IN EFFECT: ALL ZERO-FILLED QUEUE STRUCTURES ARE SUPPRESSED. |
|
RAW |
All the queue header words, without interpretation. |
|
FULL |
All the queue header words, with interpretation of several fields. |
|
MSG |
An analysis of the data comm messages in the selected queues. This option also displays all the queue header words, and interprets several fields, even if the FULL option is not specified. If you do not specify the MSG option, no information about individual messages in the selected queues is displayed. |
|
ALL |
All messages in the selected queues, even if they are not data comm messages. This option also displays all the queue header words, and interprets several fields, even if the FULL option is not specified. |
Example
The following example shows a response to the QUEUE command. The following list explains some items in the example:
-
Each entry in the QUEUE NUMBER column identifies the start of a queue stack. The queue stack is a nonrunning stack of descriptors that reference the actual queue.
-
A QMSGINFO entry in a queue stack that ends with a series of asterisks (**********) means messages are to be removed from the queue. The MSGCOUNT item in the entry indicates the number of messages to be removed.
-
The QTIBDESC entry is the queue task information block.
INPUT: QUEUE
DUMP OF DCALGOL QUEUE STACK(FFE) : 5 800010 100FFE
BRIEF OUTPUT OPTION IN EFFECT: ALL ZERO-FILLED QUEUE STRUCTURES
ARE SUPPRESSED.
QUEUE
NUMBER
------
0028 5 800000 D04D99 (QUEUE ADDR = 000DB935)
0001 0 000F80 002801 QINFO (ACTIVATING . . .
0003 0 000000 000154 QMSGINFO (MSGCOUNT=0 . . .
