Guardian Procedure Calls Reference Manual

GETCRTPID Procedure (Superseded by PROCESS_GETINFOLIST_ 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 GETCRTPID procedure is used to obtain the four-word CRTPID (which contains the process
name or creation timestamp in words [0:2] and cpu,pin in word [3]) associated with a process.
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 GETCRTPID ( cpu,pin ! i
,process-id ); ! o
Parameters
cpu,pin
input
INT:value
is the processor number and PIN number of the process whose CRTPID 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.
process-id
output
INT:ref:4
is the four-word array where GETCRTPID returns the CRTPID (or process ID) of the process
specified by cpu,pin. The process-id is returned in local form, that is,
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>
GETCRTPID Procedure (Superseded by PROCESS_GETINFOLIST_ Procedure) 655