OMEGAMON XE for DB2 Performance Expert (Monitor) V4.1.0 Fixpack 3 Interim
fix 2 (ITM)Readme 4.1.0.3-TIV-KD5-IF0002.README

© Copyright IBM Corporation 2005, 2006, 2007,2008.
  All Rights Reserved.

=========================================================================
CONTENTS
=========================================================================

1.0 About this fixpack
  1.1 Product fix history
  1.2 New or updated modules
  1.3 Backward compatibility with prior version of this product
  1.4 Cross-Product compatibility
2.0 Installation and configuration
  2.1 Hardware and Software requirements
  2.2 Installation
  2.3 Installation using a Response File (Silent Install)
3.0 Uninstallation Information
4.0 Support Information
  4.1 Using IBM Support Assistant
  4.2 Obtaining Fixes
  4.3 Receiving weekly support updates
  4.4 Contacting IBM Software Support
5.0 Notices and Trademarks
  5.1 Notices
  5.2 Trademarks

=========================================================================
1.0 ABOUT THIS FIXPACK
=========================================================================

Set the font to monospace to better view this file.

This maintenance update is Fixpack 3 Interim fix 2 for Tivoli OMEGAMON XE
For DB2 Performance Expert (Monitor) V4.1.0 for use with ITM v6.1. It 
includes 14 APAR fixes as listed below. z/OS PTFs are also required.

**NOTE**
Upgrading OMEGAMON XE for DB2 Performance Expert (Monitor) from the 
following download site before applying this fixpack is recommended. 
This upgrade will provide you more help data on EDM Pool v9 support. 

Download LCD7-0963-04.zip/tar from this application support files site:
ftp://ftp.software.ibm.com/software/tivoli_support/misc/PandA/tools_agent
/tools/appsupt/


=========================================================================
1.1 Product fix history
=========================================================================

The following APARs are addressed in this maintenance update:

PK57640 Support of DB2 Instrumentation enhancement for IFCID 1, IFCID 
    197, and enablement for IFCID 225 in TEP
Problem Summary:
    Added support in TEP for operating system information from IFCID 1, 
    DB2 messages from IFCID 197, and storage consumption from IFCID 225.
	
  Conclusion:
    Added support for operating system information, DB2 messages, 
    and storage consumption in TEP.
   
The DB2 Messages subtask must be started for DB2 messages collection.
Here are the instructions.  For detail, refer to PTF UK33238 and UK33296.
****************************************************************
*                                                              *
* The newly introduced DB2 Messages task can be started using  *
* the MODIFY command for the PESERVER subtask.                 *
*                                                              *
* Issue the following MODIFY command to start the DB2 Messages *
* subtask of PESERVER:                                         *
*                                                              *
* F <ccccccc>,F PESERVER,F <db2>,DB2MSGMON=<p>                 *
* where:                                                       *
*     <cccccccc> is the started task name that you             *
*                 specify for the OMEGAMON Server              *
*                 during the configuration within the          *
*                 Configuration Tool                           *
*     <db2>      is the identifier of the DB2                  *
*                 subsystem on which the PESERVER              *
*                 subtask runs                                 *
*     <p>        can be either "Y" or "N" to start             *
*                 or stop the messages subtask                 *
*                                                              *
* For example:                                                 *
*                                                              *
*     F D711DM4S,F PESERVER,F D811,DB2MSGMON=Y                 *
*                                                              *
* Note that in order to see data in the corresponding TEP      *
* workspaces these tasks need to be started. They are NOT      *
* started at server startup.                                   *
*                                                              *
****************************************************************
 

PK60141 Incorrect UNICODE attributes in TEP
        
Problem Summary:
    The UNICODE attributes were not converted properly resulting
    in incorrect data.

  Conclusion:
    Fixed the code to convert UNICODE attributes correctly. 
 
 
PK42628 Column Utilization in Volume Activity workspace has value
    greater then 100%
    
Problem Summary:
    The print format was incorrect for column Utilization resulting 
    in percentage greater then 100.

  Conclusion:
    Fixed the ODI to correct column Utilization print format in 
    Volume Activity workspace.  


PK46449 Added CICS TS 3.2 release to attribute CICS_Release in 
    Workspaces CICS Connections and CICS Threads
    
Problem Summary:
    CICS TS 3.2 release was not added to attribute CICS_Release.

  Conclusion:
    Added CICS TS 3.2 release to attribute CICS_Release.


PK52845 The Elapsed Time attribute in Detailed Thread Exception 
    workspace was incorrect

 Problem Summary:
    The Elapsed Time was formatted incorrectly.

  Conclusion:
    Fixed the Elapsed Time format.

 
PK55606 Dynamic workspace link support for Mainframe Network and zNetView

Problem Summary:
    Added dynamic workspace link support for Mainframe Network and
    zNetView workspaces. 
	
  Conclusion:
    Added dynamic workspace link support for Mainframe Network and
    zNetView workspaces. 



PK55619 Renew Java Certificate

Problem Summary:
   The current Java certificate is expired. 
	
  Conclusion:
   Included a renewed java certificate. If you have previously 
   installed a language pack image, you must install the corresponding 
   language pack image with the matching certificate. Download  
   language pack LCD4-8226-02 at this download site:
