Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-164
STEPMOM Procedure
(Superseded by PROCESS_SETINFO_ Procedure )
If a single named process is adopted, the caller becomes both the mom and the
ancestor and will receive two process termination messages when the process
dies.
•
STEPMOM and high-PIN processes
You cannot use STEPMOM to adopt a high-PIN process because a high PIN
cannot fit into
process-id.
Figure 14-1
illustrates the effect of STEPMOM.
Messages
•
Process deletion (STOP) message
The caller of STEPMOM receives the process deletion (STOP) system message if
the
process-id is being deleted normally because of a call to STOP.
•
Process deletion (ABEND) message
The caller of STEPMOM receives the process deletion (ABEND) system message
if the
process-id is being deleted abnormally because of a call to ABEND, or
because the process encountered a trap condition or received a process-
terminating signal and is being deleted by the operating system.
OSS Considerations
If STEPMOM is used to set the mom of an OSS process, the new mom receives the
Guardian process deletion message when the OSS process terminates. The message
indicates that the terminated process was an OSS process and contains the OSS
process ID; otherwise, the message is the same as one received for a terminating
Guardian process.
If the OSS process successfully executes one of the OSS
exec or tdm_exec set of
functions, a Guardian process deletion message is sent to the mom. Although the
process is still alive in the OSS environment (the OSS process ID still exists), the
process handle no longer exists, so the process has terminated in the Guardian
environment.
The OSS parent process (which is not necessarily the same process as the mom
process) also receives OSS process termination status if the OSS process ID no
longer exists. The order of delivery of the OSS process termination status and the
Guardian process deletion message is not guaranteed.
See the
Guardian Procedure Errors and Messages Manual for the format of the
Guardian process deletion message. 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.