A fix is available
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 number
PH03118
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
100
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2018-09-21
Closed date
2018-10-17
Last modified date
2018-11-01
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.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.4","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.4","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
01 November 2018