SNAX/APC Application Programming Manual

Verb Definitions
SNAX/APC Application Programming Manual—138786
3-64
MC-RECEIVE-AND-WAIT Verb
MC-RECEIVE-AND-WAIT Verb
The local TP issues MC-RECEIVE-AND-WAIT when it is ready to receive data or
control information from the remote TP. The local TP can issue MC-RECEIVE-AND-
WAIT while in Send state to flush the data buffer and cause a transition to Receive state.
Successful completion of the MC-RECEIVE-AND-WAIT verb occurs when the local
TP receives data or information from the remote TP. The WHAT-RECEIVED indicator
informs the local TP of the type of information received.
Note. The fields MRWR-DATA-LENGTH and MRWR-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
01 MC-RECEIVE-AND-WAIT-REQ.
02 MC-RW-HEADER.
03 REQ-UOW-ID PIC X(2).
03 REQ-UOW-CODE PIC 9(4) COMP.
02 MC-RW-PARAMETERS.
03 RESERVED-2 PIC X(2).
03 MC-RW-MAX-DATA-LENGTH PIC 9(4) COMP.
Reply Format
01 MC-RECEIVE-AND-WAIT-REP.
02 MC-RWR-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 MC-RWR-PARAMETERS.
03 RESERVED-1 PIC X(1).
03 MC-RWR-REQUEST-TO-SEND-IND PIC X(1).
88 MC-RWR-RECEIVED VALUE IS "Y".
88 MC-RWR-NOT-RECEIVED VALUE IS "N".
03 MC-RWR-WHAT-RECEIVED PIC 9(4) COMP.
88 MC-WR-DATA VALUE IS 0.
88 MC-WR-DATA-COMPLETE VALUE IS 1.
88 MC-WR-DATA-INCOMPLETE VALUE IS 2.
88 MC-WR-SEND VALUE IS 3.
88 MC-WR-CONFIRM VALUE IS 4.
88 MC-WR-CONFIRM-SEND VALUE IS 5.
88 MC-WR-CONFIRM-DEALLOCATE VALUE IS 6.
88 MC-WR-PS-HEADER-COMPLETE VALUE IS 9.
88 MC-WR-PS-HEADER-INCOMPLETE VALUE IS 10.
03 MC-RWR-MAP-NAME PIC X(8).
01 MRWR-DATA-LENGTH PIC 9(4) COMP.
01 MRWR-DATA-AREA
02 MRWR-DATA-TEXT PIC X OCCURS 0 TO N TIMES
DEPENDING ON MRWR-DATA-LENGTH.