Identify error handling (spin-off) section
Component: | SYSFILE |
Functional area: | File processing |
Domain: | JOB |
Privileges: | STD-PROCESSING |
Function
With the SET-JOB-STEP command, users can subdivide a procedure or an ENTER file into sections.
Processing branches to SET-JOB-STEP when spin-off is initiated in a procedure or a batch job (see “Spin-off mechanism” below). The command
clears job switches 16 through 31 (value *OFF),
resets compiler options set using the ISP PARAMETER command to their default values.
This command may be used only in procedures and ENTER files; it is ignored in interactive mode and consequently not offered in the menu.
If SET-JOB-STEP is issued while a program is loaded, an error message appears.
Spin-off mechanism
If an invalid command is encountered during procedure execution, the following responses are possible:
the invalid command is ignored and processing continues with the next command;
the invalid command is rejected but processing ignores the following commands, with the exception of the following commands:
EXIT-JOB, CANCEL-PROCEDURE, END-PROCEDURE, EXIT-PROCEDURE, LOGOFF, SET-JOB-STEP.
This mechanism is called spin-off.
The EXIT-JOB and LOGOFF commands terminate the job, while the CANCEL-PROCEDURE command terminates the procedure. The END-PROCEDURE and EXIT-PROCEDURE commands cause the system to branch to the last procedure level exited, but without switching off the SPIN-OFF mechanism.
The SET-JOB-STEP command switches off the spin-off mechanism and the procedure continues normally with the next command in the sequence.
Spin-off is initiated in the following cases:
syntax errors; this applies to all commands
content errors; this does not apply to all commands.
Format
SET-JOB-STEP | Alias: STJSP |
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed | |
32 | EXC0041 | System error | |
130 | CMD2282 | Command not possible because a program is loaded |