Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (L)
Guardian Procedure Calls Reference Manual—522629-013
8-29
LOOKUPPROCESSNAME Procedure
(Superseded by PROCESS_GETPAIRINFO_
To obtain DCT entries using an entry-num, use the GETPPDENTRY procedure.
If you call LOOKUPPROCESSNAME for a named process pair whose ancestor is
a named process on a remote node with a process name of six characters
(including the $),
ppd [5:8] is returned filled with zeros.
•
High-PIN considerations
If you call LOOKUPPROCESSNAME for a named process pair that has a high-PIN
process as the primary or backup, condition code < (CCL) is returned.
If you call LOOKUPPROCESSNAME 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.
•
DCT Index as an input parameter
Although supported for backward compatibility, use of a DCT index as an input
parameter is not recommended. The maximum DCT index value that
LOOKUPPROCESSNAME can handle as input is 9215, which is far below the
system limit. This also means that LOOKUPPROCESSNAME cannot reliably be
used to scan the entire DCT by index.
•
This procedure does not return information on a named process that is reserved
for future use and is not started.