PQ56467: THIS APAR ADDRESSES DEFECTS IN WEBSPHERE APPLICATION SERVER V4.0.1 FOR Z/OS AND OS/390.

 A fix may be available

Obtain the fix for this APAR



APAR status
Closed as program error.

Error description
This APAR addresses defects in WebSphere Application Server
V4.0.1 for z/OS and OS/390.
Local fix Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 V4.0.1 for z/OS and OS/390.                  *
****************************************************************
* PROBLEM DESCRIPTION: APAR PQ56467 addresses various problems *
*                      in WebSphere Application Server V4.0.1  *
*                      for z/OS and OS/390.                    *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
APAR PQ56467 addresses the following problems in
WebSphere Application Server V4.0.1 for z/OS and OS/390:

(MD12363) Exceptions thrown in bean methods are reported to the
client as NULL pointer exceptions instead of the original
exception.
Problem conclusion
APAR PQ56467 provides the following problem resolution:

(MD12363) Processing will be changed such that the original
exception in the server region is sent back to the
caller/client.
________________________________________________________________
The following publication was revised as a result
of APAR PQ56467:
________________________________________________________________
WebSphere Application Server V4.0.1 for z/OS and OS/390
System Management Scripting API
SA22-7839-02
________________________________________________________________
This 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/
________________________________________________________________
Chapter 9, pg. 224 (added section)

exportserver.xml
<?xml version='1.0'?>
<!--=========================================================-->
<!--   File name:  inputexportserver.xml                     -->
<!--                                                         -->
<!--   Descriptive name:  ...                                -->
<!--                                                         -->
<!--   Proprietary statement:                                -->
<!--                                                         -->
<!-- Licensed Material - Property of IBM                     -->
<!--                                                         -->
<!-- 5655-F31 (C) Copyright IBM Corp. 2000, 2001             -->
<!-- All Rights Reserved.                                    -->
<!-- U.S. Government users - RESTRICTED RIGHTS - Use,        -->
<!-- Duplication, or Disclosure restricted by GSA-ADP        -->
<!-- schedule contract with IBM Corp.                        -->
<!-- Status = H28W401                                        -->
<!--                                                         -->
<!--  Change history:                                        -->
<!--$L0=MD12514, H28W401, 20011018, PDRK: Created.           -->
<!--                                                         -->
<!--=========================================================-->
<!-- internal DTD -->
<!DOCTYPE inputexportserver
<!ELEMENT inputexportserver EMPTY>
<!ATTLIST inputexportserver
  conversationname CDATA #REQUIRED
  outputdirectory CDATA #REQUIRED
  servername CDATA #REQUIRED
>
 >

<!--begin of default values-->
<inputexportserver
  conversationname = ''
  outputdirectory = ''
  servername = ''
>
</inputexportserver>
________________________________________________________________
Chapter 9, pg. 227 (changed section)

<?xml version='1.0'?>
<!--=========================================================-->
<!--   File name:  inputcreatej2eeserver.xml                 -->
<!--                                                         -->
<!--   Descriptive name:  ...                                -->
<!--                                                         -->
<!--   Proprietary statement:                                -->
<!--                                                         -->
<!--   Licensed Material - Property of IBM                   -->
<!--   5655-F31 (C) Copyright IBM Corp. 2000, 2001           -->
<!--                                                         -->
<!--   All Rights Reserved.                                  -->
<!--                                                         -->
<!--   U.S. Government users - RESTRICTED RIGHTS - Use,      -->
<!--   Duplication, or Disclosure restricted by GSA-ADP      -->
<!--   schedule contract with IBM Corp.                      -->
<!--                                                         -->
<!--   Status = H28W401                                      -->
<!--                                                         -->
<!--  Change history:                                        -->
<!--$L0=
OW44455, H28K510, 20000721, PDBL: Created.           -->
<!--$L1=
OW44455, CB4.0, 20001205, PDBL: OLT support,         -->
<!--                              security enhancement       -->
<!--$L2=
OW44455, CB4.0, 20010125, PDBL: kerberos, assertedID -->
<!--                                          support        -->
<!--$P0=MD12564,H28W401, 20011204, PDBR:Enable SMF properties-->
<!--                                                         -->
<!--=========================================================-->
<!-- internal DTD -->
<!DOCTYPE inputcreatej2eeserver
<!ELEMENT security EMPTY>
<!ATTLIST security
 value CDATA #REQUIRED
