Request information on a job
Component: | STATUS |
Functional area: | Job processing |
Domain: | JOB |
Privileges: | alle Privilegien |
Routing code: | E |
Function
The SHOW-JOB-STATUS command displays information on an individual job that was issued under the user’s own ID. It can also supply information about a job generated by the user’s own ID but running under some other user ID (extended access, not applicable to SPOOL jobs).
If the job or SPOOLOUT name is specified, the information output covers all jobs with this name.
The following information can be requested (INFORMATION operand):
value *STD: attributes of the job, such as job name, account number, TSN, type (processing state), priority, CPU time used, time limit, etc.
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 *SYSTEM (output only for jobs of type T2 or T3): job name, TSN, ITN (internal task number), UNPEND-CODE, job queue number, spoolin and LOGON time.
value *JOB (output only for jobs of types T1 to T3): job name, TSN, type, 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 (output only for repeat jobs): information on job repetition, such as job name, TSN, type, interval, number of repetitions, NTSN, start time.
value *BY-CALENDAR (output only for jobs of type T1 to T3): information on job name, TSN, type; for calendar jobs, information on symbolic starting date, job count and the next calculated start time.
value *ALL: all available information is output (default value), including the information mentioned above.
If the command is entered without operands, both privileged and nonprivileged users receive all the information on their own job (under which the command is given).
The command supports structured output in S variables (see "Output in S variable").
Privileged functions
The command supplies the systems support staff (privilege TSOS and OPERATING) with all information about a single job started under any user ID. The job can also be selected on the basis of the internal task number (TID).
Information may also be required for several jobs, that can be selected by specification of their job names and user IDs (with wildcard or in a list).
RSO device administrators and spool and cluster administrators can request information about any print job scheduled for printing on any device that they manage. For more information on these user groups see the manuals “RSO” [32], “Spool & Print Commands” [42] and “Distributed Print Services” [10].
Note
Newer printer types (such as LP65-, LP48-, LP-EMULATED-PRINTER) are not supported by the SHOW-JOB-STATUS command. Detailed information on print jobs (TYPE 4 to 7) can be obtained with commands designed for that purpose (such as SHOW-PRINT-JOB-STATUS or SHOW-PRINT-JOB-ATTRIBUTES).
Format
SHOW-JOB-STATUS | Alias: SHJS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
JOB-IDENTIFICATION =
Specifies how the job is identified.
A job may be identified by job number, job name, spoolout name or monitoring job variable. Multiple jobs may be identified via the job or SPOOLOUT name. Nonprivileged users can only obtain information about jobs started from or running under their own user ID.
An RSO device administrator also receives information about print jobs to be output on a printer managed by him.
JOB-IDENTIFICATION = *OWN
Requests information about the user’s own job. JOB-ID=*OWN may not be issued on a console.
JOB-IDENTIFICATION = *TID(...)
This specification is only permissible for systems support (TSOS or operating privilege). Identifies an individual job by means of its internal task identifier (TID).
TID = <x-string 1..8>
Internal task identifier (TID) of the job.
HOST = *STD / <c-string 1..8>
Host system on which the job is running. The default is *STD, which means that the job is running on the local host. The host name of a remote system can only be specified for systems which are on a computer network (see the “HIPLEX MSCF” manual [25]).
JOB-IDENTIFICATION = *TSN(...)
Identifies an individual job via its task sequence number (TSN).
TSN = <alphanum-name 1..4>
Task sequence number of the job.
HOST = *STD / <c-string 1..8>
Host system on which the job is running. The default is *STD, which means that the job is running on the local host. The host name of a remote system can only be specified for systems which are on a computer network (see the “HIPLEX MSCF” manual [25]).
JOB-IDENTIFICATION = *JOB-NAME(...)
Identifies one or several jobs via their job names.
JOB-NAME = <name 1..8 with-wild(24)> / list-poss(16): <name 1..8> / *NONE
Name of the desired job or jobs as defined in the SET-LOGON-PARAMETERS or ENTER-JOB command.
To select the desired jobs on which information is to be output, it is also possible to specify several job names either with wildcards or in form of a list.
*NONE designates jobs for which no job name was defined.
USER-IDENTIFICATION = <name 1..8 with-wild(24)> / list-poss(16): <name 1..8> / *ALL
This specification is only permissible for systems support (TSOS or operating privilege).
One or several user IDs may be specified as additional selection criterion to identify the desired jobs on which information is to be output.
The default value is *ALL, i.e. information is desired on jobs running under all user IDs.
JOB-IDENTIFICATION = *SPOOLOUT-NAME(...)
Identifies one or several print jobs via their SPOOLOUT names.
SPOOLOUT-NAME = <alphanum-name 1..8> / <c-string 1..8 with-low> / *NONE
Name of the appropriate spoolout task as defined in the PRINT-JOB-NAME operand of the PRINT-DOCUMENT command. *NONE designates jobs for which no job name was defined.
JOB-IDENTIFICATION = *NAME(...)
Identifies one or several jobs via their job or SPOOLOUT names.
NAME = <name 1..8> / *NONE
Name of the appropriate job or spoolout task.
*NONE designates jobs for which no job name was defined.
JOB-IDENTIFICATION = *MONJV(...)
Identifies an individual job via its monitoring job variable.
MONJV = <filename 1..54 without-gen>
Name of the JV monitoring the desired job.
A monitoring JV can be specified in the SET-LOGON-PARAMETERS, LOGON or ENTER-JOB command, provided the JV software product is available. For a batch job running on a remote host to be accessible via the monitoring JV, the MRSCAT of each host must contain the catalog ID of the pubset of the other host.
INFORMATION = *ALL(...) / list-poss(6): *STD / *ENVIRONMENT(...) / *PROGRAM / *SYSTEM / *JOB / *REPEAT / *BY-CALENDAR
Type of information to be displayed.
All output formats contain the information to identify the job:
Field | Meaning / Contents |
|---|---|
NAME |
|
TSN | Task sequence number |
INFORMATION = *ALL(...)
Displays all the information for the specified job which can be called with the operand values *STD, *ENVIRONMENT, *PROGRAM, *SYSTEM, *JOB, *REPEAT and *BY-CALENDAR, plus the following information:
Field | Meaning / Contents |
|---|---|
PRINCIPAL | Only for T3: Principal name; displayed only if the authorization to access the system by a Kerberos principal has been proved. |
PERS-ID | Only for T1 / T2 / T3: Personal identifier (see "Notes on the PERS-ID and PRINCIPAL output information") |
CPU-LONG | Only for T2 / T3: CPU time used, in seconds; also displayed when the maximum possible display value of 999999.999 is reached for CPU-USED |
TERMINAL = *NONE / *APPLICATION / *ORIGINAL
Specifies which values are to be output in the fields STATION and PROCESSOR (see INFORMATION=*ENVIRONMENT(...)). The default value *NONE is the same as if *APPLICATION was specified.
TERMINAL = *APPLICATION
The data of the direct connection partner of $DIALOG is displayed. This can be both a terminal and a utility routine for connection management (e.g. OMNIS).
TERMINAL = *ORIGINAL
The data is always displayed on the console. A utility routine which is possibly switched between the console and $DIALOG is ignored.
INFORMATION = *STD
Displays the following information for the job specified:
Field | Meaning / Contents |
|---|---|
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 time used, in seconds; if the maximum possible display value of 999999.999 has been reached, the current value is displayed in a new line |
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: |
INFORMATION = *ENVIRONMENT(...)
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 |
|---|---|
STATION | Station name (with local printer; mnemonic device name); name from the application or BCAM name, for T1, and T2 jobs empty |
PROCESSOR | Processor name; for T1 job empty, for T2 job constant “BATCH”; for T3 job name from the application or BCAM name (only displayed for T1, T2, and T3 jobs), |
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 if the catalog is in the QUIET state or empty (only displayed for T1, T2, and T3 jobs) |
FORM | Form name of the form used when printing (only displayed for T4, T5, and T7 jobs) |
CLAS | Spoolout class which is assigned to the job (only displayed for T4, T5, and T7 jobs) |
DI | Name of the overlay used for the laser printer (only displayed for T4, T5, and T7 jobs) |
DEV | Name of the output device as described in INFORMATION=*STD, field TYPE (only displayed for T4, T5, and T7 jobs) |
PVS | Catalog ID of the pubset on which the output file is stored (only displayed for T4, T5,and T7 jobs) |
OPT | Displays with the ’*’ character that a FOB overlay, page rotation, or more than four character sets are used for the job (only displayed for T4, T5, and T7 jobs) |
ERMSG | Error code for RSO devices. The error message can be queried with the HELP-MSG-INFORMATION command (only displayed for T7 jobs) |
ERCOD | Complete return code returned by DCAM or the device (only displayed for T7 jobs) |
INFORMATION = *PROGRAM
Displays the following information for the specified job (only for type T1, T2 or T3):
Field | Meaning / Contents |
|---|---|
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 = *SYSTEM
Displays the following information for the specified job (only for types T1, T2 or T3):
Field | Meaning / Contents |
|---|---|
TID | Task identifier, task number of the task assigned to the job or empty (for T1) |
UNP | UNPEND code of the job or empty (for T1) |
Q# | Number of the job queue or empty (for T1) |
SPOOLIN | SPOOLIN time |
LOGON | LOGON time or empty (for T1) |
INFORMATION = *JOB
Displays the following information for the specified job (only for types T1 to T3):
Field | Meaning / Contents |
|---|---|
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 minutes) for which the job has already been in the processing status under consideration |
P | Job scheduling priority |
START | Specification of the job start time in accordance with the SET-LOGON-PARAMETERS (or LOGON), ENTER-JOB or ENTER-PROCEDURE command: |
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
Displays the following information for the specified job (only for types T1, T2, and T3):
Field | Meaning / Contents |
|---|---|
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.:
| |
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
Displays the following information for the specified job (only for types T1 to T3):
Field | Meaning / Contents |
|---|---|
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.:
| |
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". |
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).
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Without errors | |
2 | 0 | EXC0152 | Requested information does not exist |
2 | 0 | SPS0171 | Local spoolout not available |
2 | 0 | SPA0003 | Bourse of the ADM task destroyed |
2 | 0 | SPS0266 | SPOOL subsystem not loaded |
2 | 0 | SPS0420 | RSO subsystem not loaded |
1 | CMD0202 | Syntax or semantic error | |
1 | SCP0973 | Inconsistency between operands | |
32 | CMD0221 | The specified MONJV cannot be accessed | |
32 | CMD2009 | Error during generation of S variables | |
32 | SCP0974 | User ID specified for spoolout does not exist | |
64 | EXC0154 | Error on a remote system | |
64 | EXC0153 | No authorization for command | |
64 | SCP0975 | No authorization for command |
Notes on the PERS-ID and PRINCIPAL output information
When the SRPMOPT parameter NET-DIALOG-REJECT-FALLBACK=Y is set, an interactive user whose Kerberos principal has no access authorization for the selected user ID can log in by specifying the password instead. Such an “unauthorized” principal is not displayed as PRINCIPAL, but is included in the evaluation of the PERS-ID.
When the user ID requires personal identification, the personal user ID specified in the SET-PERSONAL-ATTRIBUTES command is always used as PERS-ID. When there is no personal user ID but a Kerberos principal (also an “unauthorized” one), the PERS-ID contains the first 16 characters of the principal name.
When a PRINCIPAL is displayed, the PERS-ID is not displayed. Nevertheless, it exists and is also inherited. Its value can, for example, be read from the special job variable $SYSJV.PERS-ID.
A batch task started by the user (ENTER-JOB command, ENTER macro) inherits the PERS-ID of its calling task.
Output layout for INFORMATION=*ALL
Displays of information on one particular job with INFORMATION=*ALL differ, depending on the processing status of the job.
Output for TYPE 1 - waiting jobs:
TSN: @@@@ TYPE: 1 @@@@@@@ NOW: YYYY-MM-DD.HHMMSS JOBNAME: @@@@@@@@ PRI: # ### SPOOLIN: YYYY-MM-DD.HHMM USERID: @@@@@@@@ JCLASS: @@@@@@@@ INTYPE: MMMMMM ACCNB: @@@@@@@@ CPU-MAX: ###### START: YYYY-MM-DD.HHMM COUNT: ##### RERUN: @@@ FLUSH: @@@ —————————————————— (1) REPEAT: ##### RERUN: @@@ FLUSH: @@@ —————————————————— (2) NTSN: @@@@ REPCNT: ##### NSTART: YYYY-MM-DD.HHMM —————— (3) SYMDAT: @@@@@@@@@@@@@@@@@@@@ LIMIT: @@@@@@@@@@@@@@@ —————— (1) CAL-NAME:@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ ——————— (1) ORIGFILE:@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ CMD-FILE:@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ ——————— (4) MONJV: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ PERS-ID: @@@@@@@@@@@@@@@@ ————————————————————————————————————————————— (5)
(1) | This line is displayed for calendar jobs only. |
(2) | This line is displayed for normal jobs, scheduled jobs and repeat jobs only. |
(3) | This line is displayed for repeat jobs only. |
(4) | This line is displayed only if the job was started with the ENTER-PROCEDURE command or if a copy of the command file was created when it was started with the ENTER-JOB command, e.g. because this was cataloged under a foreign user ID. |
(5) | This line is displayed only if a personal identifier exists (see also "Notes on the PERS-ID and PRINCIPAL output information"). |
TSN | Task sequence number |
TYPE | Job type, plus category information |
NOW | Date and time |
JOBNAME | Job name |
PRI | Job and task scheduling priority |
SPOOLIN | Spoolin time (date and time) |
USERID | User ID under which the job is executing |
JCLASS | Job class assigned to the job |
INTYPE | Time span for which the job is in the processing status under consideration |
ACCNB | Account number |
CPU-MAX | Maximum available CPU time for this job or the value HOLD if the job is suspended with /HOLD-TASK |
START | Job start time |
COUNT | Current number of repetitions of a calendar job |
REPEAT | Job repetition |
RERUN | Specification whether the job is to be rerun if the job is interrupted by a serious system error or system shutdown |
FLUSH | Specification whether the job is to be kept in the queue if it has not been processed by the end of the session |
NTSN | Task sequence number that was reserved for the repetition of the job |
REPCNT | Counter for job repetitions |
NSTART | Start time determined for the repetition of the job |
SYMDAT | Symbolic date on which the calendar job is to run |
LIMIT | Duration of the calendar job (maximum number of repetitions or limited by date) |
CAL-NAME | Name of the calendar file in which the SYMDAT is defined |
ORIGFILE | Name of the original file (ENTER or procedure file). If the file is a PLAM element then the library and element names may be displayed in abbreviated form. The presence of “*” in the name indicates truncated characters. |
CMD-FILE | Copy of the ENTER file S.IN.<tsn>.<date>.<time> where <date> is specified in the form yymmtt and <time> in the form hhmm or, if processing was initiated with the ENTER-PROCEDURE command, the generated S.E file. |
MONJV | The name of the job variable monitoring the job or, if no job variable was specified, *NONE. |
PERS-ID | Personal identifier (see also "Notes on the PERS-ID and PRINCIPAL output information"). |
Output for TYPE 2 - active batch jobs:
TSN: @@@@ TYPE: 2 @@@@@@@ NOW: YYYY-MM-DD.HHMMSS
JOBNAME: @@@@@@@@ PRI: # ### SPOOLIN: YYYY-MM-DD.HHMM
USERID: @@@@@@@@ JCLASS: @@@@@@@@ LOGON: YYYY-MM-DD.HHMM
ACCNB: @@@@@@@@ CPU-MAX: ###### CPU-USED:######.####
CPU-LONG:##########.#### —————— (1)
COUNT: ##### RERUN: @@@ FLUSH: @@@ —————————————————— (2)
REPEAT: @@@@ RERUN: @@@ FLUSH: @@@ —————————————————— (3)
MRSCAT: @@@@:QUIET HOLD: HHMM START: YYYY-MM-DD.HHMM
TID: @@@@@@@@ UNP/Q#: ####/###
SYMDAT: @@@@@@@@@@@@@@@@@@@@ LIMIT: @@@@@@@@@@@@@@@ —————— (2)
CAL-NAME:@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ ———————— (2)
CMD: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ SIZE: ######
PROG: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
ORIGFILE:@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
CMD-FILE:@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ ——————— (4)
MONJV: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
PERS-ID: @@@@@@@@@@@@@@@@ ————————————————————————————————————————————— (5)
(1) | This line is displayed only if the CPU time used by the task is greater than 999999.999 seconds. |
(2) | This line is displayed for calendar jobs only. |
(3) | This line is displayed for normal jobs, scheduled jobs and repeat jobs only. |
(4) | This line is displayed only if the job was started with the ENTER-PROCEDURE command or if a copy of the command file was created when it was started with the ENTER-JOB command, e.g. because this was cataloged under a foreign user ID. |
(5) | This line is displayed only if a personal identifier exists (see also "Notes on the PERS-ID and PRINCIPAL output information"). |
LOGON | LOGON time |
CPU-USED | CPU time already consumed by the task (when 999999.999 is reached, the current value is displayed in the CPU-LONG field) |
CPU-LONG | CPU time already consumed by the task (longer display if CPU-USED is not sufficient) |
MRSCAT | Identification and status of the MRSCAT catalog; otherwise empty |
HOLD | Time at which the task was suspended with the HOLD-TASK command |
TID | Task identifier |
UNP/Q# | Pend/unpend code for the task/task queue |
CMD | Last command processed by the task |
LIMIT | Maximum duration of a calendar job: unrestricted (*STD), maximum permissible number of repetitions (<integer 1..32766>) or date (YYYY-MM-DD.HHMM) for termination |
The following information is displayed only if a program is loaded within the batch task:
SIZE | Program size |
PROG | Name of the file from which the program was loaded or of the relevant library member (1 - 3 lines). |
The meaning of the other fields is identical to that described for the TYPE1 output format.
Output for TYPE 3 - interactive jobs:
TSN: @@@@ TYPE: 3 @@@@@@@ NOW: YYYY-MM-DD.HHMMSS
JOBNAME: @@@@@@@@ PRI: 0 ###
USERID: @@@@@@@@ JCLASS: @@@@@@@@ LOGON: YYYY-MM-DD.HHMM
ACCNB: @@@@@@@@ CPU-MAX: ###### CPU-USED: ######.####
STATION: @@@@@@@@ PROC: @@@@@@@@
O_STAT: @@@@@@@@ O_PROC: @@@@@@@@ ————————————————————————————————— (1)
TID: @@@@@@@@ UNP/Q#: ####/###
CMD: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ SIZE: ######
PROG: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
MONJV: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
PERS-ID: @@@@@@@@@@@@@@@@ ————————————————————————————————————————————— (2)
PRINCIPAL: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ ———— (3)
(1) | This line is displayed only if TERMINAL=ORIGINAL is specified: The original names are also displayed in addition to the names from the application. |
(2) | This line is displayed only if a personal identifier exists (see also "Notes on the PERS-ID and PRINCIPAL output information"). |
(3) | This line is displayed only if the authorization to access the system by a Kerberos principal has been proved. |
STATION | Terminal name from the application, or original name if no application is active |
PROC | Processor name application, or original name if no application is active |
O-STAT | Original name of the terminal |
O-PROC | Original name of the processor via which the terminal is addressed |
PRINCIPAL | The first 128 characters of the Kerberos principal which was accepted as access authorization to the system |
The meaning of the other fields is identical to that described for the TYPE1/TYPE2 output formats.
Output for TYPE 4 - waiting spoolout jobs:
TSN: @@@@ TYPE: 4 @@@ NOW: YYYY-MM-DD.HHMMSS
PNAME: @@@@@@@@ PRI: ### FAMILY: ####
USERID: @@@@@@@@ FORM: @@@@@@@@ SIZE: ######@
DEVICE: @@@@@@@@ CLASS: @@@@ COPIES: ###/###
RTSN: @@@@ PVS: @@@@ DIA: @@
DEST: @@@@@@@@ CONTROL: @@@@
FILENAME:<filename 1..54> or PLAM library name (element name,
version and element type)
MONJV: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
CHARS: @@@@@@@@ FOB: @@@@@@@@ ROT: ###/###
CHARS#: ### FOBSIZE: ###
TSN | Task sequence number |
TYPE | Job type, plus type of output device |
NOW | Date and time (year-month-day.hour-minute-second) |
PNAME | Job name from the PRINT-DOCUMENT command |
FAMILY | Number of spoolout jobs if a partially qualified file name or more than one file name was specified in the PRINT-DOCUMENT or WRITE-DISKETTE command. |
FORM | Form name of the paper used for printing |
SIZE | Size of the spoolout file |
DEVICE | Output device |
CLASS | Spoolout class |
COPIES | Copies still to be printed / total number of copies required |
RTSN | TSN of the job which generated the spoolout |
DIA | Name of the film overlay to be used for spoolout to a laser printer |
DEST | Name of the device pool or “*CENTRAL” |
CHARS | Name of the character set or character set pool |
FOB | Name of the specified FORM-OVERLAY-BUFFER |
ROT | Page rotation to be used |
CHARS# | Number of specified character sets |
FOBSIZE | Size of the specified FORM-OVERLAY-BUFFER |
CONTROL | Entry in the CONTROL-MODE operand (the only values shown are PHYSICAL and NO) |
FILENAME | File name of the file to be printed or of the PLAM element (PLAM library name, element name, version and type; if necessary, the output may extend over a number of lines) |
MONJV | Name of the job variable if specified |
PVS | Pubset containing the file to be printed. |
Local spoolout jobs waiting for PRE-PROCESSING:
TSN: @@@@ TYPE: 4 WP NOW: YYYY-MM-DD.HHMMSS
PNAME: @@@@@@@@ PRI: ### FAMILY: ####
USERID: @@@@@@@@ FORM: @@@@@@@@ SIZE: ######@
DEVICE: @@@@@@@@ CLASS: @@@@ COPIES: ###/###
RTSN: @@@@ PVS: @@@@ DIA: @@
DEST: @@@@@@@@ CONTROL: @@@@
FILENAME:<filename 1..54> or PLAM library name (element name,
version and element type)
MONJV: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
CHARS: @@@@@@@ FOB: @@@@@@@@ ROT: ###/###
CHARS#: ### FOBSIZE: ###
The meanings of the fields are the same as for the description of the TYPE 4 output format.
Output for TYPE 5 - active spoolout jobs:
TSN: @@@@ TYPE: 5 @@@ NOW: YYYY-MM-DD.HHMMSS
PNAME: @@@@@@@@ PRI: ### FAMILIY: ####
USERID: @@@@@@@@ FORM: @@@@@@@@ SIZE/PR: ######/######@
DEVICE: @@@@@@@@ CLASS: @@@@ COPIES: ###/###
RTSN: @@@@ PVS: @@@@ DIA: @@
DEST: @@@@@@@@ CONTROL: @@@@
FILENAME:<filename 1..54> or PLAM library name (element name,
version and element type)
MONJV: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
CHARS: @@@@@@@ FOB: @@@@@@@@ ROT: ###/###
CHARS#: ### FOBSIZE: ###
SIZE/PR
| Size of the file or number of lines, records or pages (APA printers) already output. On APA printers also the job processing status (see the description of the TYPE 4 output format and the “SPOOL” manual [42]). |
For the meanings of the other fields, see the TYPE 4 output format.
Active local spoolout jobs during PRE-PROCESSING:
TSN: @@@@ TYPE: 5 PRE NOW: YYYY-MM-DD.HHMMSS
PNAME: @@@@@@@@ PRI: ### FAMILY: ####
USERID: @@@@@@@@ FORM: @@@@@@@@ SIZE/PR ######/######@
DEVICE: @@@@@@@@ CLASS: @@@@ COPIES: ###/###
RTSN: @@@@ PVS: @@@@ DIA: @@
DEST: @@@@@@@@ CONTROL: @@@@
FILENAME:<filename 1..54> or PLAM library name (element name,
version and element type)
MONJV: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
CHARS: @@@ FOB: @@@@ ROT: ###/###
CHARS#: ### FOBSIZE: ###
The meanings of the fields are the same as for the description of the TYPE 4 output format.
Output for TYPE 7 - RSO spoolout jobs
TSN: @@@@ TYPE: 7 @@@ NOW: YYYY-MM-DD.HHMMSS PNAME: @@@@@@@@ PRI: ### FAMILY: #### USERID: @@@@@@@@ FORM: @@@@@@@@ SIZE/PR: ######@/######@ DEVICE: @@@@@@@@ CLASS: #### COPIES: ### RTSN: @@@@ PVS: @@@@ DIA: @@ DEST: @@@@@@@@ CONTROL: @@@@ FILE: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ MONJV: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ ERMSG: @@@@ ERCOD: @@@@@@@@
DEST | RSO device name or RSO device pool name |
ERMSG | Error message number (display with HELP-MSG-INFORMATION) |
ERCOD | (BCAM) error code |
For the meanings of the other fields, see the TYPE 4/TYPE 5 output formats.
Output in S variable
For compatibility reasons, the command always creates all S variables. The INFORMATION operand of the command determines which of these S-variables are supplied with a value. 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 = *ALL (see also below) | * |
INFORMATION = *STD | 1 |
INFORMATION = *ENVIRONMENT | 2 |
INFORMATION = *PROGRAM | 3 |
INFORMATION = *SYSTEM | 4 |
INFORMATION = *JOB | 5 |
INFORMATION = *REPEAT | 6 |
INFORMATION = *BY-CALENDAR | 7 |
In earlier versions the S variables were supplied with values for all job types when INFORMATION=*ALL. For reasons of compatibility these outputs are retained and marked with *: T... in the table. There are the following job types for T...:
T1 | Waiting jobs |
T2 | Active batch jobs |
T3 | Active interactive jobs |
T4 | Waiting spoolout jobs |
T5 | Active spoolout jobs |
T7 | RSO spoolout jobs |
With all other values for INFORMATION the variables are only output for jobs of the types T1 to T3 which run on the local system. INF=*ALL must be used for jobs on remote systems. The corresponding SPOOL commands must be used for print jobs.
Output information | Name of the S variable | T | Contents | Condition |
|---|---|---|---|---|
Account number the job is charged to | var(*LIST).ACCOUNT | S | ’’ | *: T1/T2/T3, |
Name of the calendar file in which the symbolic date is defined (see SYMBOLIC-DATE) | var(*LIST).CALENDAR-NAME | S | ’’ | *: T1/T2 |
Name of the last command processing by the task | var(*LIST).CMD | S | ’’ | *: T2/T3, |
Copy of the input file; begins with S.IN (ENTER file) or with S.E (procedure file) | var(*LIST).CMD-FILE | S | ’’ | *: T1/T2 |
Maximum permitted CPU time for the job | var(*LIST).CPU-LIM | S | ’’ | *: T1/T2/T3 |
Maximum amount of CPU time available for this job | var(*LIST).CPU-LIMIT | I | 0 | *: T1/T2/T3 |
CPU time the job has used so far | var(*LIST).CPU-USED | S | ’’ | *: T2/T3 |
CPU time already used by the task in long form | var(*LIST).CPU-USED-LONG | S | ’’ | *: T2/T3 |
Name of the output device: PR identifies central printer | var(*LIST).DEVICE-NAME | S | ’’ | *: T4/T5/T7 |
Member name if the program was loaded from a library | var(*LIST).ELEM-NAME | S | ’’ | *: T2/T3 |
Member type if the program was loaded from a library | var(*LIST).ELEM-TYPE | S | ’’ | *: T2/T3 |
Member version if the program was loaded from a library | var(*LIST).ELEM-VERSION | S | ’’ | *: T2/T3 |
Name of the original ENTER file | var(*LIST).ENT-FILE | S | ’’ | *: T1/T2 |
Name of the file to be printed | var(*LIST).F-NAME | S | ’’ | *: T4/T5/T7 |
Number of files specified in the same PRINT-DOCUMENT command (with “normal” printout = 1) | var(*LIST).FAMILY | I | 0 | *: T4/T5/T7 |
Name of the file containing the load module | var(*LIST).FILE-NAME | S | ’’ | *: T2/T3 |
Flush the batch job from the job queue if it has not been processed by the end of the session | var(*LIST).FLUSH-AF-SHUTD | S | ’’ | *: T1/T2, |
Name of the form used for printing | var(*LIST).FORM-NAME | S | ’’ | *: T4/T5/T7 |
Time (hhmm) at which the job is set to the “HOLD”state | var(*LIST).HOLD-TIME | S | ’’ | *: T2, 2 |
Name of the job class the job belongs to | var(*LIST).JOB-CLASS | S | ’’ | *: T1/T2/T3, |
Number of job repetitions | var(*LIST).JOB-COUNT | I | 0 | |
Job priority | var(*LIST).JOB-PRIO | I | 0 | *: T1/T2, |
Job type (1,2 3,4,5,7) | var(*LIST).JOB-TYPE | I | 0 | *: all types |
Maximum life of a calendar job | var(*LIST).LIMIT | S | 0 | *: T1/T2 |
Date for termination of a calendar job | var(*LIST).LIMIT-DATE | S | ’’ | *: T1/T2 |
Time for termination of a calendar job | var(*LIST).LIMIT-TIME | S | ’’ | *: T1/T2 |
Logon date | var(*LIST).LOGON-DATE | S | ’’ | *: T2/T3, |
Time of logon | var(*LIST).LOGON-TIME | S | ’’ | *: T2/T3, |
Length of time logged on | var(*LIST).LOGON-TIME-NORM | S | ’’ | *: T2/T3, |
Name of a monitoring job variable | var(*LIST).MONJV-NAME | S | ’’ | *: T1/T2/T3 |
Job name | var(*LIST).NAME | S | ’’ | |
Original name of the processor via which the station is addressed | var(*LIST).ORIG-PROC-NAME | S | ’’ | 2 |
Original name of the station | var(*LIST).ORIG-STATION | S | ’’ | 2 |
User ID for personal logon (see "Notes on the PERS-ID and PRINCIPAL output information") | var(*LIST).PERSONAL-ID | S | ’’ | *: T1/T2/T3 |
Principal name of the Kerberos identification in the case of interactive logon | var(*LIST).PRINCIPAL | S | ’’ | *: T3 |
Size of the SPOOLOUT job | var(*LIST).PRINT-SIZE | I | 0 | *: T5/T7 |
For dialog jobs (T3) contains the BCAM name of the dialog terminal at which the job was started | var(*LIST).PROC-NAME | S | ’’ | *: T3, |
Name of the program file | var(*LIST).PROG-FILE | S | ’’ | *: T2/T3, |
Name of the loaded program | var(*LIST).PROG-NAME | S | ’’ | *: T2/T3, |
Size of the program (in 4K blocks) | var(*LIST).PROG-SIZE | I | 0 | *: T2/T3, |
Only for PUBSET-STATE=QUIET: pubset concerned | var(*LIST).PUBSET | S | ’’ | *: T2, |
Shows whether the task is waiting for access to a pubset in QUIET status to be possible again | var(*LIST).PUBSET-STATE | S | ’’ | *: T2, |
Number of the job queue | var(*LIST).QUEUE | S | ’’ | *: T2/T3, |
Job repeat information | var(*LIST).REP | I | 0 | *: T4/T5/T7 |
Indicates when job repetition is to start | var(*LIST).REP-JOB | S | ’’ | *: T1/T2, |
Job repeat counter | var(*LIST).REP-JOB-COUNT | I | 0 | *: T1/T2, |
Starting date of job repetition | var(*LIST).REP-JOB-DATE | S | ’’ | *: T1/T2, |
Starting time for job repetition | var(*LIST).REP-JOB-START | S | ’’ | *: T1/T2 |
Starting time of job repetition | var(*LIST).REP-JOB-TIME | S | ’’ | *: T1/T2, |
TSN of the repeat job | var(*LIST).REP-JOB-TSN | S | ’’ | *: T1/T2, |
Rerun the batch job in the next session | var(*LIST).RERUN-AF-CRASH | S | ’’ | *: T1/T2, |
Run priority of the job | var(*LIST).RUN-PRIO | I | 0 | *: all types |
Scheduling time of the calendar job | var(*LIST).SCHEDULING-TIME | S | ’’ | *: T1/T2 |
Name of the spoolout class | var(*LIST).SP-CL | S | ’’ | *: T4/T5/T7 |
Number of lines, records or PAM pages already output | var(*LIST).SP-SIZE | I | 0 | *: T4/T5/T7 |
Starting time of the Spoolin job | var(*LIST).SP-TIME | S | ’’ | *: T1/T2 |
TSN of the job which creates the spoolout job (corresponds to the output field RTSN) | var(*LIST).SP-TSN | S | ’’ | *: T4/T5/T7 |
Spoolin date | var(*LIST).SPOOLIN-DATE | S | ’’ | *: T1/T2, |
Spoolin time | var(*LIST).SPOOLIN-TIME | S | ’’ | *: T1/T2, |
Time when the job is to be started: | var(*LIST).START | S | ’’ | *: T1/T2, |
Starting date of the job (see START variable) | var(*LIST).START-DATE | S | ’’ | *: T1/T2, |
Start job immediately | var(*LIST).START-IMMED | S | TRUE | *: T1/T2, |
Starting time of the job | var(*LIST).START-TIME | S | ’’ | *: T1/T2, |
Name of the station (for local printer: device mnemonic); name from the application or BCAM name | var(*LIST).STATION | S | ’’ | *: T3, |
Additional information on job type | var(*LIST).SUB-TYPE | S | ’’ | *: all types |
Symbolic date which determines the starting time of the calendar job | var(*LIST).SYMBOLIC-DATE | S | ’’ | *: T1/T2, |
Task ID of the task associated with the job | var(*LIST).TID | S | ’’ | *: T2/T3, |
Current date and time (for command input) | var(*LIST).TIME | S | ’’ | *: all types |
Job number | var(*LIST).TSN | S | <alphan.-name 4..4> | |
Pend or unpend code of the task/task queue | var(*LIST).UNPEND-CODE | S | ’’ | *: T2/T3, |
User ID under which the job was started | var(*LIST).USER-ID | S | <name 1..8> |