OMEGAMON(R) XE for Storage on z/OS(R) V4.1.0 Fix Pack 2 Interim Fix 2 (ITM) Readme
4.1.0.2-TIV-ITM_KS3-IF0002

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

US Government Users Restricted Rights - Use, duplication or disclosure 
restricted by GSA ADP Schedule Contract with IBM Corp.

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

1.0 About this fixpack/interim fix
  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
  1.5 z/OS release 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/INTERIM FIX
=========================================================================

Set the font to monospace to better view this file.

This maintenance update is Interim Fix 2 for Tivoli OMEGAMON XE for
Storage on z/OS V4.1.0 Fix Pack 2 for use with ITM v6.x. It includes 
10 APAR fixes as listed below. A z/OS prereq (or coreq) PTF fix is required.

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

The following APARs are addressed in this maintenance update:

OA26833 Support for OMEGAMON Tivoli Event Adapter

  Problem Summary:
    The Tivoli Enterprise Console requires MAP and BAROC files
    to facilitate the forwarding of events generated by Tivoli
    OMEGAMON XE for Storage on z/OS to Tivoli Enterprise Consoles.

  Conclusion:
    MAP and BAROC files are provided, along with a User's Guide 
    Supplement to instruct users on proper installation and 
    configuration to provide this integration.


OA26224 Numeric sort incorrect in many workspace columns

  Problem Summary:
    This sorting problem occurs on attributes defined as integers
    which also have ENUMs defined for them. Most often, the ENUM 
    simply exists to force the display of the literal 'n/a'      
    when a -1 is returned in the attribute.                      
                                                             
    The defect is fixed in ITM 6.2 but requires a new parm to    
    be added in the CAT & ATR files for all such attributes.     
    Presently, there is no fix for this problem at the ITM 6.1   
    level.                                                       

  Conclusion:
    CAT & ATRs have been updated with a parameter which forces  
    sorting based on the internal value of the attribute, rather
    than the display (enumerated) value.                        

OA26087 Levelset maintenance

  Problem Summary:
    Combine all previous z/OS maintenance into a single PTF for ease 
    of installation and upgrade.
                                                               
OA24244 Association lost between situations and templates.

  Problem Summary:
    An incorrect version of ks3_kcj.sql was shipped with OA22816 and
    OA23773 causing situation-to-template associations to be lost for
    some user-written situations.

    New versions of ks3.atr, ks3.cat and docks3 are also shipped with 
    this fix to correct the problem where the timestamp on these files
    was not in synch with the z/OS versions of the same files.
                                                               

OA23773 Interim Feature: Interoperability with IBM Tivoli Advanced 
        Reporting for DFSMShsm

  Problem Summary: 
    Interim Feature adding the following new functions:                                     
                                                               
    * New dynamic workspace links to IBM Tivoli Advanced Reporting for 
      DFSMShsm
                                                               

OA22816 Add support for cross-system dataset details report and the 
        cancelling of queued or active HSM requests

  Problem Summary: 
    Interim Feature adding the following new functions:                                     
                                                               
    * Ability to cancel active or pending HSM requests             
                                                               
    * Dynamic workspace linking from the Cross System Volume       
      Performance workspace to the Dataset Performance Summary     
      workspace for the target volume.                             
                                                               
    * Dynamic workspace linking from various workspaces in OMEGAMON
      XE for Storage into various workspaces in the Tivoli         
      Advanced Catalog Management and Tivoli HSM Advanced Audit    
      products.	


OA22555 Pie chart missing for Volume Space Allocation workspace

  Problem Summary:
    On a dynamic link from another product into OMEGAMON XE for Storage
    Volume Space Allocation workspace, the pie chart graphic is missing.

  Conclusion:
    The query for this graphic was malformed and has been corrected.

OA19234 INCORRECT INDEX CONFIGURATION IN ODI CAN CAUSE TEMS TO CRASH ON 
        DISTRIBUTED PLATFORMS

  Problem Summary:
    Catalog index sequence numbers should be unique  within a table but 
    they are not.  This is caused by using multiple index names within a 
    single table.                       

  Conclusion:
    ODI was modified to use a single index name aggregating the various 
    index attributes into a single key.                

