Terminate current job
Component: | BS2000 |
Functional area: | Job processing |
Domain: | JOB |
Privileges: | all privileges |
Routing code: | @ (only with NBCONOPI=Y) |
Function
The EXIT-JOB command terminates the current job. The virtual memory pages and devices occupied by the job are subsequently released and the system output files are readied for output.
If new file generations have been created during the job, the system outputs the names of the file generations concerned, their base values, and the names of the first and current file generations.
Notes on Operator LOGON
If the “Operator LOGON” function is used (incompatible mode; system parameter NBCONOPI=Y), the EXIT-JOB command can also be issued on a physical operator terminal (console) or from an authorized user program with dynamic authorization names, but operands are not allowed in either case.
On a physical operator terminal the EXIT-JOB command revokes the authorization to enter commands; with an authorized user program it results in disconnection.
In both cases EXIT-JOB also implies the RELEASE-OPERATOR-ROLE command with OPERATOR-ROLE=*ALL, which means that all routing codes are relinquished and message subscription/suppression is canceled.
Operator activities on a physical operator terminal cannot be resumed until authentication has been carried out again using SET-LOGON-PARAMETERS under a user ID with the OPERATING privilege.
Format
EXIT-JOB | ||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||
Operands
MODE =
Specifies whether the job is to be terminated normally or abnormally.
MODE = *NORMAL
The job is terminated normally. The status indicator of a monitoring job variable is set to ‘$T’.
MODE = *ABNORMAL
The job is terminated abnormally. The status indicator of a monitoring job variable is set to ‘$A’. Whether a dump is taken depends on the test options defined within the task (see MODIFY-TEST-OPTIONS command, DUMP operand).
SYSTEM-OUTPUT =
Controls output of the system files SYSLST and SYSOPT, and for batch jobs also output of the system file SYSOUT. Empty system files are not output.
SYSTEM-OUTPUT = *ALL
The system files SYSLST and SYSOUT are output to printer (see *PRINTER) or transferred by email (see *MAIL) depending on the settings of the system parameter SSMOUT.
SYSTEM-OUTPUT = *NONE
Output of the system files is suppressed.
SYSTEM-OUTPUT = *STDOUT
Depending on the setting of the system parameter SSMOUT, the system files SYSLST and SYSOUT are output to printer (see *PRINTER) or sent by email (see *MAIL).
SYSTEM-OUTPUT = *PARAMETERS(...)
Controls which of the two system files (SYSLST or SYSOUT) is output.
SYSLST-OUTPUT = *NONE
SYSLST is not output.
SYSLST-OUTPUT = *PRINTER
The system file SYSLST is to be output to printer. However, the output can be suppressed by systems support using the system parameters SSMLOGF1 and SSMLGOF2. The following applies:
SSMLGOF1=NO-SPOOL
In batch jobs output is suppressed.
In interactive jobs the output is suppressed if SSMLGOF2=NO. Output takes place when SSMLGOF2=SPOOL and the SPOOL subsystem is available. In all other cases an inquiry is displayed on the terminal.SSMLOGF1=REQ-SPOOL
Output is to printer. If SPOOL is not available, the job waits and the status in a job-monitoring MONJV remains $R. Only when SPOOL is available and printout can take place does the job terminate.SSMLOGF1=STA-SPOOL
Printout takes place if SPOOL is available, otherwise it is suppressed.
SYSLST-OUTPUT = *MAIL
SYSLST is sent by email. The receiver address(es) is/are taken over from the user entry of the job’s user ID. How the receiver address is selected from an address list in accordance with the job name is described under the MAIL-FILE command. The SYSLST system file will have a ".TXT" extension.
If transfer by email is not possible (e.g. no email address in the user ID), output takes place in accordance with SYSLST-OUTPUT=*PRINTER.
SYSLST-OUTPUT = *STDOUT
Depending on the setting of the system parameter SSMOUT, the system file SYSLST is output to printer (see *PRINT) or sent by email (see *MAIL).
SYSOUT-OUTPUT = *NONE
SYSOUT is not output.
SYSOUT-OUTPUT = *PRINTER
The system file SYSOUT is to be output to printer. However, the output can be suppressed by systems support (see SYSLST-OUTPUT=*PRINTER).
SYSOUT-OUTPUT = *MAIL
SYSOUT is sent by email. The receiver address(es) is/are taken over from the user entry of the job’s user ID. How the receiver address is selected from an address list in accordance with the job name is described under the MAIL-FILE command. The SYSLST system file will have a ".TXT" extension.
If transfer by email is not possible (e.g. no email address in the user ID), output takes place to printer.
SYSOUT-OUTPUT = *STDOUT
Depending on the setting of the system parameter SSMOUT, the system file SYSOUT is output according to SYSOUT-OUTPUT=*PRINTER.
KEEP-CONNECTION =
Specifies whether the processor connection is to be retained, enabling a new job to be started immediately.
This operand is permitted only in interactive mode; it is ignored in batch mode.
KEEP-CONNECTION = *NO
Clears down the processor connection.
KEEP-CONNECTION = *YES
Retains the processor connection. A new job can be started immediately.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed 1) | |
1 | CMD0202 | Syntax error | |
32 | CMD0221 | System error; no message is sent to SYSOUT |
1) | Cannot be evaluated since in this case the task is terminated! |
Note
If an EXIT-JOB command is issued while a program is loaded, an ABEND-STXIT routine (if defined) will be activated. This does not happen if the EXIT-JOB command is called via the CMD macro (see the “Executive Macros” manual [22]).
Examples
Example 1: Abnormal job termination and test option DUMP=*STD
/mod-test-opt dump=*std
/exit-job mode=*abnormal,keep-conn=*yes
% IDA0N51 PROGRAM INTERRUPT AT LOCATION '00000000 (NONAME), (CDUMP), EC=50' % IDA0N45 DUMP DESIRED? REPLY (Y=USER-/AREADUMP TO DISK; Y,<VOLUMETYPE>=USER-/AREADUMP TO TAPE; Y,SYSTEM=SYSTEMDUMP; N=NO)?n % EXC0419 /LOGOFF AT 1621 ON 17-11-26 FOR TSN '9VKP' % EXC0421 CPU TIME USED: 0.2166 % JMS0150 INSTALLATION ' S210-40', BS2000 VERSION 'V200', HOST 'D016ZE07': PLEASE ENTER '/SET-LOGON-PARAMETERS' OR '?'
Example 2: Abnormal job termination and test option DUMP=*YES
/mod-test-opt dump=*yes
/exit-job mode=*abnormal,keep-connection=*yes
% IDA0N51 PROGRAM INTERRUPT AT LOCATION '00000000 (NONAME), (CDUMP), EC=50' % IDA0N53 DUMP BEING PROCESSED. PLEASE HOLD ON % IDA0N54 'USERDUMP' WRITTEN TO FILE '$USER1.DUMP.9VKP.00001' % IDA0N55 TITLE: 'TSN-9VKP UID-USER1 AC#-89001 USERDUMP PC-00000000 EC- 50 VERS-150 DUMP-TIME 16:21:26 17-11-26' % EXC0419 /LOGOFF AT 1621 ON 17-11-26 FOR TSN '9VKP' % EXC0421 CPU TIME USED: 0.2166 % JMS0150 INSTALLATION ' S210-40', BS2000 VERSION 'V200', HOST 'D016ZE07': PLEASE ENTER '/SET-LOGON-PARAMETERS' OR '?'