HPlogo MPE/iX Commands Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 7 Command Definitions S-SO

SHOWJOB

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

Displays status information about jobs/sessions.

Syntax

SHOWJOB [ [#]Snnn [#]Jnnn STATUS SCHED item [;item [;...]] ] [;*listfile]

[;JOBQ]

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.

JOBQ

Which will indicate the queue name to which the job belongs. A new field JOBQ is added into the showjob output format.

Syntax for Item

[JOB={ @J | @S | @ [ @,] username.acctname [ 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.

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 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 command jobq will indicate the queue name to which the job belongs.The output appears in the following 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

:SHOWJOB;jobq

JOBNUM STATE IPRI JLIST JOBQ INTRODUCED JOB NAME #J3 EXEC LP HPSYSJQ WED 11:46A FTPMON,FTP.SYS #J7 EXEC LP SYSMGRQ WED 5:47P EMG,MGR.SYSMGR #S81 EXEC 34 THU 12:17P MGR.GOPI

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

Feedback to webmaster