Date: 
    24 August, 2001

Patch: 
    2.4-MQS-0001

Component: 
    Tivoli Manager for MQSeries, Version 2.4.0

General Description:
    This patch contains a variety of fixes for the Tivoli Manager
    for MQSeries product.

    The only prerequisite is the Tivoli Manager for MQSeries 
    product.

Function Added:
    CMVC defect 77315 - 
         Provide logging for the Start Dead Letter Queue Handler.

    CMVC defect 72628 - 
         Specify Queue Type on Title bar of Display Queue Dialog.

Function Fixed:
    CMVC defect 80061 - 
         Queue Manager Control Center fix to handle a large
         number of Inventory saved queue managers.  

    CMVC defect 80121 - 
         Fix the delete Remote, Model, and Alias Queues through the
         Queue Manager Control Center.

    CMVC defect 80843 - 
         Fix the Display Error Log for AS400 on TMF 3.6.x.

Architecture(s): 
    AIX 4.3.x, HP-UX 10.20, HP-UX 11.0, 
    Solaris 7, Solaris 8,
    Windows NT 4.0 SP6a, Windows 2000

Patches superseded by this patch: 
    None

Dependencies: 
    AMS_MQS_2.4.0

Database changes and special considerations:
    1. This patch should be applied to your TMR server, TEC server
    the Application Proxy server for your Tivoli Manager for MQSeries,
    and all Gateways in the TMR.  The patch should be applied to the TMR
    server last.  The TMR server will initiate a push of the new code
    to all endpoints for the queue managers discovered.

    2. There is no uninstall utility for patches.  Therefore, we
    we recommend that you perform a TME backup operation before 
    installing these patches.  See the documentation for the wbkupdb
    command for details on how to backup your TME database.
    
Files replaced or added by this patch 
(for all supported values of INTERP):
        bin/generic_unix/TME/MQS/24MQS001_alidb_after.sh
        bin/generic_unix/TME/MQS/sh/mqs_get_qmcentr_cb.sh
        bin/generic_unix/TME/MQS/sh/mqs_qmcentral_delete_cb.sh
        bin/generic_unix/TME/MQS/dsl/mqs_chn_launch.d
        bin/generic_unix/TME/MQS/dsl/mqs_qn_launch.d
        bin/generic_unix/TME/MQS/sh/mqs_dlq_handler_task.sh
        bin/generic_unix/TME/MQS/sh/mqs_display_error_log.sh
        bin/lcf_bundle/bin/generic_unix/TME/MQS/sh/mqs_dlq_handler_task.sh
        msg_cat/C/MQMCat.cat

Patch Contents:
    - this README file
    - An image report for this patch
    - A CDROM image for this patch

Applying the patch:
    1)  Extract the patch:

        On a Unix system:

        Extract the contents into a scratch directory. For the purpose
        of this release note, assume that the symbol $PATCH points to
        this directory.

        # cd $PATCH
        # tar xvf 2.4-MQS-0001.tar

        On a Windows NT system:

        Extract the contents into a scratch directory. For the purpose
        of this release note, assume that the symbol %PATCH% points to
        this directory.

        > %SystemRoot%\system32\drivers\etc\Tivoli\setup_env
        > X:
          ^-- 'X' is drive letter where %PATCH% is found
        > cd %PATCH%
        > tar xvf 2.4-TUX-0001.tar

        NOTE:  If you are extracting the tar image on a Windows NT
        system, you will find an executable for tar in the TME
        installation on Windows NT under bin/w32-ix86/tools/tar.exe.

    3)  If this patch is to be installed on a release level of 3.6 or
        greater, follow these instructions for using Software
        Installation Service (SIS).  If not, skip to step 4 below.

        NOTE: SIS can install Tivoli products on any hardware
              platform supported by Tivoli, but there are some
              hardware platforms on which SIS cannot be run. Please
              check your SIS User's Manual for the list of platforms
              on which SIS can be run.

        NOTE: You must have the install_product and super authorization
              roles to successfully install this patch.

        a)  From the Tivoli Desktop, pull down
            Desktop --> Install --> Software Installation Service.
        b)  SIS will initialize, and bring up the Get Installation
            Password Dialog.  Enter your Installation Password.
        c)  Click the Install Button on the dialog which contains
            the Tivoli image.
        d)  Click the Select Product Button on the Install Spreadsheet
            Dialog.
        e)  Click the Import Product Button on the Select Product
            Dialog.
        f)  Locate the media to 2.4-MQS-0001 using the file browser, and
            select the PATCHES.LST file by double-clicking it.
        g)  Select 2.4-MQS-0001 in the Import Product Dialog, and click
            the Import Button.
        h)  When the import is complete, click the OK Button on the
            Global Progress Dialog.
        i)  Select 2.4-MQS-0001 in the Select Product Dialog, if it is
            not already selected, and click the OK Button.
        j)  Now click the Select Machine Button on the Install
            Spreadsheet Dialog.
        k)  Select the machine(s) you would like to install 2.4-MQS-0001
            to, and click the OK Button.
        l)  Click the appropriate cell(s) in the Install Spreadsheet
            Dialog. (NOTE: This should yield an "X" in the cell(s)
            for the machines you want to install 2.4-MQS-0001 to).
        m)  Click the Install Button.
        n)  Select the install algorithm you want to use on the
            Installation Algorithm Dialog, and click OK.
        o)  SIS will perform the installation(s) you designated
            in the Install Spreadsheet Dialog.
        p)  Installation is complete. Check the Additional
            Installation Instructions section below.

    4)  Use the following steps to install the patch using the original
        Tivoli install mechanism.
        NOTE: You must have the install_product and super authorization
        roles to successfully install this patch.

        a)  Select the "Install -> Install Patch..." option from the
           "Desktop" menu to display the "Install Patch" dialog.
        b)  Press the "Select Media..." button to display the "File
            Browser" dialog.
        c)  Enter the path to the directory containing the patch,
            $PATCH, in the "Path Name:" field.
        d)  Press the "Set Media & Close" button to return to the
            "Install Patch" dialog.
        e)  The patch install list now contains the name of the patch.
            Select the patch by clicking on it.
        f)  Select the clients to install this patch on.  Patches
            typically need to be installed on the TME server and on each
            client.
        g)  Press the "Install" button to install the patch.

