CICS and CICSPlex SM value data areas

The values for some CICSPlex® SM resource table attributes are maintained in an encoded form. These values can be:

You can use one of two built-in translator functions to translate these values:

EYUDAs
Use the CICSPlex SM translator function called EYUVALUE. You must also specify the CPSM translator option when you run the CICS/ESA translator.
CVDAs
Use the CICS translator function called DFHVALUE. You must also specify the CICS translator option when you run the CICS/ESA translator.

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.

Notes:
  1. The EYUVALUE function is not available to programs written in REXX. You can use the TPARSE command, which 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.
  2. In some CICS environments, the DFHVALUE function returns incompatible CVDA values for the following resource table attribute:
    Resource table Attribute value CICS Environment
    LOCTRAN RESSEC(RESSECEXT) CICS/MVS
    Because these CVDA values conflict with values used in other CICS environments, CICSPlex SM must modify them to retain their uniqueness. CICSPlex SM adds 9000 to the value returned by DFHVALUE for each of these CICS CVDA attributes.

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. For example:

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

This command translates the EYUDA value for the STATUS attribute of the WLMAWAOR resource table into its character value when the program is run.

For a description of the TRANSLATE command, see TRANSLATE.

Note:
For a list of the EYUDA values used by CICSPlex SM, see Appendix B. EYUDA values.
[[ Contents Previous Page | Next Page Index ]]