Guardian Procedure Calls Reference Manual

the caller's node name, specify bit 14 of the options parameter. To search for a process
on a remote node, fully qualify the process name.
• If pair is the name of a named process that is not started, it cannot contain a sequence
number.
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 (page 1049) for details.
ancst-process handle
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.
search-nodename:length
input:input
STRING .EXT:ref:*, INT:value
if length is not 0 and search-index is present, specifies the name of the node on which the
search is to take place. PROCESS_GETPAIRINFO_ uses search-nodename to determine the
node to search on each call, so its contents must not be altered between calls. The value of
search-nodename must be exactly length bytes long and must be a valid node name.
PROCESS_GETPAIRINFO_ Procedure 1047