Guardian Procedure Calls Reference Manual

LOOKUPPROCESSNAME Procedure (Superseded by
PROCESS_GETPAIRINFO_ Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
The LOOKUPPROCESSNAME procedure is used to obtain a description of a named process pair
by its name or by its index into the local destination control table (DCT). To obtain remote process
pair descriptions by index, use the GETPPDENTRY procedure.
Syntax for C Programmers
This procedure does not have a C syntax, because it is superseded and should not be used for
new development. This procedure is supported only for compatibility with previous software.
Syntax for TAL Programmers
CALL LOOKUPPROCESSNAME ( ppd ); ! i,o
Parameters
ppd
input, output
INT:ref:9
on input, is one of the following for the entry to be returned:
• the internal format process name
• the entry number in the DCT ({0:n}), where the specified value is not greater than 9215
on return, ppd is of the form:
Process name of entry[0:2]
Processor for primary process.<0:7>[3]
PIN for primary process.<8:15>
Processor of backup process, else 0.<0:7>[4]
PIN of backup process, else 0.<8:15>
process-id of the ancestor. Note that the process-id is a four-word array where
process-id[0:2] contains the process name or creation timestamp and process-id[3]
contains:
[5:8]
Reserved.<0:3>[3]
Processor number where the process is executing.<4:7>
PIN assigned by the operating system to identify the process in the
processor
.<8:15>
LOOKUPPROCESSNAME Procedure (Superseded by PROCESS_GETPAIRINFO_ Procedure) 781