ftp://ftp.software.ibm.com/software/tivoli_support/misc/PandA/tools_agent
/tools/langsupt/


PK36297 DB2 V9 support


Problem Summary:
    Added DB2 V9 support.
	
  Conclusion:
    Added DB2 V9 support.


PK37802 History data not returned to DB2Plex workspaces

Problem Summary:
    History data not returned to DB2Plex workspaces when Data Sharing 
    Group name is eight characters long. 

  Conclusion:
    Fixed the code to return history data to DB2Plex workspaces. 


OA17918 Incorrect CICS release
    
Problem Summary:
    CICS release is displayed incorrectly for release 630 and 640.

  Conclusion:
    Fixed the ODI to print correct CICS release.   


PK22692 DB2Plex Group Object Analysis workspace GetPage per Read I/O
    incorrect
    
Problem Summary:
    The GetPage per Read I/O is incorrect when Sync Reads and Seq 
    Prefetch Reads are both zero.	

  Conclusion:
    Fixed the code to calculate GetPage per Read I/O correctly when 
    Sync Reads and Seq Prefetch Reads are both zero.
    

PK27639 History data not returned to Thread Detail, Thread Enclave and 
    Distributed Thread Detail workspace.
    
Problem Summary:
    All the thread data are filtered out due to the filtering values 
    matching was done incorrectly resulting in no data returned to 
    Thread Detail, Thread Enclave and Thread Distributed workspaces. 

  Conclusion:
    Fixed the filtering matching code so the thread data will be  
    returned correctly.


PK47408 The view title ‘Coupling Facility Connections’ was always English 
    in workspace ‘CF Connections’
    
Problem Summary:
    The view title was defined incorrectly resulting in resource 
    translation failed.

  Conclusion: 
    Defined the view title correctly to ensure that resource translation 
    works. 


PK47411 No title for chart views in workspace ‘Coupling Facility Structures’
    
Problem Summary:
    The view title was not defined in the chart views for workspace 
    ‘Coupling Facility Structures’.

  Conclusion:
    Added view title to the chart views for workspace ‘Coupling Facility 
    Structures’. 



PK48509 View Titles are not resolved in workspace ‘EDM Pool’ in Browser 
        Client
    
Problem Summary:
    The updated resource files were placed in a wrong directory for 
    Browser Client

  Conclusion:
    Placed the updated resource files in the correct directory for 
    Browser Client. 

=========================================================================
1.2 New or updated modules
=========================================================================


New Modules:

-----------

None


Replaced Modules:
----------------

Windows directory structure:

________Module______________           _____Date/Time_____     ___Size__
cms\attrlib\kdp.atr                    01/16/2008  02:23 PM     467,322
cms\rkdscatl\kdp.cat                   01/16/2008  02:23 PM     515,835
cms\sqllib\kdp.his                     01/17/2008  12:23 PM      55,643
cms\sqllib\kdp.sql                     01/29/2008  11:05 PM     207,220
cms\sqllib\kdp_del.sql                 01/17/2008  12:26 PM      14,847
cnps\cmsatr\kdp.atr                    01/16/2008  02:23 PM     467,322
cnps\rkdscatl\kdp.cat                  01/16/2008  02:23 PM     515,835

cnps\dockdp                            01/16/2008  02:23 PM     641,610

cnps\sqllib\kdp.his                    01/17/2008  12:23 PM      55,643
cnps\sqllib\kdp.sql                    01/29/2008  11:05 PM     207,220
cnps\sqllib\kdp_del.sql                01/17/2008  12:26 PM      14,847
cnps\sqllib\kdp_kcj.sql                01/15/2008  08:01 PM     593,625
cnps\sqllib\kdp_links.sql              02/02/2008  06:04 PM   1,528,350
cnps\sqllib\kdp_pres.sql               02/02/2008  06:03 PM   1,100,914

cnb\classes\kdp.inf                    01/10/2008  07:53 AM          28
cnb\classes\kdp_resources.jar          01/10/2008  07:56 AM     166,238
cnb\classes\candle\kdp\resources       (Directory is replaced)

cnp\kdp.inf                            01/10/2008  07:53 AM          28
cnp\kdp_resources.jar                  01/10/2008  07:56 AM     166,238
  

	
cms\kdpcfggl.dll                       03/25/2007  11:53 AM      27,648
cms\kdpfiltl.dll                       03/25/2007  11:53 AM      34,816
cms\kdpgbpcl.dll                       03/25/2007  11:53 AM      24,576
cms\kdpgbppl.dll                       03/25/2007  11:53 AM      25,088
cms\kdpggvdl.dll                       03/25/2007  11:53 AM      31,744
cms\kdpggvsl.dll                       03/25/2007  11:53 AM      27,648
cms\kdpglokl.dll                       03/25/2007  11:53 AM      27,648
cms\kdpgoaal.dll                       03/25/2007  11:53 AM      33,280
cms\kdpgoasl.dll                       03/25/2007  11:53 AM      32,768
cms\kdpgotal.dll                       03/25/2007  11:53 AM      32,768
cms\kdpgstsl.dll                       03/25/2007  11:53 AM      28,160
cms\kdpgvtal.dll                       03/25/2007  11:53 AM      28,672
cms\kdpthdtl.dll                       03/25/2007  11:53 AM      26,624
cms\kdptstal.dll                       03/25/2007  11:53 AM      26,624


