Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-200
PROCESS_STOP_ Procedure
receive either C-format messages or D-format messages. Refer to the description
of the FILE_OPEN_ procedure for details.)
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, the following user IDs or associated processes can 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.
If the process is a remote process running on the local system and the request to
stop it is from a local process, the following user IDs or associated processes can
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 remote process on the local system and the request to stop it is
from a remote process, the following user IDs or associated processes can stop
the process:
•
a network super ID
•
the process’s network process access ID
•
the process’s network process access ID group manager
•
the process’s network creator access ID
•
the process’s network creator access ID group manager
Being local on a system means either that the process has logged on by
successfully calling USER_AUTHENTICATE_ (or VERIFYUSER) on the system or
that the process was created by a process that had done so. A process is also
considered local if it is run from a program file that has the PROGID attribute set.
•
Rules for stopping an OSS process
The same rules apply when stopping an OSS process with the PROCESS_STOP_
procedure as apply for the OSS
kill() function. See the kill(2) function