Displaying the status of a specific job *INQUIRY,J

Function

Use the *INQUIRY,J command to display:

The names of all the spool data sets that contain the job's spool data.
Only the names of the spool data sets that are in spool hold status.
The name of the spool partition assigned for a particular job.
The status of a particular job, including why the job is waiting to be scheduled for a particular function and how long it has been waiting.
Extended information for a job, such as the scheduling environment, service class, and job class group.

Syntax


>>-+-*INQUIRY-+--,--J--=--+-+-jobname-----------+-+------------->
   '-*I-------'           | |    .-,-------.    | |   
                          | |    V         |    | |   
                          | '-(----jobname-+--)-' |   
                          +-+-jobno-----------+---+   
                          | |    .-,-----.    |   |   
                          | |    V       |    |   |   
                          | '-(----jobno-+--)-'   |   
                          '-+-pattern-----------+-'   
                            |    .-,-------.    |     
                            |    V         |    |     
                            '-(----pattern-+--)-'     

>--+------------------------------------------+----------------><
   +-,--E--+---------------------+------------+   
   |       +-,--T--=--term-------+            |   
   |       +-,--ID--=--userid----+            |   
   |       '-,--SUBID--=--userid-'            |   
   +-,--M--+---------------------+------------+   
   |       +-,--T--=--term-------+            |   
   |       +-,--ID--=--userid----+            |   
   |       '-,--SUBID--=--userid-'            |   
   +-,--SD--+---------------------+--+------+-+   
   |        +-,--T--=--term-------+  '-,--U-' |   
   |        +-,--ID--=--userid----+           |   
   |        '-,--SUBID--=--userid-'           |   
   +-,--SH--+---------------------+--+------+-+   
   |        +-,--T--=--term-------+  '-,--U-' |   
   |        +-,--ID--=--userid----+           |   
   |        '-,--SUBID--=--userid-'           |   
   +-,--SP--+---------------------+-----------+   
   |        +-,--T--=--term-------+           |   
   |        +-,--ID--=--userid----+           |   
   |        '-,--SUBID--=--userid-'           |   
   +-,--W--+----+--+---------------------+----+   
   |       '-,X-'  +-,--T--=--term-------+    |   
   |               +-,--ID--=--userid----+    |   
   |               '-,--SUBID--=--userid-'    |   
   +-,--T--=--term--+------+--+------+--------+   
   |                '-,--W-'  '-,--X-'        |   
   +-,--ID--=--userid--+------+--+------+-----+   
   |                   '-,--W-'  '-,--X-'     |   
   +-,--SUBID--=--userid--+------+--+------+--+   
   |                      '-,--W-'  '-,--X-'  |   
   '-,--X--+----+--+---------------------+----'   
           '-,W-'  +-,--T--=--term-------+        
                   +-,--ID--=--userid----+        
                   '-,--SUBID--=--userid-'

Parameters

J=jobname or jobno

Specifies the job name or job number of the jobs to be processed by the command.

JES3 displays the jobs based on the other parameters that are specified in the command.

pattern: Specifies the job name that matches the specified pattern (not to exceed eight characters). You can specify an asterisk (*) in the pattern to represent zero or more characters, or you can specify a question mark (?) to represent a single character.

E

Displays the estimated number of lines, pages, or records to be printed and the number of cards to be punched for the job. If the job has completed processing on a local main, the display contains the actual counts.

M

Displays a list of the mains on which the specified jobs are eligible to run.

SD

Displays the ddnames of all the spool data sets that contain spool data for the specified job(s).

SH

Displays the ddnames of the spool data sets in spool hold status that contain spool data for the specified job(s).

SP

Displays the name of the spool partition assigned for the specified job by the job's JCL (on the //*MAIN control statement). If none was assigned in the JCL, display the name of the partition assigned, if any, for all jobs in the same class as the specified job.

For network jobs, it displays the assigned spool partition of the origin node which is specified in the NJERMT statement for that node in inish deck.

U

Displays the number of logical track groups allocated from the spool data sets that contain spool data for the specified job(s).

W

Displays the reason a job is waiting to be scheduled, and the amount of time the job is waiting.

T=term

Displays the status of jobs from the designated terminal group.

ID=userid

Specifies the userid that belongs to the owner.

SUBID=userid

Specifies the user that belongs to the job submittor.

If specified, the userid is obtained from the //*MAIN JCL statement. If it is not specified on the //*MAIN JCL statement, the userid of the job owner (ID=userid) is used by default.

X

Displays extended information for a job such as the job's scheduling environment and service class.

Rule

You can specify a maximum of 21 job names, numbers, or job name groups each time you issue the command.

Examples

