PQ69213: THE LISTJ2EESERVER COMMAND FAILS ON SM API WITH ERROR BBON3051E. | |||||||||||||||||||||||||||||||||||||||||
![]() |
|||||||||||||||||||||||||||||||||||||||||
![]() 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 is sysrouted FROM one or more of the following: APAR is sysrouted TO one or more of the following: Modules/Macros
|
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
(C) Copyright IBM Corporation 2000, 2006. All Rights Reserved.