Date:  August 24, 2001

Patch:  2.3-MQS-0004

Component:  Tivoli Manager for MQSeries Version 2.3

General Description:

This patch supersedes patch 2.3-MQS-0001.  The ability to specify the 
@EventServer#Region_Name for the configure TEC Adapter task was added.

This is an english only patch.

This patch enables you to configure a TEC event adapter
to send events from TMA endpoints through the gateway to the TEC event
server.  Doing so reduces the network traffic to the TEC event server.

When you run the Configure TEC Adapter task, the MQS Configure TEC
Adapter dialog that is displayed contains the following new field:

Send events through the gateway?

Do one of the following:
- To send events through the gateway to the TEC event server, select
  Yes.  The TEC Server Host field is not required when you select this
  option and is, therefore, disabled.  The TEC Server Location field 
  will be enabled and use this to enter the region name of the event
  server if desired.

- To send events directly to the TEC event server, select No.  You must
  also enter the host name of the TEC event server in the TEC Server
  Host field.  This field is only meaningful for TMA endpoints.  If you
  select Yes for a managed node, the TEC adapter will be configured to
  send events directly to the TEC event server.

If you are reconfiguring an existing TEC event adapter, you must stop
the TEC event adapter before running the Configure TEC Adapter task.
After running the Configure TEC Adapter task, restart the appropriate
TEC event adapter to incorporate the change.

If you are configuring more than one TEC event adapter at the same time,
you must configure all the TEC event adapters on the same machine to
send events in the same manner, either through the gateway or directly
to the TEC event server.  One adapter cannot send events through the
gateway, while another is configured to send events directly to the TEC
event server.  If you configure the TEC event adapters differently, then
the last configuration will overwrite the executable file of the
previous configuration.

Problems fixed:  None.  The purpose of this patch is to provide the
option to send events through a gateway.  See the section New function
for more details.

Architectures:  AIX 4.2, AIX 4.3, HP-UX 10, HP-UX 11, Solaris 2.5.1,
    2.6, or 2.7, Windows NT 4.0

Patches superseded by this patch:  None

Patches this patch is dependent on:  None

Database changes:  The Configure TEC Adapter dialog and Configure TEC
Adapter task have been modified.

Files replaced or added by this patch (for all supported values of
$INTERP):
    bin/$INTERP/TME/TEC/adapters/bin/tecad_mqseries.nontme
    bin/$INTERP/TME/TEC/adapters/bin/tecad_mqseries.tmegw
    bin/hpux10/TME/TEC/adapters/bin/tecad_mqseries.ux11.nontme
    bin/hpux10/TME/TEC/adapters/bin/tecad_mqseries.ux11.tmegw
    bin/generic_unix/TME/MQS/mqs_server_patch2301.init
    bin/generic_unix/TME/MQS/sh/mqs_configure_adapter.sh
    bin/generic_unix/TME/MQS/dsl/mqs_configure_adpater.d

Patch contents:
- This README file
- A Verification Summary report for this patch
- A cdrom image for this patch

Applying the patch:  Before applying the patch do the following:
- Stop the TEC event adapter(s).
- Install the Tivoli Enterprise Console Adapter Configuration Facility
  on all of the gateways.

To install the patch, do the following:
  - Install the client patch wherever you have installed Tivoli Manager
    for MQSeries Client 2.3.
  - Install the server patch on the TMR server.

    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 3.6-TMF-0099.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 3.6-TMF-0099.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.

    2)  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 3 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 3.6-TMF-0099 using the file browser, and
           select the PATCHES.LST file by double-clicking it.
        g) Select 3.6-TMF-0099 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 3.6-TMF-0099 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 3.6-TMF-0099
           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 3.6-TMF-0099 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.

    3)  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.
          - Install the client patch wherever you have installed Tivoli
            Manager for MQSeries Client 2.3.
          - Install the server patch on the TMR server.

        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.

