HPlogo Commands Reference HP 3000 Series 9X8LX Computer Systems > Chapter 2 MPE/iX Commands

SHOWJOB

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

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



   SHOWJOB [[#]Snnn

            [#]Jnnn

            STATUS

            SCHED

            item[;item[;...]]] [;*listfile]

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



   [JOB={@J

         @S

         @

          [jsname,]username.acctname}]

   

   [;{INTRO

      EXEC

      SUSP

      WAIT [,N

            ,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. acctname

The jsname is an optional 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, or WAIT

Displays the status of all jobs or sessions in a 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
Feedback to webmaster