Displaying job output *INQUIRY,U

You use the *INQUIRY,U command to display job output in a JES3 system. The job output can be at various places within the system and your selection of the proper "Q=" keyword value on the *INQUIRY,U command dictates what output you want.

The choices are generally the following:

*INQUIRY,U,Q=TCP: To display TCP/IP job output
*INQUIRY,U,Q=BDT: To display SNA/NJE job output
*INQUIRY,U,Q=HOLD: To display job output on the HOLD queue
*INQUIRY,U,Q=WTR: To display job output on the WTR service queue
*INQUIRY,U: To display job output on the WTR service queue

Note:

Some FSS applications retain SYSOUT data sets after they have been printed. The output of the *INQUIRY,U command will include these data sets. See the FSS application documentation in z/OS MVS Using the Functional Subsystem Interface, , for information on determining whether output has been printed.

Displaying TCP/IP/NJE and SNA/NJE job output *INQUIRY,U

Function - *INQUIRY,U,Q=TCP: Use the *INQUIRY,U,Q=TCP command with the appropriate parameters to display information about TCP/IP/NJE network jobs. TCP/IP/NJE network jobs might be either network job streams or network SYSOUT streams. This command may have a length of 126 characters if the command is issued from an input device that permits that command length. See Controlling TCP/IP/NJE for a complete description of TCP/IP/NJE.
Function - *INQUIRY,U,Q=BDT: Use the *INQUIRY,U,Q=BDT command with the appropriate parameters to display information about SNA/NJE network jobs. SNA/NJE network jobs may be either network job streams or network SYSOUT streams. This command may have a length of 126 characters if the command is issued from an input device that permits that command length. See Controlling SNA/NJE for a complete description of SNA/NJE.

Displaying output service HOLD queue

Function - *INQUIRY,U,Q=HOLD: Use the *INQUIRY,U,Q=HOLD command to display a summary of output in the HOLD queue. This command may have a length of 126 characters if the command is issued from an input device that permits that command length.

Displaying output service WTR queue

Function - *INQUIRY,U,Q=WTR: Use the *INQUIRY,U,Q=WTR command to display a summary of output in the WTR queue. This command may have a length of 126 characters if the command is issued from an input device that permits that command length.

Syntax


                       .-,--Q--=--WTR-.   
>>-+-*INQUIRY-+--,--U--+--------------+------------------------->
   '-*I-------'                           

>--+-----------------------------------------------------------+-->
   +-,--Q--=--HOLD--+------------------+--+------------------+-+   
   |                '-| Unique Parms |-'  '-| Common Parms |-' |   
   +-,--Q--=--WTR--+------------------+--+------------------+--+   
   |               '-| Unique Parms |-'  '-| Common Parms |-'  |   
   +-,--Q--=--BDT--+------------------+--+------------------+--+   
   |               '-| Unique Parms |-'  '-| Common Parms |-'  |   
   '-,--Q--=--TCP--+------------------+--+-------------------+-'   
                   '-| Unique Parms |-'  '-|  Common Parms |-'     

>--+------------------------------------+----------------------->
   '-,--Q--=--WTR--+------------------+-'   
                   '-| Common Parms |-'     

>--+------------------+----------------------------------------><
   '-| Common Parms |-'   

Q=HOLD Unique Parameters

|--+---------------------+--+------------------------+----------|
   '-,--DSID--=--+-?---+-'  '-,--W--=--+-?---------+-'   
                 '-ddn-'               '-extwriter-'     

Q=WTR Unique Parameters

   .-,--GT--=--PRT-------------------.   
|--+---------------------------------+-------------------------->
   '-,--GT--=--+-PUN---------------+-'   
               '-(--PRT--,--PUN--)-'     

>--+-----------------------+------------------------------------|
   '-,--ST--=--+-?-------+-'   
               '-devtype-'     

Q=BDT Unique Parameters

|--+------------------------+--+----------------------+--------->
   '-,--BG--=--+-?--------+-'  '-,--BJ--=--+-?------+-'   
               '-group-id-'                +-nnnn---+     
                                           '-NAVAIL-'     

