Operating System BS2000 OS DX V1.0 (en)

&pagelevel(3)&pagelevel

Output system status information

Component:	STATUS
Functional area:	Job processing
Domain:	JOB
Privileges:	all privileges
Routing code:	E

Function

The SHOW-SYSTEM-STATUS command provides information on the processing status in the system. The following information can be requested (by specifying the appropriate value in the INFORMATION operand):

*SUMMARY (default):
Actual number of jobs, according to job type.
*SYSTEM-PARAMETERS:
Maximum permitted number of resident main memory pages
*CATEGORY:
Maximum number and actual number of active jobs, according to category (system, interactive, batch, transaction jobs).
*REMOTE:
Information on RSO printers, e.g. name, status display, station and processor name, user ID and TSN of jobs.
*SATURATION-QUEUE (privileged):
Information on saturation queues, such as the hold queue for a paging device, prereservation of paging areas and main memory.
*WHEN-QUEUE (privileged):
Information on jobs in the WHEN queue, such as TSN, user ID, time of entry in the queue and maximum dwell time.
*REPLAY-QUEUE (privileged):
Information on jobs in the REPLAY queue, such as TSN, user ID, volume ID, form, output device.
*JOB-CLASS:
Information on job classes, such as name, maximum number of jobs, weight, status, name of responsible job stream.

*JOB-STREAM (privileged):
Information on job streams, such as name, status, number of waiting jobs, start time and stop time.

The command supports structured output in S variables (see "Output in S variables").

Privileged functions

System support staff are shown all the available information on the processing status in the system. Among other things they can request information relating to the saturation, WHEN and REPLAY queues and to job streams.

Format

SHOW-SYSTEM-STATUS

Alias: SHSS

INFORMATION = SUMMARY (...) / SYSTEM-PARAMETERS / CATEGORY / REMOTE(...) /
SATURATION-QUEUE(...) / WHEN-QUEUE(...) / *REPLAY-QUEUE(...) /
JOB-CLASS(...) / JOB-STREAM(...)
	*SUMMARY(...)
		\|	SELECT = ALL / JOBS / SPOOLOUT / REMOTE-SPOOLOUT
		\|	,USER-IDENTIFICATION = STD / ALL / <name 1..8> / *OWN
	*REMOTE(...)
		\|	DEVICE = MANAGED-DEVICES / ALL / <alphanum-name 1..8 with-wild>
	*SATURATION-QUEUE(...)
		\|	OUTPUT-INFORMATION = USER-IDENTIFICATION / NAME / *NONE
	*WHEN-QUEUE(...)
		\|	OUTPUT-INFORMATION = *USER-IDENTIFICATION / *NAME / *NONE
	*REPLAY-QUEUE(...)
		\|	OUTPUT-INFORMATION = USER-IDENTIFICATION / NAME / *NONE
	*JOB-CLASS(...)
		\|	STATE = ALL / ACT / INACT / HOLD / *DEL
	*JOB-STREAM(...)
		\|	STATE = ALL / ACT / INACT / HOLD

Operands

INFORMATION =
Type of information to be output:
number of jobs / system utilization / categories / saturation, WHEN and REPLAY queues / job classes / job streams.

INFORMATION = *SUMMARY(...)
Outputs the actual number of jobs, according to job type (job types T4 through T8 are only included if SPOOL is loaded).

Job type		Meaning
T1		Waiting batch jobs
	(DO)	Dormant: the responsible job scheduler is not yet active; or job run J(i) (where i >= 1) of a repeat job.
	(WT)	Waiting: the job is waiting to be started by the system.
	(HO)	HELD-BY-COMMAND: Job was paused with HOLD-JOB; also displayed if one of the wait statuses HOP, HOT or HOC is in effect due to a lack of resources
	(HOP)	HELD-BY-PUBSET: job waiting for pubset import
	(HOT)	HELD-BY-TSN: job waiting for TSN release
	(HOC)	HELD-BY-CALENDAR: job waiting for import of the pubset that contains the calendar file
T2		Batch jobs in progress
T3		Interactive jobs in progress
T4		Spoolout jobs waiting for:
	(PR)	printer
	(TP)	tape
