Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual—522629-013
3-178
CRTPID_TO_PROCESSHANDLE_ Procedure
processhandle output
INT .EXT:ref:10
returns the process handle of the process designated by
process-id.
pair-flag output
INT .EXT:ref:1
returns a value of 1 if
•
cpu and pin value in process-id is set to -1
•
cpu and pin value in process-id is set to blanks (“ “)
It returns a value of 0 otherwise.
node-number input
INT(32):value
if present and not equal to -1D, and if
process-id is not in network form,
identifies the node on which the process identified by
process-id resides. If
omitted or equal to -1D, the caller’s node is assumed.
Considerations
•
When converting the process ID process, CRTPID_TO_PROCESSHANDLE_
looks up the process in a system table and it might send a system message. An
error 14 is returned if the process does not exist.
•
This procedure does not return information on a named process that is reserved
for future use and is not started.
Related Programming Manual
For programming information about the CRTPID_TO_PROCESSHANDLE_ procedure,
refer to the
Guardian Application Conversion Guide.