Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-113
PROCESS_GETPAIRINFO_ Procedure
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 should not
be altered between calls. The value of
search-nodename must be exactly
length bytes long and must be a valid node name.
options input
INT:value
specifies one or more options for the call as follows:
<0:12> Reserved (specify 0)
<13> 0 Return information only for running processes.
1 Also return information for named processes that are not started, but
the process names are reserved.
<14> 0 Resolve a partially qualified process name in
pair using the caller’s
=_DEFAULTS DEFINE.
1 Resolve a partially qualified process name in
pair using the caller’s
node.
<15> 0 Return information only for named processes.
1 Also return information for I/O processes (that is, processes controlling
devices or volumes). To return information on I/O processes that are
not started, also set
options .<13> to 1.
If this parameter is omitted, 0 is used.
ancst:maxlen input,output:input
STRING .EXT:ref:*, INT:value
if present and if
maxlen is not 0, returns the process file name of the ancestor of
the specified process or process pair. The
maxlen parameter specifies the length
in bytes of the string variable
ancst.
ancst-length output
INT .EXT:ref:1
if
ancst is returned, contains its actual length in bytes.