A fix is available
APAR status
Closed as program error.
Error description
The client was attempting to configure their WUI CMCI JVM and had added the following to their server.xml in order to stop safkeyringhw being changed to safkeyring and JCECCARACFKS to JCERACFK on WUI startup: <keyStore fileBased="false" id="dummy" location= "safkeyring:///*******" password="password" readOnly="true" type="JCERACFKS"/> <keyStore fileBased="false" id="defaultKeyStore" location= "safkeyringhw:///***********" password="password" readOnly ="true" type="JCECCARACFKS"/> This worked as expected but after applying maintenance they experienced the following CWWKG0102I: Found conflicting settings for defaultKeyStore instance of keyStore configuration. Property location has conflicting values: Property type has conflicting values: Value JCECCARACFKS is set in file:/u/xxxx/cics/****** /servers/defaultServer/server.xml. Value JCERACFKS is set in file:/u/xxxx/cics/****** /servers/defaultServer/server.xml. Property type will be set to JCERACFKS.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICS users with UI83848 or UI91770, * **************************************************************** * PROBLEM DESCRIPTION: keyStore element in CMCI JVM server's * * server.xml is always deleted and * * re-written on enable, with the CICS * * default keyStore based on assigned * * SIT parameters. * **************************************************************** When a CMCI JVM server (EYUCMCIJ) is enabled the keyStore element within its server.xml is deleted and then re-written with the CICS default keyStore element, with its attributes based on relevant SIT parameters. This results in any manual custom configuration being overwritten when the CMCI JVM server is enabled. Where more than one keyStore element exists this issue may be observed by receiving a CWWKG0102I, as after three enabling cycles there will be more than one element with id "defaultKeyStore". When specifying a KEYRING system initialization parameter in the new formats provided by APARs PH49253 and PH49261, the parameter cannot be correctly applied to the server.xml for EYUCMCIJ.
Problem conclusion
UI83848 UI91770 CICS has been changed to add two new properties that can be set in the jvmprofile: com.ibm.cics.jvmserver.wlp.server.keystore.location com.ibm.cics.jvmserver.wlp.server.keystore.type These properties are assigned as -D values within the jvmprofile and allow the location and type fields within the keyStore element to be assigned in the JVM server's server.xml. Where these values are not assigned, any existing keyStore element will no longer be overwritten. The sample JVM Profiles have been updated with usage instructions. This APAR also enables the changes made by PH49253 and PH49261 to work in a EYUCMCIJ JVM server.
Temporary fix
Comments
APAR Information
APAR number
PH55288
Reported component name
CICS TS Z/OS V6
Reported component ID
5655YA100
Reported release
400
Status
CLOSED PER
PE
YesPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2023-06-20
Closed date
2023-11-15
Last modified date
2023-12-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PH56456 UI94467
Modules/Macros
DFHAPJVM DFHAXIS2 DFHCDJNI DFHMKDIR DFHSJCLS DFHSJDGS DFHSJPP DFHSJSC DFHSJT8 DFHWLP DFHZFSSH DFJ@H182 DFJ@H186 DFJ@H187 DFJ@H236 DFJ@H237 DFJ@H238 DFJ@H350 DFJ@H352 DFJ@H353 DFJ@H356 DFJ@H360 DFJ@H390 DFJ@H395 DFJ@H396 DFJ@H427 DFJ@H453 DFJ@H454 DFJ@H455 DFJ@H456 DFJ@H457 DFJ@H467 DFJ@H480 DFJ@H484 DFJ@H492 DFJ@H571 DFJ@H586 DFJ@H602 DFJ@H603 DFJ@H604 DFJ@H609 DFJ@H657 DFJ@H997 DFJDTCOE DFJOUTRE DFJWLPBP DFJWLPPL EYUCMCIJ EYUSMSSJ
Fix information
Fixed component name
CICS TS Z/OS V6
Fixed component ID
5655YA100
Applicable component levels
R400 PSY UI94467
UP23/11/18 P F311 {
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"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"6.1","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
04 December 2023