Guardian Procedure Calls Reference Manual

pair-flag
input
INT:value
specifies whether process-id designates a process pair (1 it does; 0 it does 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.
Returned Value
INT
A file-system error code that indicates the outcome of the call.
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 eight bits.
1142 Guardian Procedure Calls (P)