CICS and CICSPlex SM value data areas

These values can be CICSPlex SM value data areas (EYUDAs) or CICS® value data areas (CVDAs). You can use one of two built-in translator functions to translate these values:

EYUDAs

Use the CICSPlex SM translator function called EYUVALUE.

The EYUVALUE function is not available to programs written in REXX. You can use the TPARSE command, that is supplied specifically for REXX programs, to access and translate the attribute values in a resource table. For a description of this command, see REXX functions and commands.

CVDAs

Use the CICS translator function called DFHVALUE.

In some CICS environments, the DFHVALUE function might return incompatible CVDA values. Because these CVDA values conflict with values used in other CICS environments, CICSPlex SM must modify them to retain their uniqueness. CICSPlex SM adds either 8000 or 9000 to the value returned by DFHVALUE for each of these CVDA attributes. For more information about translating CVDA values, see TRANSLATE command.

For example, consider the following COBOL statement:

  MOVE EYUVALUE(QUIESCING) TO EYUDATA

This statement translates the EYUDA character value of QUIESCING into its numeric equivalent of 48 when the program is translated. CICSPlex SM also provides a TRANSLATE command to translate EYUDA and CVDA values at run time. You can use TRANSLATE to convert an EYUDA or CVDA value that is associated with a specific resource table and attribute:

  EXEC CPSM TRANSLATE OBJECT(WLMAWAOR)
                      ATTRIBUTE(STATUS)
                      FROMCV(48)
                      TOCHAR(EYUCHAR)
                      RESPONSE(RESPDATA)
                      REASON(REASDATA)