>--+------------------------+--+----------------------+---------|
   '-,--BS--=--+-?--------+-'  '-,--BT--=--+-?------+-'   
               +-ACTIVE---+                +-JOB----+     
               +-INACTIVE-+                '-SYSOUT-'     
               +-QUEUED---+                               
               '-SENT-----'                               

Q=TCP Unique Parameters

|--+------------------------+--+------------------------+------->
   '-,--TG--=--+-?--------+-'  '-,--TS--=--+-?--------+-'   
               '-group-id-'                +-ACTIVE---+     
                                           +-INACTIVE-+     
                                           '-QUEUED---'     

>--+----------------------+-------------------------------------|
   '-,--TT--=--+-?------+-'   
               +-JOB----+     
               '-SYSOUT-'     

Q=HOLD & Q=WTR Common Parameters

|--+-------------------+--+-----------------------------+------->
   '-,--C--=--+-?----+-'  '-,--CH--=--+-tab-----------+-'   
              '-carr-'                +-?-------------+     
                                      |    .-,---.    |     
                                      |    V     |    |     
                                      '-(----tab-+--)-'     

>--+---------------------+--+--------------------------+-------->
   '-,--CL--=--+-?-----+-'  '-,--CM--=--+-module-----+-'   
               '-class-'                +-module,trc-+     
                                        +-?----------+     
                                        '-NONE-------'     

>--+-----------------+--+------------------------+-------------->
   '-,--CONS--=--con-'  '-,--DG--=--+-?--------+-'   
                                    '-devgroup-'     

>--+-------------------+--+-----------------------+------------->
   '-,--F--=--+-?----+-'  '-,--FD--=--+-?-------+-'   
              '-form-'                '-formdef-'     

>--+------------------------+--+----------------------+--------->
   '-,--FL--=--+-flash id-+-'  '-,--ID--=--+-?------+-'   
               +-?--------+                '-userid-'     
               '-NONE-----'                               

>--+----------------------+------------------------------------->
   '-,--IP--=--+-?------+-'   
               +-Y------+     
               +-N------+     
               '-ipaddr-'     

>--+----------------------------------------------+------------->
   +-,--J--=--+-?-------+-------------------------+   
   |          +-jobname-+                         |   
   |          '-jobno---'                         |   
   '-,--J--=--+-?-------+--+-,--DD--=--+-?---+--+-'   
              +-jobname-+  |           '-ddn-'  |     
              '-jobno---'  '-,--DSN--=--+-?---+-'     
                                        '-dsn-'       

>--+---------------------+--+-----------------------+----------->
   '-,--OB--=--+-?-----+-'  '-,--PD--=--+-?-------+-'   
               +-nnnnn-+                '-pagedef-'     
               '-NONE--'                                

>--+---------------------+--+------------------------+---------->
   '-,--PM--=--+-?-----+-'  '-,--SL--=--+-?--------+-'   
               '-value-'                '-seclabel-'     

>--+-----------------+--+----------------------------+---------->
   '-,--SS--=--+-C-+-'  '-,--T--=--+-?-------------+-'   
               +-S-+               '-terminal name-'     
               '-?-'                                     

>--+--------------------+---------------------------------------|
   '-,--U--=--+-?-----+-'   
              '-train-'     

*INQUIRY, U Common Parameters

|--+-----------------------+--+---------------------------+----->
   '-,--AGE--=--+-?------+-'  '-,--APPC--=--+-?---------+-'   
                +-nnn--D-+                  +-tpid------+     
                '-nnn--H-'                  '-tpjobname-'     

>--+---------------------------+--+-------------------+--------->
   '-,--BY--=--+-?-----------+-'  '-,--C--=--+-?----+-'   
               +-nnnnnnnn----+               '-carr-'     
               '- ---nnnnnnn-'                            

>--+----------------------+--+--------------------------+------->
   '-,--J--=--+-?-------+-'  '-,--L--=--+-?-----------+-'   
              +-jobno---+               +-nnnnnnnn----+     
              '-jobname-'               '- ---nnnnnnn-'     

   .-,--N--=--10---------.                                 
>--+---------------------+--+--------------------------+-------->
   '-,--N--=--+-nnnnnn-+-'  '-,--OUTDISP--=--+-?-----+-'   
              '-ALL----'                     +-H-----+     
                                             +-HOLD--+     
                                             +-K-----+     
                                             +-KEEP--+     
                                             +-L-----+     
                                             +-LEAVE-+     
                                             +-W-----+     
                                             +-WRITE-+     
                                             +-N-----+     
                                             '-NONE--'     

