Operating System BS2000 OS DX V1.0 (en)

&pagelevel(5)&pagelevel

This statement displays information on a subset of the job descriptions in the currently open job pool file.

The jobs are selected by means of the JOB-IDENTIFICATION operand on the basis of job attributes. You can set the number of attributes displayed by means of the INFORMATION operand. The output destination is set by means of the OUTPUT operand.

Format

SHOW-JOBPOOL-STATUS

JOB-IDENTIFICATION = ALL / NONE / TSN(...) / JOB-STATE (...) / *USER-IDENTIFICATION(...) /
				JOB-CLASS(...) / JOB-NAME(...) / *PUBSET-OF-SYSCMD-FILE(...)
	*TSN(...)
		\|	TSN = <alphanum-name 1..4>
	*JOB-STATE(...)
		\|	JOB-STATE = EXECUTING / WAITING / DORMANT / REPEAT / *CALENDAR
	*USER-IDENTIFICATION(...)
		\|	USER-IDENTIFICATION = <alphanum-name 1..8>
	*JOB-CLASS(...)
		\|	JOB-CLASS = <alphanum-name 1..8>
	*JOB-NAME(...)
		\|	JOB-NAME = <alphanum-name 1..8>
	*PUBSET-OF-SYSCMD-FILE(...)
		\|	PUBSET-OF-SYSCMD-FILE = <alphanum-name 1..4>
,INFORMATION = SUMMARY / JOB-LIST / *FULL
,OUTPUT = list-poss(2): SYSOUT / SYSLST

Operands

JOB-IDENTIFICATION = *ALL / *NONE / *TSN(...) / *JOB-STATE (...) / *USER-IDENTIFICATION(...) /
*JOB-CLASS(...) / *JOB-NAME(...) / *PUBSET-OF-SYSCMD-FILE(...)
Selects the jobs about which information is to be output on the basis of the specified parameters.

JOB-IDENTIFICATION = *ALL
Selects all the jobs in the job pool.

JOB-IDENTIFICATION = *NONE
If INFORMATION = *SUMMARY is selected, information on the current job pool file is displayed. Otherwise, there is no output.

JOB-IDENTIFICATION = *TSN(...)
Selects the job by means of the TSN.

TSN = <alphanum-name 1..4>
TSN of the job to be selected.

JOB-IDENTIFICATION = *JOB-STATE(...)
Selects the jobs on the basis of the state or type of the jobs from the viewpoint of JMS.

JOB-STATE = *EXECUTING
Selects all the active jobs for which there was already a task in the system.

JOB-STATE = *WAITING
Selects all the jobs that are waiting for their system startup under the control of a job stream.

Waiting repeat job repetitions with a repetition count > 0 are not selected.

JOB-STATE = *DORMANT
Selects all the jobs with an inactive job stream or inactive repeat job repetitions.

JOB-STATE = *REPEAT
Selects all repeat jobs.

JOB-STATE = *CALENDAR
Selects all calendar jobs.

USER-IDENTIFICATION = *USER-IDENTIFICATION(...)
Selects all jobs to run under the specified user ID.

USER-IDENTIFICATION = <alphanum-name 1..8>
User ID under which the selected jobs are to run.

JOB-IDENTIFICATION = *JOB-CLASS(...)
Selects all jobs that belong to the specified job class.

JOB-CLASS = <alphanum-name 1..8>
Job class of the jobs that are to be selected.

JOB-IDENTIFICATION = *JOB-NAME(...)
Selects all jobs with the specified job name.

JOB-NAME = *NONE / <alphanum-name 1..8>
Name of the jobs to be selected. If *NONE is specified, jobs without a name are selected.

JOB-IDENTIFICATION = *PUBSET-OF-SYSCMD-FILE(...)
Selects all jobs whose command file is on the specified pubset.

PUBSET-OF-SYSCMD-FILE = <alphanum-name 1..4>
ID of the pubset containing the command file of the selected jobs.

INFORMATION = *SUMMARY / *JOB-LIST / *FULL
Specifies the amount of information to be output on the selected jobs.

INFORMATION = *SUMMARY
Limits the information that is output to the name and version of the current job pool file and the number of selected jobs.
If JOB-INFORMATION = *NONE is selected, the number of jobs is not specified (see example 1).

