Guardian Procedure Calls Reference Manual

Syntax for C Programmers
#include <cextdecs(FILE_READUPDATELOCK64_)>
short FILE_READUPDATELOCK64_ ( short filenum
,char _ptr64 *buffer
,unsigned int read-count
,[ unsigned int _ptr64 *count-read ]
,[ long long tag ] );
Syntax for TAL Programmers
?SETTOG _64BIT_CALLS
?SOURCE EXTDECS(FILE_READUPDATELOCK64_)
error := FILE_READUPDATELOCK64_ ( 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.
read-count
input
INT(32):value
is the number of bytes to be read: {0:4096}
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_READUPDATELOCK64_.
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.
FILE_READUPDATELOCK64_ Procedure 493