***********************************************************
***********************************************************
**                                                       **
**  NOTICE:  This Patch has been superseded by patch     **
**  2.0.1-POS-0004                                       **
**                                                       **
**  Please use it instead unless otherwise directed.     **
**                                                       **
***********************************************************
***********************************************************


Date:   January 18, 2002

Patch:  2.0.1-POS-0002

Component: Tivoli Point-of-Sale Manager 2.0.1

General Description:
    This patch contains a collection of fixes for the Tivoli 
    Point-of-Sale Manager Base component package.

Problems Fixed: 
 New Fixes in 2.0.1-POS-0002

  Symptoms: Tivoli Point-of-Sale Manager's Retail Server
  kept network connection open after the Retail Server logged an event. 
  Eventually, the Retail Server (AMRServer) hangs.
  A user can verify the existence of this problem by issuing "netstat"
  command from the Endpoint.
  The problem only exists on AIX and Solaris Endpoints, not NT Endpoints.


Patches superseded by this patch:
    None

Dependencies:
    Tivoli Point-of-Sale Manager 2.0.1

Database Changes and Special Considerations:
    None

Files Replaced or Added by this Patch: 
 $BINDIR/TDM/TM4R/TM4RAPPMGR/AMRServerUpdate.sh (TMR)
 $BINDIR/../lcf_bundle.40/bin/%INTERPS%/TDM/TM4R/TM4RDSVC/AMRServer (GW)
 $BINDIR/../lcf_bundle.40/bin/%INTERPS%/TDM/TM4R/TM4RDSVC/AMRver.dat (GW)

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.0.1-POS-0002.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.0.1-POS-0002.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)  Installation of this patch using Tivoli Software Installation 
        Service (SIS) is not supported.

    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.

        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 names of the two
            components of the patch.  Select the Gateway patch by 
            clicking on it. 
        f)  Select the clients to install this patch on.  The Gateway
            patch component needs to be installed on all TME Gateways
            which have the Tivoli Point-of-Sale Manager Base package
            installed.
        g)  Press the "Install" button to install the patch.
        h)  The patch install list now contains the names of the two
            components of the patch.  Select the Server patch by 
            clicking on it
        i)  Select the clients to install this patch on.  The Server
            patch component needs to be installed only on the TMR 
            server.
        j)  Press the "Install & Close" button to install the patch.

Additional Installation Instructions: 
    As reflected in the instructions above, it is important to install
    the Gateway component of the patch before installing the Server 
    component.
    This is because the Server component, when installed, will push 
    some of the new code down to any TME Endpoints which are being 
    used to manage 4690 systems.  
    If the Gateway patch has not yet been applied, it will
    simply push the old code back to them again.

    If this happens, the solution is to install the patch on all the
    Gateways, using the instructions above, 
    and then run the following script on the TMR Server:

        # $BINDIR/TDM/TM4R/TM4RAPPMGR/AMRServerUpdate.sh

    Note that on a Windows NT TMR, this command must be run from the 
    bash shell.
    
    When installing the Server component, if there is any problem
    preventing  the new code from pushing to Endpoints
    (such as AMRServer not running or hung), you need to fix the
    problem that caused the problem. Then run the following
    script on the TMR Server to install the new code at the Endpoints:

        # $BINDIR/TDM/TM4R/TM4RAPPMGR/AMRServerUpdate.sh

    

Known Defects: 
    None