T5		Spoolout jobs in progress, in state:
	(AC)	active
	(KP)	suspended; on explicit request from the operator, these jobs are returned to the job queue (T4).
T7		RSO spoolout jobs in state:
	(WT)	waiting
	(AC)	active
	(KP)	suspended
T8		RSO devices

SELECT =
Job types on which information is required.

SELECT = *ALL
Outputs all job types (T1 through T8); T1 and T7 are output without status information.

SELECT = *JOBS
Outputs job types T1 through T3.

SELECT = *SPOOLOUT
Outputs job types T4 through T8.

SELECT = *REMOTE-SPOOLOUT
Outputs job types T7 and T8.

USER-IDENTIFICATION = *STD / *ALL / <name 1..8> / *OWN
Specifies the user ID of the jobs for which information is to be output. By default, all user IDs are included.
Nonprivileged users are only provided with information relating to jobs running under their own user ID.

USER-IDENTIFICATION = <name 1..8>
Only the jobs of the user ID specified here are to be included in the overview.

USER-IDENTIFICATION = *OWN
Only the user’s own jobs are included. The output also includes information about devices managed by the user. USER-IDENTIFICATION=*OWN is not allowed at consoles.

INFORMATION = *SYSTEM-PARAMETERS
Outputs the maximum permitted number of resident main memory pages under “CORE”.

INFORMATION = *CATEGORY
Outputs the maximum permitted and the actual number of active jobs, according to category.
The following table lists the output fields and their meaning:

Field	Meaning / contents
CATEGORY NAME	Name of the category, e.g.: SYS: System jobs DIALOG:Interactive jobs BATCH: Batch jobs TP: Transaction jobs
MINMPL	Minimum number of active jobs.
MAXMPL	Maximum permitted number of active jobs.
WEIGHT	Value for calculating the index for this category. This determines the activation sequence.
#EXISTING	Number of existing jobs.
#ACTIVE	Number of active jobs.
#READY INACT	Number of inactive jobs that are ready for activation.
#RDY NOT ADMITTED	Number of inactive jobs that are ready to run but that are not permitted in this category (this column is only relevant if the software product PCS is used).
IO-PRIO	I/O priority of the category

INFORMATION = *REMOTE(...)

DEVICE = *MANAGED-DEVICES / *ALL / <alphanum-name 1..8 with-wild>
Specifies the device name of an RSO printer about which information is required. The device name can also be specified using wildcards. The default value *MANAGED-DEVICES supplies information about all printers for which the user is defined as device manager.

Field	Meaning / contents
DEVICE	Name of printer
A	Status display for RSO printers: “A”: printer attached but not active “D”: no virtual connection (detached) “I”: no spoolout jobs available “M”: a message is outstanding at the console for this device “R”: output of a spoolout job “S”: printer stopped due to error “W”: 9025 or 9645 printer currently inaccessible, since it is being used by the SPSERVE program
STA/PORT	Station name of an RSO printer which is not connected to TACLAN, or port name of an RSO printer on TACLAN.
PROC/ INTERNET@	Name of processor if the relevant RSO printer is not connected to TACLAN, or Internet address if the printer is on TACLAN. Note: If the Internet address is more than 16 bytes long, the first 15 bytes are displayed, followed by an asterisk.
USERID	For privileged users only: User ID of the RSO job.
TSN	For privileged users only: TSN of the spoolout job to be output.
ERCOD	Return information from DCAM or printer.
ERMSG	Message number of error (HELP-MSG-INF).
E	For privileged users only: Exit routine activated, “Y” or “N”.
CTRL TSK	TSN of the RSO control task for the device. Output only if a device name has been specified.

INFORMATION = *SATURATION-QUEUE(...)
Only privileged users are allowed to select this value.
Outputs information on the saturation queue.
The information specified in the OUTPUT-INFORMATION operand is output for each queue. If a queue does not contain any tasks, NO TASK ON QUEUE is output for the queue involved.

PD HOLD :	Hold queue for a paging device
PD PRERESERVE :	Queue for prereservation of a paging area
CORE PRERESERVE :	Queue for prereservation of main memory

OUTPUT-INFORMATION = *USER-IDENTIFICATION / *NAME / *NONE
Specifies whether the name or user ID of the jobs in the saturation queue is to be output in addition to the TSN.

