PQ80286: ESCAPE CHAR REQ FOR # WHEN CREATING LDAP DN NAMES

 A fix may be available

Obtain the fix for this APAR



APAR status
Closed as program error.

Error description
Customer has a sysplex name that contains a # character.
The sysplex name is used as part of the jndi name in the
ldap based namespace.  But the # is a special character to
ldap and the attempt to call an ldap function with this
character results in the following failure during step 11 of
the bootstrap process:
javax.naming.ConfigurationException: Cannot create Name Tree -
Exception creating Primary Context: ibm-wsnName=LSY#00.
Root exception is:
javax.naming.NameNotFoundException:  LDAP: error code 32 - R0020
An escape sequence found in the following DN component is not va
ibm-wsnName=LSY#00 (dir_rdn.c|1.19|816), (schemaimpl.c|1.77|2680
(schemaimpl.c|1.77|2570) ; remaining name 'ibm-wsnName=LSY#00
:at com.sun.jndi.ldap.LdapCtx.mapErrorCode(LdapCtx.java:2775)
:at com.sun.jndi.ldap.LdapCtx.processReturnCode(LdapCtx.java:269
:at com.sun.jndi.ldap.LdapCtx.processReturnCode(LdapCtx.java:250
the ldap reason code is truncated, it's R002002, which means
the following:
an escape sequence found in the following DN component is not
valid, meaning the # needs to have a / in front of it as an
escape character.  The locations where WebSpere Application
Server for z/os creates a dn for input to an ldap function
using the sysplex name must be checked for a # character and
a / escape character must be placed immediately before it.
The Security Server LDAP Client Programming document contains
an explanation on how to handle the escape character.
Local fix
no local fix is available
Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 version 4.0.1 for z/OS and OS/390.           *
****************************************************************
* PROBLEM DESCRIPTION: A '#' character  in a SYSPLEX name      *
*                      causes the following error during       *
*                      step 11 of the bootstrap process        *
*                      (ldap tree initialization):             *
*                      javax.naming.ConfigurationException:    *
*                         Cannot create Name Tree -            *
*                         Exception creating Primary Context:  *
*                            ibm-wsnName=LSY#00.               *
*                         Root exception is:                   *
*                         javax.naming.NameNotFoundException:  *
*                           LDAP: error code 32 - R0020        *
*                           An escape sequence found in the    *
*                           following DN component is not      *
*                           valid                              *
*                           ibm-wsnName=LSY#00                 *
*                            (dir_rdn.c|1.19|816),             *
*                            (schemaimpl.c|1.77|2680           *
*                            (schemaimpl.c|1.77|2570) ;        *
*                            remaining name 'ibm-wsnName=LSY#0 *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
The '#' is a special ldap charachter that requires escaping.
This problem affects the upper tree structure only as standard
jndi names are scanned for this character as part of
jndi processing. The upper tree structure is created with
pieces of information, one of which is the SYSPLEX
name. If the SYSPLEX name validly contains a hash mark,
the error is encountered.
Problem conclusion
Support has been modified to escape any pound sign characters
found in a the piece of data derived from the sysplex name.

APAR PQ80286 is associated with SERVICE LEVEL W401606 of
WebSphere Application Server version 4.0.1 for z/OS and OS/390.
Temporary fix Comments
APAR information
APAR number PQ80286
Reported component name WASKBASE
Reported component ID 5655A9801
Reported release 401
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Submitted date 2003-10-31
Closed date 2003-11-21
Last modified date 2004-01-03

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:

Modules/Macros
BBOUBINF          

Fix information
Fixed component name WASKBASE
Fixed component ID 5655A9801

Applicable component levels
R401 PSY UQ82447    UP03/12/03 P F312

  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


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server for z/OS
Operating system(s):
Software version: 401
Software edition:
Reference #: PQ80286
IBM Group: Software Group
Modified date: Jan 3, 2004