HP 3000 Manuals

Display Job and Session Status With SHOWJOB [ Controlling System Activity ] MPE/iX 5.0 Documentation


Controlling System Activity

Display Job and Session Status With SHOWJOB 

In the SHOWJOB output, sessions are identified by numbers with the prefix
#S. Jobs are identified by numbers with the prefix #J. Session and job
numbers range from 1 to 16,383.

The SHOWJOB command reports status information in three different ways,
depending on the parameters used:

 *  Session or job information for a specific session or job includes job
    number, state, input priority, input device, output device number or
    class, time introduced, and job name.

 *  Status parameter information includes summary information about all
    the number of jobs and sessions in each status, the jobfence, and
    limits.

 *  Session or job information for several sessions or jobs includes the
    job number, state, input priority, input device, output device, time
    introduced, job name, and a summary of the number of jobs and
    sessions in each status, the jobfence (which specifies job priority),
    and limit (which specifies the maximum number of jobs that can run
    concurrently).

SHOWJOB, entered without parameters, displays all information for all
logged on jobs.  For example:

     SHOWJOB 

The system responds:
________________________________________________________________________
|                                                                      |
|                                                                      |
|      JOBNUM  STATE IPRI JIN  JLIST    INTRODUCED  JOB NAME           |
|                                                                      |
|      #S32    EXEC        20  20       SAT 12:02A  MANAGER.SYS        |
|      #J1     EXEC*       10S LP       SAT12:11A   BACKUP,MANAGER.SYS |
|                                                                      |
|          2 JOBS:                                                     |
|          0 INTRO                                                     |
|          0 WAIT; INCL 0 DEFERRED                                     |
|          2 EXEC; INCL 1 SESSIONS                                     |
|          0 SUSP                                                      |
|                                                                      |
|          JOBFENCE= 7; JLIMIT= 1; SLIMIT= 10                          |
|                                                                      |
|          CURRENT:  3/10/87  9:21                                     |
|                                                                      |
________________________________________________________________________

SHOWJOB, entered without parameters, displays all information for all
logged on sessions.  For example:

     SHOWJOB 

The system responds:
_____________________________________________________________________________
|                                                                           |
|                                                                           |
|      JOBNUM  STATE IPRI JIN  JLIST     SCHEDULED-INTRO   JOB NAME         |
|                                                                           |
|      #J42    SCHED    8  10S LP       3/10/87  17:30 MYWORK,MANAGER.S     |
|                                                                           |
|      #J35    SCHED    9  10S PP        3/11/87   5:00    OFFHOUR,MANAGER. |
|                                                                           |
|          2 SCHEDULED JOB(S)                                               |
|                                                                           |
_____________________________________________________________________________

Where:

JOBNUM              Identifies the job by the number MPE XL assigned to it.

STATE               Indicates processing state of job.

IPRI                Displays the input priority for jobs in the WAIT state.

JIN                 Lists the input device used by the job.

JLIST               Lists the output device used by the job.  The number listed is the
                    logical device number or device class of the terminal, tape drive,
                    or printer.

INTRODUCED          Tells the date and time the job was introduced.

JOB NAME            Displays the user name and account of the person who submitted the
                    job.  The job name can be chosen arbitrarily and is used primarily
                    as a convenient means for two users who are logged on to the same
                    user name and account to uniquely identify their jobs.

SCHEDULED-INTRO     Tells the date and time for which a job is scheduled.


