A fix is available
APAR status
Closed as program error.
Error description
The WebSphere administrative console can display incorrect values for the location of the recovery logs for the compensation service that do not match the location used by the compensation service runtime. This error occurs when the recoveryLogDirectory attribute exists in the compensationService element contained in the server-pme51.xml configuration file for the application server.
Local fix
Since the value for the recovery log directory from server-pme51.xml could be migrated by accident if subsequent changes are made to the compensation service via the admin console, the value can be removed from the server-pme51.xml file. This can be done via the admin console, blanking out the value shown for the compensation service's recovery log directory field and applying the changes. Since there is no danger of the runtime using the value from server-pme51.xml this change is sufficient and that there is no need to restart the servers. This is a per server process.
Problem summary
**************************************************************** * USERS AFFECTED: All users of IBM WebSphere Application * * Server compensation service V6.1.0 * **************************************************************** * PROBLEM DESCRIPTION: The WebSphere administrative console * * can display incorrect values for the * * compensation service's recovery log * * directory. * **************************************************************** * RECOMMENDATION: * **************************************************************** The WebSphere administrative console can display incorrect values for the location of the recovery logs for the compensation service. The configuration of the logs for the compensation service changed between WebSphere versions 5.1 and 6.0.1. In versions before 6.0.1 the location of the logs was stored in the server-pme51.xml file. From version 6.0.1 onwards the runtime ignores that value, it only uses the recoveryLog entry in the serverindex.xml file. Having a value set in server-pme51.xml file will have no effect on the runtime behaviour of the service. The WebSphere Administration console contains logic to administer back-level application servers in a mixed cell environment. For administering a pre V6.0.1 application server the administrative console will read in the recoveryLogsDirectory from the server-pme51.xml as designed. However, the adminministrative console will also retrieve and display a non-default value specified in the server-pme51.xml file when the application server is at version 6.0.1 or later even though this value is not used by the runtime. Furthermore if the compensation service values were changed or reapplied via the administrative console, these values would be migrated into the serverindex.xml, replacing the values in use by the runtime. In the case where the values in the server-pme51.xml did not match the value in use by the runtime this could cause a loss of compensation service state data when the migrated value took effect.
Problem conclusion
The WebSphere administrative console was modified so that it no longer retrieves the recovery log directory for the compensation service from the server-pme51.xml file when processing the configuration for an application server instance running at versions of 6.0.1 and later. APAR PM68230 is currently targeted for inclusion in WebSphere Application Server Fix Pack 6.1.0.45. Please refer to URL: //www.ibm.com/support/docview.wss?rs=404&uid=swg27006970 for Fix Pack availability.
Temporary fix
Comments
APAR Information
APAR number
PM68230
Reported component name
WEBSPHERE FOR Z
Reported component ID
5655I3500
Reported release
610
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2012-07-05
Closed date
2012-09-10
Last modified date
2012-10-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK81671
Modules/Macros
BBGUBINF BBOUBINF
Fix information
Fixed component name
WEBSPHERE FOR Z
Fixed component ID
5655I3500
Applicable component levels
R610 PSY UK81671
UP12/09/23 P F209
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":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS7K4U","label":"WebSphere Application Server for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"6.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]
Document Information
Modified date:
10 February 2022