Guardian Procedure Calls Reference Manual

#include <cextdecs(READUPDATELOCKX)>
_cc_status READUPDATELOCKX ( short filenum
,char _far *buffer
,unsigned short read-count
,[ unsigned short _far *count-read ]
,[ __int32_t tag ] );
• 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 READUPDATELOCK[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 READUPDATELOCK[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 READUPDATELOCK)INT:ref:*
(for READUPDATELOCKX)STRING .EXT:ref:*
is an array 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 READUPDATELOCK)INT:ref:1
(for READUPDATELOCKX)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.
1222 Guardian Procedure Calls (R)