NOTE In the SHOWJOB output, EXEC includes all executing and initialized jobs and sessions. EXEC* denotes an initializing job or session.
SHOWJOB Syntax [[#]Snnn ] [[#]Jnnn ] SHOWJOB [STATUS ] [;*listfile] [SCHED ] [item[;item[;...]]] Syntax for Item [{@J }] [{INTRO }] [{@S }] [{EXEC }] [{JOB= @ }] [{; SUSP }] [{[jsname,]username.acctname}] [{WAIT [,N]}] [{[,D] }] Table 3-2. SHOWJOB Parameters -------------------------------------------------------------------------------------------- | | | | Parameter | Description | | | | -------------------------------------------------------------------------------------------- | | | | [#]Snnn | The session number for which status information is to be displayed. | | | | -------------------------------------------------------------------------------------------- | | | | [#]Jnnn | The job number for which status information is to be displayed. | | | | -------------------------------------------------------------------------------------------- | | | | STATUS | Lists the number of jobs and sessions in each processing state, and | | | the current job and session limits. | | | | -------------------------------------------------------------------------------------------- | | | | *listfile | Formal designator of file on which output is written. The file is a | | | temporary file with a record size of 256 bytes, blocked one record | | | per block, with carriage control (CCTL), and displays the time and | | | date. The default characteristics can be overridden with a FILE | | | command. Default is $STDLIST. | | | | -------------------------------------------------------------------------------------------- | | | | SCHED | Restricts display to scheduled jobs only. | | | | -------------------------------------------------------------------------------------------- | | | | item | A list of jobs and/sessions whose status is displayed.Default is a | | | display of the status information for all jobs and/or sessions. The | | | descriptions are: | | | | | | | | | | | @J Displays status information for all jobs. | | | | | | @S Displays status information for sessions. | | | | | | @ Displays status information for all jobs and | | | sessions. Default. | | | | | | | | | | | [jsname,] jsname is an optional job or username session name | | | assigned by a user. username.acctname is the name the user is | | | assigned by the account manager; acctname is assigned by the system | | | manager. | | | | | | | | | | | [INTRO ] Job has been introduced and input to the spooler. | | | | | | | | | [EXEC ] Job is executing. | | | | | | [SUSP ] Job is suspended, pending availability of resources. | | | | | | | | | | | | | | [WAIT [,N] [,D]] Job is completed and waiting for availability of a | | | list device. N specifies a display of nondeferred device files and | | | D specifies a display of deferred device files, whose priorities are | | | equal to or less than the value of the system or device outfence. | | | | -------------------------------------------------------------------------------------------- Table 3-3. Examples of SHOWJOB -------------------------------------------------------------------------------------------- | | | | Command | Purpose | | | | -------------------------------------------------------------------------------------------- | | | | SHOWJOB EXEC | Displays the status of all executing sessions and | | | jobs. | | | | | | | | | | SHOWJOB SCHED | Displays the status of all scheduled jobs. | | | | | | | | | | SHOWJOB JOB=@S | Displays the status of all sessions. | | | | | | | | | | SHOWJOB S16 | Displays the status of session number S16. | | | | | | | | | | SHOWJOB STATUS | Displays summary information for all jobs/sessions. | | | | | | | | | | SHOWJOB JOB=@J;INTRO | Displays the status of all jobs in the INTRO state. | | | | | | | | | | SHOWJOB J16 | Displays the status of job number J16. | | | | | | | | | | SHOWJOB JOB=@.SANDY | Displays the information for all scheduled jobs in the | | | SANDY account. | | | | | | | -------------------------------------------------------------------------------------------- Limiting the Number Of Jobs and Sessions When initially, configuring the system, a system supervisor can set a limit to the number of jobs and sessions that can run at any time. Limiting the number of jobs and sessions helps you keep track of user activity, because less activity is easier to monitor. A system manager, system supervisor, or system operator can change the job or session limit to any number less than the configured maximum at any time. LIMIT Syntax [{numberjobs }] LIMIT [{,numbersessions }] [{numberjobs,numbersessions}] Table 3-4 describes LIMIT parameters. Table 3-4. LIMIT Parameters --------------------------------------------------------------------------------------------- | | | | Parameter | Description | | | | --------------------------------------------------------------------------------------------- | | | | numberjobs | The maximum number of jobs. | | | | --------------------------------------------------------------------------------------------- | | | | ,numbersessions | The maximum number of sessions. | | | | --------------------------------------------------------------------------------------------- To change the job or session limit, use the LIMIT command. For example, to change the job limit to 5, enter: LIMIT 5 To change the session limit to 15, enter LIMIT ,15 To change the job limit to 10 and the session limit to 25 at the same time, enter: LIMIT 10,25


MPE/iX 5.0 Documentation