Sending data to the partner transaction
The SEND command is used to send data to the connected partner.
This command is valid in allocated state (state 1) or send state (state 2). Because a successful simple SEND completes in send state (state 2), it is possible to issue a number of successive sends.
An example of a simple SEND command can be seen in
Figure 1.
Figure 1. Transferring data on
an MRO conversation
* ...
DATA DIVISION.
WORKING-STORAGE SECTION.
* ...
01 FILLER.
02 WS-CONVID PIC X(4).
02 WS-RESP PIC S9(8) COMP.
02 WS-STATE PIC S9(8) COMP.
* ...
01 FILLER.
02 WS-SEND-AREA PIC X(70).
02 WS-SEND-LEN PIC S9(5) COMP VALUE +70.
* ...
01 FILLER.
02 WS-RCVD-AREA PIC X(100).
02 WS-MAX-LEN PIC S9(5) COMP VALUE +100.
02 WS-RCVD-LEN PIC S9(5) COMP VALUE +0.
* ...
PROCEDURE DIVISION.
* ...
EXEC CICS SEND CONVID(WS-CONVID) RESP(WS-RESP)
STATE(WS-STATE)
FROM(WS-SEND-AREA) LENGTH (WS-SEND-LEN)
END-EXEC.
* ... Check outcome of SEND.
* ...
*
EXEC CICS SEND INVITE CONVID(WS-CONVID)
RESP(WS-RESP) STATE(WS-STATE)
END-EXEC.
* ...
* Receive data from the partner transaction.
*
EXEC CICS RECEIVE CONVID(WS-CONVID)
RESP(WS-RESP) STATE(WS-STATE)
INTO(WS-RCVD-AREA) MAXLENGTH(WS-MAX-LEN)
NOTRUNCATE LENGTH(WS-RCVD-LEN)
END-EXEC.
*
* ... Check outcome of RECEIVE.
* ...