A fix is available
APAR status
Closed as program error.
Error description
The z-native code relys on retrieving the cookie name from server.xml if the cookie name is changed to something different than JSESSIONID. When the cookie name is set at application level it is placed in the deployment.xml of the application and the z-native code is unable to handle the change in cookie name and route the request incorrectly.
Local fix
Set the cookie name at the server level.
Problem summary
**************************************************************** * USERS AFFECTED: All users of IBM WebSphere Application * * Server V7.0 * **************************************************************** * PROBLEM DESCRIPTION: A WebSphere Application Server for z/OS * * server running with multiple Servants * * does not route HTTP requests with * * session affinity to the proper Servant. * **************************************************************** * RECOMMENDATION: * **************************************************************** By default, the name of the cookie that carries session affinity information is JSESSIONID, however this value can be overridden for a specific application or web module. When a WebSphere for z/OS Controller routes HTTP requests to a Servant, it looks for session affinity information in the cookie name that is specified at the server level; it does not check if the session cookie name is overridden at another level. Thus, if the option to override the session cookie name at the application or web module level is enabled, WebSphere Application Server for z/OS servers with more than one Servant will not be able to route HTTP requests for that application or module to the right Servant.
Problem conclusion
Code was changed so that when the JVM Custom Property com.ibm.ws390.routing.EnableCustomSessionCookieName is set to true, the Controller properly checks for an overridden session cookie name at the application or web module level for each request. APAR PM26672 APAR requires changes to documentation. NOTE: Periodically, we refresh the documentation on our Web site, so the changes might have been made before you read this text. To access the latest on-line documentation, go to the product library page at: http://www.ibm.com/software/webservers/appserv/library The following changes to the z/OS version of the WebSphere Application Server Version 7.0 Information Center will be made available in September, 2011. The following Avoid Trouble note will be added to the description of the Enable cookies mechanism in the "Session management settings" topic: Avoid Trouble: If you are running with multiple servants enabled, and the session management configuration setting for the session cookie name might be overridden at either the application or web module level, you must set the com.ibm.ws390.routing.EnableCustomSessionCookieName custom property to true to enable the controller to continue routing requests to the proper servant. If com.ibm.ws390.routing.EnableCustomSessionCookieName=true is not added to the session management configuration for the controller before the session cookie name changes, the controller will not be able to properly route requests to the affected servants. See the topic "Java Virtual Machine custom properties" for more information about this property. The following information will be added to the topic "Java Virtual Machine custom properties": com.ibm.ws390.routing.EnableCustomSessionCookieName Use this property to enable routing of requests from the controller to the proper servant in a situation where, in a multiple servant environment, you are overriding the default value for the session cookie name at either the application or web module level. The default session management configuration setting for the session cookie name is JSESSIONID. If you are running with multiple servants enabled, and the session management configuration setting for the session cookie name might be overridden at either the application or web module level, you must set the com.ibm.ws390.routing.EnableCustomSessionCookieName custom property to true to enable the controller to continue routing requests to the proper servant. If com.ibm.ws390.routing.EnableCustomSessionCookieName=true is not added to the session management configuration for the controller before the session cookie name changes, the controller will not be able to properly route requests to the affected servants. This custom property must be set for the controller. When specified, this setting applies to all of the servants associated with that controller. This custom property is not required if you are running in a single servant environment. The default value for this property is false. APAR PM26774 is currently targeted for inclusion in Service Level (Fix Pack) 7.0.0.19 of WebSphere Application Server V7.0. 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
PM26774
Reported component name
WEBSPHERE FOR Z
Reported component ID
5655I3500
Reported release
700
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2010-11-15
Closed date
2011-05-24
Last modified date
2011-10-04
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Fix information
Fixed component name
WEBSPHERE FOR Z
Fixed component ID
5655I3500
Applicable component levels
R700 PSY UK71280
UP11/09/10 P F109
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":"7.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]
Document Information
Modified date:
10 February 2022