Fix (APAR):  PM55913

Status:  Fix

Release:  1.0.1.13

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

Supersedes Fixes:  PM52848 PM53362 PM5383 PM53844 PM53777 PM54591 PM56160

CMVC Defect:  PM55913

Byte size of APAR:  269085

Date: 2012-02-28

Abstract:  DataObject.getDate methods may return incorrect result

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

ERROR DESCRIPTION:?                                             
Running Websphere Sensor Events version 7.0 on WebSphere        
Application Server Network Deployment version 7.0.0.7 with      
Feature Pack for XML 1.0.0.5 and Feature Pack for Service       
Component Architecture (SCA) 1.0.1.3, the date in the event     
table contains two different dates in the database. The date    
in the event_xml has the correct date while the date in the     
event_dts column is a day ahead.                                

LOCAL FIX:?                                                     
n/a                                                             

PROBLEM SUMMARY:?

USERS AFFECTED:
 All IBM WebSphere Application Server
Feature Pack for Service Component
Architecture (SCA) users

PROBLEM DESCRIPTION:
DataObject.getDate methods may return
incorrect result

RECOMMENDATION:
None

In SDO (Service Data Objects), the java.util.Date objects
retrieved from DataObject.getDate methods may be incorrect for
DateTime values before March 1 in any leap year (where they
will be ahead by 1 day) or for dates before the epoch (January
1, 1970). This problem only applies to DateTime values that
contain timezone information.
For the Business Objects API, which is built upon SDO, the
problem occurs only when DateTime values are parsed from their
textual representation - either from an XML input document or
set programmatically as a string via the DataObject.setString
methods. For direct users of the Service Data Objects API, the
problem occurs in these cases and additionally when a
java.util.Date object is provided programmatically via the
DataObject.setDate methods.

PROBLEM CONCLUSION:?                                            
The algorithm handling DateTime values with timezone            
information has been updated to properly take into account      
leap years and to handle dates before the epoch correctly.      
                                                                
The fix for this APAR is currently targeted for inclusion in    
fix pack SCA 1.0.1.15. Please refer to the Recommended Updates  
page for delivery information:                                  
http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980   


Directions to apply fix:  

Install fix to:
__ Application Server Nodes
__ Deployment Manager Nodes
_X_ Both

NOTE:
The user must:
* Log in with the same authority level when unpacking a fix, fix pack or refresh pack.
* Use Installation Manager to apply the fix.

1) Shutdown WebSphere Application Server.

2) Apply the fix.  The fix can be applied in 1 of 2 ways (2a and 2b).

  2a) Allow Installation Manager to download the fix from the repository (Recommended)
    1) Run Installation Manager.
    2) Setup the repository by going to File > Preferences.
    3) Click Add repository and add http://public.dhe.ibm.com/software/websphere/repositories/repository.config
    4) Click OK and close the Preferences panel.
    5) Click Update and select the Package Group corresponding to the WebSphere Application Server Feature Pack for SCA Install.  Click Next.
    6) Select the desired interim fix and proceed to install it.

  2b) If Installation Manager cannot download the fix due to a firewall access or for some other reason, you can download the fix manually.
    1) Download the fix by navigating to: http://public.dhe.ibm.com/software/websphere/downloads/sca/service/1.0/fixes and then navigating down through the directories for the specific fix.
    2) Unzip the file into a new directory specifically for this fix.
    3) Run Installation Manager.
    4) Setup the repository by going to File > Preferences.
    5) Click Add repository and browse to the repository.config in the new directory
    6) Click OK and close the Preferences panel.
    7) Click Update and select the Package Group corresponding to the WebSphere Application Server Feature Pack for Service Component Architecture (SCA) Install.  Click Next.
    8) Select the desired interim fix and proceed to install it.

3) Start WebSphere Application Server.



Directions to remove fix:  
NOTE:
* The user must have Administrative rights in Windows, or be the Actual Root User in a UNIX environments.
* IF THE FIX THAT YOU ARE REMOVING IS A PREREQUISITE OF ANOTHER FIX, THEN BOTH FIXES MUST BE REMOVED.

1) Shutdown WebSphere Application Server.

2) Start the Installation Manager.

3) Click Uninstall Packages.

4) Select the interim fix and click Next.

5) Click Uninstall.

6) Start WebSphere Application Server.



Directions to re-apply fix:  
1) Shutdown WebSphere Application Server.

2) Follow the Fix instructions to apply the fix.

3) Start WebSphere Application Server.





Additional Information: