Guardian Procedure Calls Reference Manual

Syntax for TAL Programmers
CALL READLOCK[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 READLOCK)INT:ref:*
(for READLOCKX)STRING .EXT:ref:*
is an array in the application process where the information read from the file returns.
read-count
input
INT:value
is the number of bytes to be read: {0:4096}.
count-read
output
(for READLOCK)INT:ref:1
(for READLOCKX)INT .EXT:ref:1
is for wait I/O only. count-read returns a count of the number of bytes returned from the
file into buffer.
tag
input
INT(32):value
is for nowait I/O only. tag is a value you define that uniquely identifies the operation associated
with this READLOCK[X].
NOTE: The system stores the tag value until the I/O operation completes. The system then
returns the tag information to the program in the tag parameter of the call to AWAITIO[X],
thus indicating that the operation completed. If READLOCKX is used, you must call AWAITIOX
to complete the I/O. If READLOCK is used, you may use either AWAITIO or AWAITIOX to
complete the I/O.
Condition Code Settings
indicates that an error occurred (call FILE_GETINFO_ or FILEINFO).< (CCL)
is also returned following a successful read with an insertion-ordered alternate key path if the alternate
key value of the current record is equal to the alternate key value in this record along that path. A call
< (CCL)
READLOCK[X] Procedures 1209