Displaying the status of jobs, volumes, and data sets *INQUIRY,S

Function

Use the *INQUIRY,S command to display the status of jobs currently in setup or the status of volumes and data sets controlled by MDS. If none of the optional parameters is specified, the status of all mains in the complex and a summary of the MDS queues are displayed.

Syntax


>>-+-*INQUIRY-+--,--S--+----------------------------+----------><
   '-*I-------'        +-,--ALWIO-------------------+   
                       +-,--A--+----------------+---+   
                       |       +-,--SUMM--------+   |   
                       |       '-,--J--=--jobno-'   |   
                       +-,--E--+----------------+---+   
                       |       '-,--J--=--jobno-'   |   
                       +-,--R--+----------------+---+   
                       |       '-,--J--=--jobno-'   |   
                       +-,--SS--+----------------+--+   
                       |        '-,--J--=--jobno-'  |   
                       +-,--SV--+----------------+--+   
                       |        '-,--J--=--jobno-'  |   
                       +-,--U--+----------------+---+   
                       |       '-,--J--=--jobno-'   |   
                       +-,--B-----------------------+   
                       +-,--D--=--dsn---------------+   
                       +-,--DE--=--dsn--------------+   
                       +-,--F-----------------------+   
                       +-,--THWSSEP-----------------+   
                       +-,--V-----------------------+   
                       +-,--V--=--+-vol--+------+-+-+   
                       |          |      '-,--E-' | |   
                       |          +-ALL--+------+-+ |   
                       |          |      '-,--E-' | |   
                       |          '-RES-----------' |   
                       '-,--W-----------------------'

Parameters

ALWIO: Displays the current, allowed (ALWIO), and maximum (MAXIO) number of asynchronous I/O requests that can be processed simultaneously. These numbers are specified in the ALWIO and MAXIO parameters of the SETPARAM initialization statement.
A: Displays jobs currently in the MDS allocate queue (competing for resources such as devices, volumes, and data sets).
E: Displays jobs currently in the MDS error queue.
R: Displays jobs currently in the MDS restart queue.
SS: Displays jobs currently on the MDS system select queue.
SUMM: Displays a summary of jobs in MDS allocation, including the resources that are required and the number of jobs that require each resource.
SV: Displays jobs currently on the MDS system verify queue.
U: Displays all unavailable volumes and jobs waiting because of unavailable volumes.
J=jobno: Specifies the job number of the job in the allocate, unavailable, error, restart, system select, or system verify queue and requests specific information about the job.
B: Displays jobs currently having their resources deallocated.
D=dsn: Specifies that the fully qualified data set name, separated by blanks, commas or periods, have its status and the status of any associated volumes listed. You can enter a maximum of 8 data set name qualifiers.
DE=dsn: Specifies that the fully qualified data set name, separated by blanks, commas or periods, have its status and the status of any associated volumes listed. Any jobs referencing the specified data set are also listed. You can enter a maximum of 8 data set name qualifiers.
F: Displays jobs currently in the MDS fetch queue.
THWSSEP: Displays the current value of the high watermark option. This option indicates whether JES3 should separate scratch and specific requests or scratch requests of different media types during tape high watermark setup processing.
V: Displays jobs waiting to be verified by setup. (The current number of volume mounts yet to be performed is also displayed.)
V=volser[,E]: Displays the status of the designated volume and associated data sets. If you specify E, the status of all job references to the volume is also listed.
V=ALL[,E]: Displays the number of currently managed volumes. If you specify E, all volume serials are also listed.
V=RES: Displays all volumes specified on the SETRES initialization statement.
W: Displays jobs currently in the MDS WAITVOL queue (waiting for the *S,SETUP command).

Examples

Display a list of the number of jobs in each setup queue:

*I,S

Note: The *I,S command can also be used to display information for main processors, but only if SETUP is active in the complex. IBM® suggests using the *I,MAIN= command for this purpose instead of *I,S as it does not depend on SETUP and displays more comprehensive information relevant to main processors.

Display a list of all jobs currently in the allocate queue:

*INQUIRY,S,A

Display status of job 12345.

 
*INQUIRY,S,A,J=12345
 IAT5642 MDS ALLOCATION NOT YET ATTEMPTED FOR ... ON SY1  SCHENV NAVAIL
 IAT5642 MDS ALLOCATION NOT YET ATTEMPTED FOR ... ON SY2  GRP/CLS NAVAIL
 IAT5642 MDS ALLOCATION NOT YET ATTEMPTED FOR ... ON SY3  SCHENV NAVAIL
 IAT5642 MDS ALLOCATION NOT YET ATTEMPTED FOR ... ON SY4  SMS RES. NAVAIL

