Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-170
STOP Procedure
(Superseded by PROCESS_STOP_ Procedure )
If the process is a remote process running on this node and the request to stop
it is from a local process on this node, then 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 remote process on this node and the request to stop it is
from a remote process, the following user IDs or associated processes may
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
where network ID implies that the user IDs or associated process creators
have matching remote passwords.
Being local on a system means that the process has logged on by successfully
calling 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 STOP
procedure as apply for the OSS
kill() function. See the kill(2) function
reference page either online or in the
Open System Services System Calls
Reference Manual
.
•
Rules for stopping any process; stop mode
When one process attempts to stop another process, another item checked is
the stopmode of the process. Stopmode is a value associated with every
process that determines which other processes can stop the process. The
stopmode, set by procedure SETSTOP, is defined as follows:
0 ANY other process can stop the process.
1 ONLY the process qualified by the above rules can stop the process.
2 NO other process can stop the process.
•
Returning control to the caller before the process is stopped
When
error is 0, STOP returns control to the caller before the specified process
is actually stopped. Although the process does not execute any more user code,
you should make sure that it has terminated before you attempt to access a file