HP 3000 Manuals HP 3000 Manuals
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
Commands None
Manuals Process Management Programmer's Guide (32650-90023)