>--+-------------------+--+---------------------------+--------->
   '-,--P--=--+-?----+-'  '-,--PG--=--+-?-----------+-'   
              '-prty-'                +-nnnnnnnn----+     
                                      '- ---nnnnnnn-'     

>--+-----------------------------------+------------------------>
   '-,--CJID--=--+-Y-----------------+-'   
                 +-N-----------------+     
                 '-client-job-string-'     

>--+-----------------------------+------------------------------|
   '-,--CJNM--=--client-job-name-'

Parameters

Q=TCP

Displays information about TCP/IP jobs.

Q=BDT

Displays information about SNA/NJE jobs on the output service BDT queue.

Q= HOLD

Specifies the output service HOLD queue is to be searched.

Q=WTR

Displays information for data sets on the output service writer queue (WTR).

AGE=nnnnD|nnnnH|?

Displays the age of all (?) data sets or displays information about job or SYSOUT streams that have been on the output queue for at least the specified minimum number (1 through 9999) of days (D) or hours (H).

APPC= Y|N|tpname|?|tpid

Displays SYSOUT from APPC transaction programs (TPs) only (Y). Displays non-APPC TPs generated from SYSOUT only (N). Displays SYSOUT from a specific TP only (tpname). Displays TP, job name, and TP identifier (tpid) if applicable (?). Displays SYSOUT from a tpname (tpid). If APPC= is not specified, all work is displayed and SYSOUT from APPC TPs is indicated by the string APPC.

BG=group-id or ?

Displays the groupid of all (?) data sets or SYSOUT streams in the output queue, or displays information about job or SYSOUT streams that have the specified group-id. The group-id is an 8-byte alphanumeric value that is unique for each network job stream or network SYSOUT stream within a JES3 job. The group identifier is displayed in the form: BDTxxxxx. xxxxx represents a value from 0 to 32767.

BJ=NAVAIL or nnnn or ?

Displays all (?) BDT work and corresponding job numbers or displays all BDT work that does not have a BDT job number assigned to it (NAVAIL) or displays the BDT work of the specified BDT job number (nnnn).

BS=?, ACTIVE. INACTIVE, QUEUED, or SENT

Displays the status of all (?) network job streams or SYSOUT streams in the output queue, or displays information about job or SYSOUT streams with the specified status.

ACTIVE: Displays the work that MVS/BDT is currently processing.
INACTIVE: Displays the work that has been built by output service.
QUEUED: Displays the work that MVS/BDT has added to its job queue.
SENT: Displays the work that is waiting for processing by MVS/BDT.

BT=JOB or SYSOUT or ?

Displays all (?) SNA/NJE job or SYSOUT streams in the output queue or displays information about all job streams in the output queue (JOB), or displays information about all SYSOUT streams in the output queue (SYSOUT).

BY=nnnnnnnn or ? or -nnnnnnn

Specifies to select for display data sets having a specified number of bytes.

nnnnnnnn (1 to 8 characters): Data sets with at least the specified number of bytes.
(?): All data sets regardless of size.
-nnnnnnn (up to 7 characters in length): Data sets with no more than the specified number of bytes. For example, BY=-4096 selects data sets for display whose size in bytes does not exceed 4096.

C=carr or ?

Displays the carriage (FCB) requirements of all work in the hold queue (?) or the information for data sets that require the specified carriage (FCB) name (carr).

CH=tab or (tab[,tab...]) or ?

Displays the image or table requirements for all 3800 data sets in the queue (?) or information for data sets requiring the designated character arrangement table (tab) or tables. Up to four table names may be displayed. Parentheses are required as shown.

CJ=Y or N or ? or client-job-string

Displays SYSOUT with spinoff job names only (Y). Displays SYSOUT without spinoff job names only (N). Displays spinoff job name and spinoff job id if applicable (?). Displays SYSOUT whose spinoff job name or spinoff job id matches client-job-string only (client-job-string). If none of CJ=, CJID=, and CJNM= is specified, all work is displayed and SYSOUT with spinoff job names is indicated by the string CJ.

