*******************************************************************************
*
*   PRIMARY DISCLAIMER:
*
*     It is not recommended that you install this fix unless specifically
*   instructed to do so by a qualified IBM Technical Support representative.
*
*     Please call your appropriate support location for more information.
*
*******************************************************************************
*
*
*
*   VISIT OUR PAGES ON THE INTERNET
*   _______________________________
*
*   IBM Communications Server Support
*       http://www.ibm.com/software/network/commserver/support
*
*
* +--------------------------------------------------------------------------+
*
*  DATE: 11/12/2008
*
*  DESCRIPTION:
*  ____________
*
*  README FILE FOR
*
*   IBM Communications Server for Linux temporary fix ("efix")
*                                        (Installs only on PTF level 6.2.3.1)
* APARS: LI73879
*
* This package contains APAR fixes to the product above.  This
* package can be distributed to any one who has a license for
* this product.
*
*+----------------------------------------------------------------------------+
*
*
* PREREQUISITES :
* _______________
*
*   CS Linux v6.2.3.1 (only applies to i686 platforms)
*
*
*      PTF:  This efix is designed for the Isolation Module driver for CS Linux
*      level of 6.2.3.1.  It is not designed for any other level of the product
*      and may cause irreparable damage if inappropriately applied. This efix
*      replaces Open Source code built for the i686 platform of CS Linux.
*
*
*   No other prerequisites are required for the installation of this efix.
*
*+----------------------------------------------------------------------------+
*
* PROBLEM FIXED:  LI73879
* Module Name: snalinux.c.orig
*
* APAR DESCRIPTION:
* The Isolation Module driver allows the CS Linux drivers to be independent of the
* Linux distribution kernel layer. It provides a mechanism to call kernel routines
* that have kernel level specific entry points. The call to the timer clock needs to
* to be set to 1/1000 of a second for the i686 platform. This fix provides the proper
* check to set the clock interval for that platform.
*
* ERROR DESCRIPTION:
* The performance of HPR connections ran 10 times slower than the previous release.
* An error in setting the granularity of the clock caused the HPR timers to run 10
* times slower than capable of running.
*
* PROBLEM SUMMARY:
*
*   USERS AFFECTED: All HPR and Enterprise Extender connections on i686 platforms.
*
*   PROBLEM DESCRIPTION:
*   The performance for a i686 Linux system ran slow compare to x86_64, ppc64 and
*   Linux on SYstem z platforms.
*
*   PROBLEM SUMMARY:
*   The calculation of the proper clock granularity was not checked correctly. For
*   32-bit systems, the settings should be the same as 64_bit Linux systems.
*
* PROBLEM CONCLUSION:
* By setting the proper check, the i686 Linux system would perform as well as x86_64
* Linux systems connecting over the same media.
*
*
*+----------------------------------------------------------------------------+
*
* INSTALLATION INSTRUCTIONS:
* __________________________
*
*   li73879.tar.gz ("this efix" in the steps below) is a compressed tar archive
*   file containing the updated modules and this readme.
*
*
*   To install this efix:
*   _____________________________
*
*
**   Downloading the file:
*
*      1) Be SURE to download this efix in BINARY format.
*
*      2) Make sure that you have backed up your system recently and
*         that you have copies of your configuration files saved
*         (the /etc/ibm/opt/sna directory contents).
*
*      3) Stop SNA and proceed to the next step:
*           sna stop
*           snaulmod
*           snarmdrv
*
*      4) Make a backup copy of the affected files:
*            cp -p /etc/opt/ibm/sna/isolationdrivers/snalinux.c.orig \
*                  /etc/opt/ibm/sna/isolationdrivers/snalinux.c.pre_li73879
*
*      5) Uncompress and untar the efix package:
*            cd /tmp
*            gunzip li73879.tar.gz
*            tar -xvf li73879.tar
*
*      6) Check the output of sum against the updated modules.
*            sum  snalinux.c.orig
*         You should see:
*            33650    28 snalinux.c.orig
*
*      7) Copy the updated files into the appropriate directories and
*         set the permissions and ownership:
*            cp -p snalinux.c.orig /etc/opt/ibm/sna/isolationdrivers/snalinux.c.orig
*            chown root.root /etc/opt/ibm/sna/isolationdrivers/snalinux.c.orig
*            chmod 544 /etc/opt/ibm/sna/isolationdrivers/snalinux.c.orig
*
*      8) Restart SNA
*            sna start
*
*
* +--------------------------------------------------------------------------+
*
*
*
* IBM COPYRIGHT INFORMATION:
* __________________________
*
*   IBM Communications Server for Linux, Version 6.2.3.1
*
*
*   (c)Copyright International Business Machines Corporation 1998, 1999, 2008.
*   All rights reserved.  Note to U.S. Government Users - Documentation
*   related to restricted rights - Use, duplication or disclosure is
*   subject to restrictions set forth in GSA ADP Schedule Contract
*   with IBM Corp.
*
*
*
* LIMIT OF LIABILITY:
* ___________________
*
*   License to the contained APAR fixes is conditioned upon the recipient
*   holding a license to the prerequisite product.  The license terms
*   and conditions of the APAR fixes are the same as those for the
*   prerequisite product.  Please see the product license for specifics.
*
*******************************************************************************