>
<!ELEMENT environment EMPTY>
<!ATTLIST environment
 value CDATA #REQUIRED
 name CDATA #REQUIRED
>
<!ELEMENT inputcreatej2eeserver (environment*,security*)>
<!ATTLIST inputcreatej2eeserver
  acceptassertedid (Y|N) #REQUIRED
  allowkerberos (Y|N) #REQUIRED
  allownonauthenticatedclients (Y|N) #REQUIRED
  allowserverregiongarbagecollection (Y|N) #REQUIRED
  allowuseridpasswd (Y|N) #REQUIRED
  allowssl (Y|N) #REQUIRED
  allowsslclientcerts (Y|N) #REQUIRED
  conversationname CDATA #REQUIRED
  dcekeytabfile  CDATA #REQUIRED
  dcequalityofprotection CDATA #REQUIRED
  debuggerallowed (Y|N) #REQUIRED
  enablerunasidentity (Y|N) #REQUIRED
  garbagecollectioninterval CDATA #REQUIRED
  identityofthecontrolregion CDATA #REQUIRED
  identityoftheserverregion CDATA #REQUIRED
  isolationpolicy CDATA #REQUIRED
  j2eeserverdescription CDATA #IMPLIED
  j2eeservername CDATA #REQUIRED
  localidentity CDATA #REQUIRED
  logstreamname CDATA #REQUIRED
  olthostname CDATA #REQUIRED
  oltport CDATA #REQUIRED
  procname CDATA #REQUIRED
  productionserver (Y|N) #REQUIRED
  remoteidentity CDATA #REQUIRED
  replicationpolicy CDATA #REQUIRED
  sendassertedid (Y|N) #REQUIRED
  serverregionjvmname CDATA #REQUIRED
  serverregionrequiresjvm (Y|N) #REQUIRED
  serverregionstacksize CDATA #REQUIRED
  smfwrserveractivity (Y|N) #REQUIRED
  smfwrcontaineractivity (Y|N) #REQUIRED
  smfwrserverinterval (Y|N) #REQUIRED
  smfwrcontainerinterval (Y|N) #REQUIRED
  smfintervallength CDATA #REQUIRED
  sslracfkeyring CDATA #REQUIRED
  sslv2timeout CDATA #REQUIRED
  sslv3timeout CDATA #REQUIRED
  transactionfactory (Y|N) #REQUIRED
  usedce (Y|N) #REQUIRED
  useibmconfidential (Y|N) #REQUIRED
  useridpassticket (Y|N) #REQUIRED
>
 >

<!--begin of default values-->
<inputcreatej2eeserver
  acceptassertedid = 'N'
  allowkerberos = 'N'
  allownonauthenticatedclients = 'N'
  allowserverregiongarbagecollection = 'Y'
  allowuseridpasswd = 'N'
  allowssl = 'N'
  allowsslclientcerts = 'N'
  conversationname = ''
  dcekeytabfile = ''
  dcequalityofprotection = 'No_Protection'
  debuggerallowed = 'Y'
  enablerunasidentity = 'N'
  garbagecollectioninterval = '50000'
  identityofthecontrolregion = ''
  identityoftheserverregion = ''
  isolationpolicy = 'One_Transaction_Per_Server_Region'
  j2eeserverdescription = ''
  j2eeservername = ''
  localidentity = ''
  logstreamname = ''
  olthostname = ''
  oltport = '5000'
  procname = ''
  productionserver = 'N'
  remoteidentity = ''
  replicationpolicy = 'Replicate_As_Needed'
  sendassertedid = 'N'
  serverregionjvmname = ''
  serverregionrequiresjvm = 'N'
  serverregionstacksize = ''
  smfwrserveractivity = 'N'
  smfwrcontaineractivity = 'N'
  smfwrserverinterval = 'N'
  smfwrcontainerinterval = 'N'
  smfintervallength = '3600'
  sslracfkeyring = 'CBKeyring'
  sslv2timeout = '100'
  sslv3timeout = '600'
  transactionfactory = 'N'
  usedce = 'N'
  useibmconfidential = 'N'
  useridpassticket = 'N'
