Guardian Procedure Calls Reference Manual

RECEIVEINFO Procedure (Superseded by FILE_GETRECEIVEINFO[L]_
Procedures)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
Example
Related Programming Manual
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
The RECEIVEINFO procedure is used to obtain the four-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.
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.
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 RECEIVEINFO ( [ process-id ] ! o
,[ message-tag ] ! o
,[ sync-id ] ! o
,[ filenum ] ! o
,[ read-count ] ! o
,[ iotype ] ); ! o
1226 Guardian Procedure Calls (R)