ABORTSESS

NM and CM callable.

Enables a program to abort a specified job or session from the system.

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 MANAGEMENT

ABORTSESS 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

ABORTSESS

Technical documentation

» Table of Contents

» Index

Syntax

Parameters

Operation Notes

Related Information