CJID=Y or N or client-job-id

Displays SYSOUT with spinoff job ids only (Y). Displays SYSOUT without spinoff job ids only (N). Displays SYSOUT from a specific spinoff job id only (client-job-id).

CJNM=client-job-name

Displays SYSOUT with a specific spinoff job name only.

CL=class or ?

Displays information for data sets in all output classes (?) or the designated output class (class).

CM= module or (module, trc) or NONE or ?

Displays copy modification module requirements for all of output data sets (?), in the queue, information for data sets requiring the designated copy modification module (module), or information for data sets requiring the designated copy modification module and table reference character (trc). NONE specifies that data sets without copy modification requirements are to be displayed.

CONS=con

Specifies the console to which the response to this command is to be sent. If omitted, the response is sent to the console on which you entered the command. You must specify the console's name on the CONS parameter.

D=node|node.remote|?

SNA/NJE

For Q=BDT, the node must be a SNA/NJE defined node. The remote part of the specification is a secondary destination that can only be specified with DD=ddname or DSN=dataset name.

TCP/IP

For Q=TCP, the node must be a TCP/IP defined node. The remote part of the specification is a secondary destination which can only be specified with DD=ddname or DSN=dataset name.

WTR/HOLD

For Q=HOLD or Q=WTR the destination node can be a JES3 managed device, a PSF managed device, or an application name. The remote part of the specification is a secondary destination which should be a user ID and can only be specified when DD=ddname or DSN=data set name.

D=dest or ?

Displays the destination of all (?) network job or SYSOUT streams in the output queue, or displays information about job or SYSOUT streams for the specified destination (node or node.remote).

Displays all the destinations of the specified data set (?), or displays information about the data sets of the specified destination (node or node.remote).

DD=ddn|?

Displays a summary of output for the designated ddname (ddn). Specify ddn using procstepname.jobstepname.ddname. You must include a period as a qualifier for names that you omit, or displays a summary of output for all data sets of a given job (?). The output summary will display both the three-qualifier ddname and the five-qualifier data set identifier (dsn) of a data set. The job must be specified (J=) if the keyword DD is used. The DD= and DSN= keywords are mutually exclusive; that is, you cannot include both the DD= and the DSN= keywords on the same command.

Displays a summary of output for the designated ddname (ddn). Specify ddn using procstepname.jobstepname.ddname (for example, ..JESYSMSG). Include a period for names that you omit.

Displays a summary of output for all data sets of a given job (?).

DG=devgroup or ?

Displays the status of all data sets created by jobs submitted from the designated device group or destined for an output device in the designated group. Device group names are assigned to devices during initialization.

Note: The DG= parameter cannot be issued from a remote workstation or from NJE.

DSID =ddn or jobno or ?

Displays the information for all 3540 output data sets (?) or a single designated data set (ddn).

DSN=dsn|?

Displays a summary of output for the designated data set (dsn) or displays a summary of output for all data sets of a job (?). You must specify the job (J=) keyword. The DD= and DSN= keywords are mutually exclusive; that is, you cannot include both the DD= and the DSN= keywords on the same command.

When specified, DSN can be either a fully qualified data set name or only the data set number.

When specifying the fully qualified data set name, use DSN=userid.jobname.jobid.datasetnumber.dsname. You must include all five qualifiers.
When specifying only the data set number, use DSN=...datasetnumber Even though the first three qualifiers and the fifth qualifier are left out, the initial separator periods are still required. The final trailing separator period is not required.

F=form or ?

Displays the forms required for all work in the queue (?) or information for data sets requiring the specified form name (form).

FD=formdef or ?

Displays information for data sets requiring the specified FORMDEF (formdef) or the FORMDEF required for all work in the queue (?).

FL=flash-id or NONE or ?

Displays flash (forms overlay) requirements for all data sets (?), information for output requiring the designated flash name (flash-id), or information for data sets with no flash requirements (NONE).

GT=PRT or PUN

Specifies the general type of output whose writer-selection characteristics are to be modified: print data sets (PRT), or punch data sets (PUN).

H=S|SYS or O|OPER or U|USER or Y|N|?

(S|SYS,O|OPER,U|USER)

(S|SYS,O|OPER)

(S|SYS,U|USER)

(O|OPER,U|USER)