UNIX and Linux directory structure:

________Module______________           _____Date/Time_____     ___Size__
tables/cicatrsq/ATTRLIB/kdp.atr        01/16/2008  02:23 PM     467,322
tables/cicatrsq/RKDSCATL/kdp.cat       01/16/2008  02:23 PM     515,835
tables/cicatrsq/SQLLIB/kdp.his         01/17/2008  12:23 PM      55,643
tables/cicatrsq/SQLLIB/kdp.sql         01/29/2008  11:05 PM     207,220
tables/cicatrsq/SQLLIB/kdp_del.sql     01/17/2008  12:26 PM      14,847
$platform/cq/CMSATR/kdp.atr            01/16/2008  02:23 PM     467,322
$platform/cq/RKDSCATL/kdp.cat          01/16/2008  02:23 PM     515,835

$platform/cq/dockdp                    01/16/2008  02:23 PM     641,610
$platform/cq/sqllib/kdp.his            01/17/2008  12:23 PM      55,643
$platform/cq/sqllib/kdp.sql            01/29/2008  11:05 PM     207,220
$platform/cq/sqllib/kdp_del.sql        01/17/2008  12:26 PM      14,847
$platform/cq/sqllib/kdp_kcj.sql        01/15/2008  08:01 PM     593,625
$platform/cq/sqllib/kdp_links.sql      02/02/2008  06:04 PM   1,528,350
$platform/cq/sqllib/kdp_pres.sql       02/02/2008  06:03 PM   1,100,914

$platform/cw/kdp.inf                   01/10/2008  07:53 AM          28
$platform/cw/classes/kdp_resources.jar 01/10/2008  07:56 AM     166,238
$platform/cw/classes/candle/kdp/resources (Directory is replaced)

$platform/cj/kdp.inf                   01/10/2008  07:53 AM          28
$platform/cj/lib/kdp_resources.jar     01/10/2008  07:56 AM     166,238

aix513/ms/lib/KDPCFGGL                 03/25/2007  05:00 PM      43,165 
aix513/ms/lib/KDPFILTL                 03/25/2007  05:00 PM      51,888 
aix513/ms/lib/KDPGBPCL                 03/25/2007  05:00 PM      39,091 
aix513/ms/lib/KDPGBPPL                 03/25/2007  05:00 PM      39,634 
aix513/ms/lib/KDPGGVDL                 03/25/2007  05:00 PM      50,073 
aix513/ms/lib/KDPGGVSL                 03/25/2007  05:00 PM      44,001 
aix513/ms/lib/KDPGLOKL                 03/25/2007  05:00 PM      43,683 
aix513/ms/lib/KDPGOAAL                 03/25/2007  05:00 PM      53,405 
aix513/ms/lib/KDPGOASL                 03/25/2007  05:00 PM      50,713 
aix513/ms/lib/KDPGOTAL                 03/25/2007  05:00 PM      51,041 
aix513/ms/lib/KDPGSTSL                 03/25/2007  05:00 PM      43,027 
aix513/ms/lib/KDPGVTAL                 03/25/2007  05:00 PM      44,817 
aix513/ms/lib/KDPTHDTL                 03/25/2007  05:00 PM      41,591
aix513/ms/lib/KDPTSTAL                 03/25/2007  05:00 PM      40,059 
	

li6243/ms/lib/KDPCFGGL                 03/17/2007  10:35 PM      37,327
li6243/ms/lib/KDPFILTL                 03/17/2007  10:35 PM      45,940
li6243/ms/lib/KDPGBPCL                 03/17/2007  10:35 PM      33,860
li6243/ms/lib/KDPGBPPL                 03/17/2007  10:35 PM      36,994
li6243/ms/lib/KDPGGVDL                 03/17/2007  10:35 PM      42,448
li6243/ms/lib/KDPGGVSL                 03/17/2007  10:35 PM      37,375
li6243/ms/lib/KDPGLOKL                 03/17/2007  10:35 PM      38,450
li6243/ms/lib/KDPGOAAL                 03/17/2007  10:35 PM      45,830
li6243/ms/lib/KDPGOASL                 03/17/2007  10:35 PM      45,688
li6243/ms/lib/KDPGOTAL                 03/17/2007  10:35 PM      45,525
li6243/ms/lib/KDPGSTSL                 03/17/2007  10:35 PM      38,273
li6243/ms/lib/KDPGVTAL                 03/17/2007  10:35 PM      41,247
li6243/ms/lib/KDPTHDTL                 03/17/2007  10:35 PM      37,912
li6243/ms/lib/KDPTSTAL                 03/17/2007  10:35 PM      36,996

	
ls3263/ms/lib/KDPCFGGL                 03/25/2007  05:18 PM      42,600
ls3263/ms/lib/KDPFILTL                 03/25/2007  05:18 PM      50,437
ls3263/ms/lib/KDPGBPCL                 03/25/2007  05:18 PM      38,809
ls3263/ms/lib/KDPGBPPL                 03/25/2007  05:18 PM      39,551
ls3263/ms/lib/KDPGGVDL                 03/25/2007  05:18 PM      48,173
ls3263/ms/lib/KDPGGVSL                 03/25/2007  05:18 PM      42,788
ls3263/ms/lib/KDPGLOKL                 03/25/2007  05:18 PM      42,911
ls3263/ms/lib/KDPGOAAL                 03/25/2007  05:18 PM      50,767
ls3263/ms/lib/KDPGOASL                 03/25/2007  05:18 PM      49,285
ls3263/ms/lib/KDPGOTAL                 03/25/2007  05:18 PM      49,366
ls3263/ms/lib/KDPGSTSL                 03/25/2007  05:18 PM      43,826
ls3263/ms/lib/KDPGVTAL                 03/25/2007  05:18 PM      43,892
ls3263/ms/lib/KDPTHDTL                 03/25/2007  05:18 PM      41,961
ls3263/ms/lib/KDPTSTAL                 03/25/2007  05:18 PM      40,561

