Guardian Procedure Calls Reference Manual

#include <cextdecs(WRITEUPDATEUNLOCKX)>
_cc_status WRITEUPDATEUNLOCKX ( short filenum
,const char _far *buffer
,unsigned short write-count
,[ unsigned short _far *count-written ]
,[ __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 WRITEUPDATEUNLOCK[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 WRITEUPDATEUNLOCK[X] ( filenum ! i
,buffer ! i
,write-count ! i
,[ count-written ] ! o
,[ tag ] ); ! i
Parameters
filenum
input
INT:value
is a number of an open file that identifies the file to be written.
buffer
input
(for WRITEUPDATEUNLOCK)INT:ref:*
(for WRITEUPDATEUNLOCKX)STRING .EXT:ref:*
is an array containing the data to be written to the file.
write-count
input
INT:value
is the number of bytes to be written to the file: {0:4096}.
For key-sequenced and relative files: 0 deletes the record.
For entry-sequenced files: 0 is invalid (error 21).
count-written
output
(for WRITEUPDATEUNLOCK)INT:ref:1
(for WRITEUPDATEUNLOCKX)INT .EXT:ref:1
is for wait I/O only. It returns an integer indicating the number of bytes written to the file.
WRITEUPDATEUNLOCK[X] Procedures 1517