Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (R)
Guardian Procedure Calls Reference Manual—522629-013
13-4
READ[X] Procedures
•
The function value returned by READ[X], which indicates the condition code, can
be interpreted by
_status_lt(), _status_eq(), or _status_gt() (defined
in the file
tal.h).
Syntax for TAL Programmers
Parameters
filenum input
INT:value (Use with both READ and READX)
is the number of an open file that identifies the file to be read.
buffer output
INT:ref:* (Use with READ)
STRING .EXT:ref:* (Use with READX)
is an array in the application process in which the information read from the file is
returned. The
buffer for READ can be only in the user’s stack area, while the
buffer for READX can be in the caller’s stack segment or in any extended data
segment.
read-count input
INT:value (Use with both READ and READX)
is the number of bytes to be read:
{0:57344} for disk files (see
Disk File Considerations on page 13-8 and
Appendix J, System Limits)
{0:32755} for terminal files
{0:57344} for other nondisk files (device dependent)
{0:57344} for $RECEIVE and process files
{0:80} for the operator console
count-read output
INT:ref:1 (Use with READ)
INT .EXT:ref:1 (Use with READX)
is for waited I/O only. It returns a count of the number of bytes returned from the
file into
buffer.
CALL READ[X] ( filenum ! i
,buffer ! o
,read-count ! i
,[ count-read ] ! o
,[ tag ] ); ! i