sol283/ms/lib/KDPCFGGL                 03/17/2007  10:52 PM      51,664 
sol283/ms/lib/KDPFILTL                 03/17/2007  10:52 PM      63,636 
sol283/ms/lib/KDPGBPCL                 03/17/2007  10:52 PM      47,992 
sol283/ms/lib/KDPGBPPL                 03/17/2007  10:52 PM      48,632 
sol283/ms/lib/KDPGGVDL                 03/17/2007  10:52 PM      58,924 
sol283/ms/lib/KDPGGVSL                 03/17/2007  10:52 PM      52,732 
sol283/ms/lib/KDPGLOKL                 03/17/2007  10:52 PM      52,560 
sol283/ms/lib/KDPGOAAL                 03/17/2007  10:52 PM      62,212 
sol283/ms/lib/KDPGOASL                 03/17/2007  10:52 PM      60,232 
sol283/ms/lib/KDPGOTAL                 03/17/2007  10:52 PM      60,780 
sol283/ms/lib/KDPGSTSL                 03/17/2007  10:52 PM      53,540 
sol283/ms/lib/KDPGVTAL                 03/17/2007  10:52 PM      53,912 
sol283/ms/lib/KDPTHDTL                 03/17/2007  10:52 PM      49,840 
sol283/ms/lib/KDPTSTAL                 03/17/2007  10:52 PM      49,520 




Where $platform is one of the following:

   li6243 or li6263 for Intel Linux
   ls3263 for zSeries Linux

   aix513 or aix533 for AIX.
   sol283 for Solaris

Note that the date and time values listed above will be adjusted on your
system based on your local time zone settings. All of the above times 
are United States Pacific Standard Time (PST).

=========================================================================
1.3 Backward compatibility with prior version of this product
=========================================================================

This maintenance update requires installation of IBM Tivoli OMEGAMON XE
for DB2 Performance Expert (Monitor) V410 PTFs as follows:

UK23929
UK23930
UK33238
UK33296   

Supersedes prior maintenance updates:
4.1.0-TIV-KD5-ITM-IF0001
4.1.0-TIV-ITM_KD5-IF0002
4.1.0-TIV-KD5-IF0003
4.1.0-TIV-KD5-IF0004

4.1.0.3-TIV-KD5-IF0001


=========================================================================
1.4 Cross-Product compatibility
=========================================================================
	
The maintenance update requires IBM Tivoli Monitoring Version 6.1.0
-  IBM Tivoli Monitoring Version 6.1.0 Fix Pack 5 Interim fix 4 
   (6.1.0.5-TIV-ITM-IF0004) is recommended.

=========================================================================
2.0 Installation and configuration

=========================================================================

=========================================================================
2.1 Hardware and Software Requirements
=========================================================================


=========================================================================
2.2 Installation steps:
=========================================================================

1. Use SMP/E to confirm that OMEGAMON XE for DB2 Performance 
   Expert (Monitor) V410 PTF UK23929, UK23930, UK33238 and UK33296 have 
   been installed.

2. Confirm that IBM Tivoli Monitoring 6.1.0 Fix Pack 5 Interim fix 4 
   (6.1.0.5-TIV-ITM-IF0004) (or later) has 
   been installed by using the Help --> About function from the Tivoli 
   Enterprise Portal.

3. Ensure that Tivoli Enterprise Portal Server (TEPS) is running.

4. Backup the Tivoli Enterprise Portal Database. To do this:
   
   On Windows systems:

     Navigate to the CNPS subdirectory and enter this command:


       migrate-export

     This script generates a file named saveexport.sql in the 
     c:\ibm\itm\cnps\sqllib subdirectory. It contains all the Tivoli 
     Enterprise Portal Server data.

     Note: Running the migrate-export process stops the Tivoli 
     Enterprise Portal Server if it is currently running.


   On UNIX or Linux systems:

     Navigate to /opt/IBM/ITM/bin and run the following command:

       ./itmcmd execute cq "runscript.sh migrate-export" 

     This script generates a file named saveexport.sql in the 
     /opt/IBM/ITM/$platform/cq/sqllib subdirectory. It contains all 
     the Tivoli Enterprise Portal Server data, where $platform is one 
     of the following:
   
       li6243 or li6263 for Intel Linux


       ls3263 for zSeries Linux 
       aix513 or aix533 for AIX

       sol283 for Solaris

