Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (W-Z)
Guardian Procedure Calls Reference Manual—522629-013
16-23
WRITEREAD[X] Procedures
is an array containing information to be written to the file.
On return,
buffer contains the information read from the file.
write-count input
INT:value (Use with WRITEREAD and WRITEREADX)
is the number of bytes to be written:
{0:32755} for terminals
{0:57344} for interprocess files
read-count input
INT:value (Use with WRITEREAD and WRITEREADX)
returns the number of bytes to be read:
{0:32755} for terminals
{0:57344} for interprocess files
count-read output
INT:ref:1 (Use with WRITEREAD)
INT .EXT:ref:1 (Use with WRITEREADX)
is for wait I/O only. It returns a count of the number of bytes returned from the file
into
buffer.
tag input
INT(32):value (Use with WRITEREAD and WRITEREADX)
is for nowait I/O only.
tag must uniquely identify the operation associated with this
WRITEREAD[X].
Condition Code Settings
< (CCL) indicates that an error occurred (call FILE_GETINFO_ or FILEINFO).
= (CCE) indicates the WRITEREAD[X] is successful.
> (CCG) indicates that CTRL-Y is pressed on the terminal.
Note. When using terminals in block mode, an error 21 occurs if write-count exceeds 256
bytes.
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 WRITEREADX is used, you must call
AWAITIOX to complete the I/O. If WRITEREAD is used, you can use either AWAITIO or
AWAITIOX to complete the I/O.