Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-36
PROCESS_ACTIVATE_ Procedure
processhandle input
INT .EXT:ref:10
is a process handle that specifies the process to be activated:
•
To activate a single process, specify the process handle of that process.
•
To activate a process pair, specify the process handle of either the primary or
backup process.
specifier input
INT:value
for a named process pair, indicates whether both members should be activated.
Valid values are:
0 Activate the specified process.
1 Activate both members of current instance of named process pair if the
specified process is part of a named process pair; otherwise, activate the
specified process.
If this parameter is omitted, 0 is used.
Considerations
•
Procedure use
You can use PROCESS_ACTIVATE_ to activate any suspended process or
process pair, even if it was suspended by a call to SUSPENDPROCESS.
•
Security
When PROCESS_ACTIVATE_ is called on a Guardian process, the caller must be
the super ID, the group manager of the process access ID, or a process with the
same process access ID as the process or process pair being activated. For
information about the process access ID, refer to the description under
“Considerations” for the PROCESS_GETINFO_ procedure and the
Guardian
User’s Guide.
The caller must be local to the same system as the specified process. A process
is considered to be local to the system on which its creator is local. A process is
considered to be remote, even if it is running on the local system, if its creator is
remote. (In the same manner, a process running on the local system whose
creator is also running on the local system might still be considered remote
because it’s creator’s creator is remote.)
A remote process running on the local system can become a local process by
successfully logging on to the local system with a call to the
USER_AUTHENTICATE_ (or VERIFYUSER) procedure. After a process logs on
to the local system, any processes that it creates are considered local.