SHOWJOB

Generated from C.60.01 /SYS/PUB/CICAT last modified on Thu Jan 11 09:18:52 2001

Back to Main Index


SHOWJOB


     Displays the status information about jobs/sessions.

SYNTAX


             [[#]Snnn          ]
             [[#]Jnnn          ]
     SHOWJOB [STATUS           ][;JOBQ][;*listfile]
             [SCHED            ]
             [item[;item[;...]]]



PARAMETERS


#Snnn               The session number (assigned by MPE/iX) of the
                    session for which the status information is to be
                    displayed.  The information appears in Type I
                    format, described under "OPERATION".  Default is
                    that the status information for all jobs/sessions is
                    displayed.

#Jnnn               The job number (assigned by MPE/iX) of the job for
                    which status information is to be displayed.  The
                    information is in Type I format, described under
                    "OPERATION".  Default is that the status information
                    for all jobs/sessions is displayed.

STATUS              Lists the number of jobs and sessions in each
                    processing state and the current jobfence and
                    job/session limits.  This information is in Type II
                    format, described under "OPERATION".  Default is
                    that the status information for all job/sessions is
                    displayed.

SCHED               Displays only the scheduled jobs.  The information
                    is in Type III format, described under "OPERATION".

item                A list of jobs/sessions whose status is displayed.
                    Default is that the status information for all
                    jobs/sessions is displayed.  The syntax appears
                    below.

*listfile           Formal file designator of the file on which the
                    output listing is written.  A backreference to a
                    FILE equation is required.  The listfile is a
                    temporary file with record size of 256 bytes,
                    blocked one record per block, with Carriage Control
                    (CCTL), with the time and date displayed.  You can
                    override the default characteristics of listfile
                    with the FILE command.  Default is $STDLIST.
                    FOR ITEM

JOBQ                Displays the queuename to which each job belongs.


SYNTAX FOR ITEM


          {@J                        }
          {@S                        }
     [JOB={@,                        }]
          {[jsname,]username.acctname}

             {INTRO      }
             {EXEC       }
           [;{SUSP       }
             {WAIT [,N]  }
                   [,D]

PARAMETERS FOR ITEM


JOB=                A list of jobs/sessions for which status information
                    is to be displayed.  Use one of the following
                    options

                    @J       Displays status information for all jobs.

                    @S       Displays status information for all
                             sessions.

                    @        Displays status information for all jobs
                             and sessions.  Default.

jsname,]username.acctname    The jsname is an optional name given to
                             the session or job by the user.  The
                             username parameter is the user name
                             established by the account manager.  This
                             name may consist of one to eight
                             alphanumeric characters beginning with an
                             alphabetic character. The acctname
                             parameter is the name of the account
                             established by the system manager.  This
                             name may consist of one to eight
                             alphanumeric characters beginning with an
                             alphabetic character. The @ can be used to
                             replace the jsname or username in a
                             specified account.

                             NOTE:

                             You can not use the @ option if the
                             jsname option has been specified.

INTRO, EXEC, SUSP or WAIT
                    Displays the status of all jobs or sessions in a
                    specified state.  INTRO means that the job is
                    introduced.  In this case, the spooler process
                    validates the JOB command and, if the job is
                    legitimate, copies the job input records to disk.
                    EXEC means that the job is executing.  SUSP means
                    that the job or session is suspended, because table
                    entries or system resources are unavailable.  WAIT
                    means that there are no available list devices for
                    the job. WAIT has the following subparameters

                    N        Displays the status of nondeferred READY
                             device files.

                    D        Displays the status of deferred READY
                             device files.

                    If information for only one device file is
                    displayed, output is in Type I format; if
                    information for more than one device file is
                    displayed, output is in Type I followed by Type II
                    format. (Format types are described under
                    "OPERATION".)


OPERATION


     This command enables you to determine the number of jobs and
     sessions in each processing state, the current jobfence and
     job/session limits, and allows you to keep track of
     individual spooled and streamed jobs that are entered in the
     system.  The output appears in two possible formats or in a
     combination of both formats

Type I

     JOBNUM  STATE IPRI  JIN  JLIST    INTRODUCED JOB NAME

     #S16     EXEC        45     45    MON  708A  TEST.PUBS

     JOBFENCE= 0; JLIMIT = 3; SLIMIT= 16

Type II

     7 JOBS
          0 INTRO
          0 WAIT; INCL 0 DEFERRED
          7 EXEC; INCL 7 SESSIONS
          0 SUSP
     JOBFENCE= 0; JLIMIT= 3; SLIMIT= 16

     If the SHOWJOB SCHED command is used, the output is
     displayed as shown below.  The STATE field shows that the
     job is scheduled.  The SCHEDULED-INTRO field shows the time
     and date the job will be introduced to the system.  Note
     that the scheduled jobs are listed in the order in which
     they will be introduced to the system.  If you enter only
     the SHOWJOB command, the formatted output for jobs and
     sessions in the INTRO, WAIT, and EXEC states will be
     displayed first in the Type I and Type II formats.  The
     formatted data for jobs in the SCHED state is displayed last
     and is in the Type III format.

Type III

     CURRENT  5/13/85  1600

     JOBNUM  STATE IPRI  JIN  JLIST  SCHEDULED-INTRO JOB NAME

     #J38    SCHED   3    10   6     5/16/84 1124   NOTHING,JON.OSE
     #J23    SCHED   8    10   PP    5/25/84  801   REPORT,MGR.OSE
     #J25    SCHED   8    10   LP    7/ 4/84 1805   FIREWORK,UNCLE.SAM

     3 JOBS (DISPLAYED)
     JOBFENCE=7; JLIMIT=2; SLIMIT=20

     If specified, the ;JOBQ option displays the queuenames into which
     each job belongs. Showjob output format will have a new field
     JOBQ. If the ;JOBQ option is not specified the SHOWJOB output will
     be the same as before.

     This command may be issued from a session, job, in BREAK, or
     from a Program.  Pressing [Break] aborts the execution of
     this command.


EXAMPLE(S)


     To determine the number of jobs and sessions in each
     processing state, the current jobfence and the job/session
     limits, enter

     SHOWJOB STATUS
     6 JOBS
     0 INTRO
     0 WAIT; INCL 0 DEFERRED
     6 EXEC; INCL 6 SESSIONS
     0 SUSP
     JOBFENCE= 0; JLIMIT= 3; SLIMIT= 16

     To get a report on all jobs and sessions in the system,
     enter

     SHOWJOB

     JOBNUM   STATE IPRI  JIN  JLIST    INTRODUCED JOB NAME
     #S745    EXEC         29  29       MON  253P DL,SPL.ALANG
     #S746    EXEC         26  26       MON  253P CLI.AOPSYS

     2 JOBS
           0 INTRO
           0 WAIT; INCL 0 DEFERRED
           2 EXEC; INCL 2 SESSIONS
           0 SUSP
     JOBFENCE= 2; JLIMIT= 1; SLIMIT= 16

     The following example of a SHOWJOB command sequence
     illustrates an override of the default characteristics of
     listfile with the FILE command, and shows the output
     produced with the new listfile characteristics

     FILE A;REC=40,1,F,ASCII;NOCCTL
     SHOWJOB;*A
     SAVE A
     FCOPY FROM=A;TO=

     HP32212A.3.21 FILE COPIER (C) HEWLETT-PACKARD CO. 1985

     MON, MAY 7, 1987,  754 AM

     JOBNUM STATE IPRI JIN  JLIST  INTRODUCED JOB NAME
     #S46   EXEC        20  20     MON  714A OPERATOR.SYS
     #S45   EXEC        47  47     MON  637A MAC.PUBS
     #S47   EXEC        10S LP     MON  726A SUPPORT.DOC
     #S48   EXEC       102  102    MON  728A MAC.TECH
     #J19   EXEC        28  28     MON  641A JON.OSE
     #S49   EXEC*       34  34     MON  731A FLASH.G
     #J21   EXEC        10S LP     MON  715A DELIVER,MAIL.MAIL
     #J22   EXEC        10S LP     MON  714A RSPOOLJ,RSPOOL.SYS

     8 JOBS (DISPLAYED)
           0 INTRO
           0 WAIT; INCL 0 DEFERRED
           8 EXEC; INCL 5 SESSIONS
           0 SUSP
     JOBFENCE= 6;   JLIMIT= 4;   SLIMIT= 50
     EOF FOUND IN FROMFILE AFTER RECORD 17

     18 RECORDS PROCESSED *** 0 ERRORS

     END OF SUBSYSTEM

     To display the job queue names, enter

     SHOWJOB;JOBQ

     JOBNUM  STATE IPRI JIN  JLIST JOBQ     INTRODUCED  JOB NAME

     #J3     EXEC        10S LP    HPSYSJQ  WED 11:46A  FTPMON,FTP.SYS
     #J7     EXEC         2  LP    SYSMGRQ  WED  5:47P  EMG,MGR.SYSMGR


     To display a particular job and job queue name, enter

     SHOWJOB #J7;JOBQ

     JOBNUM  STATE IPRI JIN  JLIST JOBQ     INTRODUCED  JOB NAME

     #J7     EXEC       10S  LP    SYSMGRQ  WED  5:47P  EMG,MGR.SYSMGR

     JOBFENCE= 7; JLIMIT= 10; SLIMIT= 60

     The SHOWJOB command reports a job or session as being in
     EXEC* when it is initializing.  After initialization is
     complete, the state will change to EXEC.  The number shown
     in the EXEC state is the sum of the jobs and sessions in
     both EXEC and EXEC*.

ADDITIONAL INFORMATION


Commands:   None

Manuals :   Performing System Operation Tasks (32650-90137)

Back to Main Index