SHOWJOB


SHOWJOB

     Displays the status information about jobs/sessions.  (CM)

SYNTAX


[[#]Snnn ]
[[#]Jnnn ]
SHOWJOB [STATUS ][;JOBQ][;*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". 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". 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". 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".

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.
FOR ITEM

JOBQ Displays the queuename to which each job belongs.


SYNTAX FOR ITEM


{@J }
{@S }
[JOB={@, }]
{[jsname,]username.acctname}

{INTRO }
{EXEC }
[;{SUSP }
{WAIT [,N] }
[,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.acctname The jsname is an optional 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.

NOTE:

You can not use the @ option if the
jsname option has been specified.

INTRO, EXEC, SUSP or WAIT
Displays the status of all jobs or sessions in a
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".)


OPERATION

     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 708A 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 will be
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 1124 NOTHING,JON.OSE
#J23 SCHED 8 10 PP 5/25/84 801 REPORT,MGR.OSE
#J25 SCHED 8 10 LP 7/ 4/84 1805 FIREWORK,UNCLE.SAM

3 JOBS (DISPLAYED)
JOBFENCE=7; JLIMIT=2; SLIMIT=20

If specified, the ;JOBQ option displays the queuenames into which
each job belongs. Showjob output format will have a new field
JOBQ. If the ;JOBQ option is not specified the SHOWJOB output will
be the same as before.

This command may be issued from a session, job, in BREAK, or
from a Program. Pressing [Break] aborts the execution of
this command.


EXAMPLE(S)

     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 253P DL,SPL.ALANG
#S746 EXEC 26 26 MON 253P 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.3.21 FILE COPIER (C) HEWLETT-PACKARD CO. 1985

MON, MAY 7, 1987, 754 AM

JOBNUM STATE IPRI JIN JLIST INTRODUCED JOB NAME
#S46 EXEC 20 20 MON 714A OPERATOR.SYS
#S45 EXEC 47 47 MON 637A MAC.PUBS
#S47 EXEC 10S LP MON 726A SUPPORT.DOC
#S48 EXEC 102 102 MON 728A MAC.TECH
#J19 EXEC 28 28 MON 641A JON.OSE
#S49 EXEC* 34 34 MON 731A FLASH.G
#J21 EXEC 10S LP MON 715A DELIVER,MAIL.MAIL
#J22 EXEC 10S LP MON 714A 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

To display the job queue names, enter

SHOWJOB;JOBQ

JOBNUM STATE IPRI JIN JLIST JOBQ INTRODUCED JOB NAME

#J3 EXEC 10S LP HPSYSJQ WED 11:46A FTPMON,FTP.SYS
#J7 EXEC 2 LP SYSMGRQ WED 5:47P EMG,MGR.SYSMGR


To display a particular job and job queue name, enter

SHOWJOB #J7;JOBQ

JOBNUM STATE IPRI JIN JLIST JOBQ INTRODUCED JOB NAME

#J7 EXEC 10S LP SYSMGRQ WED 5:47P EMG,MGR.SYSMGR

JOBFENCE= 7; JLIMIT= 10; SLIMIT= 60

The SHOWJOB command reports a job or session as being in
EXEC* when it is initializing. After initialization is
complete, the state will change to EXEC. The number shown
in the EXEC state is the sum of the jobs and sessions in
both EXEC and EXEC*.

ADDITIONAL INFORMATION

Commands:   None

Manuals : Performing System Operation Tasks (32650-90137)