List the ddnames of all spool data sets that contain data for all jobs with names beginning with the character string DISB:

*I,J=DISB*,SD

IAT8674 JOB DISB98   (JOB34150) P=04 CL=E        OUTSERV(PENDING WTR)
IAT8677 JOB DISB98   (JOB34150) DD=SPOOL1, SPOOL3
IAT8674 JOB DISB93   (JOB34130) P=02 CL=A        OUTSERV(PENDING WTR)
IAT8677 JOB DISB93   (JOB34130) DD=SPOOL1, SPOOL2, SPOOL4

When spool data set SPOOL3 was released from spool hold status, a message was issued stating that job number 4321 is still in spool hold status. Display the name(s) of the other spool data set(s) containing data for job 4321 that are still being held:

*I,J=4321,SH

IAT8674 JOB JOB9      (JOB04321) P=02 CL=A      OUTSERV(PENDING WTR)
IAT8675 JOB JOB9      (JOB04321) 001 EXTENTS HELD- SPOOL2

Display the name of the partition assigned to job DISB2:

*I,J=DISB2,SP

IAT8674 JOB DISB2     (JOB04321) P=02 CL=A      OUTSERV(PENDING WTR)
IAT8681 JOB DISB2     (JOB34148) SP=PART5

Display the status of job INVENTA:

*I,J=INVENTA

IAT8674 JOB INVENTA   (JOB34191) P=03 CL=B      CI

List the mains on which job 5290 is eligible to run:

*I,J=5290,M

IAT8674 JOB JOB52   (JOB05290) P=03 CL=B         MAIN(GMS SELECT)
IAT8683 JOB JOB52   (JOB05290) ELIGIBLE ON SY2, SY1, SY3, SY4, SY5
IAT8683 JOB JOB52   (JOB05290)             SY6, SY7, SYLOCAL8

Display why job 1122 is not being scheduled and how long it has been waiting:

*I,J=1122,W

IAT8674 JOB JOB123   (JOB01122) P=02 CL=Z        MAIN(ALLOCATE)
IAT8685     SY1      - SCHEDULING ENVIRONMENT NOT AVAILABLE
IAT8685     SY2      - REQUIRED RESOURCES NOT AVAILABLE
IAT8685     SY3      - MAIN OFFLINE/NOT CONNECTED
IAT8685     SY4      - GROUP/CLASS DISABLED
IAT8685     SY5      - GROUP/CLASS DISABLED
IAT8685     SY6      - MAIN OFFLINE/NOT CONNECTED
IAT8685     SY7      - MAIN OFFLINE/NOT CONNECTED
IAT8685     SYLOCAL8 - MAIN OFFLINE/NOT CONNECTED
IAT8687     JOB WAITING/ACTIVE 00001 HOURS  29 MINUTES  05 SECONDS

Display estimates of the number of lines, pages, or records to be printed for JOB52:

*I,J=JOB52,E

IAT8686 JOB JOB52     (JOB34191) ESTIMATES
IAT8686 0100000 LINES, 00001000 PAGES, 0001500000 BYTES, 20000 CARDS

Display extended information for JOB123, such as its scheduling environment:

*I,J=JOB123,X
IAT8674 JOB JOB123   (JOB32787) P=02 CL=Z        MAIN(ALLOCATE)
IAT8564 SCHENV=IMS_PRIME, SRVCLASS=SLOWWWW, GROUP= GRPA(WLM), RUN COMMAND

Display extended information for JOB123, such as its scheduling environment, and display why the job is not being scheduled:

*I,J=JOB123,X,W
IAT8674 JOB JOB123   (JOB32787) P=02 CL=Z        MAIN(ALLOCATE)
IAT8564 SCHENV=IMS_PRIME, SRVCLASS=SLOWWWW, GROUP= GRPA(WLM), RUN COMMAND
IAT8685     SY2       - MAIN OFFLINE/NOT CONNECTED
IAT8685     SY1       - NO INITIATORS STARTED in SRVCLASS ??
IAT8687     JOB WAITING/ACTIVE 00000 HOURS  07 MINUTES  40 SECONDS

List the ddnames of all spool data sets that contain data for job 14, along with the number of logical track groups allocated for the job:

*I,J=14,SD,U
IAT8674 JOB SJOBS (JOB00040) P=15 CL=W OUTSERV(PENDING WTR)
IAT8750 JOB SJOBS (JOB00040) DD=SPOOL2 1 TRKGPS
IAT8750 JOB ISJOBS (JOB00040) DD=SPOOL3 3 TRKGPS
IAT8750 INQUIRY ON JOB STATUS COMPLETE, 1 JOB DISPLAYED