IBM Tivoli OMEGAMON XE for Messaging Version 6 interim fix pack 1 Readme

(C)Copyright International Business Machines Corporation 2003. All rights reserved.


Contents
  • 1.0 About this fix pack
  • 2.0 Fixes contained in this fix pack
  • 3.0 Enhancements contained in the fix pack
  • 4.0 Fix pack contents
  • 5.0 Installing the fix pack
  • 6.0 Uninstalling the fix pack
  • Appendix A Supported platforms
  • Appendix B Files replaced or added by this fix pack
  • Notices and trademarks

  • 1.0 About this fix pack

    The information in this readme file should be read by users who plan to upgrade their present version of IBM Tivoli OMEGAMON XE for Messaging with the latest fix pack.

    This is the first interim fix pack for IBM Tivoli OMEGAMON XE for Messaging Version 6.0. It contains 17 fixes and enhancements for WebSphere MQ Configuration.

    2.0 Fixes contained in this fix pack

    The following defects have been fixed for WebSphere MQ Configuration:

    ARAR-IY85528:

    In certain situations where two newly created queues with identical names are saved, no error message is displayed, although changes are not actually saved.

    ARAR-IY85741:

    When an object is selected in the defined view, a detailed information panel is displayed in the top right of the main window. This panel is not automatically refreshed after the user saves changes made to the object.

    ARAR-IY87094:

    After deleting an object from the defined view, if a second copy of the object is created from the same prototype in the same location, it functions incorrectly.

    ARAR-IY87912:

    If all Configured System Groups in the defined view are deleted, a workspace error occurs.

    ARAR-IY87909:

    When importing objects in XML format, if variables are assigned values using a variable argument (for example, A = B) instead of being assigned a numerical value directly (for example, A = 10), values are lost.

    ARAR-OA17985:

    Discovery operations fail to complete when a queue manager object has a namelist.

    Note: This problem has been fixed for small namelists, but may still occur if a namelist is very large.

    ARAR-OA18336:

    Hub TEMS stops responding for an unacceptably long period of time after discovering a queue manager with a large number of queues.

    ARAR-IY90090:

    When copying objects with names containing symbolic variables, incorrect suffixes are apended to the object names.

    ARAR-IY88590:

    Display resources window is not refreshed when resources are updated.

    ARAR-IY89172:

    When changes are made to a resource's attibutes, the information in the resources window is not updated automatically.


    3.0 Enhancements contained in the fix pack

    The following enhancements are introduced in this fix pack:

    1. Add Application Support for Power Linux platform added to TEP, TEB, TEPS and TEMS.

    2. When the user types a queue name into a combo box, the name being entered is matched to the closest queue name in the list. This name will then be highlighted in a drop-down list containing a subsection of list entries below the text entry area.

    3. The speed with which the queue configuration dialog is displayed has been greatly enhanced.

    4. Added F5 shortcut to refresh the resources window.

    5. Update actual from defined operation can be performed on multiple objects from the same resource group simultaneously.

    6. Replicate operation can be performed on multiple objects from the same resource group simultaneously.

    7. Validate operation can be performed on multiple objects from the same resource group simultaneously.


    4.0 Fix pack contents:

    The files contained in the fix pack are as follows:

    6.0.0-TIV-OMEWSCC-IF0001.README -- Pure text README file

    6.0.0-TIV-OMEWSCC-IF0001.README.htm -- This README file

    aix51d6364.tar.Z -- Patch for AIX

    hpx1111d6364.tar.Z -- Patch for HP

    sos58d6364.tar.Z -- Patch for Solaris

    lnxx86-l22d6364.tar.gz -- Patch for SUSE 8 on Intel systems

    lnxx86-l23d6364.tar.gz -- Patch for SUSE 9, RH3 and RH4 on Intel systems

    lnxz-l22d6364.tar.gz -- Patch for SUSE 8 on zSeries systems

    lnxz-l23d6364.tar.gz -- Patch for SUSE 9, RH3 and RH4 on zSeries systems

    lnxppc-l23d6364.tar.gz -- Patch for SUSE 9 on pSeries systems

    mcoad6364.savf.zip -- Patch for OS/400

    wv7i386d6364.zip -- Patch for Windows

    patch_install.bat -- Patch installer for Windows

    patch_install -- patch installer for Unix/Linux


    5.0 Installing the fix pack

    Prerequisites

    OS/400: IBM Tivoli Monitoring 6.1 (fix pack 1 or above);

    All other platforms: IBM Tivoli Monitoring 6.1 (fix pack 3 or above);

    For Unix/Linux platforms, Bash shell is needed during the installation.

    Installing the fix pack on UNIX/Linux:

    1. Stop the TEMS, TEPS, TEP and WebSphere MQ Configuration agents if running.

    2. Copy the patch file to a temporary directory, for example $HOME/MCIF0001.

    3. Run the following command to unpack the patch file:

        uncompress -c [driver] | tar xvf -

        Or gunzip -c [driver] | tar xvf -

        where [driver] is fully qualified path name of the patch file for the target platform (for example, aix51d6364.tar.Z).

    4. Copy file patch_install to the depot folder (MCIF0001) and make sure file patch_install have execution permission.

    5. Patch installer need to bash shell installed on /bin/bash folder on the system, if user did not install bash on the system and do not want to install it, user could create a soft link by issuing:

        ln -s /bin/sh /bin/bash     (This step need root priviledge. If user is on Solaris system, the Bourne Shell might not work. Recommend Solaris user must use bash to execute the installer program)

    6. Issue below command line from depot directory to start the installation:

        ./patch_install [$ITM_HOME]

        $ITM_HOME is Tivoli Monitoring installation directory (by default this is located in /opt/IBM/ITM/).

    7. User could follow the prompted messages to finish the installation. After install scripts exit, a new folder "backup" which contains all the original files in user's environment will be created and an uninstall script (patch_uninstall) will be generated too.

        Please Note: User should not run the install program again unless user already made a copy of the backup folder and the generated uninstall script. Otherwise user will lose the original files.

    8. In user's environment, the architecture codes might be different from the patch provided. For example, "ls3263" might become "ls3243". User does not need to change the folder names in the depot directory, the install script will handle those mappings.

    9. Install scripts will report the not found files which are not existing in user's environment.

    10. User might Start the TEMS, TEPS, TEP and WebSphere MQ Configuration agents.

    Installing the fix pack on OS/400

    1. Execute the GO OMAMC command at the OS/400 command line.

    2. Select option 3 to stop the WebSphere MQ Configuration agent.

    3. Enter the following command to verify that OMAMC has stopped:

        WRKACTJOB SBS(KMCLIB)

        Wait for the following message to be displayed under active jobs:

        (No active jobs to display)

    4. Extract mcoad6364.savf from the OS/400 patch file (mcoad6364.savf.zip) on a Windows or UNIX system.

    5. Log onto the target AS/400 system and create a save file called MCOAD6364.

    6. On the Windows or UNIX system, use binary mode FTP to transfer mcoad6364.savf to the newly created save file on the

        AS/400 system.

    7. Create library MC6149F52P on the AS/400 system and restore the object with the following command:

        RSTOBJ OBJ(*ALL) SAVLIB(MC6149F52P) DEV(*SAVF) SAVF(KMC600_TMP/MCOAD6364)

        This procedure restores 2 files to the MC6149F52P library:

            KMC_AGENT *PGM CPPLE 28065792

            KMCCMQU1 *PGM CPPLE 28065792

    8. Backup the original versions of the two restored files so that the fix pack can be removed if any problems are encountered.

    9. Replace the original versions of the files with the versions in the MC6149F52P library.

    10.Enter the GO OMAMC command and select option 2 to restart the WebSphere MQ Configuration agent.

    Installation is now complete.

    Installing the fix pack on Windows

    1. Stop the TEMS, TEPS, TEP and WebSphere MQ Configuration agents if running.

    2. Make a depot directory for example c:\patch\MCIF0001, copy file wv7i386d6364.zip to this folder. On user's Windows file explorer, double click the zip file icon to extract files into the same folder.

    3. Copy the install batch file patch_install.bat into the folder and run it in a cmd window or from a file explorer.

    4. Follow the prompted messages to complete the install. When the install batch exits, a "backup" folder and an uninstall batch file are also generated. The original files in user's environment are in the "backup" folder.

    5. User should not run the install program again unless user already made a copy of the backup folder and the generated uninstall batch file. Otherwise user will lose the original files.

    6. Start the TEMS, TEPS, TEP and WebSphere MQ Configuration agents.


    6.0 Uninstalling the fix pack

    To uninstall the fix pack on Windows or Unix/Linux, please run the generated uninstall script. The script will restore the backup files into user's environment.

    On OS/400, please replace the installed files with the back up files manually.


    Appendix A Supported platforms

    The following platforms are supported by IBM Tivoli OMEGAMON XE for Messaging:

    AIX V5.2 (32/64 bit)

    AIX V5.3 (32/64 bit)

    Solaris V9 (32/64 bit)

    Solaris V10 (32/64 bit)

    HP-UX V11.i (32/64 bit) with the following Goldpacks released in June 2003:

        GOLDBASE11i,r=B.11.11.0306.4

        GOLDAPPS11i,r=B.11.11.0306.4

    Linux on zSeries systems

        SUSE Enterprise Server 8 (2.4.x kernel level)

        SUSE Enterprise Server 9 (2.6.x kernel level)

        Red Hat Enterprise Linux 3 (2.4.x kernel level)

        Red Hat Enterprise Linux 4 (2.6.x kernel level)

    Linux on Intel systems

        SUSE Enterprise Server 8 (2.4.x kernel level)

        SUSE Enterprise Server 9 (2.6.x kernel level)

        Red Hat Enterprise Linux 3 (2.4.x kernel level)

        Red Hat Enterprise Linux 4 (2.6.x kernel level)

    Linux on pSeries systems

        SUSE Enterprise Server 9 (2.6.x kernel level)

    OS/400 V5R2

    OS/400 V5R3

    Windows 2003 Server

    Windows XP Professional Edition (service pack 1 or above)

    Windows 2000 Professional server or advanced server (service pack 3 or above)


    Appendix B Files replaced by this fix pack

    AIX

    aix513/mc/bin/kmccmqu1

    aix513/mc/bin/kmcrca

    aix513/ms/bin/kcfcrstr

    aix513/ms/bin/kcfcrst2

    aix513/ms/lib/KCFFEPRB

    aix513/ms/lib/KMCMQ

    aix513/ms/lib/libkcfconfg.a

    aix513/ms/lib/libkcfdummydb2.a

    HP-UX

    hp11/mc/bin/kmccmqu1

    hp11/mc/bin/kmcrca

    hp11/ms/bin/kcfcrstr

    hp11/ms/bin/kcfcrst2

    hp11/ms/lib/KMCMQ.sl

    hp11/ms/lib/KCFFEPRB.sl

    hp11/ms/lib/libkcfconfg.sl

    hp11/ms/lib/libkcfdummydb2.sl

    Solaris

    sol283/mc/bin/kmccmqu1

    sol283/mc/bin/kmcrca

    sol283/ms/bin/kcfcrstr

    sol283/ms/bin/kcfcrst2

    sol283/ms/lib/KCFFEPRB

    sol283/ms/lib/KMCMQ

    sol283/ms/lib/libkcfconfg.so

    sol283/ms/lib/libkcfdummydb2.so

    Linux on Intel systems

    li6243/mc/bin/kmccmqu1

    li6243/mc/bin/kmcrca

    li6263/ms/bin/kcfcrstr

    li6263/ms/bin/kcfcrst2

    li6263/ms/lib/KCFFEPRB

    li6263/ms/lib/KMCMQ

    li6263/ms/lib/libkcfconfg.so

    li6263/ms/lib/libkcfdummydb2.so

    Linux on Intel systems (SUSE 8 only)

    li6243/mc/bin/kmccmqu1

    li6243/mc/bin/kmcrca

    Linux on zSeries systems

    ls3243/mc/bin/kmccmqu1

    ls3243/mc/bin/kmcrca

    ls3263/ms/bin/kcfcrstr

    ls3263/ms/bin/kcfcrst2

    ls3263/ms/lib/KCFFEPRB

    ls3263/ms/lib/KMCMQ

    ls3263/ms/lib/libkcfconfg.so

    ls3263/ms/lib/libkcfdummydb2.so

    Linux on zSeries systems (SUSE 8 only)

    ls3243/mc/bin/kmccmqu1

    ls3243/mc/bin/kmcrca

    Linux on pSeries systems

    lpp263/mc/bin/kmccmqu1

    lpp263/mc/bin/kmcrca

    OS/400

    /KMC_AGENT

    /KMCCMQU1

    Windows

    CNB\classes\candle\kcf\resources\GenConst.class

    CNB\classes\candle\kcf\resources\KcfBundle.class

    CNB\classes\candle\kcf\resources\KCFErrorMessageNumbers.properties

    CNB\classes\candle\kcf\resources\KCFErrorMessages.properties

    CNB\classes\candle\kcf\resources\KcfGenBundle.class

    CNB\classes\candle\kcf\resources\KcfIds.class

    CNB\classes\candle\kcf\resources\KcfToolTips.properties

    CNB\classes\candle\kcf\resources\KMC140.class

    CNB\classes\candle\kmc\resources\KmcBundle.class

    CNB\classes\candle\kmc\resources\KMCErrorMessageNumbers.properties

    CNB\classes\candle\kmc\resources\KMCErrorMessages.properties

    CNB\classes\kcf.inf

    CNB\classes\kcf.jar

    CNB\classes\kmc.inf

    CNB\classes\kmc.jar

    CNP\candle\kcf\resources\GenConst.class

    CNP\candle\kcf\resources\KcfBundle.class

    CNP\candle\kcf\resources\KCFErrorMessageNumbers.properties

    CNP\candle\kcf\resources\KCFErrorMessages.properties

    CNP\candle\kcf\resources\KcfGenBundle.class

    CNP\candle\kcf\resources\KcfIds.class

    CNP\candle\kcf\resources\KcfToolTips.properties

    CNP\candle\kcf\resources\KMC140.class

    CNP\candle\kmc\resources\KmcBundle.class

    CNP\candle\kmc\resources\KMCErrorMessageNumbers.properties

    CNP\candle\kmc\resources\KMCErrorMessages.properties

    CNP\kcf.inf

    CNP\kcf.jar

    CNP\kmc.inf

    CNP\kmc.jar

    CNPS\classes\candle\kcf\resources\GenConst.class

    CNPS\classes\candle\kcf\resources\KcfBundle.class

    CNPS\classes\candle\kcf\resources\KcfGenBundle.class

    CNPS\classes\candle\kcf\resources\KcfIds.class

    CNPS\classes\candle\kcf\resources\KMC140.class

    CNPS\classes\candle\kmc\resources\KmcBundle.class

    CNPS\sqllib\KcfPackage.xml

    CNPS\sqllib\kcf_kcj.sql

    CNPS\sqllib\KmcPackage.xml

    cms\kcfconfg.dll

    cms\kcffeprb.dll

    cms\kmcmq.dll

    tmaitm6\kmcrca.exe

    file_list.txt (this file is used by patch_install.bat)

    Notices and trademarks

    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/region 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 may 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 that 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.

    This information is for planning purposes only. The information herein is subject to change before the products described become available.

    Trademarks

    AIX, AS/400, IBM, OMEGAMON, OS/400, pSeries, Tivoli, WebSphere, z/OS and zSeries are 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 and Windows NT are registered trademarks of Microsoft Corporation 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, other countries, or both.

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