Guardian Procedure Calls Reference Manual

Syntax for TAL Programmers
?SETTOG _64BIT_CALLS
?SOURCE EXTDECS(FILE_READ64_)
error := FILE_READ64_ ( 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
STRING .EXT64:ref:*
is an array where the information read from the file is returned. The buffer can be in the
caller's stack segment or in any extended data segment.
read-count
input
INT(32):value
is the number of bytes to be read:
{0:57344} for disk files (see also Disk File Considerations (page 479))
{0:32755} for terminal files
{0:57344} for other nondisk files (device dependent)
{0:2097152} for $RECEIVE and process files
{0:80} for the operator console
count-read
output
INT(32) .EXT64:ref:1
for wait I/O only, returns a count of the number of bytes returned from the file into buffer.
tag
input
INT(64):value
for nowait I/O only, is a value you define that uniquely identifies the operation associated
with FILE_READ64_.
NOTE: The system stores the tag value until the I/O operation completes. It then returns the
tag information to the program in either the tag parameter of the call to FILE_AWAITIO64_
or the tag field of the completion-info parameter of the call to FILE_COMPLETEL_, thus
indicating that the operation finished.
476 Guardian Procedure Calls (F)