5. Make backup copies of all the files listed above under the heading
  "Replaced Modules."

6. Copy the maintenance update zip or tar file to the Tivoli Enterprise 
   Monitoring Server(s) and Tivoli Enterprise Portal Server system(s).


7. Extract the maintenance update zip or tar file, using a command 
   such as:

   On Windows systems:
     unzip -v 4.1.0.3-TIV-KD5-IF0002.zip


   On UNIX or Linux systems: 
     - if the version of tar used supports z, then
       tar -zxvf 4.1.0.3-TIV-KD5-IF0002.tar.gz

     - if the version of tar used does not support z, then
       gunzip 4.1.0.3-TIV-KD5-IF0002.tar.gz
       tar -xvf 4.1.0.3-TIV-KD5-IF0002.tar

   This action should create a directory structure that contains the
   fix patches and this readme file.

8. Start the Application Support Installer GUI to install the interim 
   fixpack.  The GUI can be started by using the following command from
   within the interim fixpack directory
    
     java -jar setup.jar	

   Note that you need to have a JVM in your path.  When prompted by the 

   Application Support Installer for the patch directory, select the 
   maintenance update directory, NOT the component directory, as in 
   these examples:

   On Windows systems: c:\temp\4.1.0.3-TIV-KD5-IF0002

   On UNIX or Linux systems: /temp/4.1.0.3-TIV-KD5-IF0002


   The installer can install updates for multiple components at the same 
   time, which is why you need to select the parent directory.

NOTE: Steps 9-11 apply to UNIX and Linux ONLY. The commands in these 
      steps    must be executed from the bin subdirectory of the IBM 
   Tivoli Monitoring V6.1.0 installation:


9. Stop the portal server by running the following command:


     ./itmcmd agent stop cq 



10. Run the following command to configure the portal server with the 
    new agent information:

      ./itmcmd config -A cq 

    Complete the configuration as prompted. For information about
    configuring the portal server, refer to the latest version of IBM 
    Tivoli Monitoring: Install and Setup Guide, found at this Web 
    address:

    http://publib.boulder.ibm.com/infocenter/tivihelp/v15r1/index.jsp?
    toc=/com.ibm.omegamon.mn.doc/toc.xml


11. Restart the portal server by running the following command:

      ./itmcmd agent start cq 


NOTE: Step 12 applies to Windows, UNIX, and Linux systems.

12. If the Tivoli Enterprise Portal Desktop or Tivoli Enterprise Portal
    Browser were running when the update was installed, the Tivoli 
    Enterprise Portal Desktop or Tivoli Enterprise Portal Browser must
    be restarted.

=========================================================================
2.3 Installation using a response file (silent install):
=========================================================================

You can install the application support files on the IBM Tivoli 


Monitoring components through the silent install method using a response 
file. 

Note: If your UNIX or Linux computer does not have X-Windows, you must 
use the silent installation method. 

1. Perform Steps 1 through 7 as described under "Installation steps."

2. In the same directory with the extracted files, create a text file 
   named response.txt that contains the following lines: 

# IBM Tivoli Monitoring installation directory
-W Directories.itmhome="/opt/IBM/ITM"

# Directory where the application support media is located
-W Directories.mediaLocation=""

# Select "true" to install monitoring server support files
-W ComponentSelectionPanel.temsSelected="true"

# Select "true" to install portal server support files

-W ComponentSelectionPanel.tepsSelected="true"


# Select "true" to install portal desktop client support files
# IMPORTANT: set this to true if you have the portal desktop 
# client installed.
-W ComponentSelectionPanel.tepdSelected="false"


# Comma-separated list of directories with the application media
# location to install.These are directories that contain the
# product support files and are sub-directories under the specified
# media location.
# e.g. -W ProductSelectionPanel.products="kc5_v410,km5_v410"
-W ProductSelectionPanel.products=""

# Set this flag to "true" if you want to re-install if the
# specified product is already installed. This overwrites
# any previously installed support files for this product.
-W ProductSelectionPanel.reinstall="true"

# Setting this flag to "true" confirms that you have purchased
# an OMEGAMON DE license. If any product requires a DE LICENSE
# and this flag is "false" installation will fail
-W ProductSelectionPanel.deLicense="false" 

3. Launch the installation program by running the following command 
   from within the install CD-ROM directory: 

     java -jar setup.jar -silent -options response.txt 

   Note that you need to either have the IBM Java JRE v1.4.2 in 
   your path or invoke the JRE executable directly by specifying 
   the path to it on the command line. To invoke the JRE executable 
   directly, issue the following command: 


     Java_installDir\java -jar setup.jar -silent -options response.txt 

   Where Java_installDir is the location where the JRE (provided 
   by IBM Tivoli Monitoring) is installed on your monitoring server. 

   To locate the JRE that is being used by IBM Tivoli Monitoring 
   on UNIX or Linux, run the following command: 

     find ITM_installDir -name java 



   Where ITM_installDir is the location where IBM Tivoli Monitoring is 
   installed on your monitoring server.

   To ensure that the level of JRE is 1.4.2, run the following command 

   from the directory where the JRE is installed: 


     ./java -version 

   If the JRE level is not 1.4.2, you must download the IBM Java JRE 
   v1.4.2 from the IBM Software Support Web site. 