Displays the data sets placed in the hold state by the system, the operator, or the user. You can specify one or more of these hold types (S|SYS, O|OPER, U|USER) in any order.

If you specify more than one operand for H=S|SYS and O|OPER and U|USER, you must use parentheses. Parentheses are optional if you specify only one operand.

You cannot specify S|SYS, O|OPER or U|USER with Y, N or ?.

When asking for hold information about the system (S|SYS), operator (O|OPER), or user (U|USER), you must specify the DD= parameter with a designated ddname or ?, or you must specify DSN= with a designated data set name or ?.

Y, N or ? are mutually exclusive; that is you can only specify one of these operands.

ID=userid

Displays output information for all users (?) or a designated user (userid).

IP=Y or N or ipaddr or ?

Displays one of the following:

the IP address required for all work in the queue (?)
information for data sets that have an IP address (Y)
information for data sets that do not have an IP address (N)
information for data sets that have the specified IP address (ipaddr).

The IP variable (ipaddr) is case sensitive and must be enclosed in single quotation marks. If the address itself contains imbedded quotation marks, each one must be represented by two single quotation marks.

J=jobno or jobname or ?

Displays the output information for the specified JES3 job (jobno or jobname) or for all jobs (?).

Specifies the job for which 3800 data set information is to be displayed. If omitted, the display includes all jobs that have output destined for the 3800 printer.

L=nnnnnnnn or ? or -nnnnnnn

Specifies to select for display data sets having a specified number of lines.

nnnnnnnn (1 to 8 characters): Data sets with at least the specified number of lines.
(?): All data sets regardless of line count
-nnnnnnn (up to 7 characters in length): Data sets with no more than the specified number of lines. For example, L=-1000 selects data sets for display whose line count does not exceed 1000.

N=10 or nnnnnn or ALL

Specifies the number of detail lines (0 through 999999) to be displayed on the console or that all lines of the response to the INQUIRY command are to be displayed. If you omit the N= keyword, a maximum of ten lines is displayed.

OB=nnn or NONE or ?

Displays the ID of the printer output bin for all data sets (?), information for all data sets with the designated printer output bin ID (00001 through 66535), or information for data sets with no printer output bin ID (NONE) be displayed.

Displays the output disposition of all data sets in the output queue (?) or displays information about data sets with the specified output disposition. End of change

P=prty or ?

Displays the priorities of all (?) network job or SYSOUT streams in the output queue, or displays information about job or SYSOUT streams having the specified priority.

PD=pagedef or ?

Displays information for data sets requiring the specified PAGEDEF (pagedef) or the PAGEDEF required for all work in the queue (?).

PG=nnnnnnnn or ? or -nnnnnnn

Specifies to select for display data sets having a specified number of pages.

nnnnnnnn (1 to 8 characters): Data sets with at least the specified number of pages.
(?): All data sets regardless of page count.
-nnnnnnn (up to 7 characters in length): Data sets with no more than the specified number of pages. For example, PG=-500 selects data sets for display whose page count does not exceed 500.

PM=value or ?

Display data sets for the process mode specified on this parameter or displays the process mode values for all data sets.

REQ=ALL

Displays summary information for each job in the specified queue.

,S

Specifies the total number of JES3 jobs. The total number of JES3 jobs or BDT jobs is summarized with messages IAT8119 and IAT8141. Any IAT8131 messages are written to the hardcopy log. If you omit S, all messages are written to both the hardcopy log and the console.

Specifies that only summary message (IAT8119) can be displayed on the console. Any IAT8131 messages are written to the SYSLOG.

S=nnn

Specifies the sequence number of the data set to be displayed. Use this keyword only when several data sets have identical ddnames. S=1 is the default. This keyword can only be used when using the DD= keyword.

SL=seclabel or ?

Specifying a security label (seclabel) displays a summary of output with the designated security label. Specifying a question mark (?) displays a summary of output with the security label of the userid who requested the APPC to run. If you are dealing with APPC SYSOUT, SL=? displays a summary of output with the security label of the userid who requested the APPC transaction program to run. If DD= or DSN= is specified, the output information displayed will be by data set rather than by job. For additional information about security labels, see z/OS JES3 Initialization and Tuning Guide or z/OS Security Server RACF Security Administrator's Guide.

