Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-172
STOP Procedure
(Superseded by PROCESS_STOP_ Procedure )
OSS Considerations
•
When an OSS process is stopped by the STOP 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, a STOP system message is sent to the mom, GMOM, or ancestor
process according to the usual Guardian rules.
•
When the STOP procedure is used to stop 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 SIGKILL
•
The pid parameter set to the OSS process ID of the process identified by
process-id in the STOP call
•
The security rules that apply to stopping an OSS process using STOP are the
same as those that apply to the OSS
kill() function. See the kill(2) function
reference page either online or in the
Open System Services System Calls
Reference Manual for details.
Examples
CALL STOP; ! stop me.
CALL STOP ( ProcID ); ! stop the process that has
! this process ID.
Related Programming Manual
For programming information on batch processing, see the NetBatch User’s Guide.