Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-202
PROCESS_STOP_ Procedure
•
If a process calls PROCESS_STOP_ on another process, the system supplies
a completion code value of 6.
•
If a process calls PROCESS_STOP_ with the STOP option on itself but does
not supply a completion code, the system supplies a completion code value of
0.
•
If a process calls PROCESS_STOP_ with the ABEND option 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 completion codes.
NetBatch Considerations
•
The PROCESS_STOP_ procedure supports NetBatch by:
•
returning the completion code information in the process deletion system
message
•
returning the process processor time in the process deletion system message
•
sending a process deletion system message to the job ancestor (GMOM) of
the job, as well as to the mom and ancestor of the process, when any process
in the job is terminated
Safeguard Considerations
For information on processes protected by Safeguard, refer to the Safeguard
Reference Manual.
OSS Considerations
•
When an OSS process is stopped by the PROCESS_STOP_ procedure, either by
calling the procedure to stop itself or when some other process calls the
procedure, the OSS caller 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, a process deletion system message is sent to the MOM, GMOM, or
ancestor process according to the usual Guardian rules. The OSS process ID of
the terminated process is included in the process deletion message.
•
When the PROCESS_STOP_ procedure is used to stop an OSS process other
than the caller, the process handle 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 SIGKILL to stop the process or SIGABEND to
abend the process