Testing the conversation state
There are two ways for a transaction to inquire on the current state of one of its conversations.
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. The table also
shows the symbolic names defined for these 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 |
| Pendreceive | 3 | DFHVALUE(PENDRECEIVE) | 87 |
| Pendfree | 4 | DFHVALUE(PENDFREE) | 86 |
| Receive | 5 | DFHVALUE(RECEIVE) | 88 |
| Confreceive | 6 | DFHVALUE(CONFRECEIVE) | 83 |
| Confsend | 7 | DFHVALUE(CONFSEND) | 84 |
| Conffree | 8 | DFHVALUE(CONFFREE) | 82 |
| Syncreceive | 9 | DFHVALUE(SYNCRECEIVE) | 92 |
| Syncsend | 10 | DFHVALUE(SYNCSEND) | 93 |
| Syncfree | 11 | DFHVALUE(SYNCFREE) | 91 |
| Free | 12 | DFHVALUE(FREE) | 85 |
| Rollback | 13 | DFHVALUE(ROLLBACK) | 89 |