QUERY SYSTEM COUNTS

Authorization

C, G, R, S, U

Purpose

The QUERY SYSTEM COUNTS command requests information about RSCS traffic statistics. For every link, RSCS keeps track of the number of files and messages sent and received, the number of bytes sent and received, and other performance information (such as spool reads and writes).

Note: The numbers representing byte counts are approximate numbers. Use the QUERY SYSTEM COUNTS command to help you gauge the performance of a specific link or the performance of RSCS overall.

The following counters will reset when these fields reach the maximum value of X'7530' or 30000 decimal:

FILEIn
FILEOut
MSGIn
MSGOut
SPReads
SPWrites

The following counters will reset when these fields reach the maximum value of X'77359400' or 2,000,000,000 decimal:

FILEINKbytes
FILEOUTKbytes
MSGINKbytes
MSGOUTKbytes

Operands

filter

is a filter that selects a group of links. (For more information about using filters, see Using QUERY Command Filters.)

The valid filters and what they select are:

FILEIn sign nnnnnnnn: Links that have received a specific number of files; nnnnnnnn is the decimal number of files received and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
FILEINKbytes sign nnnnnnnn: Links that have received a specific number of file kilobytes; nnnnnnnn is the decimal number of file bytes received and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
FILEOut sign nnnnnnnn: Links that have sent a specific number of files; nnnnnnnn is the decimal number of files sent and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
FILEOUTKbytes sign nnnnnnnn: Links that have sent a specific number of file kilobytes; nnnnnnnn is the decimal number of file bytes sent and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
IO sign nnnnnnnn: Links that have performed a specific number of I/O transactions; nnnnnnnn is the decimal number of I/O transactions processed and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
IOERRors sign nnnnnnnn: Links that have had a specific number of errors in I/O transactions; nnnnnnnn is the decimal number of I/O errors and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
LINEIOTime sign nnnnnnnn: Links that have a specific average line I/O time; nnnnnnnn is the average number (decimal) of microseconds for RSCS to perform the line I/O and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
LINK linkid: Links with a specific link identifier.
MSGIn sign nnnnnnnn: Links that have received a specific number of messages; nnnnnnnn is the decimal number of messages received and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
MSGINKbytes sign nnnnnnnn: Links that have received a specific number of message kilobytes; nnnnnnnn is the decimal number of message bytes received and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
MSGOut sign nnnnnnnn: Links that have sent a specific number of messages; nnnnnnnn is the decimal number of messages sent and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
MSGOUTKbytes sign nnnnnnnn: Links that have sent a specific number of message kilobytes; nnnnnnnn is the decimal number of message bytes sent and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
NETworking: Networking links (LISTPROC-type, NJE-type, SNANJE-type, and TCPNJE-type links).
NODE nodeid: Links connected to a specific node.
NONNETworking: Non-networking links (ASCII-type, GATEWAY-type, LPD-type, LPR-type, MRJE-type, NOTIFY-type, RJE-type, SNARJE-type, SNA3270P-type, TCPASCII-type, TN3270E-type, UFT-type, UFTD-type, and 3270P-type links).
NONSNA: Non-SNA links (ASCII-type, GATEWAY-type, LISTPROC-type, LPD-type, LPR-type, MRJE-type, NJE-type, NOTIFY-type, RJE-type, TCPASCII-type, TCPNJE-type, TN3270E-type, UFT-type, UFTD-type, and 3270P-type links).
RPLRc sign nnnn: Links with a specific RPL return code; nnnn is the hexadecimal return code number and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
RPLSense sign nnnn: Links with a specific RPL sense code; nnnn is the hexadecimal sense code and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
RPLUSense sign nnnn: Links with a specific RPL user sense code; nnnn is the hexadecimal user sense code and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
SNA: SNA links (SNANJE-type, SNARJE-type, and SNA3270P-type links).
SPReads sign nnnnnnnn: Links that have performed a specific number of spool reads; nnnnnnnn is the decimal number of spool reads performed and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
SPREADTime sign nnnnnnnn: Links that have a specific average spool read time; nnnnnnnn is the average number (decimal) of microseconds for RSCS to perform a spool read and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
SPWrites sign nnnnnnnn: Links that have performed a specific number of spool writes; nnnnnnnn is the decimal number of spool writes performed and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
SPWRITETime sign nnnnnnnn: Links that have a specific average spool write time; nnnnnnnn is the average number (decimal) of microseconds for RSCS to perform a spool write and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
TIMEOuts sign nnnnnnnn: Links that have a specific number of timeouts; nnnnnnnn is the decimal number of timeouts and sign is one of the numeric operators: =, <, >, <=, >=, <>, ¬=, ¬<, or ¬>. (For more information about these numeric operators, see usage note 4.)
TCPIP: TCP/IP links (LPR-type, LPD-type, TCPASCII-type, TCPNJE-type, UFT-type, and UFTD-type links).

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:

BASE: Base address of the LINKSTAT entry.
KBytes: Link ID, number of received file kilobytes, number of sent file kilobytes, number of received message kilobytes, and number of sent message kilobytes, in that order.
FILEIn: Number of files received.
FILEINKbytes: Number of received file kilobytes.
FILEOut: Number of files sent.
FILEOUTKbytes: Number of sent file kilobytes.
FULL: Link ID, number of files received, number of files sent, number of messages received, number of messages sent, number of spool reads performed, and number of spool writes performed, in that order. This is the default.
IO: Total number of line I/O transactions performed.
IOERRors: Total number of I/O errors.
IOTime: Link ID and average time (in microseconds) to perform a spool write, a spool read, and a line I/O transaction, in that order.
LINEIOTime: Average time to perform a line I/O transaction (in microseconds).
LINK: Link identifier.
MSGIn: Number of messages received.
MSGINKbytes: Number of received message kilobytes.
MSGOut: Number of messages sent.
MSGOUTKbytes: Number of sent message kilobytes.
NONE: Nothing; just show total number of links found.
RPLRc: Last RPL return code.
RPLR0: Last RPL value in register 0.
RPLR15: Last RPL value in register 15.
RPLSense: Last RPL sense code.
RPLUSense: Last RPL user sense code.
SINCE: Date and time that the link statistics began (or were reset).
SNAInfo: Link ID, last RPL return code, last RPL sense code, last RPL user sense code, last RPL value in register 15, last RPL value in register 0, and last VTAM® request code, in that order.
SPReads: Number of spool reads performed.
SPREADTime: Average time to perform a spool read (in microseconds).
SPWrites: Number of spool writes performed.
SPWRITETime: Average time to perform a spool write (in microseconds).
STatus: Link status.
STREAMS: Link ID, number of files sent on streams 1, 2, 3, 4, 5, 6, and 7, in that order.
STREAM1: Number of files sent on stream 1.
STREAM2: Number of files sent on stream 2.
STREAM3: Number of files sent on stream 3.
STREAM4: Number of files sent on stream 4.
STREAM5: Number of files sent on stream 5.
STREAM6: Number of files sent on stream 6.
STREAM7: Number of files sent on stream 7.
STREAM8to32: Total number (combined) of files sent on streams 8 through 32. RSCS does not provide totals for individual streams beyond stream 7.
SUMmary: Link ID, total number of line I/O transactions performed, total number of I/O errors occurred, and total number of timeouts occurred, in that order.
TIMEOuts: Total number of timeout occurred.
VTAMRequest: Last VTAM request code.