Guardian Procedure Calls Reference Manual

If the process name is not in the DCT, ppd is unchanged.
Condition Code Settings
indicates that the specified process name is not in the directory, or that the remote system could not
be accessed, or that the specified process pair has a high-PIN process as the primary or backup.
< (CCL)
indicates that the specified name was found.= (CCE)
indicates that the specified entry number exceeds the last table entry.> (CCG)
Considerations
• Network use
Remote DCT entries can be obtained by passing the process name (in network form) of the
process desired. On return, the process name remains in network form.
The following example uses LOOKUPROCESSNAME to get the DCT entry for the name process
"$PROC" running on the system "\DETROIT":
EXTERNAL^NAME ':=' 17 * [ " " ]; ! blanks.
EXTERNAL^NAME ':=' "\DETROIT.$PROC";
! note that "$proc1" is not a valid remote name.
CALL FNAMEEXPAND ( EXTERNAL^NAME , INTERNAL^NAME , DEFAULTS
);
! converts \DETROIT to its system number.
CALL LOOKUPPROCESSNAME ( INTERNAL^NAME );
! returns the desired DCT entry.
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 eight 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. LOOKUPPROCESSNAME cannot reliably
be used to scan the entire DCT by index.
• LOOKUPPROCESSNAME does not return information on a named process that is reserved
for future use and is not started.
782 Guardian Procedure Calls (L)