*************************************************************** {COPYRIGHT-TOP}
* Licensed Materials - Property of IBM
* Restricted Materials of IBM
* IBM Tivoli Usage and Accounting Manager
* 5724-O33, 5765-UAV, 5765-UA7, 44E7863
* (c) Copyright IBM Corp. 2004, 2009 All Rights Reserved.
*
* US Government Users Restricted Rights - Use, duplication or
* disclosure restricted by GSA ADP Schedule Contract with
* IBM Corp.
**************************************************************** {COPYRIGHT-END}

Interim Fix 13 for TUAM 7.1.1


Please note, interim fix 13 supersedes interim fixes 7 and 12; therefore, interim fix 7 or 12
must not be installed after interim fix 13.

If you have installed interim fix 7 or interim fix 12, it is recommended that you uninstall 
these before interim fix 13 is installed.

1. Description

This interim fix was created to solve the following Authorized Program Analysis 
Reports (APARs):

The solution to the following APAR is new to Interim Fix 13:

*  APAR - IZ43332: When using multiple identifiers to do Account Code Conversion in 
   either the ACCT or Integrator programs, the job file is observed to hang.
*  APAR - IZ43292: When collecting usage data from VMWare Virtual Centre/ ESX, a 
   failure in collecting that data can occur with certain hierarchical structure 
   configurations in Virtual Center/ ESX.

   
The solutions to the following APAR have been rolled up from Fix 12:

*  APAR - IZ41929: When running the Bill Program on a date that is a user Calendar 
   Close Date, the calculated Accounting Date is null. 


The solutions to the following APAR have been rolled up from Interim Fix 7:

*  APAR - IZ34261: If the Input file of the Bill step is bigger than 64 megabytes, 
   an out of memory exception will occur during the sorting of records.
   This error was found while processing a large amount of data. The Acct step 
   output a 65 mb file that was then processed by the Bill step. By default the Bill 
   step sorts the data. The amount of data needed for the sorting was not assessed 
   correctly, which caused the out of memory exception.
*  APAR - IZ32912: The TUAM server may not recognize the timezone listed in the 
   advanced accounting log. The result of this being, data time stamps are incorrectly 
   interpreted.
*  APAR - IZ33780: The SAP Collector incurs a java.lang.NullPointerException when 
   parsing the input file.
*  APAR - IZ31966: When attempting a two-level lookup with CreateIdentifierFromTable, 
   the stage only matches against the first identifier value, disregarding the second 
   identifier value in the table.

  
                                                              
2. Prerequisites 

You must be running TUAM 7.1.1.

If you have installed Interim Fix 7, or Interim Fix 12, it is recommended that you 
uninstall these before Interim Fix 13 is installed.

  
  
3. Installation Instructions 

How to install the patch

For Windows: 
1. Extract the zip file to a temporary directory.
2. Open a command line window. 
3. Use the "cd" command to change to the temporary directory.
4. Type "applyFix.bat" into the command line window.
   (If eWAS web server security is enabled, append the username and password for 
   eWAS to the script execution command, i.e., type "applyFix.bat username password")

For Linux, Unix:
1. Extract the tar file to a temporary directory.
2. Open a shell.
3. Use the "cd" command to change to the temporary directory.
3. Type "chmod u+x applyFix.sh" in the shell. This will change the rights 
   to applyFix.sh.
4. Type "./applyFix.sh" into the shell.
   (If eWAS web server security is enabled, append the username and password for 
   eWAS to the script execution command, i.e., type "./applyFix.sh username password")

How to uninstall the patch

For Windows:
1. Open a command line window. 
2. Use the "cd" command to change to the directory containing the extracted 
   zip file.
3. Type "undoFix.bat" into the command line window.
   (If eWAS web server security is enabled, append the username and password for 
   eWAS to the script execution command, i.e., type "undoFix.bat username password")

For Linux, Unix:
1. Open a shell.
2. Use the "cd" command to change to the directory containing the extracted 
   tar file.
3. Type "chmod u+x undoFix.sh" into the shell. This will change the rights 
   to undoFix.sh.
4. Type ./undoFix.sh into the shell.
   (If eWAS web server security is enabled, append the username and password for 
   eWAS to the script execution command, i.e., type "./undoFix.sh username password")


NOTE: The fix will stop the eWAS web server, copy the updated program files, 
and then restart the web server. If security is turned on for the web server, 
you may be prompted for a user name and password when the update attempts to 
stop the web server.
 
Problems (APARS) fixed: IZ43332, IZ43292, IZ41929, IZ34261, IZ32912, IZ33780, IZ31966,