>
</inputcreatej2eeserver>
________________________________________________________________
The following publication was revised as a result
of APAR PQ56467:
________________________________________________________________
WebSphere Application Server V4.0.1 for z/OS and OS/390
Messages and Diagnosis
GA22-7837-02
________________________________________________________________
This 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/
________________________________________________________________
Chapter 9, pg. 130 (new message)
BBON0887I The reference from EJB EJB-name to JNDI-name could not
be validated.
Explanation: The J2EE Application (*.ear file) that is being
installed has already been resolved before. While checking the
resolved references to Enterprise Java Beans the System
Management User Interface detected that the targets for one or
more of these references do not currently exist in the current
conversation. Either the reference is no longer valid, since
the target bean is no longer installed, or the reference has
been resolved to another system outside the scope of this
WebSphere installation, for which the System Management User
Interface cannot do validation. Note that this will not prevent
the application from being installed and run properly, unless
the references cannot be resolved at all.
User Response: Make sure that all Enterprise Java Beans
referenced by your application have already been installed. If
they have already been installed, but have been registered in
JNDI with a different name, you can resolve the reference again
to the new JNDI name in the following dialog.
________________________________________________________________
Chapter 10, pg. 178 (changed)
BBON3010E Getting xml parser reference for parsing xml input
failed.
Explanation: This error occurs while the client generates
the input stream for the server side. During the generation
of a DOMParser object an error occurred.
User Response: Follow your local procedures for contacting IBM
for support.
________________________________________________________________
Chapter 10, pg. 178 (changed)
BBON3011E Xml input file is not valid.
Explanation: This error occurs while the client generates
the input stream for the server side. During the generation
of a DOMParser object an exception has appeared.
User Response: Follow your local procedures for contacting IBM
for support.
________________________________________________________________
Chapter 10, pg. 179 (changed)
BBON3012E Getting xml input document reference failed.
Explanation: This error occurs while the client generates
the input stream for the server side. The DOMParser object
could not get the document from the xml input string.
User Response:  Follow your local procedures for contacting IBM
for support.
________________________________________________________________
Chapter 10, pg. 182 (new message)
BBON3050E Getting xml parser reference for parsing xml output
failed.
Explanation: This error occurs while the client parses the
output stream from the server side. During the generation of
a DOMParser object an error occurred.
User Response: Follow your local procedures for contacting IBM
for support.
________________________________________________________________
Chapter 10, pg. 182 (new message)
BBON3051E Xml output file is not valid.
Explanation: This error occurs while the client parses the
output stream from the server side. During the generation of
a DOMParser object an exception has appeared cause the server
side has send an XML document which contains invalid
characters.
User Response: Follow your local procedures for contacting IBM
for support.
________________________________________________________________
Chapter 10, pg. 182 (new message)
BBON3052E Getting xml output document reference failed.
Explanation: This error occurs while the client parses the
output stream from the server side. The DOMParser object
could not get the document from the xml output string.
User Response: Follow your local procedures for contacting IBM
for support.
________________________________________________________________
Chapter 10, pg. 182 (new message)
BBON3053E Getting root element of xml output document failed.
Explanation: This error occurs while the client parses the
output stream from the server side. The DOMParser object could
not get the root element of the xml output string.
User Response:  Follow your local procedures for contacting IBM
for support.
________________________________________________________________
Chapter 10, pg. 187 (changed)
BBON3136E Conversation conversationname not found or not owned
by this administrator.
Explanation: The conversation indicated by conversationname
either does not exist or is not owned by the administrator
running the script.
User Response: Check your script to make sure the
conversationname is correct.  Also verify that the conversation
is owned by your  administrator id.
________________________________________________________________
APAR PQ56467 is associated with SERVICE LEVEL W401013 of
WebSphere Application Server V4.0.1 for z/OS and OS/390.
Temporary fix Comments
APAR information
APAR number PQ56467
Reported component name WASKBASE
Reported component ID 5655A9801
Reported release 401
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Submitted date 2002-01-08
Closed date 2002-01-08
Last modified date 2002-02-02

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 UQ61730    UP02/01/17 P F201

  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 #: PQ56467
IBM Group: Software Group
Modified date: Feb 2, 2002