Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (G)
Guardian Procedure Calls Reference Manual—522629-013
6-21
GETPPDENTRY Procedure
(Superseded by PROCESS_GETPAIRINFO_
Considerations
•
Checking the DCT entry
If
index is not currently being used, GETPPDENTRY returns CCE and sets ppd
to zeros. To check for all conditions, an application could contain the following
code:
CALL GETPPDENTRY( INDEX^NUM , SYS^NUM , PROCESS^PAIR^DESCRIPT
);
IF < THEN ... ; ! system unavailable.
IF > THEN ! STOP, no more DCT entries available.
IF = AND PROCESS^PAIR^DESCRIPT THEN ... ! found an entry.
ELSE
! unused entry, try the next INDEX^NUM.
•
Difference between GETPPDENTRY and LOOKUPPROCESSNAME
The difference between the GETPPDENTRY procedure and the
LOOKUPPROCESSNAME procedure is:
GETPPDENTRY is primarily used to obtain a local or remote process pair
description by its index into a system table.
LOOKUPPROCESSNAME
is primarily used to obtain a local or remote process pair
description by its name.
•
High-PIN considerations
If you call GETPPDENTRY for a named process pair that has a high-PIN process
as the primary or backup, the
ppd array (ppd [0:8]) is returned filled with zeros.
If you call GETPPDENTRY for a named process pair that has a high-PIN process
as the ancestor, a synthetic process ID is returned in
ppd [5:8]. A synthetic
process ID contains a PIN value of 255 in place of a high-PIN value, which cannot
be represented by 8 bits.