Display information about group of jobs
Component: | STATUS |
Functional area: | Job processing |
Domain: | JOB |
Privileges: | alle Privilegien |
Routing code: | E |
Function
The SHOW-USER-STATUS command supplies information on jobs assigned to the user’s own ID. It can also supply information on jobs generated under the user’s own ID but running under a different user ID (extended access; does not apply to spool jobs). The RSO device administrator also obtains information on spoolout jobs under other user IDs if the output is directed to a device under his administration. The following information can be requested (INFORMATION operand):
Value *STD: attributes of the individual job, such as job name, account number, TSN, type (processing state), priority, CPU time used, time limit etc. This information is output for all jobs if the command is issued without operands.
value *ENVIRONMENT: job name, TSN, names of the hardware used by the job (terminal, processor, SPOOL devices, forms, overlays), waiting time in HOLD status, catalog identification, spoolout class.
value *PROGRAM (output only for jobs of type T2 or T3): job name, TSN, type, category, name and size of the loaded program (if present), current command.
Value *JOB (can be queried only for jobs of types T1 to T3): job names, TSN, type, category, job class, residence time in the current processing state; in addition, for batch jobs: job scheduling priority, start time, repetition interval, values for RERUN-AFTER-CRASH and FLUSH-AFTER-SHUTDOWN.
Value *REPEAT-JOB (can be queried only for repeat jobs): information on job repetition, such as job name, type, category, interval, number of repetitions, NTSN, next start time.
Value *BY-CALENDAR (can be queried only for calendar jobs): information on job name, TSN, type, symbolic starting date, job count and next calculated start time.
The specification of a job class for selecting the jobs to be output is available as an additional selection criterion (JOB-CLASS-NAME operand).
The command supports structured output in S variables (see "Output in S variable").
Privileged functions
Systems support (TSOS and OPERATING privilege) can use the command to obtain comprehensive and detailed information relating both to jobs of all users and to a specific user ID. The INFORMATION operand allows them to define the overview they want to have displayed in more detail in terms of job type and associated attributes. They can also use a category as an additional criterion for selecting the jobs to be displayed (CATEGORY-NAME operand).
Format
SHOW-USER-STATUS | Alias: SHUS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Operands
USER-IDENTIFICATION =
Defines the user ID to which the information output is to relate.
USER-IDENTIFICATION = *ALL
The jobs of all users currently on the system are to be displayed. Nonprivileged users receive information about all jobs started under their own user ID. They also receive information about jobs which were generated by their own ID and are running under a different ID (extended access; does not apply to SPOOL jobs). An RSO device administrator receives information about all print jobs to be output on a printer under his administration.
USER-IDENTIFICATION = <name 1..8 with-wild(24)>
Only jobs for this user ID are to be included in the information output. Nonprivileged users can only explicitly specify their own user ID. An exception to this applies to RSO device administrators for RSO SPOOL jobs. The same information is output as with USER-IDENTIFICATION=*ALL.
Restriction
Specifying a USER-IDENTIFICATION with wildcards is not supported for spoolout jobs.
JOB-TYPE = *ANY / *JOBS / *SPOOLOUT / *WAITING-JOBS / *BATCH-JOBS / *DIALOG-JOBS /
*WAITING-SPOOLOUT / *RUNNING-SPOOLOUT / *RSO-SPOOLOUT(...)
Job types on which information is desired.
Operand value | Meaning (job type) |
---|---|
*ANY | All (subsequently listed) job types |
*JOBS | All ENTER and interactive jobs (T1, T2, and T3) |
*SPOOLOUT | Executing and waiting spoolout tasks |
*WAITING-JOBS | Waiting ENTER jobs (T1) |
*BATCH-JOBS | Executing ENTER jobs (T2) |
*DIALOG-JOBS | Executing interactive jobs (T3) |
*WAITING-SPOOLOUT | Waiting spoolout tasks (T4) |
*RUNNING-SPOOLOUT | Executing spoolout tasks (T5) |
*RSO-SPOOLOUT(...) | Waiting and executing spoolout tasks for RSO printers (T7); the output can be restricted to specific RSO printers or printer pools (see operand description) |
JOB-TYPE = *RSO-SPOOLOUT(...)
Requests information about spoolout jobs for the specified RSO printers.
DESTINATION = *ALL / <name 1..8 with-wild>
Provides information on all spoolout jobs that are output to the RSO designated printers. The following may be specified:
name of the RSO printer; can be specified in wildcard format
name of an RSO device pool; all printers in this pool are selected.
DEVICE = *ALL / <alphanum-name 1..8 with-wild>
Names of the RSO printers (can also be specified in wildcard format). The default value is *ALL, i.e. all device pools are selected.
INFORMATION = *STD / *ENVIRONMENT(...) / *PROGRAM / *JOB / *REPEAT-JOB / *BY-CALENDAR
Type of information to be displayed. The operand values *PROGRAM, *JOB, *REPEAT-JOB, and *BY-CALENDAR return information which is available only for some types of job. In this case only on information on such jobs is output.
INFORMATION = *STD
Displays the following information for the job type specified:
Field | Meaning / Contents |
---|---|
NAME |
|
TSN | Task sequence number |
TYPE | Job type (T1 to T7), additional information, depending on job type |
TYPE = 1 | Type = 1: Waiting batch jobs
|
TYPE = 2/3 | Type = 2/3: Active batch and interactive jobs; the first 7 characters of the category name are output, e.g.:
|
TYPE = 4 | Type = 4
|
TYPE = 5 | Type = 5: Active spoolout task
|
TYPE = 7 | Type = 7: RSO spoolout tasks
|
PRI | Job and task priority; * indicates the job express function |
CPU-USED | Only for T2 / T3: |
CPU-MAX | Only for T1 / T2 / T3:
|
ACCOUNT# | Only for T1 / T2 / T3: |
SIZE | Only for T4/T5/T7; the value depends on the setting in the SPOOL parameter file (SPOOLOUT-SIZE); possible settings:
|
COPIES | Only for T4/T5/T7: Number of copies still to be printed |
PRSIZE | Only for T4/T5/T7:
|
RTSN | Only for T4/T5/T7: |
OPT | Only for T4/T5: |
DEVICE | Only for T7: Device name or pool name (identified by *) |
INFORMATION = *ENVIRONMENT(...)
The RFA application name R<tsn><sysid> is displayed for AFR partner tasks.
TERMINAL = *NONE / *APPLICATION / *ORIGINAL
Specifies which values are to be output in the fields STATION and PROCESSOR. If *APPLICATION is specified, the names used in the application (e.g. OMNIS) for the station and processor names are output. If *ORIGINAL is specified, the names used by BCAM are output.
Specifying *NONE is the same as specifying *APPLICATION.
Displays the following information for the job specified:
Field | Meaning / Contents |
---|---|
NAME |
|
TSN | Task sequence number |
STATION | Station name (with local printer; mnemonic device name); name from the application or BCAM name |
PROCESSOR | Processor name; name from the application or BCAM name |
HOLD | Time (hhmm) at which the job was placed in the "HOLD" state or "NO" state if it is not in the HOLD state (only displayed for T1, T2 and T3 jobs) |
MRSCAT | Catalog ID and QUIET when the catalog is in the QUIET state or empty |
FORM | Form name when printing the form used |
CLASS | Spoolout class which is assigned to the job |
DIA | Name of the overlay used for the laser printer |
DEV | Name of the output device as described in INFORMATION=*STD, field TYPE; (only displayed for T4 and T5 jobs) |
PVS | Catalog ID of the pubset on which the output file is stored |
OPT | Displays with the ’*’ character that a FOB overlay, page rotation, or more than four character sets are used for the job |
ERMSG | Error code for RSO devices. The error message can be queried with the HELP-MSG-INFORMATION command |
ERCOD | Complete return code returned by DCAM or the device |
INFORMATION = *PROGRAM
Output for jobs of type T2 and T3 only
Displays the following information for the specified job:
Field | Meaning / Contents |
---|---|
NAME |
|
TSN | Task sequence number |
TYPE | Job type (T2 or T3) plus category name (7 characters) |
SIZE | Program size in main memory pages (4 KB) |
CURR-CMD |
|
PROG | Name of the loaded program, if available (up to 154 characters depending on the type of program file) |
INFORMATION = *JOB
Output for jobs of type T1, T2 and T3 only
Displays the following information for the specified job:
Field | Meaning / Contents |
---|---|
NAME |
|
TSN | Task sequence number |
TYPE | Job type (T1 to T3), additional information, depending on job type |
Type = 1: Waiting batch jobs
| |
Type = 2/3: Active batch and interactive jobs; the first 7 characters of the category name are output, e.g.:
| |
JCLASS | Job class assigned to the user |
INTYPE | Time span in which the job is in the processing status under consideration (in minutes) |
P | Job scheduling priority |
START | Specification of the job start time in accordance with the SET-LOGON- |
REP | Specification of the job repetition in accordance with the SET-LOGON-PARAMETERS, LOGON or ENTER-JOB command: |
RER | YES or NO, as specified in the RERUN-AFTER-CRASH operand of the SET-LOGON-PARAMETERS, LOGON or ENTER-JOB command |
FLU | YES or NO, as specified in the FLUSH-AFTER-SHUTDOWN operand of the SET-LOGON-PARAMETERS, LOGON or ENTER-JOB command |
INFORMATION = *REPEAT-JOB
Output for repeat jobs only (type T1 and T2)
Displays the following information for the specified job:
Field | Meaning / Contents |
---|---|
NAME |
|
TSN | Task sequence number |
REP | Information on job repetition |
REPCNT | Counter for job repetitions |
NTSN | TSN which was reserved for the job repetition |
NSTART | Start time determined for the repetition of the job |
INFORMATION = *BY-CALENDAR
Output for calendar jobs only (type T1 and T2)
Displays the following information for the specified job:
Field | Meaning / Contents |
---|---|
NAME |
|
TSN | Task sequence number |
TYPE | Job type (T1 to T2), additional information, depending on job type |
Type = 1: Waiting batch jobs
| |
Type = 2: Active batch and interactive jobs; the first 7 characters of the category name are output, e.g.:
| |
SYMDAT | Symbolic date which determines the start time of the calendar job; the output field is empty if the job is not a calendar job |
COUNT | Run counter for the current number of job repetitions; the output field is empty if the job is not a calendar job. |
START | Specification of the job start time of the calendar job which is calculated from the specified symbolic date in the format "yyyy-mm-dd.hhmm". The output field is empty if the job is not a calendar job. |
OUTPUT-JOB-ID = *STD / *NAME / *USER-IDENTIFICATION / *NONE
Specifies whether the name or user ID of the job desired is to be displayed in addition to the TSN. The default value is *STD, i.e. the nonprivileged user receives the job name in output field NAME (corresponds to OUTPUT-JOB-ID=*NAME), the privileged user receives the user ID (corresponds to OUTPUT-JOB-ID=*USER-ID).
CPU-LIMIT = *ANY / *PARAMETERS(...)
Selects jobs according to CPU time usage.
The operand has no significance for SPOOL tasks.
CPU-LIMIT = *PARAMETERS(...)
MINIMUM = 0 / <integer 0..2147483647 seconds>
CPU time, in seconds; selects jobs that have required at least the specified amount of CPU time.
MAXIMUM = 2147483647 / <integer 0..2147483647 seconds>
CPU time, in seconds; selects jobs that have required not more than the specified amount of CPU time.
JOB-TYPE-TIME = *ANY / *PARAMETERS(...)
Selects jobs of the types 1 to 3 according to the amount of time they belonged to the specified job type. SPOOL jobs are not displayed.
JOB-TYPE-TIME = *PARAMETERS(...)
MINIMUM = 0 / <integer 0..2147483647 minutes>
Time, in minutes; selects jobs that were assigned to the specified job type for at least the specified length of time.
MAXIMUM = 2147483647 / <integer 0..2147483647 minutes>
Time, in minutes; selects jobs that were assigned to the specified job type for at most the specified length of time.
CATEGORY-NAME =
Selects jobs according to their job (task) category.
CATEGORY-NAME = *ALL
Jobs of all categories are included in the output.
CATEGORY-NAME = <name 1..8>
Specifies the category according to which jobs are selected.
JOB-CLASS-NAME =
Selects the jobs according to their job class.
JOB-CLASS-NAME = *ALL
The jobs from all job classes are examined.
JOB-CLASS-NAME = <name 1..8>
JOB-NAME =
Selects the jobs according to their name as defined in the SET-LOGON-PARAMETERS or ENTER-JOB command.
JOB-NAME = *ALL
All jobs are examined.
JOB-NAME = *NONE
*NONE designates jobs for which no job name was defined.
JOB-NAME = <name 1..8 with-wild(24)>
Determines the job name which is used as a basis for selecting the jobs.
Return codes
(SC2) | SC1 | Maincode | Meaning |
---|---|---|---|
0 | CMD0001 | Without errors | |
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 | SPS0171 | Local spoolout not available |
2 | 0 | SPA0003 | RSO subsystem not loaded |
2 | 0 | SPS0266 | Bourse of the ADM task destroyed |
2 | 0 | SPS0420 | RSO subsystem not loaded |
1 | CMD0202 | Syntax or semantic error | |
1 | SCP0973 | Inconsistency between operands | |
32 | CMD2009 | Error during generation of S variables | |
32 | SCP0974 | User ID specified for spoolout does not exist | |
64 | EXC0252 | Specified user ID does not exist | |
64 | EXC0153 | No authorization for command | |
64 | SCP0975 | No authorization for command |
Output in S variable
The INFORMATION operand identifies the S variables which are to be created. 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 = *STD | 1 |
INFORMATION = *ENVIRONMENT | 2 |
INFORMATION = *PROGRAM | 3 |
INFORMATION = *JOB | 4 |
INFORMATION = *REPEAT | 5 |
INFORMATION = *BY-CALENDAR | 6 |
When information is output to SYSOUT, print jobs are also displayed for reasons of compatibility. Variable output, on the other hand, only contains jobs of the types 1 to 3. The corresponding SPOOL commands must be used for print jobs.
Output information | Name of the S variable | T | Contents | Condition |
---|---|---|---|---|
Account number to which the job is being charged | var(*LIST).ACCOUNT | S | ’’ | 1 |
Name of the last command which was processed by the task | var(*LIST).CMD | S | ’’ | 3 |
Maximum CPU time allowed for the job | var(*LIST).CPU-LIM | S | ’’ | 1 |
CPU time already used by the task | var(*LIST).CPU-USED | S | ’’ | 1 |
CPU time already used by the task in unabbreviated form | var(*LIST).CPU-USED-LONG | S | ’’ | 1 |
Member name when the program was loaded from a library | var(*LIST).ELEM-NAME | S | ’’ | 3 |
Member type when the program was loaded from a library | var(*LIST).ELEM-TYPE | S | ’’ | 3 |
Member version when the program was loaded from a library | var(*LIST).ELEM-VERSION | S | ’’ | 3 |
Name of the file containing the load module | var(*LIST).FILE-NAME | S | ’’ | 3 |
Removal of the batch job from the job queue if it has not been processed by the end of the session | var(*LIST).FLUSH-AFTER-HUTDOWN | S | ’’ | 4 |
Time since the job has been in the HOLD state | var(*LIST).HOLD-TIME | S | ’’ | 2 |
Name of the job class in which the job has been queued | var(*LIST).JOB-CLASS | S | ’’ | 4 |
Number of job repetitions | var(*LIST).JOB-COUNT | I | 0 | 5, 6 |
Job name | var(*LIST).JOB-NAME | S | ’’ | |
Priority of the job | var(*LIST).JOB-PRIO | I | 0 | 1, 4 |
Type of job (1,2 3,4,5,7) | var(*LIST).JOB-TYPE | I | 0 | 1, 3, 4, 5, 6 |
Original name of the processor via which the terminal is addressed | var(*LIST).ORIG-PROC-NAME | S | ’’ | 2 |
Original name of the terminal | var(*LIST).ORIG-STATION | S | ’’ | 2 |
Name of the processor via which the terminal is addressed | var(*LIST).PROC-NAME | S | ’’ | 2 |
Size of the program (in 4KB) | var(*LIST).PROG-SIZE | I | 0 | 3 |
Only when PUBSET-STATE=QUIET: Pubset affected | var(*LIST).PUBSET | S | ’’ | 2 |
Displays whether the task is waiting for access to a pubset in QUIET state to become possible again. | var(*LIST).PUBSET-STATE | S | ’’ | 2 |
Specifies when the job repetition is to be started | var(*LIST).REPEAT-JOB | S | ’’ | 4, 5 |
Start date of job repetition | var(*LIST).REPEAT-JOB-DATE | S | ’’ | 5 |
Start time of job repetition | var(*LIST).REPEAT-JOB-TIME | S | ’’ | 5 |
TSN of the job repetition | var(*LIST).REPEAT-JOB-TSN | S | ’’ | 5 |
Restart of the batch job in the next | var(*LIST).RERUN-AFTER-CRASH | S | ’’ | 4 |
Run priority of the job | var(*LIST).RUN-PRIO | I | 0 | 1 |
Desired start time of the job. | var(*LIST).START | S | ’’ | 4 |
Start date of the job | var(*LIST).START-DATE | S | ’’ | 4, 6 |
Job is to be started immediately. | var(*LIST).START-IMMED | S | TRUE | 1 |
Start time of the job | var(*LIST).START-TIME | S | ’’ | 4, 6 |
Name of the station (with local printer; mnemonic device name); | var(*LIST).STATION | S | ’’ | 2 |
Additional details of job type | var(*LIST).SUB-TYPE | S | ’’ | 1, 3, 4, 5, 6 |
Symbolic date which determines the start time of the calendar job | var(*LIST).SYMBOLIC-DATE | S | ’’ | 6 |
Task sequence number | var(*LIST).TSN | S | <alphan.-name 4..4> | |
User ID under which the job was started | var(*LIST).USER-ID | S | ’’ |