Guardian Procedure Calls Reference Manual

Considerations
• When PROCESS_STOP_ executes, all open files associated with the deleted process are
closed. If a process had BREAK enabled, BREAK is disabled.
• Recipients of process deletion system messages
When a process is stopped, these processes receive a process deletion system message:
◦ The mom of the stopped process (if any)
◦ The ancestor of the stopped process if the stopped process is a single named process or
part of a named process pair where both members of the pair are stopped (only one
message is received when both members of a named process pair are stopped)
◦ The job ancestor (GMOM) of the stopped process if the stopped process is part of a
batch job
If the caller of PROCESS_STOP_ is also the mom, ancestor, or job ancestor of the process
being terminated, it receives a process deletion system message.
• Recipients of OSS process termination status
If the stopped process was an OSS process, then its 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 interpreting the OSS process termination status.
• Differences between ABEND and STOP options
When used to stop the calling process, the ABEND and STOP options (options.<15>)
operate almost identically; they differ in the system messages that are sent and the default
completion codes that are reported. In addition, PROCESS_STOP_ with the ABEND option
specified causes a saveabend file to be created if the process' SAVEABEND attribute is set
to ON. See the Inspect Manual for information about saveabend files.
For the exact formats of the process deletion system messages, see the Guardian Procedure
Errors and Messages Manual. Note that PROCESS_STOP_ can send either a C-format message
or a D-format message, depending on the recipient. (A process can specify, when it opens
$RECEIVE, that it wants to receive either C-format messages or D-format messages. For details,
see the FILE_OPEN_ Procedure (page 457).)
PROCESS_STOP_ sends a default completion code of 0 when the STOP option is specified;
it sends a completion code of 5 when the ABEND option is specified.
• Rules for stopping a Guardian process: process access IDs and creator access IDs
If the process is a local process and the request to stop it is also from a local process,
these user IDs or associated processes can stop the process:
◦
– local super ID
– the process' creator access ID (CAID) or the group manager of the CAID
– the process' process access ID (PAID) or the group manager of the PAID
◦ If the process is a local process, a remote process cannot stop it.
1124 Guardian Procedure Calls (P)