State tables for APPC mapped conversations at sync level 1
Tables showing the state transitions that occur when transactions engage in APPC mapped conversations at sync level 1, 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
| 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 | Abend |
| CONNECT PROCESS | × | Immediately | 2 | Abend | Abend | Abend | Abend | Abend |
| EXTRACT PROCESS (back-end transaction only) | × | Immediately | Abend | = | = | = | = | = |
| EXTRACT ATTRIBUTES | × | Immediately | = | = | = | = | = | = |
| SEND (any valid form) | EIBERR + EIBFREE | After error flow detected | Abend | 12 | 12 | 12 | Abend | Abend |
| SEND (any valid form) | EIBERR | After error flow detected | Abend | 5 | 5 | 5 | Abend | Abend |
| SEND INVITE WAIT | × | After data flows | Abend | 5 | Abend | Abend | Abend | Abend |
| SEND INVITE CONFIRM | × | After response from partner | Abend | 5 | Abend | Abend | Abend | Abend |
| SEND INVITE | × | After data buffered | Abend | 3 | Abend | Abend | Abend | Abend |
| SEND LAST WAIT | × | After data flows | Abend | 12 | Abend | Abend | Abend | Abend |
| SEND LAST CONFIRM | × | After response from partner | Abend | 12 | Abend | Abend | Abend | Abend |
| SEND LAST | × | After data buffered | Abend | 4 | Abend | Abend | Abend | Abend |
| SEND WAIT | × | After data flows | Abend | = | Abend | Abend | Abend | Abend |
| SEND CONFIRM | × | After response from partner | Abend | = | 5 | 12 | Abend | Abend |
| SEND | × | After data buffered | Abend | = | Abend | Abend | Abend | Abend |
| RECEIVE | EIBERR + EIBFREE | After error detected | Abend | 12 | 12 | Abend | 12 | Abend |
| RECEIVE | EIBERR | After error detected | Abend | 5 | 5 | Abend | = | Abend |
| RECEIVE | EIBCONF + EIBFREE | After confirm flow detected | Abend | 8 | 8 | Abend | 8 | Abend |
| RECEIVE | EIBCONF + EIBRECV | After confirm flow detected | Abend | 6 | 6 | Abend | 6 | Abend |
| RECEIVE | EIBCONF | After confirm flow detected | Abend | 7 | 7 | Abend | 7 | Abend |
| RECEIVE | EIBFREE | After error detected | Abend | 12 | 12 | Abend | 12 | Abend |
| RECEIVE | EIBRECV | When data available | Abend | 5 | 5 | Abend | = | Abend |
| RECEIVE NOTRUNCATE | EIBCOMPL | When data available | Abend | 5 | 5 | Abend | = | Abend |
| RECEIVE | × | When data available | Abend | = | 2 | Abend | 2 | Abend |
| 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 CONFIRMATION | × | Immediately | Abend | Abend | Abend | Abend | Abend | 5 |
| ISSUE ERROR | EIBFREE | After response from partner | Abend | 12 | 12 | Abend | 12 | 12 |
| ISSUE ERROR | × | After response from partner | Abend | = | 2 | Abend | 2 | 2 |
| ISSUE ABEND | × | Immediately | Abend | 12 | 12 | 12 | 12 | 12 |
| ISSUE SIGNAL | × | Immediately | Abend | = | = | Abend | = | = |
| WAIT CONVID | × | Immediately | Abend | = | 5 | 12 | Abend | Abend |
| FREE | × | Immediately | End | End | Abend | End | Abend | Abend |
| 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 | Abend | Abend | N/A | N/A | N/A | Abend | N/A |
| CONNECT PROCESS | × | Abend | Abend | N/A | N/A | N/A | Abend | N/A |
| EXTRACT PROCESS (back-end transaction only) | × | = | = | N/A | N/A | N/A | = | N/A |
| EXTRACT ATTRIBUTES | × | = | = | N/A | N/A | N/A | = | N/A |
| SEND (any valid form) | EIBERR + EIBFREE | Abend | Abend | N/A | N/A | N/A | Abend | N/A |
| SEND (any valid form) | EIBERR | Abend | Abend | N/A | N/A | N/A | Abend | N/A |
| SEND INVITE WAIT | × | Abend | Abend | N/A | N/A | N/A | Abend | N/A |
| SEND INVITE CONFIRM | × | Abend | Abend | N/A | N/A | N/A | Abend | N/A |
| SEND INVITE | × | Abend | Abend | N/A | N/A | N/A | Abend | N/A |
| SEND LAST WAIT | × | Abend | Abend | N/A | N/A | N/A | Abend | N/A |
| SEND LAST CONFIRM | × | Abend | Abend | N/A | N/A | N/A | Abend | N/A |
| SEND LAST | × | Abend | Abend | N/A | N/A | N/A | Abend | N/A |
| SEND WAIT | × | Abend | Abend | N/A | N/A | N/A | Abend | N/A |
| SEND CONFIRM | × | Abend | Abend | N/A | N/A | N/A | Abend | N/A |
| SEND | × | Abend | Abend | N/A | N/A | N/A | Abend | N/A |
| RECEIVE | EIBERR + EIBFREE | Abend | Abend | N/A | N/A | N/A | Abend | N/A |
| RECEIVE | EIBERR | Abend | Abend | N/A | N/A | N/A | Abend | N/A |
| RECEIVE | EIBCONF + EIBFREE | Abend | Abend | N/A | N/A | N/A | Abend | N/A |
| RECEIVE | EIBCONF + EIBRECV | Abend | Abend | N/A | N/A | N/A | Abend | N/A |
| RECEIVE | EIBCONF | Abend | Abend | N/A | N/A | N/A | Abend | N/A |
| RECEIVE | EIBFREE | Abend | Abend | N/A | N/A | N/A | Abend | N/A |
| RECEIVE | EIBRECV | Abend | Abend | N/A | N/A | N/A | Abend | N/A |
| RECEIVE NOTRUNCATE | EIBCOMPL | Abend | Abend | N/A | N/A | N/A | Abend | N/A |
| RECEIVE | × | Abend | Abend | 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 | |
| ISSUE CONFIRMATION | × | 2 | 12 | N/A | N/A | N/A | Abend | N/A |
| ISSUE ERROR | EIBFREE | 12 | 12 | N/A | N/A | N/A | Abend | N/A |
| ISSUE ERROR | × | 2 | 2 | N/A | N/A | N/A | Abend | N/A |
| ISSUE ABEND | × | 12 | 12 | N/A | N/A | N/A | Abend | N/A |
| ISSUE SIGNAL | × | = | = | N/A | N/A | N/A | Abend | N/A |
| WAIT CONVID | × | Abend | Abend | N/A | N/A | N/A | Abend | N/A |
| FREE | × | Abend | Abend | N/A | N/A | N/A | End | N/A |