*******************************************************************************
*
* 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.
* For instance, in the United States, you would call 1-800-CALL-AIX.
*
*******************************************************************************
*
*
*
* VISIT OUR PAGES ON THE INTERNET
* _______________________________
*
* IBM Communications Server Support
* http://www.ibm.com/software/network/commserver/support
*
*
* +--------------------------------------------------------------------------+
*
* DATE: 04/09/2003
*
* DESCRIPTION:
* ____________
*
* README FILE FOR
*
* IBM Communications Server for AIX temporary fix ("efix")
*
* (Installs only on PTF level 6.1.0.1)
* APAR: IY41992
*
* 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 :
* _______________
*
* IBM Communications Server for AIX version 6.1
*
*
* PTF: This efix is designed for the fileset sna.rte at the specific
* level of 6.1.0.1. It is not designed for any other level of the product
* and may cause irreparable damage if inappropriately applied. If you are
* in need of this PTF supplement to the product before proceeding with
* the download and application of this efix please go to the above support
* site and refer to the Code Updates section for details on retrieving the
* minimum level of maintenance for this efix. You may also choose instead
* to call support directly at 1-800-CALL AIX for more information.
*
*
* No other prerequisites are required for the installation of this efix.
*
*+----------------------------------------------------------------------------+
*
*
* PROBLEM FIXED: IY41992
* Module Name: sna_v5router
*
* APAR DESCRIPTION:
* System hang due to loop in code that assigns LUWID
*
* ERROR DESCRIPTION:
* System performance is severely affected. Kernel process 'gil' is seen
* using large amount (up to 100%) of CPU time. SNA and other processes
* are unable to perform properly. SNA commands are non-responsive.
* A stack trace from a forced system dump shows that 'gil' is waiting
* on SNA processes to complete.
*
* PROBLEM SUMMARY:
* USERS AFFECTED: All
* This problem affects anyone using APPC communications, effectively
* anyone using LU 6.2 sessions.
*
* PROBLEM DESCRIPTION:
* The system is hanging due to a loop in the CS/AIX code that assigns
* the LUWID for a transaction.
*
* PROBLEM SUMMARY:
* The code uses a variable to track time to generate a unique LUWID
* for a given local LU. This code requires that time increments and
* does not decrement. The time represented by this variable has gone
* down by a large amount, and this code is looping around for each
* tp_started (new transaction) millions of times.
* .
* The variable used to track time counts tenths of a second since
* the startup of the SNA software. At approximately 49.5 days, this
* variable exceeds its maximum value and wraps to zero (0).
*
* PROBLEM CONCLUSION:
* This problem was introduced by APAR IY35887 in PTF U486851.
* The code has been modified to protect against a negative change in
* time and to produce a reliable time for the LUWID function.
*
* LOCAL FIX:
* Stop (sna stop) and start (sna start) the SNA software withing the
* 49 day window. This will reset the counter to begin a new 49 day
* window.
*
*
* Also included in this updated module are fixes for the following APARs:
*
* iy33597 sna_v5router
* iy33760 sna_v5router
* iy35887 sna_v5router
* iy37689 sna_v5router
* iy41992 sna_v5router
*
*+----------------------------------------------------------------------------+
*
* INSTALLATION INSTRUCTIONS:
* __________________________
*
* iy41992.tar.Z ("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) Check the output of sum against the updated module after
* uncompressing and untarring this efix. You should see:
*
* 09342 4289 sna_v5router
*
* 3) Make sure that you have backed up your system recently.
*
* 4) Make sure that you have copies of your configuration files saved
* (the /etc/sna directory contents).
*
* 5) Stop SNA and proceed to the next step
*
* sna stop
*
* (IMPORTANT) - Be sure that SNA is stopped. Please issue:
*
* ps -ef | grep sna*
*
* If a sna* process exists, use the kill command on the process.
* It is also recommended that, if possible you take down any
* applications that may try to access CS/AIX.
*
* 6) Backup your previous versions of the module(s) listed in this readme
* by renaming them.
*
* cp /usr/lib/sna/drivers/sna_v5router /usr/lib/sna/drivers/sna_v5router.original
*
* 7) Copy this efix's updated module into its/their place(s).
*
* cp sna_v5router /usr/lib/sna/drivers/sna_v5router
*
* 8) Shutdown and reboot your system.
*
* shutdown -Fr
*
* 9) Restart Communications Server for AIX
*
* sna start
* snaadmin init_node (and so on)...
*
*
* +--------------------------------------------------------------------------+
*
*
* CONTACT FOR Support:
* ____________________
*
* If you have any questions, please call the IBM AIX SUPPORT CENTER
* for your Country. For example in the USA call: 1-800-CALL-AIX
*
*
* IBM COPYRIGHT INFORMATION:
* __________________________
*
* IBM Communications Server for AIX version 6.1
*
*
* (c)Copyright International Business Machines Corporation 1998, 1999, 2003.
* 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.
*
*******************************************************************************