Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-163
STEPMOM Procedure
(Superseded by PROCESS_SETINFO_ Procedure )
Parameters
process-id input
INT:ref:4
is a 4-word array containing the process ID of an already executing process, for
which the calling process wants to receive the process deletion message.
The process ID is a 4-word array, where:
[0:2] Process name or creation timestamp
[3].<0:3> Reserved
.<4:7> Processor number where the process is executing
.<8:15> PIN assigned by the operating system to identify the process
in the processor
Condition Code Settings
< (CCL) indicates that STEPMOM failed, or that no process designated process-
id exists.
= (CCE) indicates that the caller is now the creator (mom) of
process-id.
> (CCG) is not returned from STEPMOM.
Considerations
•
Process access ID and the caller of STEPMOM
If STEPMOM is called from a Guardian process, the caller must either have the
same process access ID as the process it is attempting to adopt, be the group
manager of the process access ID, or be the super ID. See the description under
“Considerations” of procedure PROCESSACCESSID and to the
Guardian User’s
Guide for a description of the process access ID.
•
OSS security
If STEPMOM is called from an OSS process, the security rules that apply to calling
STEPMOM are the same as those that apply to calling the OSS
kill() function.
See the reference pages either online or in the
Open System Services System
Calls Reference Manual for details.
•
Why STEPMOM should not be called for a process pair
A process should not call STEPMOM for either member of a process pair.
Adoption of a process pair by a third process causes errors and interferes with
operation, because the operation depends upon each member of the process pair
being the mom of the other.
•
Adopting a single named process is not recommended