CICS-value data areas (cvdas)

There are options on a number of commands that describe or define a resource. CICS® supplies, in CICS-value data areas, the values associated with these options. The options are shown in the syntax of the commands with the term cvda in parentheses.

You pass a CVDA value in two different ways:

You can assign a CVDA value with the translator routine DFHVALUE. This allows you to change a CVDA value in the program as the result of other run-time factors.
For example:
```
MOVE DFHVALUE(NOTPURGEABLE) TO AREA-A.
EXEC CICS WAIT EXTERNAL ECBLIST() NUMEVENTS()
                        PURGEABILITY(AREA-A)
```
If the required action is always the same, you can declare the value directly.
For example:
```
EXEC CICS WAITCICS ECBLIST() NUMEVENTS() PURGEABLE
```

You receive a CVDA value by defining a fullword binary data area and then testing the returned value with the translator routine DFHVALUE. For example:

EXEC CICS CONNECT PROCESS .... STATE(AREA-A)
IF AREA-A = DFHVALUE(ALLOCATED) ....
IF AREA-A = DFHVALUE(CONFFREE) ....

The CVDA values and their numeric equivalents are listed in the following topics: