Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (L)
Guardian Procedure Calls Reference Manual—522629-013
8-7
LASTRECEIVE Procedure
(Superseded by FILE_GETRECEIVEINFO_
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 ID is of the named form and thus 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 operating system to identify the process in
the processor
If the process ID is of the unnamed form and thus not in the 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 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> “\”
[0].<8:15> System number
[1:2] Process name
[3].<0:3> Reserved
.<4:7> processor number in which 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
currently queued. To associate a reply with a given request,
message-tag is
passed in a parameter to the REPLY procedure.
The value of
message-tag is an integer between 0 and receive-depth minus
1, inclusive, that is not currently being used as a message tag. When a reply is
made, its associated message tag value is made available for use as a message
tag for a subsequent request message.