4. Validate the silent install by examining the installation log file:

   On Windows systems: A location defined by the TEMP environment 
   variable

   On UNIX and Linux systems: /tmp/ ITM_AppSupport_SilentInstall.log


5. Perform Steps 9 through 12 as described under "Installation steps."

=========================================================================
3.0 Uninstallation information
=========================================================================

1. Stop the Tivoli Enterprise Portal Server.

2. Restore your Tivoli Enterprise Portal database. To do this:

  
   On Windows systems:

   Navigate to the CNPS subdirectory and enter this command:

     migrate-import

   Note: Running the migrate-import process stops the Tivoli 
   Enterprise Portal Server if it is currently running.


   On UNIX or Linux systems:

   Navigate to /opt/IBM/ITM/bin and run the following command:

     ./itmcmd execute cq "runscript.sh migrate-import" 

   This script imports Tivoli Enterprise Portal Server data to TEPS 
   database from saveexport.sql located at /opt/IBM/ITM/$platform/

   cq/sqllib subdirectory. Where $platform is one of the following:
   
     li6243 or li6263 for Intel Linux
     ls3263 for zSeries Linux 
     aix513 or aix533 for AIX 
     sol283 for Solaris

3. Copy the backed up files from Step 5 of the installation steps to 
   the corresponding directories under your \IBM\ITM (Windows) or 
   /opt/IBM/ITM/ (UNIX or Linux) directory.

4. Rebuild the presentation files by issuing the following commands: 

   On Windows systems:

   Navigate to the CNPS subdirectory and enter this command:

     InstallPresentation

   On UNIX or Linux systems:

   a. Navigate to /opt/IBM/ITM/bin and run the following command to 
      stop the portal server:

        ./itmcmd agent stop cq 

   b. Run the following command to configure the portal server with 
      the new agent information:

        ./itmcmd config -A cq 

      Complete the configuration as prompted. For information about
      configuring the portal server, refer to the latest version of 
      IBM Tivoli Monitoring: Install and Setup Guide, found at this 
      Web address:


      http://publib.boulder.ibm.com/infocenter/tivihelp/v15r1/
      index.jsp?toc=/com.ibm.omegamon.mn.doc/toc.xml

   c. Restart the portal server by running the following command:

        ./itmcmd agent start cq 

=========================================================================
4.0 SUPPORT INFORMAITON
=========================================================================

If you have a problem with your IBM software, you want to resolve it
quickly. This section describes options for obtaining support for IBM
software products.

=========================================================================


4.1 Using IBM Support Assistant
=========================================================================

The IBM Support Assistant is a free, stand-alone application that you can
install on any workstation. You can then enhance the application by
installing product-specific plug-in modules for the IBM products you use.

The IBM Support Assistant saves you time searching product, support, and
educational resources. The IBM Support Assistant helps you gather support
information when you need to open a problem management record (PMR), 
which you can then use to track the problem.

The product-specific plug-in modules provide you with the following
resources:
- Support links
- Education links
- Ability to submit problem management reports

For more information, see the IBM Support Assistant Web site at: 
 

            http://www.ibm.com/software/support/isa

If your product does not use IBM Support Assistant, use the links to
support topics in your information center. In the navigation frame, check
the links for resources listed in the ibm.com and related resource
section where you can search the following resources:

- Support and assistance (includes search capability of IBM technotes
  and IBM downloads for interim fixes and workarounds)
- Training and certification
- IBM developerWorks
- IBM Redbooks
- General product information

If you cannot find the solution to your problem in the information
center, search the following internet resources for the latest
information that might help you resolve your problem:
- Forums and newsgroups
- Search engines

=========================================================================
4.2 Obtaining Fixes

=========================================================================


A product fix might be available to resolve your problem. To determine
what fixes are available for your IBM software product, follow these
steps:
- Go to the IBM Software Support Web site at
  http://www.ibm.com/software/support
- Under Find product support, click "All IBM Software (A-Z)”. This opens
  the software product list.
- In the software product list,
  click "IBM Tivoli OMEGAMON XE for DB2 on z/OS". This opens the
  "IBM Tivoli OMEGAMON XE for DB2 on z/OS" support site.
- Click the name of a fix to read the description and optionally download
  the fix. You can also search for a specific fix; for tips on refining
  your search, click "Search tips".
- In the "Find downloads and drivers by product" section, select one
  software category from the "Category" list.
- Select one product from the "Sub-category" list.
- Type more search terms in the "Search within results" if you want to
  refine your search.

- Click "Search".
- From the list of downloads returned by your search, click the name of

  a fix to read the description of the fix and to optionally download
  the fix.

For more information about the types of fixes that are available, see the
IBM Software Support Handbook at

  http://techsupport.services.ibm.com/guides/handbook.htm


=========================================================================
4.3 Receiving weekly support updates
=========================================================================

To receive weekly e-mail notifications about fixes and other software
support news, follow these steps: 

- Go to the IBM Software Support Web site at

    http://www.ibm.com/software/support. 