OUTPUT-INFORMATION = *USER-IDENTIFICATION
Outputs the user ID.

OUTPUT-INFORMATION = *NAME
Outputs the job name, as specified in the SET-LOGON-PARAMETERS or PRINT-DOCUMENT command.

INFORMATION = *WHEN-QUEUE(...)
Only privileged users are allowed to select this value. Outputs information on the WHEN queue.
If the queue is empty, message EXC0354 is output.

Field	Meaning / contents
TSN	TSN of the jobs waiting for a condition to become true.
NAME	User ID, job name or blanks, depending on the specification made in the OUTPUT-INFORMATION operand.
IN QUEUE SINCE	Date and time at which the job was entered in the WHEN queue
MINLIMIT	Maximum number of minutes the job may remain in the queue or SHUTDWN.

OUTPUT-INFORMATION = *USER-IDENTIFICATION / *NAME / *NONE
Specifies whether the name or user ID of the jobs in the WHEN queue is to be output in addition to the TSN.

OUTPUT-INFORMATION = *USER-IDENTIFICATION
Outputs the user ID.

OUTPUT-INFORMATION = *NAME
Outputs the job name, as specified in the SET-LOGON-PARAMETERS or PRINT-DOCUMENT command.

INFORMATION = *REPLAY-QUEUE(...)
Only privileged users are allowed to select this value.
Outputs information on the REPLAY queue.
If the queue is empty, the message “NO TASK ON REPLAY QUEUE” is output.

Field	Meaning / contents
NAME	User ID, job name or blanks, depending on the specification made in the OUTPUT-INFORMATION operand.
TSN	Task serial number.
SESSID	VSN of the first replay tape.
CLASS	Spoolout class according to entry in user catalog.
FORM	Form name.
DIA	Form overlay name.
SIZE	Size of original file written to tape, specified in PAM blocks.
DEV	The desired output device: SD: Printer with loadable VFB (3341, 3342, 3343) SD7: Printer with loadable VFB(3337, 3338, 3339, 3348, 3349, 3365, 9xxx) NSD: Printer with loadable VFB or ND Laser Printer HP: HP/SD/SD7 Printer or devices which are no longer supported NHS: HP Laser Printer or printer with loadable VFB NHP: HP Laser Printer or devices which are no longer supported HSD: HP/SD/SD7 Printer

OUTPUT-INFORMATION = *USER-IDENTIFICATION / *NAME / *NONE
Specifies whether the name or user ID of the jobs in the REPLAY queue is to be output in addition to the TSN.

OUTPUT-INFORMATION = *USER-IDENTIFICATION
Outputs the user ID.

OUTPUT-INFORMATION = *NAME
Outputs the job name, as specified in the SET-LOGON-PARAMETERS or PRINT-DOCUMENT command.

INFORMATION = *JOB-CLASS(...)
Outputs information on job classes.
The following table lists the output fields and their meaning:

Field	Meaning / contents
JCLASS	Name of job class.
CLIM	Maximum number of jobs that can run at the same time in the job class; further batch jobs are not started and they wait in type 1.
OPTM	Optimum number of jobs that should run at the same time in the job class.
W	Weight (urgency) of the job class.
STATE	State of the job class (ACT/INACT/HOLD/DEL) ACT: Job class active HOLD: Job class in the “hold” state; waiting jobs are no longer started and new jobs are placed in the queue (T1). INACT: The relevant job scheduler is inactive; waiting jobs are not started and new jobs are placed in the queue (T1). DEL: Job class is in the in “delete” state.
JSTREAM	Name of the responsible job scheduler (job stream).
The following outputs DORM, ANCD, WAIT, STRT, and HOLD apply to the relevant job class.
DORM	Number of jobs waiting because the responsible job scheduler is not yet active; or ith job run of a repeat job (i >= 1) that has not yet been started.
ANCD	Number of jobs administered by the job scheduler.
WAIT	Number of jobs waiting to be started.
STRT	Number of started jobs.
HOLD	Number of suspended jobs

STATE =
Selects the job classes according to their state.

STATE = *ALL
Outputs information on all job classes.

STATE = *ACT
Outputs information on active job classes.

STATE = *INACT
Outputs information on inactive job classes.

