Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (L)
Guardian Procedure Calls Reference Manual—522629-013
8-28
LOOKUPPROCESSNAME Procedure
(Superseded by PROCESS_GETPAIRINFO_
On return, ppd is of the form:
[0:2] Process name of entry
[3].<0:7> processor for primary process
.<8:15> PIN for primary process
[4].<0:7> processor of backup process, else 0
.<8:15> PIN of backup process, else 0
[5:8] process-id of the ancestor. Note that the process-
id is a 4-word array where process-id[0:2] contains
the process name or creation timestamp and
process-
id[3] contains:
[3].<0:3> Reserved
.<4:7> processor number where the process is
executing
.<8:15> PIN assigned by the operating system to
identify the process in the processor
If the process name is not in the DCT,
ppd is unchanged.
Condition Code Settings
< (CCL) 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.
= (CCE) indicates that the specified name was found.
> (CCG) indicates that the specified entry number exceeds the last table entry.
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.
This is an example of using 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.