Guardian Programming Reference Summary for C

Functions Summary (O-Q)
Guardian Programming Reference Summary for C—522630-001
7-21
PROCESS_GETPAIRINFO_
Obtains basic information about a named process or process pair.
returned value:
#include <cextdecs(PROCESS_GETPAIRINFO_)>
short PROCESS_GETPAIRINFO_ ([ short *processhandle ]/* i */
,[ char *pair ] /* i */
,[ short maxlen ] /* o,i*/
,[ short *pair-length ] /* o */
,[ short *primary-processhandle ] /* o */
,[ short *backup-processhandle ] /* o */
,[ long *search-index ] /* i,o */
,[ short *ancst-processhandle ] /* o */
,[ const char *search-nodename ] /* i */
,[ short length ] /* i */
,[ short options ] ); /* i */
0 = Information is returned for a process pair (not the calling process).
1=Reserved.
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.
12 = The option to allow I/O processes was selected, but the process is an I/O
process running on a C-series system.