Envoy Application Programming Manual

File-System Procedures
Envoy Application Programming Manual—427159-001
C-32
WRITE[X]
last-params output
INT:ref:2
is the name of a two-word integer array into which Envoy places the previous values
of parameter-1 and parameter-2 for the specified SETMODENOWAIT function. The
format of the array is:
last-params[0] = parameter 1 value
last-params[1] = parameter 2 value, if applicable
If the SETMODENOWAIT call includes only function and last-params, the
specified function is not performed. Instead, Envoy fetches the most recently used
values of parameter-1 and parameter-2 for the specified function and places
them into the last-params array.
tag input
INT(32):value
is for nowait I/O only. tag is a value you define that uniquely identifies the operation
associated with this SETMODENOWAIT.
The system stores the 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.
Condition Codes
Example
CALL SETMODENOWAIT (fnum,17,100);
CALL AWAITIO (fnum);
where fnum is the name of the one-word integer variable specified in the OPEN call
that opened the particular communications line. This call sets the intermediate block size
for the specified line to 100 bytes.
WRITE[X]
A call to the WRITE[X] procedure transmits data from an application program buffer to
the remote station by way of a single message.
The WRITE procedure is intended for use with 16-bit addresses, while WRITEX is
intended for use with 32-bit extended addresses. Therefore, the data buffer for WRITEX
can be either in the caller’s stack segment or any extended data segment.
< (CCL) Indicates that an error occurred (call FILEINFO).
= (CCE) Indicates that the SETMODENOWAIT procedure was executed
successfully.