TN3270 Server Manual

CRT Communication Protocol

TN3270 Server Manual—424097-001

5-5

READ[x] Request Procedure

After a normal READ request is completed (a CONTROL 22 operation is not used), and

the client responds with text, the blocks received by the Guardian TN3270 Server are

collected and stripped of any communications control characters. When the final block

is received, the read is completed by transferring the data to the application process, as

shown in Figure 5-2

on page 5-2.

filenumber

INT:value

is the number of an open file that identifies the file to be read.

buffer

is an array in the application process in which the information read from the file is

returned.

read-count

INT:value

is the number of bytes to be read.

count-read

is for waited I/O only. It returns a count of the number of bytes returned into

buffer.

tag

INT(32):value

is for nowait I/O only. tag is a value you define that uniquely identifies the

operation associated with this READ[x].

READ[x] (filenumber, buffer, read-count [, count-read ]

[, tag ]);

INT .ref:* (for READ)

STRING .EXT:ref:* (for READ[x])

INT .ref:1 (for READ)

INT .EXT:ref:1 (for READ[x])