Modify parameters for logging a job
Component: | BS2000 |
Functional area: | Job processing |
Domain: | JOB |
Privileges: | STD-PROCESSING |
Function
The MODIFY-JOB-OPTIONS command controls the following for the user’s own job:
the form in which system messages are output (INFORMATION-LEVEL operand).
the output of console messages (OPERATOR-INTERACTION operand).
the maximum number of output records in SYSLST (SYSLST-LIMIT operand).
the logging of the current job (LOGGING operand).
The SHOW-JOB-OPTIONS command lists the current settings.
Privileged functions
The privileged user (TSOS privilege) can change job monitoring for an ongoing job, i.e. start or stop job monitoring or assign another job variable for job monitoring (JOB-IDENTIFICATION and MONJV operands).
Format
MODIFY-JOB-OPTIONS | Alias: MDJO | ||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
INFORMATION-LEVEL =
Format in which system messages are output.
INFORMATION-LEVEL = *UNCHANGED
The value last defined in a MODIFY-JOB-OPTIONS command in the course of the current job applies (current assignment). If no value has been defined, *MEDIUM applies.
INFORMATION-LEVEL = *STD
Equivalent to specifying *MEDIUM.
INFORMATION-LEVEL = *MEDIUM
System messages are output in abbreviated form.
INFORMATION-LEVEL = *MINIMUM
System messages are output in coded form.
OPERATOR-INTERACTION =
Specifies whether console messages caused by its own task and operator responses are to be output. Operator commands for controlling the current job (e.g. a change in priority), as well as general warning and error messages for the operator are not considered here.
OPERATOR-INTERACTION = *UNCHANGED
The value last defined in a MODIFY-JOB-OPTIONS command in the course of the current job applies (current assignment). If a value is not yet defined, *NO applies.
OPERATOR-INTERACTION = *STD / *NO
No console messages or operator responses are output.
OPERATOR-INTERACTION = *YES
If possible, console messages or operator responses are output. In interactive mode, however, this cannot be guaranteed, since console messages may also be created asynchronously at times where the data display terminal is not ready to output.
SYSLST-LIMIT =
Maximum number of records that may be spooled out to SYSLST and SYSOUT during the currently executing job.
The records are counted separately for SYSOUT and SYSLST respectively. In interactive mode, output records on SYSOUT are only counted if the output is (also) written to a file. In the case of SYSLST, SYSOUT records are not taken into account, even if the setting LISTING=*YES has been made to ensure that they are also written to SYSLST.
This specification must not exceed the limit specified in the job class definition (this limit can be checked with the SHOW-JOB-CLASS command).
In batch mode, if the specified value is reached during logging, the job is terminated abnormally. In interactive mode, the system asks whether the job is to be ended or continued; if the job is continued, the counter is set to zero and the specified value again applies.
SYSLST-LIMIT = *UNCHANGED
The value last defined in the course of the current job applies (defined when the job was started or last set with the MODIFY-JOB-OPTIONS command).
SYSLST-LIMIT = *STD
The value specified in the job class definition applies.
SYSLST-LIMIT = *NO-LIMIT
Unlimited number of records that may be spooled out to SYSLST and SYSOUT during the currently executing job.
If there is a lower value specified in the job class definition, *NO-LIMIT is rejected.
SYSLST-LIMIT = <integer 0..999999>
Specifies the maximum number of records that can be output to SYSLST and SYSOUT in the course of the current job.
This value must not be above the limit set in the job class definition.
LOGGING = *PARAMETERS(...)
Information on logging of the job run.
LISTING =
Specifies whether the job run is also to be logged on SYSLST.
Console messages and operator responses (OPERATOR-INTERACTION operand) are supplemented with the time of day when logged on SYSLST.
System messages requiring an answer from the user, and the message ABNORMAL PROGRAM TERMINATION, are not logged.
In line mode, logging proceeds by lines, i.e. NL control characters are interpreted.
In format mode (menu), logging takes place continuously, i.e. in the log the format is destroyed, NL control characters are not interpreted.
LISTING = *UNCHANGED
The value last defined in the course of the current job applies (defined when the job was started or last set with the MODIFY-JOB-OPTIONS command).
LISTING = *STD / *NO
The job run is not to be logged on SYSLST.
LISTING = *YES
The job run is also to be logged on SYSLST.
HARDCOPY =
This operand is ignored in batch mode.
Specifies whether the job run is also to be logged on a hardcopy printer. Formats (menus) cannot be logged.
HARDCOPY = *UNCHANGED
The value last defined in the course of the current job applies (defined when the job was started or last set with the MODIFY-JOB-OPTIONS command).
HARDCOPY = *STD / *NO
The job run is not to be logged on a hardcopy printer.
HARDCOPY = *YES
The job run is also to be logged on a hardcopy printer.
JOB-IDENTIFICATION =
This operand is available only to privileged users.
Specifies the job for which job monitoring is to be changed. The job can be identified by means of the TSN or the job variable monitoring it.
JOB-IDENTIFICATION = *OWN
Job monitoring is to be changed for the user’s own task. The settings for INFORMATION-LEVEL, OPERATOR-INTERACTION, SYSLST-LIMIT and LOGGING can only be changed for the user’s own task.
JOB-IDENTIFICATION = *TSN(...)
Identifies the job by means of its TSN.
TSN = <alphanum-name 1..4>
Task sequence number of the required job.
JOB-IDENTIFICATION = *MONJV(...)
Identifies the job by means of its monitoring job variable.
MONJV = <filename 1..54 without-gen-vers>
Name of the job variable which is monitoring the required job. The job must run on the local system.
MONJV = *UNCHANGED / *NO / <filename 1..54 without-gen-vers>
This operand is available only to privileged users.
Specifies whether job monitoring should be changed for the job specified in the operand.
MONJV = *NO
The job is not to be monitored. If it is being monitored, job monitoring is terminated.
MONJV = <filename 1..54 without-gen-vers>
Specifies the job variable which is to monitor the required job. If the job was already being monitored by a job variable, job monitoring is passed on to the new job variable.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed | |
1 | CMD0202 | Syntax error | |
32 | CMD0221 | System error | |
64 | JMS0630 | Semantic error (see SYSOUT message) |
Note
Modifying the MONJV assignment of a foreign task is done solely for job monitoring. The SHOW-JOB-STATUS command provides information about the current job monitoring for a task.
Information which is only visible locally within the task (JV link *SMONJVJ, special job variable $SYSJV.JOB-MONJV) remains unchanged.
Examples
Example 1
/mod-job-opt inf-level=*min,oper-interact=*yes,log=*par(list=*yes)——— (1)
/show-job-opt
% % INFORMATION-LEVEL = MINIMUM OPERATOR-INTERACTION = YES % SYSLST-LIMIT = NO-LIMIT SYSOPT-LIMIT = NO-LIMIT % LOGGING : LISTING = YES HARDCOPY = NO
/xxx
% CMD0186 XXX
/mod-job-opt inf-level=*med ———————————————————————————— (2)
/xxx
% CMD0186 OPERATION NAME 'XXX' UNKNOWN
/mod-job-opt log=*par(list=*no)
———————————————————————————— (3)
(1) | The following specifications are in effect:
|
(2) | The specifications are modified to:
|
(3) | Logging on SYSLST is deactivated. |
Example 2
/mod-job-opt syslst-limit=100
/show-job-opt
% % INFORMATION-LEVEL = MEDIUM OPERATOR-INTERACTION = YES % SYSLST-LIMIT = 100 SYSOPT-LIMIT = NO-LIMIT % LOGGING : LISTING = NO HARDCOPY = NO
/show-file-attr output=*syslst
% SSM2222 SPECIFIED MAXLST LIMIT REACHED. CONTINUE? REPLY (Y=YES; N=NO)?n
GROUP: :2OSG:$USERXY01.MAX.GROUP.2
BASE: 0011 FIRST: 0011 CURRENT: 0013
%(MSG) % % EXC0736 ABNORMAL TASK TERMINATION. ERROR CODE 'SSM2223': /HELP-MSG SSM2223
%(MSG) % % EXC0420 /LOGOFF PROCESSED. CPU TIME USED: 4.2455 SEC, USER ID: USERXY01,
TASK ID: 004C01F3
A limit of 100 records is specified for output to SYSLST. The SHOW-FILE-ATTRIBUTES output is directed to SYSLST, the record limit being reached. Message SSM2222 is answered with N (NO). The task is terminated abnormally.
Example 3
/ass-syslst lst.file ——————————————————————————————————————— (1)
/mod-job-opt syslst-limit=10,log=*par(list=*yes) ——————————— (2)
/show-file-attr alt.lst.,output=*syslst ———————————————————— (3)
% SSM2222 SPECIFIED MAXLST LIMIT REACHED. CONTINUE? REPLY (Y=YES; N=NO)?y % SSM2222 SPECIFIED MAXLST LIMIT REACHED. CONTINUE? REPLY (Y=YES; N=NO)?y % SSM2222 SPECIFIED MAXLST LIMIT REACHED. CONTINUE? REPLY (Y=YES; N=NO)?y %:2OSG: PUBLIC: 12 FILES RES= 462 FRE= 187 REL= 177 PAGES %:2OSG: PUB/S2: 3 FILES RES= 570 FRE= 3 REL= 3 PAGES
/ass-syslst *primary —————————————————————————————————————— (4)
/show-file lst.file —————————————————————————————————————— (5)
(IN) /mod-job-opt syslst-limit=10,log=*par(list=*yes)
(IN) /show-file-attr alt.lst.,output=*syslst
AFILE STATUS
|-----------------------------------------------------------------------------|
| | |
| FILENAME | PAM- | FREE- |
| | PAGES | PAGES |
| | | |
(OUT) % SSM2222 SPECIFIED MAXLST LIMIT REACHED. CONTINUE? REPLY (Y=
(IN) Y
|-----------------------------------------------------------------------------|
| | |
| :2OSG:$USER1.ALT.LST.BIND | 6| 1|
|#:2OSG:$USER1.ALT.LST.CMD | 90| 1|
|#:2OSG:$USER1.ALT.LST.CMDIMPL | 381| 2|
| :2OSG:$USER1.ALT.LST.CMP.040-041 | 30| 16|
| :2OSG:$USER1.ALT.LST.CMP.040-042 | 18| 0|
| | | |
| :2OSG:$USER1.ALT.LST.CMP.040-043 | 21| 1|
| :2OSG:$USER1.ALT.LST.CMP.040-044 | 6| 6|
(OUT) % SSM2222 SPECIFIED MAXLST LIMIT REACHED. CONTINUE? REPLY (Y=
(IN) Y
+ S*SOF+ 1( 1)
|#:2OSG:$USER1.ALT.LST.DOMAIN | 99| 0|
| :2OSG:$USER1.ALT.LST.RECALL | 24| 21|
| :2OSG:$USER1.ALT.LST.SPOOL043 | 6| 6|
| | | |
| :2OSG:$USER1.ALT.LST.START-CMD | 30| 24|
| :2OSG:$USER1.ALT.LST.START-CMD.SYN | 75| 21|
| :2OSG:$USER1.ALT.LST.START-KDO.DOMAIN | 174| 70|
| :2OSG:$USER1.ALT.LST.SYNTAXVERSION | 42| 0|
| :2OSG:$USER1.ALT.LST.SYSSII | 30| 21|
| | | |
(OUT) % SSM2222 SPECIFIED MAXLST LIMIT REACHED. CONTINUE? REPLY (Y=
(IN) Y
|-----------------------------------------------------------------------------|
PUBLIC SPACE: 12 FILES 462
| PUB/S2 SPACE: 3 FILES 570
|-----------------------------------------------------------------------------(OUT)
:2OSG: PUBLIC: 12 FILES RES= 462 FRE= 187 REL=
(NL) :2OSG: PUB/S2: 3 FILES RES= 570 FRE= 3 REL=
(IN) ass-syslst *p
% SHO0301 WARNING: END OF FILE REACHED
- S*SOF+ 24( 1)
(1) | The system file SYSLST is assigned file LST.FILE. |
(2) | Logging to SYSLST is activated and a limit of 10 records specified. |
(3) | Output from SHOW-FILE-ATTRIBUTES for all files starting with ALT.LST. is effected to SYSLST. The record limit is executed three times (message SSM2222 is answered with Y (YES)). |
(4) | The system file SYSLST receives the primary assignment again. |
(5) | The SHOW-FILE command displays the contents of logging file LST.FILE. |