- Click "My support" in the upper right corner of the page. 
- If you have already registered for "My support", sign in and skip to
  the next step. If you have not registered, click "register now".
  Complete the registration form using your e-mail address as your
  IBM ID and click "Submit". 
- Click "Edit profile". 
- In the "Products" list, select "Software". A second list is displayed. 
- In the second list, select a product segment, for example,
  "Systems Management". A third list is displayed. 
- In the third list, select a product sub-segment, for example,
  "System Performance". A list of applicable products is displayed. 
- Select the products for which you want to receive updates, for example,
  IBM Tivoli OMEGAMON XE for DB2 on z/OS. 
- Click Add products. 
- After selecting all products that are of interest to you, click
  Subscribe to email on the Edit profile tab. 
- Select Please send these documents by weekly email. 
- Update your e-mail address as needed. 
- In the Documents list, select Software. 
- Select the types of documents that you want to receive information
  about. 
- Click Update.

If you experience problems with the My support feature, you can obtain
help in one of the following ways: 


Online:
Send an e-mail message to erchelp@ca.ibm.com, describing your problem. 

By phone:
Call 1-800-IBM-4You (1-800-426-4968). 



=========================================================================
4.4 Contacting IBM Software Support
=========================================================================

IBM Software Support provides assistance with product defects.

Before contacting IBM Software Support, your company must have an active

IBM software maintenance contract, and you must be authorized to submit
problems to IBM. The type of software maintenance contract that you need

depends on the type of product you have: 

- For IBM distributed software products (including, but not limited to
  Tivoli, Lotus, and Rational products, as well as DB2 and WebSphere
  products that run on Windows, or UNIX operating systems),
  enroll in Passport Advantage in one of the following ways: 

  Online 
     Go to the Passport Advantage Web site at

     http://www.lotus.com/services/passport.nsf/
            WebDocs/Passport_Advantage_Home

     and click "How to Enroll".
 
  By phone 
     For the phone number to call in your country, go to the
     IBM Software Support Web site at

     http://techsupport.services.ibm.com/guides/contacts.html

     and click the name of your geographic region.
 
- For customers with Subscription and Support (S & S) contracts, go to
  the Software Service Request Web site at

  https://techsupport.services.ibm.com/ssr/login.
 


- For customers with IBMLink, CATIA, Linux, S/390, iSeries,
  pSeries, zSeries, and other support agreements, go to the IBM

  Support Line Web site at

  http://www.ibm.com/services/us/index.wss/so/its/a1000030/dt006.
 
- For IBM eServer software products (including, but not limited to,
  DB2 and WebSphere products that run in zSeries, pSeries, and iSeries
  environments), you can purchase a software maintenance agreement by
  working directly with an IBM sales representative or an IBM Business

  Partner. For more information about support for eServer software
  products, go to the IBM Technical Support Advantage Web site at

  http://www.ibm.com/servers/eserver/techsupport.html.

If you are not sure what type of software maintenance contract you need,
call 1-800-IBMSERV (1-800-426-7378) in the United States. From other
countries, go to the contacts page of the IBM Software Support Handbook
on the Web at

  http://techsupport.services.ibm.com/guides/contacts.html

and click the name of your geographic region for phone numbers of people
who provide support for your location.

To contact IBM Software support, follow these steps:

- Determining the business impact

  When you report a problem to IBM, you are asked to supply a severity
  level. Therefore, you need to understand and assess the business
  impact of the problem that you are reporting. Use the following
  criteria: 

  Severity 1 
      The problem has a critical business impact. You are unable to use
      the program, resulting in a critical impact on operations. This
      condition requires an immediate solution. 

  Severity 2 
      The problem has a significant business impact. The program is

      usable, but it is severely limited. 

  Severity 3 

      The problem has some business impact. The program is usable, but
      less significant features (not critical to operations) are
      unavailable. 

  Severity 4 
      The problem has minimal business impact. The problem causes little
      impact on operations, or a reasonable circumvention to the problem
      was implemented. 
 
- Describing problems and gathering information


  When describing a problem to IBM, be as specific as possible. Include
  all relevant background information so that IBM Software Support
  specialists can help you solve the problem efficiently. To save time,
  know the answers to these questions: 

  - What software versions were you running when the problem occurred? 
  - Do you have logs, traces, and messages that are related to the
    problem symptoms? IBM Software Support is likely to ask for this
    information. 

  - Can you re-create the problem? If so, what steps were performed to
    re-create the problem? 
  - Did you make any changes to the system? For example, did you make
    changes to the hardware, operating system, networking software, and
    so on. 
  - Are you currently using a workaround for the problem? If so, be

    prepared to explain the workaround when you report the problem.
 
- Submitting problems


  You can submit your problem to IBM Software Support in one of two ways:

  Online 
      Click Submit and track problems on the IBM Software Support site
      at

        http://www.ibm.com/software/support/probsub.html.


      Type your information into the appropriate problem submission form.
  
  By phone 
      For the phone number to call in your country, go to the contacts
      page of the IBM Software Support Handbook at

        http://techsupport.services.ibm.com/guides/contacts.html

      and click the name of your geographic region.
 
  If the problem you submit is for a software defect or for missing or
  inaccurate documentation, IBM Software Support creates an
  Authorized Program Analysis Report (APAR). The APAR describes the
  problem in detail. Whenever possible, IBM Software Support provides a

  workaround that you can implement until the APAR is resolved and a fix
  is delivered. IBM publishes resolved APARs on the Software Support
  Web site daily, so that other users who experience the same problem
  can benefit from the same resolution.



