HP 3000 Manuals

SHOWJOB [ HP 3000 Series 9X8LX Computer Systems Commands Reference ] MPE/iX 5.0 Documentation


HP 3000 Series 9X8LX Computer Systems Commands Reference

SHOWJOB 

The SHOWJOB command displays the following information:

   *   number of jobs and sessions in each processing state
   *   current jobfence and job and session limits
   *   individual spooled and streamed jobs entered in the system

You can choose from three types of display formats. 

Syntax 

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

#Snnn                 Specifies the session number (assigned by the
                      system) of the session for which the status
                      information is to be displayed.  The information
                      appears as described under "Operation Notes." The
                      default is that the status information for all jobs
                      and sessions appears.

#Jnnn                 Specifies the job number (assigned by the system)
                      of the job for which status information is to be
                      displayed.  The information appears as described
                      under "Operation Notes." The default is that the
                      status information for all jobs and sessions
                      appears.

STATUS                Lists the number of jobs and sessions in each
                      processing state and the current jobfence and job
                      and session limits.  This information appears as
                      described under "Operation Notes." The default is
                      that the status information for all jobs and
                      sessions appears.

SCHED                 Displays only the scheduled jobs.  The information
                      appears as described under "Operation Notes."

item                  A list of jobs and sessions whose status is
                      displayed.  The default is that the status
                      information for all jobs and sessions is displayed.
                      The syntax for this parameter appears below.

Syntax for Item 

                                   [ {INTRO    }]
[    {@J                        }] [ {EXEC     }]
[JOB={@S                        }] [;{SUSP     }]
[    {@                         }] [ {WAIT [,N]}]
[    {[jsname,]username.acctname}] [ {     [,D]}]

Subparameters for Item 

JOB                   A list of jobs and 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.
                                            This is the default.

                      [jsname,] username.   The jsname is an optional
                      acctname              user-assigned name.

                                            The username is the user name
                                            that the account manager
                                            establishes.

                                            The acctname is the name of
                                            the account that the system
                                            administrator establishes.
                                            You can use @ to replace the
                                            jsname or username in a
                                            specified account.

INTRO, EXEC, SUSP,    Displays the status of all jobs or sessions in a
or WAIT               specified state.

                      The INTRO parameter means that the job or session
                      is being introduced.

                      The EXEC* parameter means that the job or session
                      is initializing.

                      The EXEC parameter means that the job or session is
                      executing.

                      The SUSP parameter means that the BREAKJOB command
                      has suspended the job or session.

                      The WAIT parameter means that no list devices are
                      available for the job.  The WAIT parameter has the
                      following subparameters:

                      N       Displays the status of nondeferred ready
                              device files.

                      D       Displays the status of deferred ready
                              device files.

*listfile             Specifies the formal file designator of the file on
                      which the output listing is written.  This
                      parameter requires a backreference to a file
                      equation.

                      The default characteristics of listfile are that it
                      is a temporary file, has a record size of 256
                      bytes, is blocked one record per block, has
                      carriage control (CCTL), and displays the date and
                      time.  You can override the default characteristics
                      by using the FILE command.

Operation Notes 

   *   Usage 

       You can enter this command from a session, a job, a program, or in
       break mode.  Pressing Break aborts the execution of this command.

   *   Output format 

       Output appears in one of three possible formats or a combination
       of two of the formats.

          *   If you enter SHOWJOB #Snnn or SHOWJOB #Jnnn, the following
              format appears:

                   JOBNUM  STATE IPRI  JIN  JLIST    INTRODUCED JOB NAME

                   #S16     EXEC         45    45     MON  7:08A TEST.JOB

                   JOBFENCE= 0; JLIMIT = 3; SLIMIT= 16

          *   If you enter SHOWJOB STATUS, the following format appears:

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

          *   If you enter SHOWJOB SCHED, the following format appears:

                   CURRENT:  5/13/85  1600

                   JOBNUM  STATE IPRI  JIN  JLIST  SCHEDULED-INTRO  JOB NAME

                   #J38    SCHED   3    10   6     5/16/91 11:24    PAPERS,JON.OSE
                   #J23    SCHED   8    10   PP    5/25/91  8:01    REPORT,MGR.OSE
                   #J25    SCHED   8    10   LP    7/12/91 18:05    TEXT,MGR.LPUE

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

              In the output shown above, the STATE field shows that the
              job is scheduled.  The SCHEDULED-INTRO field shows the time
              and date that the job is to be introduced to the system.
              Note that the scheduled jobs are listed in the order in
              which they are to 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 appear
       first, and the formatted data for jobs in the SCHED state appears
       last.

Examples 

   *   To display all jobs and sessions in the system, enter:

            :SHOWJOB 

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

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

   *   To determine the number of jobs and sessions in each processing
       state, the current jobfence, and the job and 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 override the default characteristics of listfile with the FILE
       command, and then show the output produced with the new listfile 
       characteristics, enter the following sequence of commands:

            :FILE A;REC=40,1,F,ASCII;NOCCTL 
            :SHOWJOB;*A 
            :SAVE A 
            :PRINT A 

       The output appears as shown:
__________________________________________________________________
|                                                                |
|     HP32212A.03.30 FILE COPIER (C) HEWLETT-PACKARD CO. 1990    |
|                                                                |
|     MON, AUG 5, 1991,  7:54 AM                                 |
|                                                                |
|     JOBNUM STATE IPRI JIN  JLIST  INTRODUCED JOB NAME          |
|     #S46   EXEC        20  20     MON  7:14A OPERATOR.SYS      |
|     #S45   EXEC        47  47     MON  6:37A USER.PUBS         |
|     #S47   EXEC        10S LP     MON  7:26A SUPPORT.DOC       |
|     #S48   EXEC       102  102    MON  7:28A USER.TECH         |
|     #J19   EXEC        28  28     MON  6:41A JON.OSE           |
|     #S49   EXEC*       34  34     MON  7:31A TEXT.LPUE         |
|     #J21   EXEC        10S LP     MON  7:15A DELIVER,MAIL.MAIL |
|     #J22   EXEC        10S LP     MON  7:14A 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                                           |
|     :                                                          |
__________________________________________________________________

            

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

Related Commands 

     ABORTJOB
     ALTJOB
     BREAKJOB
     JOBFENCE
     LIMIT
     RESUMEJOB
     SHOWPROC



MPE/iX 5.0 Documentation