Maintenance Update for OMEGAMON XE for Storage on z/OS 3.1.0 Readme


Title: 
------

   IBM Tivoli OMEGAMON XE for Storage on z/OS 3.1.0 
   Interim Fix Version 3.1.0-TIV-ITM_XESTG-IF0001

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

Date:
-----

   September 6, 2006

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

Copyright Notice:
-----------------

   (C) Copyright IBM Corp. 2006 All Rights Reserved.
                                                                   
   US Government Users Restricted Rights - Use, duplication or
   disclosure restricted by GSA ADP Schedule Contract with 
   IBM Corp.


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

Note:  This fix is cumulative and includes all interim fixes previously
       issued for IBM Tivoli OMEGAMON XE for Storage 3.1.0

Fixes contained in this package:
--------------------------------

		Applies to
APAR		V100	V310	Description
-------	----	----	----------------------------------------------
OA17403	    	   X	No historical data for certain tables
OA15852	   X  	Track destaging rate can't be specified higher that 100
OA12838	   X		VTS workspaces show 65535 where it should say 'n/a'
OA11450	   X		Mount Pending alert lists device status as 20 instead of 'Mount_Pending'
OA10188	   X	   	Some support missing for 2107 devices
OA09835	   X		Add 2107 device support
1-27489502	   X		STORAGE CLASS AVAILABILITY SHOWS A 3 INSTEAD OF UNKNOWN
1-47549765	   X		SITUATION/POLICY COMBINATION WILL NOT CONTINUE TO RESTART
1-54767191	   X		UNABLE TO SET VALUES IN SITUATIONS OR THRESHOLDS.   
1-55018593	   X		SOME FIELDS DID NOT VALIDATE BECAUSE THE ODI RANGE KEYWORD HAD HEX INTEGERS
1-49609361	   X		ON THE DATASET DETAILS SCREENSPACE THE SPACE DETAILS AND SMS CONSTRUCT REPORTS ARE NOT DISPLAYED
1-23457701	   X		OMEGAMON XE FOR STORAGE DROPPED FROM HISTORY CONFIGURATION PRODUCT SELECTION MENU


About this fix:
---------------

APAR OA17403

User Symptom:
     Missing historical data.

Problem Description:
     Some historial uadvisors are defined with names that begin with three spaces.  This is preventing them from starting.
		    
Resolution:
     KS3HIS has been modified to remove the spaces in front of the situation name.

Keywords:
    INCORROUT

Release Level:
    IBM Tivoli OMEGAMON XE for Storage V310

Corequisite Fixes:
    None

Users Affected:
    All TEP users of OMEGAMON XE for Storage V310

Resolution:
    Apply this Interim Fix

Operating System Version(s) that Fix Applies to:
    WINDOWS XP
    WINDOWS 2000 (W2)
    WINDOWS 95,98 (W9)
    WINDOWS NT 4.0 (W4)
    Linux on z/Series
    Linux on Intel

New and Replaced Modules:

  Date        Time               Size    File name  V100 V310
  ----------  --------           ------- ---------  ---- ----
  07/24/2006  10:40 AM            23,020 ks3.his            X
  04/27/2004  08:15 AM            18,348 ks3.his       X
  06/14/2006  11:45 AM           315,392 ks3.atr       X
  06/14/2006  11:45 AM           274,432 ks3.cat       X
  06/14/2006  11:43 AM           577,536 docks3        X
  03/12/2005  04:03 AM           583,451 ks3.dat       X
  03/12/2005  04:03 AM            16,384 ks3.idx       X
  03/12/2005  04:03 AM            20,303 ks3.wsg       X
  03/12/2005  03:47 AM           313,532 ks3_kcj.sql   X


Installation Steps:
1.  Stop the CMS, CMW, CandleNet Portal Server and Client.

2.  Confirm that OMEGAMON XE for Storage has been previously installed by
    locating the ks3.atr file in one of the following directories:

    On Linux systems:  	IBM/ITM/$platform/cq/tables/ATTRLIB/
    On Windows systems:	IBM\ITM\CNPS\CMSATR\

	*where $platform is li6243 for Intel(R) Linux or ls3263 for zSeries(R) Linux
       
    If ks3.atr does not exist, the product has not been installed.

2.  Backup the TEP Database. To do this:

   . On Windows(R) systems:
         a. Open a command prompt window: Start -> Run, enter CMD.
         b. Change the directory to the cnps directory of the IBM Tivoli Monitoring V6.1.0 installation:

            cd c:\ibm\itm\cnps  (default directory)

         c. Enter:

            migrate-export

            and press Enter.

            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 Linux(R) systems:
         a. At the source system, ensure that the Tivoli Enterprise Portal Server is NOT running.
         b. Open a terminal window.
         c. In the terminal window change the directory to the cq/bin subdirectory of the IBM Tivoli Monitoring 
            installation:

            cd /opt/IBM/ITM/$platform/cq/bin  (default directory)

            where $platform is li6243 for Intel(R) Linux or ls3263 for zSeries(R) Linux

         d. In the terminal window, enter:

            ./runscript.sh migrate-export

            and press Enter.

            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.

3.  Make backup copies (copy not move) of all of the files listed above
    under the heading "New and Replaced Modules."  Also, on Windows-based
    installations copy the presentation.dat and presentation.idx files 
    from the TEPS subdirectory.  You may wish to create a new subdirectory 
    in the IBM\ITM directory where the copied data can reside. 

4.  Create a new directory and extract all files from the interim fix zip
    file, 3.1.0-TIV-ITM_XESTG-IF0001.zip, into this new directory.

5.  Launch the Application Support Installer for your platform, found in
    your extracted files; for example, for Windows click on setupwin32.exe.
    The various platform versions of the installer are named as follows:

	Windows		setupwin32.exe
	z/Series Linux	setuplinux390.bin
	Intel Linux		setupLinux.bin
	AIX			setupaix.bin
	Solaris		setupSolaris.bin
	
	For further details, please refer to itm_appsupport.pdf in the 
	extracted files directory.

Special Instructions for OA17403:
    After the fix is applied, you must logon to your TEP and stop all
    historical collection for "OMEGAMON XE for Storage on z/OS v3.1.0".
    Then UNCONFIGURE all historical collection for this same product.  
    When you reconfigure and restart historical collection the modified 
    historical uadvisors shipped with this fix will be loaded to your TEMS.
    There is no z/OS component to this fix.

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

Notices and trademarks:
-----------------------

   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.


   Trademarks:

    The following terms are trademarks of International Business 
    Machines Corporation in the United States, other countries, or 
    both: IBM, IBM logo, Tivoli, Tivoli logo, AIX, AOC/MVS, APPN, 
    IMS, CICS, CICSPlex, CICS/ESA, DB2, DB2 Universal Database, DFSMShsm, 
    Domino, DB2 Universal Database, IMS, IMS/ESA, Informix, MQSeries, 
    MVS, MVS/ESA, NetView, NWays, OS/390, RACF, RMF, SNA/APPN, 
    SecureWay, Tivoli Enterprise, Tivoli Enterprise Console, Tivoli
    Management Environment, TME 10, VTAM, WebSphere, z/OS.
 
    UNIX is a registered trademark of The Open Group in the United 
    States and other countries.

    Microsoft, Windows, Windows NT, and the Windows logo are 
    trademarks of Microsoft Corporation in the United States, other 
    countries, or both.

    Sun and Solaris are trademarks of Sun Microsystems, Inc. in 
    the United States, other countries, or both.

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

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

    Pentium is a registered trademark of Intel in the United States 
    and other countries. Other company, product, or service names may 
    be trademarks or service marks of others.

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

 
