State tables for MRO conversations

Tables showing the state transitions that occur when transactions engage in MRO conversations, under the EXEC CICS® API.

The ISSUE SIGNAL command and the EIBSIG flag

In the tables, the EIBSIG flag is not mentioned. This is because its use is optional and is entirely a matter of agreement between the two conversation partners. In the worst case, it can occur at any time after every command that affects the EIB flags. However, used for the purpose for which it was intended, it usually occurs after a SEND command. Its priority in the order of testing depends on the role you give it in the application.

The EIBSIG flag is set when the partner issues the ISSUE SIGNAL command.

The RECEIVE NOTRUNCATE command

The RECEIVE NOTRUNCATE command returns a zero value in EIBCOMPL to indicate that the user buffer was too small to contain all the data received from the partner transaction. Normally, you would continue to issue RECEIVE NOTRUNCATE commands until the last section of data is passed to you, which is indicated by EIBCOMPL = X'FF' . If NOTRUNCATE is not specified, and the data area specified by the RECEIVE command is too small to contain all the data received, CICS truncates the data and sets the LENGERR condition.

State changes for the SYNCPOINT and SYNCPOINT ROLLBACK commands

When the SYNCPOINT and SYNCPOINT ROLLBACK commands are issued, they are propagated on, and affect the state of, all the conversations that are currently active for the task, including APPC conversations.

Following rollback, the conversation can be in SEND or RECEIVE state, depending on the conversation state at the start of the current distributed unit of work.

After a syncpoint or rollback, it is advisable to determine the conversation state before issuing any further commands against the conversation. To do this, use the EXTRACT ATTRIBUTES STATE command or the STATE option on the EXEC CICS commands to determine the conversation state.

State tables

Table 1. States 1 - 6
Command issued EIB flag returned Command returns ALLO- CATED SEND PEND- RECEIVE PEND- FREE RECEIVE CONF- RECEIVE
State 1 State 2 State 3 State 4 State 5 State 6
BUILD ATTACH × Immediately = = N/A = Abend N/A
EXTRACT ATTACH × Immediately = = N/A = = N/A
EXTRACT ATTRIBUTES × Immediately = = N/A = = N/A
SEND INVITE WAIT × After data and CD flows 5 5 N/A Abend Abend N/A
SEND INVITE × After data and CD flows 5 5 N/A Abend Abend N/A
SEND LAST WAIT × After data and EB flows 12 12 N/A Abend Abend N/A
SEND LAST × After data flows 4 4 N/A Abend Abend N/A
SEND × After data flows 2 = N/A Abend Abend N/A
RECEIVE EIBSYNC + EIBFREE + EIBCOMPL After sync flow detected Abend Abend N/A Abend 11 N/A
RECEIVE EIBSYNC + EIBRECV + EIBCOMPL After sync flow detected Abend Abend N/A Abend 9 N/A
RECEIVE EIBSYNRB + EIBCOMPL After rollback flow detected Abend Abend N/A Abend 13 N/A
RECEIVE EIBFREE After EB detected Abend Abend N/A Abend 12 N/A
RECEIVE EIBRECV When data available Abend Abend N/A Abend = N/A
RECEIVE NOTRUNCATE EIBCOMPL When data available Abend Abend N/A Abend = N/A
RECEIVE × When data available Abend Abend N/A Abend 2 N/A
CONVERSE As for RECEIVE but allowed in send state   As for RECEIVE but allowed in send state As for RECEIVE but allowed in send state As for RECEIVE but allowed in send state As for RECEIVE but allowed in send state As for RECEIVE but allowed in send state As for RECEIVE but allowed in send state
SYNCPOINT EIBRLDBK After response from partner = 2 or 5 N/A 2 or 5 Abend ASP1 N/A
SYNCPOINT × After response from partner = = N/A 12 Abend ASP1 N/A
SYNCPOINT ROLLBACK × After rollback across UOW = 2 or 5 N/A 2 or 5 2 or 5 N/A
FREE × Immediately End End N/A End Abend N/A
Table 2. States 7 - 13
Command issued EIB flag returned CONF-SEND CONF-FREE SYNC-RECEIVE SYNC-SEND SYNC-FREE FREE ROLL-BACK
State 7 State 8 State 9 State 10 State 11 State 12 State 13
BUILD ATTACH × N/A N/A = N/A = = =
EXTRACT ATTACH × N/A N/A = N/A = = =
EXTRACT ATTRIBUTES × N/A N/A = N/A = = =
SEND INVITE WAIT × N/A N/A Abend N/A Abend Abend Abend
SEND INVITE × N/A N/A Abend N/A Abend Abend Abend
SEND LAST WAIT × N/A N/A Abend N/A Abend Abend Abend
SEND LAST × N/A N/A Abend N/A Abend Abend Abend
SEND × N/A N/A Abend N/A Abend Abend Abend
RECEIVE EIBSYNC + EIBFREE + EIBCOMPL N/A N/A Abend N/A Abend Abend Abend
RECEIVE EIBSYNC + EIBRECV + EIBCOMPL N/A N/A Abend N/A Abend Abend Abend
RECEIVE EIBSYNRB + EIBCOMPL N/A N/A Abend N/A Abend Abend Abend
RECEIVE EIBFREE N/A N/A Abend N/A Abend Abend Abend
RECEIVE EIBRECV N/A N/A Abend N/A Abend Abend Abend
RECEIVE NOTRUNCATE EIBCOMPL N/A N/A Abend N/A Abend Abend Abend
RECEIVE × N/A N/A Abend N/A Abend Abend Abend
CONVERSE   As for RECEIVE As for RECEIVE As for RECEIVE As for RECEIVE As for RECEIVE As for RECEIVE As for RECEIVE
SYNCPOINT EIBRLDBK N/A N/A 2 or 5 N/A 2 or 5 = Abend
SYNCPOINT × N/A N/A 5 N/A 12 = Abend
SYNCPOINT ROLLBACK × N/A N/A 2 or 5 N/A 2 or 5 = 2 or 5
FREE × N/A N/A Abend N/A Abend End Abend


mro.html | Timestamp icon Last updated: Monday, 5 June 2017