PH03118: THE CICS TRANSLATOR DOES NOT UNDERSTAND CERTAIN EYUDA VALUES WHEN USING FUNCTION EYUVALUE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• .You are translating program source code using one of the CICS
  translator programs ( DFHECP1$, DFHEPP1$, DFHEDP1$, DFHEAP1$ )
  .
  Your source code uses the CICSPlex SM translator function
  called EYUVALUE to convert a character string representation of
  an EYUDA value to its numeric format. An example of this in an
  assembler program would be:
  .
       CLC   FIELD001,EYUVALUE(OK)
  .
  For certain EYUDA values, the translator fails to interpret
  them, leading to the following error message:
  .
     DFH7257I S  'xxxxxx' IS NOT RECOGNISED AND IS NOT TRANSLATED.
  .
  where 'xxxxxx' is a valid EYUDA value. This APAR was submitted
  because the EYUDA values
   .
     EYUVALUE(LOCKED)   and
     EYUVALUE(UOW)
  .
  were not recognized. Any others that are missing will be
  corrected and documented in the APAR closing text.
  .
  
  .
  Additional Symptom(s) Search Keyword(s): KIXREVxxx
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: CICSPlex SM V5R4M0 users.                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS Translator support is missing      *
  *                      or incorrect for various EYUDA values   *
  *                      when used with the EYUVALUE function.   *
  *                      The CICS translator issues message      *
  *                      DFH7257I and the translation completes  *
  *                      with a RC12 when the EYUVALUE function  *
  *                      is used with the affected values.       *
  ****************************************************************
  The CICS Translator uses DFHSMTAB when performing
  CPSM API related functions using the EYUVALUE function.
  .
  The following EYUDA values are defined incorrectly in DFHSMTAB:
  IPCONDEF (must change from 475 to 477)
  CSDINLST (must change from 500 to 499)
  MQMONDEF (must change from 568 to 782)
  .
  CPSM API programs using EYUVALUE(xxx), where xxx is one of the
  above three values, would have been assembled with incorrect
  equate values. After applying the PTF which resolves PH03118,
  the correct EYUDA values will be used the next time any
  such program is assembled.
  .
  The following EYUDA values are not defined in DFHSMTAB, and
  must be added:
  
  EXCI (475)
  RECREATED (476)
  SAME (478)
  SUPPORTED (479)
  ENABLED (487)
  DISABLED (488)
  SNA (489)
  IPIC (490)
  PARTIAL (491)
  CSDINGRP (500)
  LOCKED (501)
  UOW (502)
  SIT (503)
  EYU (504)
  TABLE (505)
  SYSIN (506)
  WUI (507)
  REQUIRED (508)
  COMBINED (509)
  LNQUEUE (510)
  LNGOAL (511)
  GROUPRESYNC (512)
  INSTALLING (513)
  DISCARDING (514)
  MQMON (568)
  TRUSTED (754)
  ETDSA (755)
  EMPTY (756)
  INCOMPLETE (757)
  INVALIDSCOPE (758)
  DISABLING (759)
  ENABLING (760)
  SOMEDISABLED (761)
  BYTE (762)
  KILOBYTE (763)
  MEGABYTE (764)
  GIGABYTE (765)
  THOUSAND (766)
  SECOND (767)
  MILLISECOND (768)
  MICROSECOND (769)
  ABEND (770)
  PLATFORM (771)
  APPLICATION (772)
  APPLMAJVER (773)
  APPLMINVER (774)
  APPLMICVER (775)
  OPERATION (776)
  IMPORTONLY (777)
  AVAILABLE (778)
  UNAVAILABLE (779)
  SOMEAVAIL (780)
  520 (781)
  TASK (783)
  .
  CPSM API programs using EYUVALUE(xxx), where xxx is one of the
  above three values, would not assemble. The CICS translator
  would issue msgDFH7257I, and complete with RC=12.
  

Problem conclusion

• The CICS translator has been updated with the missing values.
  The values for IPCONDEF, CSDINLST, and MQMONDEF have been
  corrected.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UI59165

Modules/Macros

• DFHSMTAB
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R100 PSY UI59165

     UP18/10/18 P F810

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.