Guardian Procedure Calls Reference Manual

LASTRECEIVE Procedure (Superseded by FILE_GETRECEIVEINFO[L]_
Procedures)
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 LASTRECEIVE procedure is used to obtain the four-word process ID and the message tag
associated with the last message read from the $RECEIVE file. This information is contained in the
file's main-memory resident access control block (ACB). An application process is not suspended
because of a call to LASTRECEIVE.
NOTE: To ensure that you receive valid information about the last message, call LASTRECEIVE
before you perform another READUPDATE on $RECEIVE. If you received an error condition on the
last message, call FILEINFO or FILE_GETINFO_ to obtain the error value before you call
LASTRECEIVE.
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 LASTRECEIVE ( [ process-id ] ! o
,[ message-tag ] ); ! o
Parameters
process-id
output
INT:ref:4
returns the four-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:
$process-name[0:2]
Reserved.<0:3>[3]
Processor number where the process is executing.<4:7>
PIN assigned by operating system to identify the process in the processor.<8:15>
LASTRECEIVE Procedure (Superseded by FILE_GETRECEIVEINFO[L]_ Procedures) 763