Fix (APAR):  JR25642

Status:  Fix

Release:  6.0.1.4,6.0.1.3,6.0.1.2

Operating System:  AIX,HP-UX,Linux,Solaris,Windows

Supersedes Fixes:  

CMVC Defect:  xxxxxx

Byte size of APAR:  88185

Date: 2007-01-31

Abstract:  WPS throws NullPointerException when interface maps try to map response parameters that include sub arrary-map.

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

ERROR DESCRIPTION:                                              
An error is thrown when using a submap in a response map        
and an array structure is mapped within this submap.            
The error only occurs when the source interface contains the    
same business graph datatype as input and output in its request 
and response operation, respectively                            
Depending on the input of the map, the error disappears.        
                                                                
                                                                
                                                                
[08/12/06 12:35:34:218 CET] 00000054 ParameterMedi E            
com.ibm.wbiserver.mediation.ifm.ParameterMediationHelper        
doParameterMediation CWLAU0005E: Interface mapping              
com/./map/AccountClosureBG_MSE0023 with source operation        
execute                                                         
and target operation executeMSE0023 experienced an unexpected   
error                                                           
com.ibm.wbiserver.map.exceptions.WBIMapFailureException:        
CWLAS0015E:                                                     
Submap transformation #8 in Map MSE0023_To_AccountClosureBG     
failed with                                                     
exception null. when invoking map MSE0023_To_AccountClosureBG.  
The                                                             
calling context is SERVICE_CALL_RESPONSE.                       
                                                                
com.ibm.wbiserver.map.exceptions.WBIMapFailureException:        
CWLAS0015E:                                                     
Submap transformation #8 in Map MSE0023_To_AccountClosureBG     
failed with                                                     
exception null.                                                 

LOCAL FIX:                                                      
the workaround is to change the transformation type from submap 
to move if possible                                             

PROBLEM SUMMARY

USERS AFFECTED:
WebSphere Process Server 6.0.1.x users

PROBLEM DESCRIPTION:
WPS throws NullPointerException when
interface maps try to map response
parameters that include sub
arrary-map.

RECOMMENDATION:
None

For an two-way interface map, there are request parameters
maps and response parameters maps.
For an response parameters map, it includes business object
maps to map response parameters. If there are sub maps to map
business object in array type, wps will throw the
java.lang.NullPointerException.

The exception is like: java.lang.NullPointerException
at com.ibm.wbiserver.map.dlm.BaseMAP.invokeSubmap
(BaseMAP.java:3200)

at accounting_ver1_0_lib.com.citicorp.map.
MSE0023_To_AccountClosureBG.\submap_call_8
(MSE0023_To_AccountClosureBG.java:701)

at accounting_ver1_0_lib.com.citicorp.map.
MSE0023_To_AccountClosureBG.MSE0023_To_AccountClosureBG_map
(MSE0023_To_AccountClosureBG.java:212)

at accounting_ver1_0_lib.com.citicorp.
map.MSE0023_To_AccountClosureBG.$MSE0023_To_AccountClosureBG_map
(MSE0023_To_AccountClosureBG.java:122)

at accounting_ver1_0_lib.com.citicorp.
map.MSE0023_To_AccountClosureBG.executeMethod
(MSE0023_To_AccountClosureBG.java:91)

at com.ibm.wbiserver.map.impl.MapServiceImpl.transform
(MapServiceImpl.java:125)

at com.ibm.wbiserver.mediation.ifm.ParameterMediationHelper.
mediateBOTransform(ParameterMediationHelper.java:1004)

at com.ibm.wbiserver.mediation.ifm.ParameterMediationHelper.
doParameterMediation(ParameterMediationHelper.java:461)

at com.ibm.wbiserver.mediation.ifm.InterfaceMediationHandler.
doOutputMediation(InterfaceMediationHandler.java:220)

at com.ibm.wbiserver.mediation.MediationImplementationHandler.
processOutputs(MediationImplementationHandler.java:188)

PROBLEM CONCLUSION:                                             
With the fix, map works fine in the above scenario.             


Directions to apply fix:  
Before applying the iFix ensure that WebSphere Process Server 6.0.1 is installed on the system.
Also 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) Restart WebSphere

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. 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

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: