------------------------------------------------------------
IBM Rational Change Patch 5.2 03
------------------------------------------------------------
(C) Copyright IBM Corporation 2000, 2009
U.S. Government Users Restricted Rights - Use, duplication, or disclosure
restricted by GSA ADP Schedule Contract with IBM Corp.

SUMMARY

  This README describes the contents of IBM(R) Rational(R) Change patch 5.2 03
  and describes how to install the patch.  The README has the following
  sections: 

  PROBLEMS
    This section describes the problems fixed in this patch.

  SUPPORTED RELEASES
    This section lists the releases to which this patch may be applied.

  DELIVERABLE RATIONAL CHANGE COMPONENTS AFFECTED
    This section lists the files that will be replaced by this patch.

  INSTALLATION INSTRUCTIONS
    This section describes how to apply the patch to your Rational Change
    server.

  REVERSING THE PATCH
    This section describes how to remove the patch. 

  CONTACTING SUPPORT
    If you need assistance or have any problems with this patch, contact
    Support as described at the very end of this README.

PROBLEMS  

  Patch 5.2 03 to Rational Change Release 5.2 fixes the following problems:

  R#33303 Extended text attributes appearing in subscription notifications
          contain HTML mark-up
  R#33330 Editing attribute of CCM_EXTENDED_TEXT type during transition causes
          junk markup to appear in the transition log
  R#33346 Address communication performance issues with TDS/RDS by caching the
          profiles of database users
  R#33347 Avoid unnecessary calls to TDS/RDS while listing users and assigning
          privileges from the Users tab
  R#33352 Inline reports on show dialogs can fail under high load, resulting in
          file not found errors
  R#33447 Supported browser inconsistency between the README and the URL on the
          login screen
  R#33573 'Users' tab in admin interface takes around 15 minutes to list 1000
          users (XR#6157)
  R#33676 Poor performance due to privilege cache updates when database is
          disabled
  
  Patch 5.2 03 includes Patch 5.1 02, which fixed the following problems:

  R#31545 Can't log in due to license server issue after restarting Change
          through WASCE or WAS
  R#31879 Home pages lost under certain circumstances when RDS is unavailable
  R#32149 Change should explicitly stop any threads it started during shutdown
  R#32652 Unable to migrate CRs from a remote database
  R#33029 Prompting queries created using an attribute type (not a specific
          attribute) can't be run
  R#33087 NullPointerException thrown when clicking on "Add Home Page"
  R#33120 getTransitionLog web service is missing line separators for attribute
          modification
  R#33242 Not all CCM_EXTENDED_TEXT displays correctly in transition log
  R#33259 Need a "SwitchUser" Perl API for the admin to run operations as other
          users

  Patch 5.2 03 includes Patch 5.1 01, which fixed the following problem:

  R#33152 Change how preferences are updated to prevent RDS 5.0 Apache
          corruption

SUPPORTED RELEASES

  This patch may only be applied to Rational Change Release 5.2.

  This patch can be safely applied over any previous Rational Change 5.2
  patches.

DELIVERABLE RATIONAL CHANGE COMPONENTS AFFECTED 

  lib\
    change.jar.master
    tdsjndilib.jar.master

  perl\lib\perl5\site_perl\5.8.6\ChangeSynergy\
    CreateReportDefinition.pm
    csapi.pm
    FolderSecurityRule.pm
    Globals.pm
    QueryEntry.pm
    ReportEntry.pm
    ReportEntryFactory.pm
    SubReportEntry.pm
    util.pm

  trapeze\help\perl_api\
    csapi.html

  wsconfig\messages\
    52_patch.properties
  
  wsconfig\scripts\
    subscriptionTrigger.pl

  wsconfig\templates\pt\forms\
    browser_support.html
  
  wsconfig\templates\pt\forms\admin_framework\
    admin_user_properties_dflt.html
    frameset_admin_user_data_dflt.html
  
  wsconfig\triggers\
    crAssignEmail.pl

INSTALLATION INSTRUCTIONS

  Before you begin, make sure that you have performed a successful backup of
  your Rational Change databases.

  This patch contains a package that must be installed via the Rational Change
  package installation utility.

  Once you have installed patch 5.2 03, you should not install any individual
  patch that does not clearly state that it may be installed on top of patch
  5.2 03, unless informed otherwise by Support.

  1. Log in to the machine where Rational Change is installed as the user who
     installed Rational Change.

  2. Uncompress the patch file (patch_rc5.2-03.zip) into the packages folder,
     <CHANGE_APP_HOME>\WEB-INF\packages.  This should result in a folder
     named rc5.2-03.

  3. Login to Rational Change as Admin, and click the Administration toolbar
     icon.

  4. You can now select this patch package from the "Package Installer" tab
     which will show this patch package under "Available Packages".  Install
     the patch.

  5. Restart Rational Change.

REVERSING THE PATCH

  If it is necessary to remove the patch after it was installed, follow these
  steps.

  1. Login to Rational Change as Admin, and click the Administration toolbar
     icon.

  2. Uninstall the patch package.

     Click on the "Package Installer" tab.  You should see the rc5.2-03 package
     in the Installed Packages.  Click the uninstall button.

  3. Restart Rational Change.

CONTACTING SUPPORT

  Please visit our Telelogic support overview site at:
  http://www.ibm.com/software/rational/support/telelogic/
  You will find a one-sheet reference guide about how to best contact support
  in your geography.