Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-199
PROCESS_STOP_ Procedure
text:length input:input
STRING .EXT:ref:*, INT:value
if present and
length is not 0, is a string of ASCII text to be sent as part of the
process deletion system message. If used, the value of
text must be exactly
length bytes long. The maximum length is 80 bytes.
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, the following 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.
Refer to the
wait(2) function reference pages 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’s SAVEABEND attribute is set to ON. See the
Inspect
Manual for information about saveabend files.
Refer to the
Guardian Procedure Errors and Messages Manual for the exact
formats of the process deletion system messages. 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