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