PK30495: IN 6.1 THE 6.0 BEHAVIOR OF LOCAL OS REGISTRY UPPER-CASED IDS MUST STILL BE POSSIBLE

 Fixes are available

6.1.0.15 WebSphere Application Server V6.1 Fix Pack 15 for i5/OS
6.1.0.13 WebSphere Application Server V6.1 Fix Pack 13 for AIX
6.1.0.15 WebSphere Application Server V6.1 Fix Pack 15 for AIX
6.1.0.15: WebSphere Application Server V6.1 Fix Pack 15 for HP-UX
6.1.0.15: WebSphere Application Server V6.1 Fix Pack 15 for Windows
6.1.0.13: WebSphere Application Server V6.1 Fix Pack 13 for Windows
6.1.0.17 WebSphere Application Server V6.1 Fix Pack 17 for i5/OS
6.1.0.13: WebSphere Application Server V6.1 Fix Pack 13 for i5/OS
6.1.0.13: WebSphere Application Server V6.1 Fix Pack 13 for HP-UX
6.1.0.17: WebSphere Application Server V6.1 Fix Pack 17 for Linux
6.1.0.17: WebSphere Application Server V6.1 Fix Pack 17 for Solaris
6.1.0.17: WebSphere Application Server V6.1 Fix Pack 17 for HP-UX
6.1.0.17: WebSphere Application Server V6.1 Fix Pack 17 for Windows
6.1.0.17 WebSphere Application Server V6.1 Fix Pack 17 for AIX
6.1.0.13: WebSphere Application Server V6.1 Fix Pack 13 for Solaris
6.1.0.15: WebSphere Application Server V6.1 Fix Pack 15 for Linux
6.1.0.15: WebSphere Application Server V6.1 Fix Pack 15 for Solaris
6.1.0.9 WebSphere Application Server V6.1 Fix Pack 9 for AIX
6.1.0.9: WebSphere Application Server V6.1 Fix Pack 9 for i5/OS
6.1.0.9: WebSphere Application Server V6.1 Fix Pack 9 for HP-UX
6.1.0.9: WebSphere Application Server V6.1 Fix Pack 9 for Linux
6.1.0.9: WebSphere Application Server V6.1 Fix Pack 9 for Solaris
6.1.0.9: WebSphere Application Server V6.1 Fix Pack 9 for Windows
6.1.0.11: WebSphere Application Server V6.1 Fix Pack 11 for HP-UX
6.1.0.11: WebSphere Application Server V6.1 Fix Pack 11 for Windows
6.1.0.11: WebSphere Application Server V6.1 Fix Pack 11 for Solaris
6.1.0.11: WebSphere Application Server V6.1 Fix Pack 11 for Linux
6.1.0.11: WebSphere Application Server V6.1 Fix Pack 11 for i5/OS
6.1.0.11 WebSphere Application Server V6.1 Fix Pack 11 for AIX
6.1.0.13: WebSphere Application Server V6.1 Fix Pack 13 for Linux
6.1.0.19 WebSphere Application Server V6.1 Fix Pack 19 for AIX
6.1.0.19: WebSphere Application Server V6.1 Fix Pack 19 for HP-UX
6.1.0.19 WebSphere Application Server V6.1 Fix Pack 19 for i5/OS
6.1.0.19: WebSphere Application Server V6.1 Fix Pack 19 for Linux
6.1.0.19: WebSphere Application Server V6.1 Fix Pack 19 for Solaris
6.1.0.19: WebSphere Application Server V6.1 Fix Pack 19 for Windows
Java SDK 1.5 SR8 Cumulative Fix for WebSphere Application Server



APAR status
Closed as program error.

Error description
WebSphere on zOS, V 5.1 and 6.0 provided the behavior of having
userids, when working with a local OS user registry, to be upper
cased.  In WebSphere 6.1 there should be a way to accomodate
this behavior if it is still desireable.
Local fix Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 V6.1.0 for z/OS                              *
****************************************************************
* PROBLEM DESCRIPTION: When using a Local OS registry on z/OS, *
*                      the prinicpal returned by the           *
*                      getRemoteUser() and getUserPrincipal()  *
*                      preserved the case of the principal     *
*                      passed in instead of adhering to z/OS   *
*                      conventions and uppercasing them.       *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
The code in SAFRegistryImpl would preserve the case of the
princiapals before uppercasing them to do the authentication
checks in RACF and returned the preserved prinicpal that was
presented to WebSphere Application Server for z/OS. There were
a few customers who wanted the case to be preserved.  To resolve
this a new custom property was introduced to let the customer
decide how they would like the prinicapal returned.
Problem conclusion
A new custom property at the Local OS registry level called
disable.principal.case.preservation was added to allow the
user to decide if they wanted to preserve the case of the user
that was presented to WAS or if they wanted an upper cased
principal returned.

APAR PK30495 requires changes to WebSphere Application Server
for z/OS V6.1.0 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/was/library/

The V6.1.0 WebSphere Application Server for z/OS
Information Center article "Local operating system settings"
will be updated to include the following descriptions of the
new custom property:

Under the Custom properties link, you can add a value
for the disable.principal.case.preservation property. Setting
this property will force the principal returned by
getRemoteUser()  and getUserPrincipal() calls to be
uppercased. If this property is not set, the case  that was
presented will be preserved.
Temporary fix Comments
ž**** PE08/05/22 PTF IN ERROR. SEE APAR 
PK66366  FOR DESCRIPTION
APAR information
APAR number PK30495
Reported component name WEBSPHERE FOR Z
Reported component ID 5655I3500
Reported release 610
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Special Attention YesSpecatt / CST
Submitted date 2006-08-24
Closed date 2007-05-03
Last modified date 2008-05-23

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

APAR is sysrouted TO one or more of the following:

Modules/Macros

Publications Referenced

Fix information
Fixed component name WEBSPHERE FOR Z
Fixed component ID 5655I3500

Applicable component levels
R500 PSN    UP
R601 PSN    UP
R610 PSY UK25977    UP07/06/26 P F706

  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.


Document Information


Current web document: swg1PK30495.html
Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server for z/OS
Operating system(s):
Software version: 610
Software edition:
Reference #: PK30495
IBM Group: Software Group
Modified date: May 23, 2008