Displaying RJP status and device status *INQUIRY,D

Function

Use the *INQUIRY,D command to display the status of:

BSC RJP workstations
BSC RJP lines
SNA RJP workstation devices
All JES3 and JES3-managed devices
An output device and its current output characteristics

Note: For an FSS device, the display contains job information for the output sent to the FSS. This may be a job that has completed processing on the output device but is being retained by the FSS. See the FSS application documentation, z/OS MVS Using the Functional Subsystem Interface, to determine if there is a better way to monitor job status.

Syntax


>>-+-*INQUIRY-+--,--D------------------------------------------->
   '-*I-------'         

   .-,--N--=--10-------------------------------------------.   
>--+-------------------------------------------------------+---->
   +-| D= Options |----------------------------------------+   
   +-,--L--=--+-lname-----------+--------------------------+   
   |          |    .-,-----.    |                          |   
   |          |    V       |    |                          |   
   |          +-(----lname-+--)-+                          |   
   |          '-ALL-------------'                          |   
   +-+-,--main-----------+---------------------------------+   
   | |       .-,----.    |                                 |   
   | |       V      |    |                                 |   
   | '-,--(----main-+--)-'                                 |   
   +-,--N--=--+-nnn-+--------------------------------------+   
   |          '-ALL-'                                      |   
   +-,--T--=--+-wsname--------------+----------------------+   
   |          |    .-,------.       |                      |   
   |          |    V        |       |                      |   
   |          +-(----wsname-+--)----+                      |   
   |          '-ALL--+------------+-'                      |   
   |                 +-,--ONLINE--+                        |   
   |                 '-,--TRACEON-'                        |   
   '-,--V--=--+-vol--+-------------------+-+--+----------+-'   
              |      +-,--main-----------+ |  +-,--SHORT-+     
              |      |       .-,----.    | |  '-,--S-----'     
              |      |       V      |    | |                   
              |      '-,--(----main-+--)-' |                   
              |    .-,---.                 |                   
              |    V     |                 |                   
              '-(----vol-+--)--+---------+-'                   
                               '-,--main-'                     

>--| D= Options |----------------------------------------------><

Parameters

D=devnum or /devnum or devname

Specifies the number (by 3-digit or 4-digit hexadecimal number) or name of one or more output devices. If omitted, the number specified in the N parameter or the first ten JES3-managed devices attached to the global are displayed. A slash (/) preceding the device number is not required. Device numbers can be specified by any of the following formats:

ddd
dddd
/ddd
/dddd

where ddd and dddd represent the device numbers.

D=devnum or /devnum or devname,SHORT or S: Displays status information for the specified devices on the global processor.

D=devnum or /devnum,main

D=devnum or /devnum,(main),N=1

Indicates the device defined to JES3 by the specified device number and main name. If you include more than one main name, the parameters can see more than one device; each device is defined by device number, devnum, and a main name.

JES3 displays status information for each device on each main using the device number.

D=devnum or /devnum,(main),N=nnn or ALL

Specifies a series of JES3-defined devices being used by main. The series starts with the device defined by the device number, devnum or /devnum, and either continues for nnn device numbers or ends with the last device number defined for the main (ALL). JES3 displays devices in the order they appear in the SETUNIT or SUPUNIT table when you use this parameter. If you include more than one main name, these parameters specify a series of devices for each main.

JES3 displays status information for each device in each series.

For remote devices with N= specified, JES3 displays devices for the corresponding remote workstation only.

JES3 issues message IAT8562 for each JES3 device identified by the command and IAT8572 for each JES3-managed or SMS-managed device defined to JES3 and identified by the command.

D=devnum or /devnum,(main),SHORT or S

Displays status information for the specified devices on the selected main.

D=(devnum or /devnum-devnum or /devnum),main

Specifies a range of devices on a selected main.

D=(devnum or /devnum-devnum or /devnum),main,SHORT or S

Displays status information for the specified devices on the selected main.

D={devX|/devX},main,main....

Displays information about all devices attached to the specified control unit on a selected main(s).

D=main or (main,main...)

JES3 will indicate if the main specified is the global or local processor.

L=lname or ALL

Displays the status of the names of the BSC RJP communications lines. If ALL is specified, the status of all BSC RJP lines and SNA RJP workstations is displayed.

main or (main,main)

Displays the status of JES3-managed devices on the main(s).

{N=nnn|ALL|10 (the default)}

Specifies the number of JES3-managed devices to be displayed.

