Guardian Procedure Calls Reference Manual

• CEXTDECS (through the included file TNSINTH) defines 32-bit values as the typedef
__int32_t, which for TNS and TNS/R compiles is defined as long and for TNS/E compiles
is defined as int.
• 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
CALL READ[X] ( filenum ! i
,buffer ! o
,read-count ! i
,[ count-read ] ! o
,[ tag ] ); ! i
Parameters
filenum
input
INT:value
is the number of an open file that identifies the file to be read.
buffer
output
(for READ)INT:ref:*
(for READX)STRING .EXT:ref:*
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
is the number of bytes to be read:
for disk files (see also Disk File Considerations (page 1196) for the READ[X] procedures){0:57344}
for terminal files{0:32755}
for other nondisk files (device dependent){0:57344}
for $RECEIVE and process files{0:57344}
for the operator console{0:80}
count-read
output
(for READ)INT:ref:1
(for READX)INT .EXT:ref:1
is for waited I/O only. It returns a count of the number of bytes returned from the file into
buffer.
READ[X] Procedures 1193