Fix (APAR):  JR27952

Status:  Fix

Release:  6.0.2.3,6.0.2.2

Operating System:  AIX,HP-UX,i5/OS,Linux,Solaris,Windows

Supersedes Fixes:  

CMVC Defect:  JR27952

Byte size of APAR:  102568

Date: 2008-01-06

Abstract:  Soap message generated by mediation module contains null tag.

Description/symptom of problem:  
JR27952 resolves the following problem:

ERROR DESCRIPTION:                                              
<Problem>The request XML produced by WPS contains empty element 
which stands for sub-BO BO that are null                        
(e.g.<installmentType/>)                                        
</Problem>                                                      
                                                                
<Cause>Target sub-BO is created by default after fixing         
444351.the content of sub-BO is null after creation.            

LOCAL FIX:                                                      
<solution>Introduce a MapService .properties file which has a   
flag to indicate if target sub-BO will be created by default or 
not                                                             

PROBLEM SUMMARY

USERS AFFECTED:
WebSphere Process Server 6.0.2.2 or later
users

PROBLEM DESCRIPTION:
Soap message generated by mediation
module contains null tag.

RECOMMENDATION:
None

Soap message generated by mediation module contains null tag.
for example: <book />.

PROBLEM CONCLUSION:                                             
The problem is caused by a design change. The change is to      
create missing Business Object in custom map. But user may not  
need target missing Business Object by default. In this fix,    
there is a property file. Runtime behavior will depends on      
the value in the property file.                                 


Directions to apply fix:  
Download and follow Update Installer installation instructions.  The Update Installer can be downloaded from the following link:
http://www.ibm.com/support/docview.wss?rs=180&uid=swg21205991

1) Copy the pak file to the directory maintenance in the UpdateInstaller directory

2) Shutdown WebSphere Process Server. It is important that you perform a controlled and complete shutdown of the server to ensure that all transactions have completed, before installing the fix.

3) Run the UpdateInstaller and follow the prompts.

4) Put map.config.properties to folder WPS/properties

5) Restart WebSphere Process Server.

Directions to remove fix:  
NOTE:  FIXES MUST BE REMOVED IN THE REVERSE ORDER IN WHICH THEY WERE APPLIED.  DO NOT REMOVE A FIX UNLESS  ALL FIXES APPLIED AFTER IT HAVE FIRST BEEN REMOVED.  YOU MAY REAPPLY ANY REMOVED FIX.

Example:  If your system has fix1, fix2, and fix3 applied in that order and fix2 is to be removed, fix3 must be removed first, then fix2 may be removed

1) Shutdown WebSphere Process Server. It is important that you perform a controlled and complete shutdown of the server to ensure that all transactions have completed, before installing the fix.

2) Follow the Fix instructions that are packaged with the Fix Installer on how to uninstall and reinstall the Fix.

3) Restart WebSphere Process Server.

Directions to re-apply fix:  
1) Shutdown WebSphere. It is important that you perform a controlled and complete shutdown of the server to ensure that all transactions have completed, before installing the fix.

2) Run the UpdateInstaller and follow the instructions. The Update Installer can be downloaded from the following link:
http://www.ibm.com/support/docview.wss?rs=180&uid=swg21205991

3) Restart WebSphere Process Server.

Additional Information:  How to use this fix:
1. WPS map runtime behavior will depend on the value of createChildBOsbyDefault in map.config.properties. The defaut value is true and all custom map target BO will be created by default. This setting will generate null tag.

2. To avoid generating null tag, createChildBOsbyDefault should be set to false. And all target BO for custom map should be created manually in custom map code.
For example:
DataObject code = noClaimDiscount.createDataObject("code");