If both D= and N= are omitted, then the first ten devices are displayed.
If D= is omitted and N= specifies a number, then nnn or all global and execution devices (whichever is smaller) are displayed. Global devices are displayed first, followed by execution devices, unless the number of global devices is greater than or equal to the value specified by N=, in which case only global devices are displayed. If N=ALL is specified, then all JES3 global and execution devices are displayed.
If D= is specified and N= is omitted, then only the requested device is displayed.
If D= specifies the device name of a device that does not exist, no devices are displayed regardless of what N= specifies.
If D= specifies the device number of a device that does not exist, and N= specifies a value greater than one, JES3 displays devices starting with the first entry in the SETUNIT or SUPUNIT table (depending upon the presence of a processor name) that contains a device number greater than the one specified.
If D= specifies an RJP console, reader, punch, or printer, and N=nnn is specified, then either nnn or all devices in the workstation (whichever is smaller), starting with the requested device, are displayed. If N=ALL is specified, then all devices in the workstation, starting with the requested device, are displayed.
If D= specifies a non-RJP device attached to the global, and N=nnn is specified, then nnn or all global devices (whichever is smaller), starting with the requested device, are displayed. If N=ALL is specified, then all global devices, starting with the requested device, are displayed.
If D= specifies an execution device and N=nnn is specified, then nnn or all execution devices (whichever is smaller), starting with the requested device, are displayed. If N=ALL is specified, then all execution devices, starting with the requested device, are displayed.
Specifying N=ALL or a large number for a non-RJP inquiry can flood your console(s) with messages and adversely affect system performance.

SHORT or S

Displays the status of a device on a specified main only.

T=wsname or ALL

Specifies the 5-character workstation name.

T=ALL,ONLINE or ,TRACEON

Displays the status of all BSC RJP and SNA RJP workstations. If ONLINE is specified, the status of all BSC RJP and SNA RJP workstations that are signed on is displayed. If TRACEON is specified, the status of all SNA RJP workstations for which the trace facility was requested is displayed.

Note: This command does not display the setup characteristics of a remote SNA RJP printer.

V=vol

Displays the disposition of the device with the designated volume serial number.

V=vol,SHORT or S: Displays status information for the specified volumes on the selected main.

Rules

You can use only one set of parentheses on the D= keyword parameter.

You can specify multiple device addresses or multiple mains but not both on the D= keyword parameter. For example:

*I,D,D=(3D4,367),SY1                             is a valid entry

*I,D,D=234,(SY1,SY2)                             is a valid entry

*I,D,D=(3D4,367),(SY1,SY2)                       is not a valid entry

Do not enter the parentheses when specifying a single device address or main on the D= keyword parameter.
You can substitute the device address value with a device's JNAME on the D= keyword parameter.
You can specify multiple volume serial numbers or multiple mains, but not both on the V= keyword parameter.
For non-RJP devices, JES3 searches the SUPUNIT or SETUNIT table when you select the N= keyword parameter. JES3 displays devices in the order that they appear on the DEVICE initialization statements in the JES3 initialization deck unless you specify ADDRSORT=YES on the SETPARAM initialization statement. If you specify ADDRSORT=YES, the tables are sorted numerically.
For RJP devices, JES3 displays devices in the order that they appear within the workstation.
You can receive duplicate output if you specify multiple mains on a D= keyword parameter and the specified device is defined on both mains with the same device address.
Even though you can display the status of an SMS-managed device if it is defined in the JES3 initialization stream, it is still managed by SMS and not JES3.
If both D= and a main name are specified, and the main specified is the global, then the SUPUNIT table is searched if the device is not found in the SETUNIT table. In this case, ddd may represent a device address (JUNIT) or a JNAME.
The *INQUIRY,D(,N=nnn) command without D= specified does not display remote devices. Remote devices can be displayed only by specifying D=jname. The *INQUIRY,D,D= command can be used to display remote devices even if the remote workstation is inactive.
If you have a device name ending with an ‘X’ (dddX), and a group of devices beginning with the same hexadecimal characters as the device name (for example, a device name ‘FAAX’ and a group of device numbers ‘FAA0, FAA1, ... FAAF’), to request status of the devices attached to the control unit, you need to specify the range of devices (*I D D=devnum-devnum) instead of the control unit (*I D D=devX). This prevents JES3 from confusing the device numbers (in control unit format) with the device name.

Results

This command causes one of the following messages to be issued:

IAT8618 wsname SNA RJP NOT SIGNED ON,
{TRACE ON|TRACE OFF}

IAT8622 wsname,lname ,RDS HELD ,  TRACE ON|TRACE OFF

Examples

Display the numbers of all devices in the complex defined to JES3 with each of five device numbers starting with the number 482:

*I,D,D=482,N=5

Display the status of each occurrence in the complex of the device defined on mains SY1 and SY2 by the device number 482:

*I,D,D=482,(SY1,SY2)