INFORMATION = *JOB-LIST
Displays a header line, a line with 9 attributes for each selected job and a line that summarizes the number of these jobs (see example 2).

INFORMATION = *FULL
Displays the most important job attributes for each selected job in up to 12 output lines. The output is concluded with a line with the number of jobs (see example 3).

OUTPUT = list-poss(2): *SYSOUT / *SYSLST
Defines the output destination.

OUTPUT = *SYSOUT
Output is to be to SYSOUT.

OUTPUT = *SYSLST
Output is to be to SYSLST.

Example 1

%//show-jobpool-status *none,*summary
JOBPOOL :  :2OS6:$YLA.SYSTEM.JOBPOOL.V160
VERSION :  OSD V3.0 OR HIGHER

The JOBPOOL file shown can be used by OSD versions >= V3.0.

Example 2

%//show-jobpool-status *job-class(jcjs2xsb),*job-list 
TSN  JNAME    USER     JCLASS   CAT   TYPE  START        REPEAT LTSN
0AVX          TSOS     JCJS2XSB G     2     SOON
0AVZ          TSOS     JCJS2XSB G     1 WT  A040809.2300 
0AV0          TSOS     JCJS2XSB G     1 WT  E041010.2222 
0AV2          TSOS     JCJS2XSB G     2     W0345 
0AV3          TSOS     JCJS2XSB G     1 WT  A000809.1200 CALNDR
0AV4          TSOS     JCJS2XSB G     1 DO  STUP         STUP 
0AV6 R1       TSOS     JCJS2XSB G     1 DO  A040810.1400 DAILY  0AV5 
0AV5 R1       TSOS     JCJS2XSB G     1 WT  A040809.1400 DAILY 
0AV8          TSOS     JCJS2XSB G     1 DO  SOON         0234   0AV7 
0AV7          TSOS     JCJS2XSB G     2     SOON         0234 
0AWB          TSOS     JCJS2XSB G     1 WT  A000809.1600 CALNDR
            11 JOB(S) DISPLAYED

Explanations

The JOBPOOL file shown contains 11 job descriptions in the JCJS2XSB job class. The job attributes are output after a header linen:

`TSN:`	The jobs are output in the order in which they appear in the job pool file. The TSNs are therefore generally not sorted.
`JNAME:`	Job name
`USER:`	User ID
`JCLASS:`	Job class
`CAT:`	Catalog ID of the pubset containing the command file.
`TYPE:`	`1 WT:`	The job waits to be started in the job stream. This corresponds to the selection criterion JOB-STATE=*INACTIVE.
	`1 DO:`	waiting repeat job successor (*DORMANT).
	`1 HO:`	The stop was suspended with HOLD-JOB.
	`1 HOC:`	The job is in resource HOLD because the calendar file could not be accessed at scheduling.
	`2 :`	The job is active (*ACTIVE).
`START:`	The START attribute in the following formats:
	`SOON`
	`IMME`	IMMEDIATELY
	`STUP`	AT-STREAM-STARTUP
	`Whhmm`	WITHIN(HOURS=hh,MINUTES=mm)
	`Ayymmdd.hhmm`	AT(DATE=yyyy-mm-dd,TIME=hh:mm)
	`Eyymmdd.hhmm`	EARLIEST( .. see AT .. )
	`Lyymmdd.hhmm`	LATEST( .. see AT .. )
`REPEAT:`	The REPEAT attribute in the following formats:
	`DAILY, WEEKLY`
	`STUP`	AT-STREAM-STARTUP
	`hhmm`	PERIOD(HOURS=hh,MINUTES=mm)
	`CALENDR`	The job is a calendar job.
`LTSN:`	Only for repeat job repetitions whose predecessor was also in the job pool: TSN of the predecessor (“last” TSN).

If the job pool file in question was created with MOVE-JOBS, only the version (of the maximum of two versions) with the highest count was accepted for repeat jobs (the NEXT image in the type 1 DO). It contains the entire repeat information. In this case, there are generally no jobs with the TSN <LTSN>.
In the case of IMPORT or a warm start, the NEXT image is changed back into its predecessor, which is then given the TSN <LTSN> (if it is still available).
Information cannot be obtained on repeat jobs that are made available by /SHOW-JOB-STATUS. In particular, the link from the predecessor to the successor repeat job, which is reflected in the START and NTSN output parameters, cannot be obtained in the job pool file. The link is only possible from the successor repeat job to the predecessor repeat job via its TSN (LTSN output parameter).