OA18583 HyperPAV support and further fix to Cancel option for Storage 
    Toolkit results

  Problem Summary:
    HyperPAV support.

  Conclusion:
    HyperPAV support.

OA18897 NR OA18620 FIX COMPLETION - Cancel option not available for Storage 
    Toolkit requests

  Problem Summary:
    After applying fix OA18620 there is still no Cancel option available on 
    the popup menu for Storage Toolkit activities. The updated ks3.jar file 
    was not included in 4.1.0-TIV-ITM_XESTG-IF0001

  Conclusion:
    This fix adds the revised ks3.jar file.

OA18620 Various fixes to the user interface

  Problem Summary:
     Various problems including: Missing and/or incorrect data when requesting TDW summarized data for most 
     tables. Error in display of historical data for dataset details. Inconsistencies in field validation 
     for dataset attributes after initial install. Other minor issues in the user interface. Enables the 
     scheduling of Storage Toolkit actions and enables the cancellation of Storage Toolkit actions that are 
     either executing or waiting for execution.

  Conclusion:
     Code modified to address problems listed above. NOTE that this fixpack requires the installation of
     PTF UA30250 to the TEMS supporting the agent code on z/OS.

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

New Modules:
-----------

________Module______________            _____Date/Time_____  ___Size___
TEMS\TECLIB\ks3.map                    10/20/2008  03:59 PM     372,736
TEMS\TECLIB\ks3.baroc                  10/20/2008  04:00 PM     143,360



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

Windows directory structure:

________Module______________            _____Date/Time_____  ___Size___
TEMS\ATTRLIB\ks3.atr                   10/17/2008  03:24 PM     466,944
TEMS\RKDSCATL\ks3.cat                  10/17/2008  03:25 PM     446,464
TEMS\SQLLIB\ks3.his                    08/17/2006  06:34 PM      42,180
TEMS\SQLLIB\ks3.sql                    08/23/2008  10:18 AM      75,798
TEMS\SQLLIB\ks3_del.sql                08/23/2008  10:18 AM      13,224
TEPD\CNP\ks3.jar                       09/21/2007  10:39 AM     220,195
TEPD\CNP\ks3_resources.jar             01/16/2008  01:24 PM     310,344
TEPD\CNB\classes\ks3.jar               09/21/2007  10:39 AM     220,195
TEPD\CNB\classes\ks3_resources.jar     01/16/2008  01:24 PM     310,344
TEPD\CNB\classes\ks3.inf               01/15/2008  03:50 PM          48
TEPS\CNB\classes\candle\ks3\properties\help.properties
                                       06/28/2007  05:54 AM       2,066
TEPS\CNPS\docks3                       10/17/2008  03:25 PM     966.656
TEPS\CNPS\classes\ks3.jar              09/21/2007  10:39 AM     220,195
TEPS\CNPS\classes\ks3_resources.jar    01/16/2008  01:24 PM     310,344
TEPS\CNPS\classes\candle\ks3\resources\Ks3Ids.class
                                       08/29/2007  07:49 AM     206,008
TEPS\CNPS\CMSATR\ks3.atr               10/17/2008  03:24 PM     466,944
TEPS\CNPS\RKDSCATL\ks3.cat             10/17/2008  03:25 PM     446,464
TEPS\CNPS\SQLLIB\ks3_kcj.sql           08/23/2008  10:18 AM     426,618
TEPS\CNPS\SQLLIB\ks3_links.sql         08/23/2008  10:18 AM   5,613,512
TEPS\CNPS\SQLLIB\ks3_pres.sql          08/23/2008  10:18 AM   1,884,216
TEPS\CNPS\SQLLIB\Ks3Package.xml        06/19/2007  04:49 PM      18,810


UNIX and Linux directory structure:

________Module______________            _____Date/Time_____  ___Size___
$platform/cq/tables/ATTRLIB/ks3.atr    03/17/2008  11:53 AM     464,787
tables/$temsname/ATTRLIB/ks3.atr       03/17/2008  11:53 AM     464,787
tables/cicatrsq/ATTRLIB/ks3.atr        03/17/2008  11:53 AM     464,787

