Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (W-Z)
Guardian Procedure Calls Reference Manual—522629-013
16-28
WRITEUPDATE[X] Procedures
write-count input
INT:value (Use with WRITEUPDATE and WRITEUPDATEX)
is the number of bytes to be written to the file:
{0:4096} for disk files (see “Disk File Considerations”)
{0:32767} for magnetic tapes
For key-sequenced and relative files: 0 means delete the record.
For entry-sequenced files: 0 means anything <> the record’s length is
invalid.
count-written output
INT:ref:1 (Use with WRITEUPDATE)
INT .EXT:ref:1 (Use with WRITEUPDATEX)
is for wait I/O only. It returns a count of the number of bytes written to the file.
tag input
INT(32):value (Use with WRITEUPDATE and WRITEUPDATEX)
is for nowait I/O only.
tag is a value you define that uniquely identifies the
operation associated with this WRITEUPDATE[X].
The system stores this
tag value until the I/O operation completes. The system
returns the
tag information back to the program in the tag parameter of the call to
AWAITIO[X], thus indicating that the operation completed. If WRITEUPDATEX is
used, you must call AWAITIOX to complete the I/O. If WRITEUPDATE is used,
you can use either AWAITIO or AWAITIOX to complete the I/O.
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 the WRITEUPDATE[X] was successful.
> (CCG) indicates that an error occurred (call FILE_GETINFO_ or FILEINFO).