SNAX/APC Application Programming Manual

Verb Definitions
SNAX/APC Application Programming Manual—138786
3-32
RECEIVE-IMMEDIATE Verb
RECEIVE-IMMEDIATE Verb
The local TP issues the RECEIVE-IMMEDIATE verb to receive any data or control
information that is immediately available from the partner TP. The RECEIVE-
IMMEDIATE verb does not wait for information to arrive from the partner TP. The
information, if available, can be data, conversation status, or a request for confirmation.
The verb completes immediately with an indication of whether any information was
received and, if any, the type of information. The local TP must be in the Receive state
to issue this verb.
Note. The fields RIR-DATA-LENGTH and RIR-DATA-AREA are not defined by the
SNAX/APC DDL because they cannot be created by DDL. The SNAX/APC DDL
provides example definitions for these fields in COBOL and TAL. You must create the
definitions for these fields.
Request Format
?SECTION RECEIVE-IMMEDIATE-REQ,TANDEM
01 RECEIVE-IMMEDIATE-REQ.
02 RI-HEADER.
03 REQ-UOW-ID PIC X(2).
03 REQ-UOW-CODE PIC 9(4) COMP.
02 RI-PARAMETERS.
03 RESERVED-1 PIC X(1).
03 RI-FILL PIC X(1).
03 RI-MAX-DATA-LENGTH PIC 9(4) COMP.
Reply Format
?SECTION RECEIVE-IMMEDIATE-REP,TANDEM
01 RECEIVE-IMMEDIATE-REP.
02 RIR-HEADER.
03 REP-UOW-ID PIC X(2).
03 REP-VERB-CODE PIC 9(4) COMP.
03 REP-RETURN-CODE PIC S9(4) COMP.
03 REP-RETURN-CODE-DETAIL PIC S9(4) COMP.
02 RIR-PARAMETERS.
03 RESERVED-1 PIC X(1).
03 RIR-REQUEST-TO-SEND-IND PIC X(1).
88 RIR-RECEIVED VALUE IS "Y".
88 RIR-NOT-RECEIVED VALUE IS "N".
03 RIR-WHAT-RECEIVED PIC 9(4) COMP.
88 WR-DATA VALUE IS 0.
88 WR-DATA-COMPLETE VALUE IS 1.
88 WR-DATA-INCOMPLETE VALUE IS 2.
88 WR-SEND VALUE IS 3.
88 WR-CONFIRM VALUE IS 4.
88 WR-CONFIRM-SEND VALUE IS 5.
88 WR-CONFIRM-DEALLOCATE VALUE IS 6.
88 WR-PS-HEADER-PENDING VALUE IS 8.
88 WR-PS-HEADER-COMPLETE VALUE IS 9.
88 WR-PS-HEADER-INCOMPLETE VALUE IS 10.