Testing the conversation state
There are two ways for an application to inquire on the current conversation state.
The first is to use the EXEC CICS EXTRACT ATTRIBUTES STATE command and the second is to use the STATE parameter on the DTP commands. In both cases the current state is returned to the application in a CICS-value data area (cvda). Table 1 shows how the cvda codes relate to the conversation state. It also shows the symbolic names defined for the cvda values.
| States used in this book | States used in DTP programs | ||
|---|---|---|---|
| State name | State number | Symbolic name | cvda code |
| Allocated | 1 | DFHVALUE(ALLOCATED) | 81 |
| Send | 2 | DFHVALUE(SEND) | 90 |
| Pendfree | 4 | DFHVALUE(PENDFREE) | 86 |
| Receive | 5 | DFHVALUE(RECEIVE) | 88 |
| Syncreceive | 9 | DFHVALUE(SYNCRECEIVE) | 92 |
| Syncfree | 11 | DFHVALUE(SYNCFREE) | 91 |
| Free | 12 | DFHVALUE(FREE) | 85 |
| Rollback | 13 | DFHVALUE(ROLLBACK) | 89 |