Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-220
PROCESSHANDLE_TO_CRTPID_ Procedure
process-id output
INT .EXT:ref:4
returns the process ID (CRTPID) of the process designated by
processhandle.
If the process is named and local to the node indicated by
node-number, the
process ID is in local form. In all other cases the process ID is in network form.
pair-flag input
INT:value
specifies whether
process-id should designate a process pair (1 if it should; 0 if
it should not). If
pair-flag is set and the process is named, the cpu and pin
values in
process-id are set to -1 instead of the cpu and pin of the process.
The default is 0.
node-number input
INT(32):value
if present and not -1D, identifies the node with respect to which
process-id is
normalized. If this parameter is omitted or -1D, the caller’s node is used. See the
process-id parameter.
Considerations
•
If the name is longer than four characters (or five characters for local process)
excluding the dollar sign, error 20 is returned.
•
If the process is named, PROCESSHANDLE_TO_CRTPID_ looks up the process
name in the destination control table (DCT). If the name is not found, error 14 is
returned. However, it is sometimes possible for the name of a nonexistent process
to be found in the DCT, in which case error 0 is returned. Therefore, even for a
named process, error 0 (successful conversion of a process handle) does not
guarantee that the process exists.
•
If the PIN of the process is larger than 255, a synthetic process ID is returned
along with an error 560. A synthetic process ID contains a PIN value of 255 in
place of a high-PIN value, which cannot be represented by 8 bits.