$platform/cq/tables/ATTRLIB/ks3.cat    03/17/2008  11:54 AM     445,951
tables/$temsname/RKDSCATL/ks3.cat      03/17/2008  11:54 AM     445,951
tables/cicatrsq/RKDSCATL/ks3.cat       03/17/2008  11:54 AM     445,951

$platform/cq/data/docks3               03/17/2008  11:54 AM     940,699

$platform/cq/sqllib/ks3.his            08/17/2006  06:34 PM      42,180
tables/cicatrsq/ATTRLIB/ks3.his        08/17/2006  06:34 PM      42,180
tables/cicatrsq/SQLLIB/ks3.his         08/17/2006  06:34 PM      42,180

$platform/cq/sqllib/ks3_kcj.sql        08/23/2008  10:18 AM     426,618

$platform/cq/sqllib/ks3.sql            08/23/2008  10:18 AM      75,798
tables/cicatrsq/SQLLIB/ks3.sql         08/23/2008  10:18 AM      75,798

$platform/cq/sqllib/ks3_del.sql        08/23/2008  10:18 AM      13,224
tables/cicatrsq/SQLLIB/ks3_del.sql     08/23/2008  10:18 AM      13,224

$platform/cq/sqllib/ks3_links.sql      08/23/2008  10:18 AM   5,613,512
$platform/cq/sqllib/ks3_pres.sql       08/23/2008  10:18 AM   1,884,216

$platform/cq/classes/ks3.jar           09/21/2007  10:39 AM     220,195
$platform/cw/classes/ks3.jar           09/21/2007  10:39 AM     220,195
$platform/cj/classes/ks3.jar           09/21/2007  10:39 AM     220,195
$platform/cq/classes/ks3_resources.jar 01/16/2008  01:24 PM     310,344
$platform/cw/classes/ks3_resources.jar 01/16/2008  01:24 PM     310,344
$platform/cj/classes/ks3_resources.jar 01/16/2008  01:24 PM     310,344
$platform/cw/ks3.inf                   01/15/2008  03:50 PM          48
$platform/cj/ks3.inf                   01/15/2008  03:50 PM          48
$platform/cw/classes/ks3.inf           01/15/2008  03:50 PM          48

$platform/cq/classes/candle/ks3/resources/Ks3Ids.class
                                       08/29/2007  07:49 AM     206,008
$platform/cw/candle/ks3/properties/help.properties
                                       06/28/2007  05:54 AM       2,066

$platform/cq/sqllib/Ks3Package.xml     06/19/2007  04:49 PM      18,810


Where $temsname is the name you assigned to your tems on this Linux host
when you configured it.

Where $platform is one of the following:

   li6243 or li6263 for Intel(R) Linux
   ls3263 for zSeries(R) Linux
   aix533 for AIX(R).

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 Storage on z/OS V410 PTFs as follows:

UA44173
UA37449
UA30250
UA30424
UA32186
UA42867

Supersedes prior maintenance updates:
4.1.0-TIV-ITM_KS3-FP0002
4.1.0.1-TIV-ITM_KS3-IF0003
4.1.0.1-TIV-ITM_KS3-IF0002
4.1.0.1-TIV-ITM_KS3-IF0001
4.1.0-TIV-ITM_KS3-IF0005
Application support CD LCD7-0963-04
4.1.0-TIV-ITM_XESTG-IF0004
4.1.0-TIV-ITM_XESTG-IF0003
4.1.0-TIV-ITM_XESTG-IF0002
4.1.0-TIV-ITM_XESTG-IF0001

=========================================================================
1.4 Cross-Product compatibility
=========================================================================

The maintenance update requires a minimum IBM Tivoli Monitoring level of 
Version 6.1.0 Fix Pack 5 (6.1.0-TIV-ITM-FP0005).

