Exchange/SNA Manual

WRITE Procedure
Exchange/SNA System Procedure Calls
5–22 104700 Tandem Computers Incorporated
WRITE Procedure The WRITE procedure writes a record from your program to the specified subdevice
for transmission to the host.
CALL WRITE ( filenum
, buffer
, write-count
, [ count-written ]
, [ tag ] );
filenum
INT:value
is the file number of a previously opened subdevice supported by the
Exchange/SNA line server. The number you specify here is the number returned
by the call to OPEN that opened the subdevice.
buffer
INT:ref:*
is an array containing the record to be sent to the host.
write-count
INT:value
is the size, in bytes, of the record to be written. The maximum allowed range is
from 1 to 255 bytes.
count-written
INT:ref:1
returns the number of bytes written to the subdevice. This parameter is used for
wait I/O only. For nowait I/O, you can omit this parameter; the number of bytes
written is returned in the count-transferred parameter of the AWAITIO procedure
that completes the write operation.
tag
INT(32):value
identifies individual nowait I/O operations when a single file can have two or
more nowait I/O operations outstanding at the same time. The value of tag is a
unique, arbitrary value that your program defines for each nowait I/O operation.
A subsequent call to AWAITIO that completes this I/O operation returns this
value to your program, identifying this I/O operation as the nowait I/O operation
that just completed.