STATE = *HOLD
Outputs information on job classes in the “hold” state.

STATE = *DEL
Outputs information on job classes in the “in delete” state.

INFORMATION = *JOB-STREAM(...)
Only privileged users are allowed to select this value.
Outputs information on job streams.
If a user job was started with the REPEAT option, this is displayed in the “DORM” column.
The relevant job scheduler is active. The following table lists the output fields and their meaning:

Field

Meaning / contents

JSTREAM

Name of the job stream.

STATE

State of the job stream (ACT/INACT/HOLD)

The following outputs apply to the relevant job stream:

DORM

Number of jobs waiting because the responsible job scheduler is not yet active.

ANCD

Total number of existing jobs.

WAIT

Number of waiting jobs.

STRT

Number of started jobs

HOLD

Number of suspended jobs.

START

Start time of the job stream:

ATSHUTD	during system initialization
BYOPER	started by the operator or system administration using the STARTJOB-STREAM command
hh:mm	at a specified time (JMU statement DEFINE-JOB-STREAM)

STOP

Time at which the job stream is terminated:

ATSHUTD	during system shutdown
BYOPER	terminated by the operator or system administration using the STOPJOB-STREAM command
hh:mm	at a specified time (JMU statement DEFINE-JOB-STREAM)

LIFETIME

In conjunction with the contents of the STOP column, this means that the job stream is terminated once the specified time has elapsed.

STATE =
Selects the job stream according to its state.

STATE = *ALL
Outputs information on all job streams.

STATE = *ACT
Outputs information on active job streams.

STATE = *INACT
Outputs information on inactive job streams.

STATE = *HOLD
Outputs information on suspended job streams.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	No error
1	0	CMD0001	An attempt was made to create S variables for job types TYPE4 through TYPE8
2	0	EXC0152	Requested information does not exist
2	0	SCP1095	DPRINT does not run
2	0	SPA0003	RSO subsystem not loaded
2	0	SPS0266	Bourse of the ADM task destroyed
2	0	SPS0420	RSO subsystem not loaded
2	0	SPS0242	No job in the replay queue
2	0	SRO0373	Selected RSO printer not active
2	0	SRO0374	No RSO printers managed by the caller active
	1	CMD0202	Syntax or semantic error
	32	CMD2009	Error during generation of S variables
	64	EXC0252	Specified user ID does not exist
	64	EXC0153	No authorization for command

Output in S variables

The INFORMATION operand identifies the S variables which are to be assigned values. If there is no current value to pass to an S variable, a null string (type S) or the number 0 (type I) is assigned instead. The following specifications are possible for INFORMATION:

Notation used in command	Abbreviated form used in table
INFORMATION = *SUMMARY	1
INFORMATION = *SYSTEM-PARAMETERS	2
INFORMATION = *CATEGORY	3
INFORMATION = *JOB-CLASS	4
INFORMATION = *SATURATION-QUEUE	5
INFORMATION = *WHEN-QUEUE	6
INFORMATION = *JOB-STREAM	7