=========================================================================

5.0 NOTICES AND TRADEMARKS
=========================================================================

-----------------------
5.1 Notices:
-----------------------

This information was developed for products and services offered in the
U.S.A. IBM may not offer the products, services, or features discussed in
this document in other countries. Consult your local IBM representative
for information on the products and services currently available in your
area. Any reference to an IBM product, program, or service is not
intended to state or imply that only that IBM product, program, or
service may be used. Any =functionally equivalent product, program, or

service that does not infringe any IBM intellectual property right may be
used instead. However, it is the user’s responsibility to evaluate and
verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject
matter described in this document. The furnishing of this document does
not give you any license to these patents. You can send license
inquiries, in writing, to:

    IBM Director of Licensing 
    IBM Corporation
    North Castle Drive

    Armonk, NY 10504-1785 U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact
the IBM Intellectual Property Department in your country or send

inquiries, in writing, to:

    IBM World Trade Asia Corporation
    Licensing
    2-31 Roppongi 3-chome, Minato-ku
    Tokyo 106, Japan

The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION
"AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.




Some states do not allow disclaimer of express or implied warranties in 
certain transactions, therefore, this statement might not apply to you.

This information could include technical inaccuracies or typographical
errors. Changes are periodically made to the information herein; these
changes will be incorporated in new editions of the publication. IBM may
make improvements and/or changes in the product(s) and/or the program(s)
described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for
convenience only and do not in any manner serve as an endorsement of
those Web sites. The materials at those Web sites are not part of the
materials for this IBM product and use of those Web sites is at your own
risk.

IBM may use or distribute any of the information you supply in any way it
believes appropriate without incurring any obligation to you.
 
Licensees of this program who wish to have information about it for the 
purpose of enabling: (i) the exchange of information between
independently created programs and other programs (including this one)
and (ii) the mutual use of the information which has been exchanged,
should contact:

    IBM Corporation
    2Z4A/101
    11400 Burnet Road

    Austin, TX 78758 U.S.A.

Such information may be available, subject to appropriate terms and
conditions, including in some cases payment of a fee.

The licensed program described in this document and all licensed material 
available for it are provided by IBM under terms of the IBM Customer
Agreement, IBM International Program License Agreement or any equivalent
agreement between us.


Any performance data contained herein was determined in a controlled 
environment. Therefore, the results obtained in other operating
environments may vary significantly. Some measurements may have been made
on development-level systems and there is no guarantee that these
measurements will be the same on generally available systems.
Furthermore, some measurement may have been estimated through
extrapolation. Actual results may vary. Users of this document should
verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers
of those products, their published announcements or other publicly
available sources. IBM has not tested those products and cannot confirm
the accuracy of performance, compatibility or any other claims related to
non-IBM products. Questions on the capabilities of non-IBM products
should be addressed to the suppliers of those products.

All statements regarding IBM’s future direction or intent are subject to
change or withdrawal without notice, and represent goals and objectives

only.

This information may contain examples of data and reports used in daily 

business operations. To illustrate them as completely as possible, the
examples include the names of individuals, companies, brands, and
products. All of these names are fictitious and any similarity to the
names and addresses used by an actual business enterprise is entirely
coincidental.

COPYRIGHT LICENSE:

This information may contain sample application programs in source
language, which illustrate programming techniques on various operating
platforms. You may copy, modify, and distribute these sample programs in
any form without payment to IBM, for the purposes of developing, using,
marketing or distributing application programs conforming to the
application programming interface for the operating platform for which
the sample programs are written. These examples have not been thoroughly
tested under all conditions. IBM, therefore, cannot guarantee or imply
reliability, serviceability, or function of these programs. You may copy,
modify, and distribute these sample programs in any form without payment
to IBM for the purposes of developing, using, marketing, or distributing
application programs conforming to IBM’s application programming
interfaces.


-----------------------
5.2 Trademarks:
-----------------------

IBM, DB2, OMEGAMON, Tivoli, Tivoli Enterprise, z/OS, zSeries, pSeries,
AIX, IBMLink, S/390, ibm.com, IBM developerWorks, Passport Advantage,
Rational, Lotus, eServer, and IBM Redbooks are trademarks or registered
trademarks of International Business Machines Corporation in the
United States, other countries, or both.

Intel and Pentium  are trademarks of Intel Corporation in the United
States, other countries, or both.

Linux is a trademark of Linus Torvalds in the United States, other
countries, or both.

Microsoft(R) and Windows are registered trademarks of Microsoft
Corporation in the United States, other countries, or both.

Solaris(TM), Java(TM) and all Java-based trademarks and logos are 
trademarks or registered trademarks of Sun Microsystems, Inc. in the
United States, other countries, or both.

UNIX(R)is a registered trademark of The Open Group in the United States
and other countries.


Other company, product, and service names may be trademarks or service
marks of others.

=========================================================================
