Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12 -111
PROCESS_GETPAIRINFO_ Procedure
processhandle input
INT .EXT:ref:10
if supplied, is a process handle specifying the process of interest. You can specify
either the primary or backup process when seeking information about a process
pair.
processhandle is ignored if the search-index parameter is present.
If
processhandle is omitted or null (-1 in each word) and search-index is not
present:
•
If pair:maxlen is present, it specifies the process or process pair of interest.
•
If pair:maxlen is not present, information is returned for the caller or the
process pair to which the caller belongs.
pair:maxlen input, output:input
STRING .EXT:ref:*, INT:value
if present and if
maxlen is not 0, supplies or returns the process file name of the
process or process pair of interest.
The presence or absence of the parameters
processhandle and search-
index determine whether pair is an output parameter or an input parameter as
follows:
If
pair is an output parameter:
•
maxlen specifies the length of the string variable pair.
•
The following table describes how pair is returned:
If
pair is an input parameter:
•
maxlen specifies the length in bytes of the value supplied in pair.
•
If pair is a partially qualified process name, the process name is resolved
using the node name specified in the caller’s =_DEFAULTS DEFINE. To
resolve the process name using 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.
named process that is not started name in the form
\node.$name
(no sequence number is
returned)