Guardian Procedure Calls Reference Manual

GETREMOTECRTPID Procedure (Superseded by PROCESS_GETPAIRINFO_
Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
Example
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
The GETREMOTECRTPID procedure is used to obtain the four-word process ID associated with a
remote process. The process ID contains the remote process name or creation timestamp in
words[0:2] and cpu,pin in word[3]. The term CRTPID is synonymous with process ID as used in
this manual.
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 GETREMOTECRTPID ( cpu, pin ! i
,process-id ! o
,sysnum ); ! i
Parameters
cpu,pin
input
INT:value
is the processor number and PIN number of the process whose process ID is returned (see
process-id[3] below for the format). The PIN number is used to identify a process' process
control block (or PCB) in a given processor. Note that without a system number cpu,pin is
not sufficient to identify a remote process in a network.
process-id
output
INT:ref:4
is the four-word array where GETREMOTECRTPID returns the process ID of the process specified
by cpu,pin. process-id has the following form:
Process name or creation timestamp[0:2]
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>
668 Guardian Procedure Calls (G)