XOH37003 Maintenance Update for HP-UX CASP for WebSphere Access

Problem Description(s):

These could be the types of problems the user might encounter:

Fixpack 3:

1-49785371 - Warning during KXO modules verification in the 
             WAS or ASTK: "variable static but not final".

1-57787341 - The Manifest Class-Path contains "null" value

1-57787357 - Method: ejbCreate() must not throw application exceptions.

Fixpack 2:           

1-47375201 An empty XML document is passed to the user's EJB by the 
           Inbound Connector.

1-47675631 Improved diagnostic for the create() method not found error.

1-39871402 The deployment descriptor for the KxoOutboundBean EJB contains 
	   wrong method signature.

1-47713191 The inbound listener deployment descriptor contains a reference 
           to the inbound sample EJB that causes warnings in the WAS log.
           
1-47766013 The outbound bean deployment descriptor contains invalid 
           reference to EJB module that causes warnings in the WAS log.
           
1-47922691 ClassCastException for wsmq/SessionPoolTimeout and 
           wsmq/SessionPoolSize in the WAS log during KxoOutboundBean 
           initialization.
           
1-47991161 Invalid deployment descriptor for KxoMDBean. WAS5.1 raises 
           error during KxoMDBean deployment. 
           
Fixpack 1:

1-39139581 WebSphere Access may fail for international XMLs. 

           The samples had a problem with parsing XML from Java String and 
           writing XML into Java String. The user's code that was based on 
           the samples may need to be fixed for the same problem. 
           
           Bad code:
                KxmMessage message;
                ...
                new String(message.write());

           Right code:
                KxmMessage message;
                ...
                // write() writes in UTF-8 for standalone XML 
                new String( message.write(), "UTF-8" );

           Bad code:
                String xml;
                ...
                KxmMessage message = new KxmMessage( 
                        xml.getBytes(), KxmMessage.STANDALONE );

           Right code:
                String xml;
                ...
                // by default KxmMessage constructor expects XML message 
                // in UTF-8
                KxmMessage message = new KxmMessage( 
                        xml.getBytes("UTF-8"), KxmMessage.STANDALONE );
           
1-39139673 Outbound sample does not show error message on the html page.

1-35924768 CASP EJB support for WAS 5.0.2

           Components to deploy:

             Inbound
               WAS 4.x (EJB 1.1)
                          KxoInboundListener.war - message listener
                          KxoInTarget.jar        - sample user's bean

               WAS 5.0.2 (EJB 2.0)
                          KxoMDBean.jar          - message-driven bean
                          KxoInTarget.jar        - sample user's bean

             Outbound
               WAS 4.x, WAS 5.0.2
                          KxoOutboundBean.jar    - outbound bean
                          UserEJBBean.jar        - sample user's bean
                          KxoSample.war          - sample servlet for outbound
           
           NOTE: With this fixpack you no longer need to deploy 
           KxoInboundBean.jar. For WAS 4.x the inbound messages are handled
           by the KxoInboundListener.war servlet. For WAS 5.x the inbound 
           messages are handled by the KxoMDBean.jar message-driven bean.
           
           See more about deployment in "CASP for WebShpere Access" 
           User's Guide.

Release Level:

CASP, Version 2.0 GA (RQV200G3)

Corequisite Fixes:

None

Users affected:

CASP for WebSphere Access

Resolution:

Apply this fixpack.

Operating System Versions that Fix Applies To: 

HP-UX 11 (H3)

Modules Replaced:

New and replaced modules:

__Size_ __Date______ __File________________________________________  
  2134  Oct 10 2004  CASP/toolkit/lib/LogHelper.jar
  53805 Oct 10 2004  CASP/toolkit/WAS/apps/KxoMDBean.jar
  50911 Oct 10 2004  CASP/toolkit/WAS/apps/KxoOutboundBean.jar
  57154 Oct 10 2004  CASP/toolkit/WAS/apps/KxoInboundListener.war
  5780  Oct 10 2004  CASP/toolkit/WAS/samples/inbound/apps/KxoInTarget.jar
  5578  Oct 11 2004  CASP/toolkit/WAS/samples/inbound/src/KxoInboundTargetBean.java  
  50488 Oct 10 2004  CASP/toolkit/WAS/samples/outbound/apps/UserEJBBean.jar
  12754 Oct 10 2004  CASP/toolkit/WAS/samples/outbound/apps/KxoSample.war
  15064 Oct 11 2004  CASP/toolkit/WAS/samples/outbound/src/UserEJBBean.java  
   9291 Nov 12 2003  CASP/toolkit/WAS/samples/outbound/src/AccessBean.java
   5102 Nov 12 2003  CASP/toolkit/WAS/samples/outbound/src/KxoServlet.java
   8247 Nov 12 2003  CASP/toolkit/WAS/samples/outbound/src/KxoServletAgent.java
   9029 Nov 12 2003  CASP/toolkit/WAS/samples/outbound/src/SOAPAccessBean.java
   2638 Nov 12 2003  CASP/toolkit/WAS/samples/outbound/src/UserEJB.java
   1905 Nov 12 2003  CASP/toolkit/WAS/samples/outbound/src/UserEJBHome.java
  13013 Nov 12 2003  CASP/toolkit/WAS/samples/outbound/src/XmlAccessBean.java
   4534 Nov 12 2003  CASP/toolkit/WAS/samples/outbound/src/XmlAccessUtils.java

Creation date:

11 October 2004

Installation steps:

1. Shutdown applications using CASP.
  
2. Make backup copies of all of the files listed under the heading   
   "New and replaced modules".

3. Copy the fix patch, XOH37003.tar.Z , to the $CANDLE_CASP_HOME/..
   directory.

4. Type the command "uncompress XOH37003.tar.Z".

5. Type the command "tar xvf XOH37003.tar"

6. Deploy updated Java components as necessary.

Fix Removal Steps:

1. Shutdown applications using CASP.

2. Copy the replaced modules from the backup directory created in
   step 2 of installation instructions to the locations indicated
   in the New and Replaced modules section above.

