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