Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)

Guardian Procedure Calls Reference Manual—522629-013

5-106

FILE_GETRECEIVEINFO_ Procedure

Summary

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

Considerations

Example

Related Programming Manual

Summary

The FILE_GETRECEIVEINFO_ procedure returns information about the last message

read on 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 FILE_GETRECEIVEINFO_.

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

error returned value

INT

is a file-system error number indicating the outcome of the operation. The only

possible errors are error 16 (file not open) and program errors such as error 22

(bounds error).

#include <cextdecs(FILE_GETRECEIVEINFO_)>

short FILE_GETRECEIVEINFO_ ( short *receive-info );

Note. To ensure that you receive valid information about the last message, call

FILE_GETRECEIVEINFO_ before you perform another readupdate operation on $RECEIVE.

error := FILE_GETRECEIVEINFO_ ( receive-info !o

,[ dialog-info ] ); !o