Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-114
PROCESS_GETPAIRINFO_ Procedure
error-detail output
INT .EXT:ref:1
returns additional information about some classes of errors. See the list under
error for details.
Considerations
•
To perform an indexed search, initialize search-index to 0D before issuing the
first call.
•
Errors 11 and 12 are not returned during an indexed search. Excluded I/O
processes are skipped over with no error reported.
•
If PROCESS_GETPAIRINFO_ returns any value of error that indicates that no
information is being returned, the contents of all output parameters are undefined.
•
The values returned to identify the primary and backup processes reflect the
current view of the operating system at the time that PROCESS_GETPAIRINFO_
was called. When the members of a named process pair voluntarily switch
responsibilities, the new primary process should call the PROCESS_SETINFO_
procedure with the
primary attribute to inform the operating system of the pair’s
new state.
•
The pair parameter is the only output parameter of interest that is returned for a
named process that is not started. A named process that is not started does not
have any process handles (primary, backup, or ancestor) or ancestor program file
name associated with it.
•
When certain error values are returned, a null process handle (-1 in each word)
or an undefined value is returned in one or more of the output process-handle
parameters. The
error values and the affected output parameters are as follows:
error output process-handle parameters
2 all are undefined.
3 all are undefined.
4
backup-processhandle is null.
7 all are undefined.
8 all are undefined.
9 all are undefined.
10 all are undefined.
13
primary-processhandle, backup-processhandle, and
ancst-processhandle are null.