Date:   August 24, 2001

Patch:  3.7.1-PMQ-0001

Component:  Policy Director for MQSeries 3.7.1

General Description:

    This FixPack contains fixes for APARS reported against
    Policy Director for MQSeries.  It also includes support
    for Windows 2000 and MQSeries Integrator (MQSI).

Problems Fixed:

    Internal CMVC Defect 8266
    Symptom: PKI mapping failed, map reason 1 on Windows.

    Internal CMVC Defect 10066
    Symptom: Customer data conversion exits not always invoked.

    Internal CMVC Defect 10690
    Symptom: On Solaris, after running mvlib, strmqm hangs.

Architecture(s):

    Solaris 2.7, AIX 4.3, Windows NT 4.0, and Windows 2000.

Patches superseded by this patch:  None

Dependencies:

    Policy Director for MQSeries 3.7.1 GA

Database Changes and Special Considerations: 

    
    1.  MQSI is not supported on Solaris or AIX.


Files Replaced or Added by this Patch:

    For AIX:
        /opt/pdmq/bin/mvlib
        /opt/pdmq/lib/libpdmqmap.a
        /opt/pdmq/lib/libmqm_r510.a
        /opt/pdmq/lib/libmqm_r520.a
        /opt/pdmq/lib/libmqm510.a
        /opt/pdmq/lib/libmqm520.a
        /opt/pdmq/nls/msg/C/pdmqm.cat

    For Solaris:
        /opt/pdmq/bin/mvlib
        /opt/pdmq/lib/lipdmqmap.so
        /opt/pdmq/lib/libmqm.so
        /opt/nls/msg/C/pdmqm.cat

    For NT/Windows:
        %INSTALL_PATH%/lib/pdmqmap.dll
        %INSTALL_PATH%/lib/secmqm.dll
        %INSTALL_PATH%/nls/msg/C/pdmqm.cat

Patch Contents:

    - This README file
    - Updated binary files
    - Install commands
    - ls.out and cksums.out (UNIX) dir.out (Windows)
    - GSKit update package 

Applying the Patch:

    Read the RELEASE NOTES before applying the patch.  (See
    Additional Installation Instructions section below.)

    Prior to installing this patch on any platform a
    GSKIT update needs to be made. Please refer to the
    'Additional Installation Instructions' section below.

    Disk space requirement: You must have at least 20 MB of free 
    space on your hard drive to install the patch.

 
    - To apply the patch on a Unix system

        1.  Log into the system on the root account.
        2.  Extract the archive into a temporary directory.  For the
            purpose of this README, assume that the symbol $PATCH
            points to this directory.
        3.  Stop the MQSeries processes.

        4.  Change to the patch directory and run the install
            script:

                cd $PATCH
                ./install.sh
       
        5.  Restart the MQSeries processes.


    - To apply the patch on a Windows NT system


        1. Log onto the NT system as the Administrator.
        2. Shutdown the MQSeries Services:
           - From ControlPanel -> Services click 'IBM MQSeries'
             then 'Stop'.
           - Confirm your action by clicking 'Yes'.
        3. Unpack the package into a temporary directory.
           For the purpose of this README, assume %PATCH% is the
           location of the extract directory. 
        4. Change to the patch directory and run the install command:

                cd %PATCH%
                install.exe

        5. Restart MQSeries.
           - From Control Panel -> Services
           - IBM MQSeries -> Start


Additional Installation Instructions:

    Release Notes
    -------------
    For the latest information on the product, please read the
    Release Notes for Policy Director 3.7/3.7.1 found under the 
    following URL:

    http://www.tivoli.com/support/documents/


    A Tivoli customer ID will be required to access this site.


    GSKIT

    All commands assume you are in the directory where the gskit package
    is located.

    To install GSKit on AIX:

       installp -d '.' gskit.rte


    To install/update GSKit on Solaris:

       a) if applicable, uninstall the current version of
          GSKit

       b) Extract the gskit package:

          tar xvf gsk4bas.tar

       c) Use the following command to install the new version of
          the GSKIT product:

          pkgadd -a none -d . gsk4bas


    To install GSKit on NT:

       a) cd into the %PATCH%\gskit directory.

       b) create a directory to copy the self extracting
          binary and copy it into it.

       c) run the self extracting zip executable gskit.EXE


       d) Use the following command to install the GSKIT product:

          setup gsk4 



    Verify that the correct version of GSKit is now installed with
    the following command:

          gsk4ver
        
Known Defects:

    1.  Policy Director for MQSeries version 3.7.1 installations
        that do not install this patch may not inter-operate in
        some cases with systems that do install the patch.

        You should install the patch on each systems that will
        be exchanging secure messages.