Display a summary of jobs in MDS allocation.

*I,S,A,SUMM

In this example, there are three jobs waiting for 3490 devices and there is one job waiting for specific device F0B1.

*I,S,A,SUMM

IAT5030 00003 REQUESTS NEED DEVICE 3490
IAT5033     JOB TAPE1    (JOB32810),14 - NEEDS 00004 DEVICES
IAT5033     JOB TAPE2    (JOB32804),02 - NEEDS 00001 DEVICE
IAT5033     JOB TAPE3    (JOB32804),02 - NEEDS 00002 DEVICES
IAT5033
IAT5030 00001 REQUESTS NEED SPECIFIC DEVICE F0B1
IAT5031   00001 REQUESTS HAVE EXCLUSIVE USE OF THE RESOURCE
IAT5033     JOB DEMAND   (JOB32812),03 - NEEDS DEVICE F0B1
IAT5033

In this example, there are two jobs waiting for exclusive use of a tape volume, and there is one job waiting for the device associated with a DASD volume to be varied online.

*I,S,A,SUMM

IAT5030 00002 REQUESTS NEED VOLUME TAPVL1
IAT5031   JOB GOTTAPE  (JOB27842) HAS EXCLUSIVE USE OF THE RESOURCE
IAT5032   RESOURCE HAS BEEN RESERVED EXCLUSIVE BY A JOB IN PRIORITY
IAT5033     JOB WANTTAP1 (JOB34000),14 - NEEDS EXCLUSIVE USE OF VOLUME
IAT5033     JOB WANTTAP2 (JOB34009),06 - NEEDS EXCLUSIVE USE OF VOLUME
IAT5033
IAT5030 00001 REQUESTS NEED THE DEVICE FOR VOLUME VSAM01
IAT5033     JOB DASDVOL1 (JOB35000),12 - NEEDS SHARED USE OF VOLUME
IAT5033

In the following example, there is one job waiting for shared use of a non-SMS data set and one job waiting for exclusive use of an SMS managed data set:

*I,S,A,SUMM

IAT5030 00001 REQUESTS NEED DATA SET RIEDY.LINKLPA ON VOLUME D75902
IAT5031   JOB LINKNUC  (JOB27881) HAS EXCLUSIVE USE OF THE RESOURCE
IAT5032   RESOURCE HAS BEEN RESERVED EXCLUSIVE BY A JOB IN PRIORITY 12
IAT5033     JOB LISTMEM  (JOB34011),12 - NEEDS SHARED USE OF DATA SET
IAT5033
IAT5030 00001 REQUESTS NEED SMS DATA SET D75JES3.COMMON.DECKS
IAT5031   00002 REQUESTS HAVE SHARED USE OF THE RESOURCE
IAT5033     JOB INITCHEK (JOB35123),11 - NEEDS EXCLUSIVE USE OF DATA SET
IAT5033

In the following example, there is one job waiting for a device fence to become available, two jobs waiting for a job class to become available on SY2, one job waiting for a scheduling environment to become available on SY1, and two jobs waiting for a scheduling environment to become available on SY2. Note that the device fence condition does not have a system name associated with it since it is not associated with a particular system.

*I,S,A,SUMM
IAT5030 00001 REQUESTS - DEVICE FENCE PENDING
IAT5033     JOB DJCFENCE (JOB12012), 02
IAT5033
IAT5030 00002 REQUESTS - CLASS OR GROUP DISABLED ON SY2
IAT5033     JOB CLASSZ1  (JOB12012), 02
IAT5033     JOB CLASSZ2  (JOB12013), 02
IAT5033
IAT5030 00001 REQUESTS - SCHEDULING ENVIRONMENT UNAVAILABLE ON SY1
IAT5033     JOB IMSDB1   (JOB11936), 02 - IMS_PRIME_TIME
IAT5033
IAT5030 00002 REQUESTS - SCHEDULING ENVIRONMENT UNAVAILABLE ON SY2
IAT5033     JOB IMSDB1   (JOB11936), 02 - IMS_PRIME_TIME
IAT5033     JOB VECTOR   (JOB11950), 02 - VECTOR_FACILITY
IAT5033