Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (R)
Guardian Procedure Calls Reference Manual—522629-013
13-39
RECEIVEINFO Procedure
(Superseded by FILE_GETRECEIVEINFO_
RECEIVEINFO Procedure
(Superseded by FILE_GETRECEIVEINFO_
Procedure )
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
Example
Related Programming Manual
Summary
The RECEIVEINFO procedure is used to obtain the 4-word process ID, message tag,
error recovery (sync ID), and request-related (file number, read count, and I/O type)
information associated with the last message read from the $RECEIVE file. Because
this information is contained in the file’s main-memory resident access control block
(ACB), the application process is not suspended by a call to RECEIVEINFO.
Note that the first two parameters to RECEIVEINFO (
process-id and message-
tag) duplicate the parameters to the LASTRECEIVE procedure.
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.
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
RECEIVEINFO 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 RECEIVEINFO.