Example 3

%//show-jobpool-status *t(0avx),*full 
 TSN:     0AVX 
 JOBNAME:            TYPE:    2     USER-ENTER                           1.
 USERID:  TSOS       ACCNB:   ADMINSTR   JCLASS:  JCJS2XSB 
 PRI:     8 230      CPU-MAX: 200        START:   SOON 
 RERUN:   NO         FLUSH:   NO         SPOOLIN: <date>.<time> 
 CREATOR: TSOS       PROTECT: *NONE      LOGON:   <date>.<time>          2.
 ORIGFILE::G:$TSOS.OS232.E 
 CMD-FILE:*SAME 
          1 JOB(S) DISPLAYED 
//show-jobpool-status *t(0awb),*full 
 TSN:     0AWB
 JOBNAME:            TYPE:    1 WT  USER-ENTER 
 USERID:  TSOS       ACCNB:   ADMINSTR   JCLASS:  JCJS2XSB 
 PRI:     8 230      CPU-MAX: 200        START:    A<date>.<time> 
 RERUN:   NO         FLUSH:   NO         SPOOLIN:  <date>.<time> 
 CREATOR: TSOS       PROTECT: *NONE      LOGON: 
 REPEAT:  CALENDAR   COUNT:   0          LIMIT:   *STD                    3.
 SYMDAT:  SYM.16.00 
 CAL-NAME::G:$TSOS.ULTIMATIVER.CALENDAR 
 ORIGFILE::G:$TSOS.S.199.0AV7.E 
 CMD-FILE::G:$TSOS.S.E.0AV7.<date>.<time> 
 MONJV:   :G:$TSOS.JV 
          1 JOB(S) DISPLAYED
//show-jobpool-status *t(0av6),*full 
 TSN:     0AV6 
 JOBNAME:            TYPE:    1 DO  USER-ENTER 
 USERID:  TSOS       ACCNB:   ADMINSTR   JCLASS:  JCJS2XSB 
 PRI:     8 230      CPU-MAX: 200        START:   A<date>.<time> 
 RERUN:   NO         FLUSH:   NO         SPOOLIN:  <date>.<time> 
 CREATOR: TSOS       PROTECT: *NONE      LOGON: 
 REPEAT:  DAILY      COUNT:   1          LTSN:    0AV5                    4.
 RTIME:   <date>.<time> 
 ORIGFILE::G:$TSOS.OS232.E 
 CMD-FILE::G:$TSOS.S.E.0AV2.<date>.<time> 
          1 JOB(S) DISPLAYED

Explanations

Most of the attributes output are based on the output of /SHOW-JOB-STATUS but differ in their arrangement. The essential differences are as follows:

`1.`	After the `TYPE` output as shown in example 2, the origin of the job is specified:
	`USER-ENTER:`	Created with ENTER-JOB or ENTER-PROCEDURE by a user task. You can recognize ENTER-PROCEDURE from the name of the CMD-FILE: S.E.<tsn>.<yyyy-mm-dd>.<hh.mm.ss>.
	`PRIVILEGED-ENTER:`	Created by the system with a privileged ENTER (e.g. the job scheduler tasks).
	`CONSOLE-ENTER:`	Created by a user task with OPERATING privilege using the DEFAULT-FROM-FILE = *YES operand or from a console.
`2.`	`CREATOR:`	The ID under which the creating task ran.The job can also be managed from this ID.
`2.`	`PROTECT:`	`CANCEL` : The job was started with the ENTER operand PROTECTION=CANCEL. `NONE` : The job was started with the ENTER operand PROTECTION=NONE.
`3.`	`REPEAT:`	Calendar jobs are displayed here in addition to the original repeat attributes.
`3.`	`LIMIT:`	Only output with calendar jobs. Has the same meaning as SHOW-JOB-STATUS.
`4.`	`LTSN:`	Refers in repeat jobs to the predecessor (see example 2)

Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly

SHOW-JOBPOOL-STATUS - Output information on the job pool

Format

Operands

Example 1

Example 2

Example 3