Output information	Name of the S variable	T	Contents	Condition
Number of active jobs	var(*LIST).ACTIVE	I	<integer>	3
Number of jobs managed by the job scheduler	var(*LIST).ANNOUNCED	I	<integer>	4, 7
Name of the category	var(*LIST).CATEG	S	<name 1..8>	3
Maximum permitted number of resident main memory pages	var(*LIST).CORE	I	<integer>	2
Names of the jobs in the queue for main memory prereservation	var(LIST).CORE-PRERES(LIST).JOB-NAME	S	’’ <name 1..8>	5
TSNs of the jobs in the queue for main memory prereservation	var(LIST).CORE-PRERES(LIST).TSN	S	<alphan.-name 4..4>	5
User IDs of the jobs in the queue for main memory prereservation	var(LIST).CORE-PRERES(LIST).USER-ID	S	’’ <alphan.-name 1..8>	5
Date on which the job was entered in the condition queue	var(*LIST).DATE	S	<yyyy-mm-dd>	6
Number of jobs waiting because the job scheduler is not yet active, or n-th job run of a repeat job not yet started	var(*LIST).DORMANT	I	<integer>	4, 7
Number of existing jobs	var(*LIST).EXIST	I	<integer>	3
Number of jobs on hold	var(*LIST).HOLD	I	<integer>	4, 7
I/O priority of the category	var(*LIST).IO-PRIO	S	NONE / LOW MEDIUM / HIGH	3
Name of the job class	var(*LIST).JOB-CLASS	S	<name 1..8>	4
Job name in the condition queue; empty string if OUPUT-INF not equal *NAME	var(*LIST).JOB-NAME	S	’’ <name 1..8>	6
Name of the job stream	var(*LIST).JOB-STREAM	S	<name 1..8>	4, 7
Time after which the job stream is terminated	var(*LIST).LIFE-TIME	S	’’ <hh:mm:00>	7
Maximum number of jobs that can run concurrently in the job class	var(*LIST).LIM	I	<integer>	4
Specification in minutes as to how long the job may remain in the queue	var(*LIST).LIM	S	SHUTDWN <integer>	6
Maximum number of jobs that may be active	var(*LIST).MAXMPL	I	<integer>	3
Minimum number of jobs that should be active	var(*LIST).MINMPL	I	<integer>	3
Ideal number of jobs that should run concurrently in the job class	var(*LIST).OPTIMUM	I	<integer>	4
Names of the jobs in the HOLD queue	var(LIST).PAGING-DEV-HOLD(LIST). JOB-NAME	S	’’ <name 1..8>	5
TSNs of the jobs in the HOLD queue	var(LIST).PAGING-DEV-HOLD(LIST).TSN	S	<alphan.-name 4..4>	5
User IDs of the jobs in the HOLD queue	var(LIST).PAGING-DEV-HOLD(LIST).USER-ID	S	’’ <alphan.-name 1..8>	5
Names of the jobs in the queue for paging area prereservation	var(LIST).PAGING-DEV-PRERES(LIST).JOB-NAME	S	’’ <name 1..8>	5
TSNs of the jobs in the queue for paging area prereservation	var(LIST).PAGING-DEV-PRERES(LIST).TSN	S	<alphan.-name 4..4>	5
User IDs of the jobs in the queue for paging area prereservation	var(LIST).PAGING-DEV-PRERES(LIST).USER-ID	S	’’ <alphan.-name 1..8>	5
Number of inactive jobs ready for activation	var(*LIST).READY-INACTIVE	I	<integer>	3
Number of ready, inactive but not admitted tasks in this category	var(*LIST).READY-NOT-ADMITTED	I	<integer>	3
Number of jobs started in the job class/job stream	var(*LIST).START	I	<integer>	4, 7
Starting time of the job stream	var(*LIST).START-TIME	S	ATLOAD BYOPER <hh:mm:00>	7
State of the job class/job stream	var(*LIST).STATE	S	ACT DEL HOLD INACT	4, 7
Stop time of the job stream	var(*LIST).STOP-TIME	S	’’ ATSHUTD BYOPER <hh:mm:00>	7
Number of waiting batch jobs	var(*LIST).T1	I	<integer>	1
Number of batch jobs waiting because the job scheduler is not yet active, or n-th job run of a repeat job	var(*LIST).T1-DO	I	<integer>	1
Number of batch jobs waiting because they were placed on hold	var(*LIST).T1-HO	I	<integer>	1
Number of batch jobs waiting to be started by the system	var(*LIST).T1-WT	I	<integer>	1
Number of running batch jobs	var(*LIST).T2	I	<integer>	1
Number of running interactive jobs	var(*LIST).T3	I	<integer>	1
Time at which the job was entered in the condition queue	var(*LIST).TIME	S	<hh:mm:ss>	6
TSNs of the jobs waiting for the condition to be fulfilled	var(*LIST).TSN	S	<alphan.-name 4..4>	6
User IDs of the jobs waiting for the condition to be fulfilled; empty string if OUPUT-INF not equal *USER-ID	var(*LIST).USER-ID	S	’’ <name 1..8>	6
Number of jobs waiting for start	var(*LIST).WAIT	I	<integer>	4, 7
Weighting (urgency) of the category or job class	var(*LIST).WEIGHT	I	<integer>	3, 4

Your Browser is not longer supported

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

SHOW-SYSTEM-STATUS

Function

Privileged functions

Format

Operands

Return codes

Output in S variables