Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-169
STOP Procedure
(Superseded by PROCESS_STOP_ Procedure )
length input
INT:value
is the text length in bytes. Maximum is 80 bytes.
text input
STRING .EXT:ref:
length
is an optional string of ASCII text to be sent in the STOP system message.
Condition Code Settings
A condition code value is returned only when a process is calling STOP on another
process and that other process could not be stopped.
< (CCL) the
process-id parameter is invalid, or an error occurred while stopping
the process.
= (CCE) indicates that the STOP was successful.
> (CCG) does not return from STOP.
Considerations
•
Differences between STOP and ABEND procedures
When used to stop the calling process, the ABEND and STOP procedures operate
almost identically; they differ in the system messages that are sent and the default
completion codes that are reported. In addition, ABEND, but not STOP, 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.
•
Creator of the process and the caller of STOP
If the caller of STOP is also the creator of the process being deleted, the caller
receives the STOP system message.
•
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, the following user IDs or associated processes may stop the process:
•
local super ID
•
the process’s creator access ID (CAID) or the group manager of the CAID
•
the process’s process access ID (PAID) or the group manager of the PAID
If the process is a local process, a remote process cannot stop it.