SS=C or S or ?

Displays stacker requirements for all output data sets (?), information for data sets requiring the continuous form stacker option (C), or information for data sets requiring the burster-trimmer-stacker option be displayed (S).

ST=? or devtype

Specifies that all specific JES3 device requirements be displayed (?) or output for the designated JES3 device type be displayed (devtype).

T=term or ?

Specifies that JES3 display the status of all data sets created by jobs submitted from the designated RJP terminal or from all (?) RJP terminals.

TG=group-id or ?

Displays the group id of all data sets or SYSOUT streams in the output queue, or displays information about job or SYSOUT streams that have the specified group-id. The group-id is an 8-byte alphanumeric value that is unique for each network job stream or network SYSOUT stream within a JES3 job. The group identifier is displayed in the form: TCPxxxxx. xxxxx represents a value from 0 to 32767.

TS=?, ACTIVE, INACTIVE or QUEUED

Displays the status of all TCP/IP job streams or SYSOUT streams in the output queue, or displays information about job or SYSOUT streams with the specified status.

ACTIVE: Displays the work that a Netserv is currently processing.
INACTIVE: Displays the work that has been built by output service.
QUEUED: Displays the work that has been queued to a Netserv for processing.

TT=JOB or SYSOUT or ?

Displays all TCP/IP job or SYSOUT streams in the output queue, displays information about all job streams in the output queue (JOB), or displays information about all SYSOUT streams in the output queue (SYSOUT).

BY=nnnnnnnn or ? or -nnnnnnn

Specifies to select for display data sets having a specified number of bytes.

nnnnnnnn (1 to 8 characters): Data sets with at least the specified number of bytes.
(?): All data sets regardless of size.
-nnnnnnn (up to 7 characters in length): Data sets with no more than the specified number of bytes. For example, BY=-4096 selects data sets for display whose size in bytes does not exceed 4096.

U=train or ?

Displays the train (UCS) name for all data sets in the queue (?) or information for data sets having the specified train name (train).

W=extwriter or ?

Specifies information for all external writer data sets (?) or the designated external writer data sets (extwriter).

Rules

You cannot code AGE= and BS= together in the same command.
If you specify REQ=ALL with Q=TCP or Q=BDT, JES3 displays the status of all the network job streams (TS=?) or SYSOUT (BS=?) streams.
The use of IP=?, IP=ipaddr, FD=, and PD= will cause extra I/O to be performed and could affect performance. When possible, use the J= keyword to limit the search to one job or the N= keyword to limit the number of jobs processed.
If you specify more than one operand for H=S|SYS and O|OPER and U|USER, you must use parentheses. Parentheses are optional if you specify only one operand. If you use H=Y or N or ? only one operand is allowed.

Examples

Display information for a specified data set with the data set identifier SUPERU.INTEREST.JOB00071.D000000B.? created by the job INTEREST on the hold queue:

*I U Q=HOLD,J=INTEREST,DSN=SUPERU.INTEREST.JOB00071.D000000B.?,SL=?

Display all jobs destined for NODE5:

*INQUIRY,U,Q=WTR,J=?,D=NODE5

Display which data sets are destined for userid WS001 at node NODE5. The operator specifies both the job and data sets name:

*INQUIRY,U,Q=WTR,J=MYJOB,D=NODE5.WS001,DD=?

Display information for output on the WTR queue created by job PAYROLL that has a five-qualifier data set identifier of SUPERU.PAYROLL.JOB00070.D000000A.?:

*I U Q=WTR,J=PAYROLL,DSN=SUPERU.PAYROLL.JOB00070.D000000A.?

Display information for all output on the WTR queue created by job PAYROLL:

*I U Q=WTR,J=PAYROLL,DD=?

Display information for all output on the writer queue that does not contain an IP address.

*I,U,J=?,D=?,ID=?,D=?,IP=N

Display information for all output on the writer queue that has an IP address of KOLA@myhouse. The IP variable is case sensitive and must be enclosed in quotation marks.

*I,U,J=?,DD=?,IP='KOLA@myhouse'

Display all SYSOUT streams destined for TCP/IP connected node NODE2:

*INQUIRY,U,Q=TCP,J=?,D=NODE2,TT=SYSOUT