Guardian Procedure Calls Reference Manual

Syntax for TAL Programmers
?SETTOG _64BIT_CALLS
?SOURCE EXTDECS(FILE_WRITEUPDATEUNLOCK64_)
error := FILE_WRITEUPDATEUNLOCK64_ ( 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
STRING .EXT64:ref:*
is an array that contains the data to be written to the file.
write-count
input
INT(32):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
INT(32) .EXT64:ref:1
for wait I/O only, returns an integer indicating the number of bytes written to the file.
tag
input
INT(64):value
for nowait I/O only, is a value you define that uniquely identifies the operation associated
with this FILE_WRITEUPDATEUNLOCK64_ procedure call.
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.
544 Guardian Procedure Calls (F)