Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (A-B)
Guardian Procedure Calls Reference Manual—522629-013
2-7
ABEND Procedure
(Superseded by PROCESS_STOP_ Procedure )
•
If a process calls ABEND on another process, the system supplies a
completion code value of 6.
•
If a process calls ABEND on itself but does not supply a completion code, the
system supplies a completion code value of 5.
Refer to Appendix C, Completion Codes
for a list of the completion codes.
•
Deleting high-PIN processes
ABEND cannot be used to delete a high-PIN unnamed process, but it can use it to
delete a high-PIN named process or process pair.
A high-PIN caller (named or unnamed) can delete itself by omitting
process-id.
NetBatch Considerations
•
The ABEND procedure supports NetBatch by:
•
Returning the completion code information in the ABEND system message.
•
Returning the process processor time in the ABEND system message
•
Sending an ABEND system message to the ancestor of a job (the GMOM) as
well as the ancestor of a process
Messages
•
Process deletion (ABEND) message
The creator of the stopped process is sent a system message -6 (process deletion:
ABEND) indicating that the deletion occurred. See the
Guardian Procedure Errors
and Messages Manual for the format of the interprocess system messages.
OSS Considerations
•
When an OSS process is stopped by the ABEND procedure, either by calling the
procedure to stop itself or when some other process calls the procedure, the OSS
parent process receives a
SIGCHLD signal and the OSS process termination
status. See the
wait(2) function reference page either online or in the Open
System Services System Calls Reference Manual for details on the OSS process
termination status.
In addition, an ABEND system message is sent to the MOM, GMOM, or ancestor
process according to the usual Guardian rules.
•
When the ABEND procedure is used to terminate an OSS process other than the
caller, the Guardian process ID must be specified in the call. The effect is the same
as if the OSS
kill() function was called with the input parameters as follows:
•
The signal parameter set to SIGABEND