SNAX/APC Application Programming Manual

Verb Definitions
SNAX/APC Application Programming Manual—138786
3-33
RECEIVE-IMMEDIATE Verb
Request Details
REQ-UOW-CODE
This field must contain the value 1011, which identifies the RECEIVE-
IMMEDIATE verb.
RESERVED-1
This field must contain the value 0 or space (ASCII 32).
RI-FILL
This field specifies the unit of data to be returned to the local TP in the reply. This
field can contain one of the following two values:
B (FILL-BUFFER)
specifies that the data is to be returned as soon as the buffer is full or the end of
the data is received, whichever comes first. The size of the buffer is specified in
the RI-MAX-DATA-LENGTH field. This specification causes SNAX/APC to
ignore the logical record structure of the received data.
L (FILL-LL)
specifies that the data is to be returned in units of logical records. Data is
returned as soon as a complete logical record is received or when the buffer is
full, whichever comes first. The size of the buffer is specified in the RI-MAX-
DATA-LENGTH field. If the logical record is larger than the buffer, the TP
receives a partial record in the buffer and the RIR-WHAT-RECEIVED field in
the reply indicates that an incomplete logical record was received. To receive
the remainder of the logical record, the local TP must issue one or more
RECEIVE-IMMEDIATE (or RECEIVE-AND-WAIT) verbs.
RI-MAX-DATA-LENGTH
This field specifies the maximum amount of data, in bytes, that the local TP can
receive in one reply. The value you specify must be such that the size of the reply
from SNAX/APC (including the IPC header, the verb reply header, and any other
UOWs) is less than or equal to the size specified in MAXAPPLIOSIZE when
SNAX/APC was started.
01 RIR-DATA-LENGTH PIC 9(4) COMP VALUE 0.
01 RIR-DATA-AREA.
02 RIR-DATA-TEXT PIC X OCCURS 0 TO N TIMES
DEPENDING ON RIR-DATA-LENGTH.