Guardian Procedure Calls Reference Manual

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 in the application process where the information read from the file returns.
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_READLOCK64_ .
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.
Returned Value
INT
A file-system error code that indicates the outcome of the call.
22
• The address of a parameter is extended, but either the extended data segment is invalid or the address is
for a selectable segment that is not in use at the time of the call.
• The address of a parameter is extended, but it is an absolute address and the caller is not privileged.
Considerations
• EpTAL callers must set toggle
EpTAL callers must set the toggle _64BIT_CALLS before sourcing the FILE_READLOCK64_
procedure section from EXTDECS.
• Familiar semantics
Unless otherwise described, the semantic behavior of FILE_READLOCK64_ is the same as that
of READLOCKX.
FILE_READLOCK64_ Procedure 483