Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-110
PROCESS_GETPAIRINFO_ Procedure
Syntax for TAL Programmers
Parameters
error returned value
INT
indicates the outcome of the operation. It returns one of the following values:
0 Information is returned for a process pair (not the calling process).
2 Parameter error;
error-detail contains the number of the first parameter
found to be in error, where 1 designates the leftmost parameter.
3 Bounds error;
error-detail contains the number of the first parameter
found to be in error, where 1 designates the leftmost parameter.
4 Information is returned for a single named process (can be the calling
process).
5 Information is returned for a process pair where the caller is the current
primary.
6 Information is returned for a process pair where the caller is the current
backup.
7 No information is returned; process is unnamed (can be the calling process).
8 No information is returned; search is complete.
9 Specified process does not exist.
10 Unable to communicate with the node where the process resides.
11 Process is an I/O process, but the option to allow I/O processes was not
selected.
13 Limited information is returned for a named process that is not started, but the
process name is reserved.
error := PROCESS_GETPAIRINFO_ (
[ processhandle ] !i 1 !
,[ pair: maxlen ] !i,o:i 2 !
,[ pair-length ] !o 3 !
,[ primary-processhandle ] !o 4 !
,[ backup-processhandle ] !o 5 !
,[ search-index ] !i,o 6 !
,[ ancst-processhandle ] !o 7 !
,[ search-nodename: length ] !i:i 8 !
,[ options ] !i 9 !
,[ ancst: maxlen ] !i,o:i10 !
,[ ancst-length ] !o 11 !
,[ error-detail ] ); !o 12 !