HPlogo 900 Series HP 3000 Computer Systems: MPE/iX Intrinsics Reference Manual > Chapter 4 Command Definitions

ABORTSESS
» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

spacerspacerspacer
spacer
spacer
  		 
 

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:

ValueMeaning
1Session number
2Job 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:

ValueMeaning
0Successful
1Jobsecurity set to high, or job/session not yours
2Job/session does not exist
3Job/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)



Chapter 4 Command Definitions
  		 


ACTIVATE  
Feedback to webmaster