ABORTSESS
MPE documents | |
 Complete PDF | |
| Table of Contents | |
| Index | |
| Edition 7 E0701 ♥ | |
| Edition 7 E0300 | |
| Edition 6 E0195 |
Syntax
I16V I32V I16A
ABORTSESS (jsid, jsnum, jsstatus);
Parameters
- jsid
16-bit signed integer by value (required)
Indicates whether the jsnum parameter refers to a job number or a session number:
Value Meaning 1 Session number 2 Job number Because jobs and sessions can have identical numbers, the jsid parameter is required to indicate whether jsnum describes a job or a session.
- jsnum
32-bit signed integer by value (required)
Passes the job or session number of the job/session to be aborted.
- jsstatus
16-bit signed integer array (required)
Returns a two-element array containing status information. The second element is reserved for the operating system. The first element returns one of the following status values:
Value Meaning 0 Successful 1 Jobsecurity set to high, or job/session not yours 2 Job/session does not exist 3 Job/session being introduced and cannot be aborted when in the INTRO state
Operation Notes
All resources held by the aborted job/session are released, and any I/O activity is terminated. Although the job/session is abnormally terminated, the operating system issues log records and updates CPU and connect times. The following message is displayed on the job/session list device:
SESSION ABORTED BY SYSTEM MANAGEMENTABORTSESS can be applied to waiting or scheduled jobs, or executing jobs or sessions. If the spooler input file ($STDIN) for a batch job has been created and has not yet been opened, the entire file is deleted. If ABORTSESS is issued before the output spoolfile is complete, only that portion of the file already opened is printed and an error message is issued indicating that the job was aborted. ABORTSESS can be successfully called only if the program is executing in a job/session that satisfies at least one of the following conditions:
The job/session is on the system console.
The job/session was allowed the ABORTJOB command.
JOBSECURITY is set to LOW and the user and account names of the job/session are the same as the user and account names of the job/session being aborted.
JOBSECURITY is set to LOW and the job/session has account manager (AM) capability, and the account name of the job/session is the same as the account name of the job/session being aborted.
JOBSECURITY is set to LOW and the job/session has system manager (SM) capability.
Related Information
| Intrinsics | STARTSESS |
| Manuals | Process Management Programmer's Guide |
|
Chapter 4 Command Definitions (ABORTSESS - FCLOSE) |
ACTIVATE |