Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (R)
Guardian Procedure Calls Reference Manual—522629-013
13-40
RECEIVEINFO Procedure
(Superseded by FILE_GETRECEIVEINFO_
Syntax for TAL Programmers
Parameters
process-id output
INT:ref:4
returns the 4-word process ID of the process that sent the last message read
through the $RECEIVE file. If the process is of the named form, and thus is in the
destination control table (DCT), the information returned consists of:
[0:2] $process-name
[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 is of the unnamed form, and thus is not in the destination control
table (DCT), the information returned consists of:
[0:2] creation-time-stamp
[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
process-id (continued)
If the process ID is of the network form, the information returned consists of:
[0] .<0:7> “\” (ASCII backslash)
[0] .<8:15> System number
[1:2] Process name
[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
message-tag output
INT:ref:1
is used when the application process performs message queuing.
message-tag
returns a value that identifies the request message just read among other requests
CALL RECEIVEINFO ( [ process-id ] ! o
,[ message-tag ] ! o
,[ sync-id ] ! o
,[ filenum ] ! o
,[ read-count ] ! o
,[ iotype ] ); ! o