State tables for APPC mapped conversations at sync level 0

Tables showing the state transitions that occur when transactions engage in APPC mapped conversations at sync level 0, 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 tables

Table 1. States 1 - 6
Command issued EIB flags returned Command returns ALLOC- ATED SEND PEND- RECEIVE PEND- FREE RECEIVE CONF- RECEIVE
State 1 State 2 State 3 State 4 State 5 State 6
CONNECT PROCESS EIBERR + EIBFREE Immediately 12 Abend Abend Abend Abend N/A
CONNECT PROCESS × Immediately 2 Abend Abend Abend Abend N/A
EXTRACT PROCESS (back-end transaction only) × Immediately = = = = = N/A
EXTRACT ATTRIBUTES × Immediately = = = = = N/A
SEND (any valid form) EIBERR + EIBFREE After error detected Abend 12 Abend Abend Abend N/A
SEND (any valid form) EIBERR After error detected Abend 5 Abend Abend Abend N/A
SEND INVITE WAIT × After data flows Abend 5 Abend Abend Abend N/A
SEND INVITE × After data buffered Abend 3 Abend Abend Abend N/A
SEND LAST WAIT × After data flows Abend 12 Abend Abend Abend N/A
SEND LAST × After data buffered Abend 4 Abend Abend Abend N/A
SEND WAIT × After data flows Abend = Abend Abend Abend N/A
SEND × After data buffered Abend = Abend Abend Abend N/A
RECEIVE EIBERR + EIBFREE After error detected Abend 12 12 Abend 12 N/A
RECEIVE EIBERR After error detected Abend 5 5 Abend = N/A
RECEIVE EIBFREE After error detected Abend 12 12 Abend 12 N/A
RECEIVE EIBRECV When data available Abend 5 5 Abend = N/A
RECEIVE NOTRUNCATE EIBCOMPL When data available Abend 5 5 Abend = N/A
RECEIVE × When data available Abend = 2 Abend 2 N/A
CONVERSE (equivalent to SEND INVITE WAIT followed by RECEIVE) As for RECEIVE   As for RECEIVE As for RECEIVE As for RECEIVE As for RECEIVE As for RECEIVE As for RECEIVE
ISSUE ERROR EIBFREE After response from partner Abend 12 12 Abend 12 N/A
ISSUE ERROR × After response from partner Abend = 2 Abend 2 N/A
ISSUE ABEND × Immediately Abend 12 12 12 12 N/A
ISSUE SIGNAL × Immediately Abend = = Abend = N/A
WAIT CONVID × Immediately Abend = 5 12 Abend N/A
FREE × Immediately End End Abend End Abend N/A
Table 2. States 7 - 13
Command issued EIB flags 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
CONNECT PROCESS EIBERR + EIBFREE N/A N/A N/A N/A N/A Abend N/A
CONNECT PROCESS × N/A N/A N/A N/A N/A Abend N/A
EXTRACT PROCESS (back-end transaction only) × N/A N/A N/A N/A N/A = N/A
EXTRACT ATTRIBUTES × N/A N/A N/A N/A N/A = N/A
SEND (any valid form) EIBERR + EIBFREE N/A N/A N/A N/A N/A Abend N/A
SEND (any valid form) EIBERR N/A N/A N/A N/A N/A Abend N/A
SEND INVITE WAIT × N/A N/A N/A N/A N/A Abend N/A
SEND INVITE × N/A N/A N/A N/A N/A Abend N/A
SEND LAST WAIT × N/A N/A N/A N/A N/A Abend N/A
SEND LAST × N/A N/A N/A N/A N/A Abend N/A
SEND WAIT × N/A N/A N/A N/A N/A Abend N/A
SEND × N/A N/A N/A N/A N/A Abend N/A
RECEIVE EIBERR + EIBFREE N/A N/A N/A N/A N/A Abend N/A
RECEIVE EIBERR N/A N/A N/A N/A N/A Abend N/A
RECEIVE EIBFREE N/A N/A N/A N/A N/A Abend N/A
RECEIVE EIBRECV N/A N/A N/A N/A N/A Abend N/A
RECEIVE NOTRUNCATE EIBCOMPL N/A N/A N/A N/A N/A Abend N/A
RECEIVE × N/A N/A N/A N/A N/A Abend N/A
CONVERSE (equivalent to SEND INVITE WAIT followed by RECEIVE) As for RECEIVE As for RECEIVE As for RECEIVE As for RECEIVE As for RECEIVE As for RECEIVE As for RECEIVE As for RECEIVE
ISSUE ERROR EIBFREE N/A N/A N/A N/A N/A Abend N/A
ISSUE ERROR × N/A N/A N/A N/A N/A Abend N/A
ISSUE ABEND × N/A N/A N/A N/A N/A Abend N/A
ISSUE SIGNAL × N/A N/A N/A N/A N/A Abend N/A
WAIT CONVID × N/A N/A N/A N/A N/A Abend N/A
FREE × N/A N/A N/A N/A N/A End N/A


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