QUERY QUEUES

Authorization

C, G, R, S, U

Purpose

The QUERY QUEUES command requests information about the files currently present in the queue for a node. RSCS may be in the process of receiving, sending, waiting to send, or holding these files.

Note: The QUERY QUEUES and QUERY FILES commands are very similar in function. QUERY QUEUES displays information about where the file is located in the network. If someone sends a file to multiple links, the file may be queued on several links, causing you to receive several messages about the same file. QUERY FILES displays information about a file. QUERY FILES does not display information about which link or links RSCS queued the file on. For more information about QUERY FILES, see QUERY FILES.

Operands

filter

is a filter that selects a group of files. You can specify as many filters as you want. (For more information about using filters, see Using QUERY Command Filters.)

The valid filters and what they select are:

ACTive: Files being sent or received.
BLocks sign size: Files less than, greater than, or equal to a specific block size; size is the decimal number of blocks and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
CLass c: Files with a specific spool class.
DEST destname: 3820 files with a specific PSF destination.
DIST code: Files with a specific distribution code.
EXITHOld: Files being held by Exit 31.
FILEName filename: Files with a specific file name.
FILEType filetype: Files with a specific file type.
FN filename: Files with a specific file name.
FOrm formname: Files with a specific user form name.
FROM nodeid userid: Files being sent from a specific user or virtual machine.
FT filetype: Files with a specific file type.
HOld: Files in hold status.
INActive: Inactive files in the queue.
INgroup groupid: Active and queued files destined to nodes belonging to a specific routing group.
LOOPing: Files in looping status.
NAME fn ft: Files with a specific file name and file type.
NOHold: Files not in hold status.
NOPROP: Files in the queue on your local node. (This QUERY command is not propagated to other nodes in the network.)
OFOrm formname: Files with a specific operator form name.
ON linkid: Active and queued files on a specific link.
OSPid sign spoolid: Files less than, greater than, or equal to a specific origin spool identifier; spoolid is the decimal spool ID number and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
POSinq sign nnnn: Files less than, greater than, or equal to a specific position in the queue; nnnn is the position number and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
PRINTer: Files being sent to printers.
PRIority sign nn: Files with a specific transmission priority; nn is the decimal transmission priority number and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
PRT: Files created on a virtual printer.
PUNch: Files created on a virtual punch.
RECEiving: Files being received on a link.
RECords sign num: Files less than, greater than, or equal to a specific number of records; num is the decimal number of records and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
SENDing: Files being transmitted on a link.
SPECHOld: Files put into a special hold by a NOTIFY-type link.
SPid sign spoolid: Files less than, greater than, or equal to a specific local spool identifier; spoolid is the decimal spool ID number and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
TO nodeid userid: Files being sent to a specific user or virtual machine.
Note: If you specify the TO filter with a specific node ID, RSCS automatically propagates this command throughout the network. To prevent this propagation, also specify either the NOPROP filter or the ON linkid filter.

SHOW option

tells RSCS how to format the response. (For more information about using SHOW options, see Using QUERY Command SHOW Options.)

The valid SHOW options and what they display (in columns) are:

ACcmsg: Accepted message setting.
BASE: Tag slot address.
BLOCKs: Total number of blocks in the file, or if the file is being received, total number of expected blocks.
BLOCKSDone: Number of blocks transmitted or received thus far.
CHAR0: Character translation table number 0.
CHAR1: Character translation table number 1.
CHAR2: Character translation table number 2.
CHAR3: Character translation table number 3.
CLass: Spool file class.
COpies: Spool file copy count.
COpy: Spool file copy count.
COUNT: Flash count.
DEST: PSF destination.
DESTInfo: Destination node ID and destination user ID, in that order.
DEVice: Virtual device type used to create the file (printer, punch, 3800-1, 3800-3, 3800-8, or unknown).
DIST: Distribution code.
DSName: Data set name.
ENQmsg: Enqueue message setting.
FCB: Forms control buffer name.
FILEInfo: File name, file type, spool file class, priority, and distribution code, in that order.
FILEName: File name.
FILEType: File type.
FINalmsg: Final message setting.
FLash: Flash name.
FN: File name.
FOrm: User form name.
FROMNode: Origin node ID.
FROMQual: Origin node qualifier (only for files originating from an MVS™ system).
FROMUser: Origin user ID.
FT: File type.
FULL: Position in queue, spool ID, origin node ID, origin user ID, destination node ID, destination user ID, files queued on link, and status, in that order. This is the default.
HOld: Hold status of files.
ID: Spool ID.
Jobid: Five-digit job identifier of files.
LINK: Files queued on link.
LOOPing: Looping status of files.
MODify: Name of copy modification module.
MSGInfo: Accept, queue, sent, and final message settings, in that order.
NONE: Nothing; just show the total number of queues found.
OFOrm: Operator form name.
ORDered: Ordered status of files.
ORIGID: Origin spool ID.
ORIGInfo: Origin spool ID, origin node ID, origin user ID, origin node qualifier, and network origin time of file, in that order.
OSPid: Origin spool ID.
OTIme: Time the file entered the network.
OVerridenode: Name of the node to which RSCS will queue the file regardless of the destination node originally specified for the file.
POSinq: Position in the queue.
PREFlink: Preferred link for printing this file. (This column applies only to files with multiple copies.) RSCS prefers to print a file with multiple copies on the same printer. Therefore, when the first of several copies of a file begins printing, RSCS marks the link to that printer as preferred so that the other copies of the file will print on the same printer.
PREVNode: Name of the previous node that this file was on. If there is no previous node, RSCS displays an ellipsis (…) in this column.
PRIority: Priority.
PROGRESS: Spool ID, origin spool ID, destination node ID, destination user ID, number of records transmitted or received thus far, total number of records (or if the file is being received, total number of expected records), and status, in that order.
PROGRESSBlocks: Spool ID, origin spool ID, destination node ID, destination user ID, number of blocks transmitted or received thus far, total number of blocks (or if the file is being received, total number of expected blocks), and status, in that order.
PRTInfo: User form name, operator form name, spool file copy count, forms control buffer name, and device type, in that order.
QInfo: Position in the queue, spool ID, files queued on link, and status, in that order.
RECords: Total number of records in the file, or if the file is being received, total number of expected records.
RECSDone: Number of records transmitted or received thus far.
RERouted: Files in reroute status.
Rscs: Spool ID, origin spool ID, origin node ID, origin user ID, network origin time of file, destination node ID, and destination user ID, in that order.
SANDFwd: Store-and-forward status of files.
SEntmsg: Sent message setting.
SPid: Spool ID.
STATInfo: Hold, looping, reroute, store-and-forward, and ordered status of files, in that order.
STatus: Status of the file (sys-hold, user-hold, spec-hold, hop-loop, immed-loop, exit-hold, no stream, trace, sending, receiving, or waiting). For more information about this option, see Usage Note 7.
TOInfo: Origin spoolid, time the file entered the network, file name, file type, destination node ID, and destination user ID, in that order.
TONode: Destination node ID.
TOUser: Destination user ID.
Vm: Spool ID, origin spool ID, file name, file type, spool file class, priority, distribution code, user form name, operator form name, and spool file copy count, in that order.
3800Info: Flash name, flash count, name of copy modification module, and character translation tables 0, 1, 2, and 3, in that order.