Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (W-Z)
Guardian Procedure Calls Reference Manual—522629-013
16-36
WRITEUPDATEUNLOCK[X] Procedures
write-count input
INT:value (Use with WRITEUPDATEUNLOCK and
WRITEUPDATEUNLOCKX)
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 illegal (error 21)
count-written output
INT:ref:1 (Use with WRITEUPDATEUNLOCK)
INT .EXT:ref:1 (Use with WRITEUPDATEUNLOCKX)
is for wait I/O only. It returns an integer indicating the number of bytes written to
the file.
tag input
INT(32):value (Use with WRITEUPDATEUNLOCK and
WRITEUPDATEUNLOCKX)
is for nowait I/O only.
tag is a value you define that uniquely identifies the
operation associated with this WRITEUPDATEUNLOCK[X].
Condition Code Settings
< (CCL) indicates that an error occurred (call FILE_GETINFO_ or FILEINFO).
< (CCL) is returned following successful insertion or update of a record in a file with
one or more insertion-ordered alternate keys if a duplicate key value was
created for at least one insertion-ordered alternate key. A call to
FILE_GETINFO_ or FILEINFO shows that error 551 occurred; this error is
advisory only and does not indicate an unsuccessful write operation.
= (CCE) indicates that the WRITEUPDATEUNLOCK[X] was successful.
> (CCG) indicates that an error occurred (call FILE_GETINFO_ or FILEINFO).
Note. The system stores this 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 WRITEUPDATEUNLOCKX is used, you must
call AWAITIOX to complete the I/O. If WRITEUPDATEUNLOCK is used, you can use either
AWAITIO or AWAITIOX to complete the I/O.