PQ69213: THE LISTJ2EESERVER COMMAND FAILS ON SM API WITH ERROR BBON3051E.

 A fix may be available

Obtain the fix for this APAR



APAR status
Closed as program error.

Error description
The listj2eeserver command in the SM API script fails with the
following error messages:
The reference to entity "JOBNAME..D" must end with the ';'
delimiter.
BBON3051E Xml output file is not valid.
.
This error occurs when the server environment variable
IBM_JAVA_ZOS_TDUMP_PATTERN=DUMP.&JOBNAME..D&YYMMDD..T&HHMMSS is
set in the SMEUI. This error only occurs when this variable is
set in the SMEUI and will not occur when it is set in the
current.env file for the j2ee server.
Local fix
Set the IBM_JAVA_ZOS_TDUMP_PATTERN variable ONLY in the
current.env file for the server. The server will pick up the
environment variable to set the dump data set name, the
listj2eeserver command via the SM API will not, so it will not
fail. The SM API calls a function that retreives the server
properties from the database. If a property is set only in the
current.env, the SM API will not retreive it.The limitations of
the workaround are:
-each time a conversation is activated,the current.env gets
overwritten, so it would have to be updated.
-the environement variable will not be displayed in the output
of the listj2eeserver command.
Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 V4.0.1 for z/OS and OS/390                   *
****************************************************************
* PROBLEM DESCRIPTION: The Systems Management Scripting API    *
*                      (SMAPI) fails with a SAXPArseException  *
*                      when listing j2ee server properties     *
*                      that contain the XML reserved character *
*                      "&".                                    *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
The j2ee server environment variable IBM_JAVA_ZOS_TDUMP_PATTERN
when set to the value "DUMP.&JOBNAME..D&YYMMDD..T&HHMMSS.",
causes a SAXParseException on being processed by the SMAPI
listj2eeserver function. This variable is passed on to the
IEATDUMP service as is on a JVM crash and the above value is
a valid IEATDUMP dump dataset name string pattern.
The cause of the problem is the presence of the reserved XML
char "&" in the environment variable value, which causes the
XML parse exception.
Problem conclusion
Support has been modified to handle presence of the reserved XML
character "&" in server environment properties.

APAR PQ69213 is associated with SERVICE LEVEL W401500 of
WebSphere Application Server V4.0.1 for z/OS and OS/390.
Temporary fix Comments
APAR information
APAR number PQ69213
Reported component name WASKBASE
Reported component ID 5655A9801
Reported release 401
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Submitted date 2002-12-17
Closed date 2003-02-13
Last modified date 2003-03-05

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 UQ74000    UP03/02/28 P F302

  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 #: PQ69213
IBM Group: Software Group
Modified date: Mar 5, 2003