Guardian Procedure Calls Reference Manual

GETPPDENTRY 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 GETPPDENTRY procedure is used to obtain a description of a named process pair by its index
into the destination control table (DCT). To obtain process pair descriptions by process name, use
either the PROCESS_GETPAIRINFO_ procedure or the LOOKUPPROCESSNAME 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 GETPPDENTRY ( index ! i
,sysnum ! i
,ppd ); ! o
Parameters
index
input
INT:value
specifies the index value of the DCT entry to be returned. The first entry is 0, the second is 1,
and so on. The largest valid value that can be specified is 65375.
sysnum
input
INT:value
specifies the system where the process pair exists.
ppd
output
INT:ref:9
is an array where GETPPDENTRY returns the nine-word DCT entry specified by the given index
and sysnum. The form of this array is:
Process name (in local form).[0:2]
Processor of primary process.[3].<0:7>
PIN of primary process.[4].<0:7>
Processor of backup process if it is a process pair. (This is 0 if there is no backup.)[4].<8:15>
666 Guardian Procedure Calls (G)