This fix contains resource bundle jar files signed with a java certificate
Valid from: 8/29/07 5:00 PM until: 8/29/10 4:59 PM.  If you use a language
pack with your product, you must download and install the latest language 
pack, which contains matching jar signatures. Failure to do this will cause 
areas of the product which are normally globalized to your specific language 
to default to English.

As of 08/23/2008 the following links represent the latest language packs 
for the OMEGAMON XE for Storage product.  You may use one which suits your 
environment and installation needs.

ftp://ftp.software.ibm.com/software/tivoli_support/misc/PandA/tools_agent/
tools/langsupt/LCD7-0971-02.iso
ftp://ftp.software.ibm.com/software/tivoli_support/misc/PandA/tools_agent/
tools/langsupt/LCD7-0971-02.tar
ftp://ftp.software.ibm.com/software/tivoli_support/misc/PandA/tools_agent/
tools/langsupt/LCD7-0971-02.zip

=========================================================================
1.5 z/OS release compatibility
=========================================================================

Maintenance contained on this fixpack requires a minimum release level of
z/OS 1.6 as the operating environment for the OMEGAMON XE for Storage 
agent.

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

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

This fix supports the following operating environments:
    WINDOWS XP
    WINDOWS 2000 (W2)
    WINDOWS 95,98 (W9)
    WINDOWS NT 4.0 (W4)
    Linux on z/Series
    Linux on Intel
    AIX

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

**** SPECIAL NOTICE * PLEASE READ * SPECIAL NOTICE * PLEASE READ ****

PLEASE NOTE:  Installation control files for Interim Fix levels 5 and 
beyond have been modified to correct the internal version and release 
number. Previous fixpacks identified themselves as 04.01.00.xx during 
install. This has been corrected and all subsequent fixes to the v410 
release will report as 04.10.00.xx.  (where xx is the Interim Fix number)

**** SPECIAL NOTICE * PLEASE READ * SPECIAL NOTICE * PLEASE READ ****


1. Use SMP/E to confirm that all PTFs mentioned in 1.3 above have been
   installed in the CSI containing your OMEGAMON XE for Storage on z/OS 
   V410 installation.

2. If you are running ITM 6.1, confirm that IBM Tivoli Monitoring 6.1.0 
   Fixpack 5 has been installed by using the Help --> About function 
   from the Tivoli Enterprise Portal.

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


4. Backup the Tivoli Enterprise Portal Database. To do this:
   
   On Windows(R) 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(TM) 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(R) Linux
       ls3263 for zSeries(R) Linux 
       aix533 for AIX

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

6. Copy the fix pack zip or tar file (4.1.0.2-TIV-ITM_KS3-IF0002.zip 
   or .tar) 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.2-TIV-ITM_KS3-IF0002.zip

   On UNIX or Linux systems: tar -xvf 4.1.0.2-TIV-ITM_KS3-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 fix pack.
   The GUI can be started by using the following command from within
   the fix pack 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.2-TIV-ITM_KS3-IF0002

   On UNIX or Linux systems: c:/temp/4.1.0.2-TIV-ITM_KS3-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 ITM installation
   directory.


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" 

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

   # 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 
   -W ComponentSelectionPanel.tepdSelected="true" 

   # 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.
   -W ProductSelectionPanel.products="kqf-v1.0,kqc-v1.0" 

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


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(R) systems:

   Navigate to the CNPS subdirectory and enter this command:

     migrate-export

   Note: Running the migrate-export process stops the Tivoli 
   Enterprise(TM) 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(R) Linux
     ls3263 for zSeries(R) Linux 
     aix533 for AIX 


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(R) 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 rekated 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 Storage on z/OS". This opens the
  "IBM Tivoli OMEGAMON XE for Storage 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 Storage 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(R) products, as well as DB2 and WebSphere
  products that run on Windows, or UNIX operating systems),
  enroll in Passport Advantage(R) 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(TM), CATIA, Linux, S/390(R), iSeries(TM),
  pSeries(R), 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(TM) 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 IBMs application programming
interfaces.

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

IBM, CICS, OMEGAMON, Tivoli, Tivoli Enterprise, z/OS, ibm.com,
IBM developerWorks, 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.

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.

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