Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-112
PROCESS_GETPAIRINFO_ Procedure
pair-length output
INT .EXT:ref:1
if
pair:maxlen is an output parameter, contains the length in bytes of the value
returned in
pair.
primary-processhandle output
INT .EXT:ref:10
returns the process handle of the primary process of a named process pair or (if
the specified process is a single named process) the process handle of a single
named process.
If the process is a named process that is not started, a null process handle (-1 in
each word) is returned. This procedure can return information on named
processes that are not running if bit 13 of the
options parameter is set to 1.
backup-processhandle output
INT .EXT:ref:10
returns the process handle of the backup process of a named process pair.
If there is no backup process, a null process handle (-1 in each word) is returned.
search-index input, output
INT(32) .EXT:ref:1
if present and not -1D, serves as an index for searching through the named
processes on a system. To use
search-index, initialize it to 0D before issuing
the first call to PROCESS_GETPAIRINFO_ ; then issue repeated calls until an
error value of 8 (no more names) is returned. Do not alter search-index
between calls.
See “Considerations” for details.
ancst-processhandle output
INT .EXT:ref:10
returns the process handle of the ancestor of the specified process or process pair.
If the process or process pair does not have an ancestor, a null process handle (-1
in each word) is returned.