Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (L)
Guardian Procedure Calls Reference Manual—522629-013
8-6
LASTRECEIVE Procedure
(Superseded by FILE_GETRECEIVEINFO_
LASTRECEIVE Procedure
(Superseded by FILE_GETRECEIVEINFO_
Procedure )
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
Example
Summary
The LASTRECEIVE procedure is used to obtain the 4-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.
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
Note. This procedure is supported for compatibility with previous software and should not be
used for new development.
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.
CALL LASTRECEIVE ( [ process-id ] ! o
,[ message-tag ] ); ! o