HP 3000 Manuals HP 3000 Manuals
SHOWJOB
Displays status information about jobs/sessions.
Syntax
[[#]Snnn ]
[[#]Jnnn ]
SHOWJOB [STATUS ] [;*listfile]
[SCHED ]
[item[;item[;...]]]
Parameters
#Snnn The session number (assigned by MPE/iX) of the
session for which the status information is to be
displayed. The information appears in Type I
format, described under "Operation Notes." Default
is that the status information for all
jobs/sessions is displayed.
#Jnnn The job number (assigned by MPE/iX) of the job for
which status information is to be displayed. The
information is in Type I format, described under
"Operation Notes." Default is that the status
information for all jobs/sessions is displayed.
STATUS Lists the number of jobs and sessions in each
processing state and the current jobfence and
job/session limits. This information is in Type II
format, described under "Operation Notes." Default
is that the status information for all job/sessions
is displayed.
SCHED Displays only the scheduled jobs. The information
is in Type III format, described under "Operation
Notes."
item A list of jobs/sessions whose status is displayed.
Default is that the status information for all
jobs/sessions is displayed. The syntax appears
below.
*listfile Formal file designator of the file on which the
output listing is written. A backreference to a
FILE equation is required. The listfile is a
temporary file with record size of 256 bytes,
blocked one record per block, with carriage-control
(CCTL), with the time and date displayed. You can
override the default characteristics of listfile
with the FILE command. Default is $STDLIST.
Syntax for Item
[ {@J }] [ {INTRO }]
[ {@S }] [ {EXEC }]
[JOB={@ }] [;{SUSP }]
[ {[@,]username.acctname }] [ {WAIT [,N]}]
[ {[jsname,]username.acctname}] [ { [,D]}]
Parameters for Item
JOB= A list of jobs/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.
Default.
[jsname,] username. The jsname is an optional
acctname name given to the session or
job by the user. The
username parameter is the
user name established by the
account manager. This name
may consist of one to eight
alphanumeric characters
beginning with an alphabetic
character. The acctname
parameter is the name of the
account established by the
system manager. This name
may consist of one to eight
alphanumeric characters
beginning with an alphabetic
character. The @ can be used
to replace the jsname or
username in a specified
account.
INTRO, EXEC, SUSP or Displays the status of all jobs or sessions in a
WAIT specified state. INTRO means that the job is
introduced. In this case, the spooler process
validates the JOB command and, if the job is
legitimate, copies the job input records to disk.
EXEC means that the job is executing. SUSP means
that the job or session is suspended, because table
entries or system resources are unavailable. WAIT
means that there are no available list devices for
the job. WAIT has the following subparameters:
N Displays the status of
nondeferred READY device
files.
D Displays the status of
deferred READY device files.
If information for only one device file is displayed, output is in Type I
format; if information for more than one device file is displayed, output
is in Type I followed by Type II format. (Format types are described
under "Operation Notes.")
Operation Notes
This command enables you to determine the number of jobs and sessions in
each processing state, the current jobfence and job/session limits, and
allows you to keep track of individual spooled and streamed jobs that are
entered in the system. The output appears in two possible formats or in
a combination of both formats:
Type I:
JOBNUM STATE IPRI JIN JLIST INTRODUCED JOB NAME
#S16 EXEC 45 45 MON 7:08A TEST.PUBS
JOBFENCE= 0; JLIMIT = 3; SLIMIT= 16
Type II:
7 JOBS:
0 INTRO
0 WAIT; INCL 0 DEFERRED
7 EXEC; INCL 7 SESSIONS
0 SUSP
JOBFENCE= 0; JLIMIT= 3; SLIMIT= 16
If the SHOWJOB SCHED command is used, the output is displayed as shown
below. The STATE field shows that the job is scheduled. The
SCHEDULED-INTRO field shows the time and date the job will be introduced
to the system. Note that the scheduled jobs are listed in the order in
which they will 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 is displayed first in the Type I and Type II
formats. The formatted data for jobs in the SCHED state is displayed
last and is in the Type III format.
Type III:
CURRENT: 5/13/85 1600
JOBNUM STATE IPRI JIN JLIST SCHEDULED-INTRO JOB NAME
#J38 SCHED 3 10 6 5/16/84 11:24 NOTHING,JON.OSE
#J23 SCHED 8 10 PP 5/25/84 8:01 REPORT,MGR.OSE
#J25 SCHED 8 10 LP 7/ 4/84 18:05 FIREWORK,MR.SAM
3 JOBS (DISPLAYED)
JOBFENCE=7; JLIMIT=2; SLIMIT=20
Use
This command may be issued from a session, job, program, or in BREAK.
Pressing Break aborts the execution of this command.
Examples
To determine the number of jobs and sessions in each processing state,
the current jobfence and the job/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 get a report on 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
The following example of a SHOWJOB command sequence illustrates an
override of the default characteristics of listfile with the FILE
command, and shows the output produced with the new listfile
characteristics:
FILE A;REC=40,1,F,ASCII;NOCCTL
SHOWJOB;*A
SAVE A
FCOPY FROM=A;TO=
HP32212A.03.26 FILE COPIER (C) HEWLETT-PACKARD CO. 1984
MON, MAY 7, 1987, 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 FLASH.G
#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
:
The SHOWJOB command reports a job or session as being in EXEC* when it is
initializing. After initialization is complete, the state changes to
EXEC. The number shown in the EXEC state is the sum of the jobs and
sessions in both EXEC and EXEC*.
Related Information
Commands ABORTJOB, BREAKJOB
Manuals Performing System Operation Tasks (32650-90137)