*******************************************************************************
*
*   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: 08/03/2000
*
*  DESCRIPTION:
*  ____________
*
*  README FILE FOR
*
*   IBM Communications Server for AIX temporary fix ("efix")
*
*                                        (Installs only on PTF level 5.0.4.2)
* APAR: IY10481
*
* 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 5
*
*
*      PTF:  This efix is designed for the fileset sna.rte at the specific
*      level of 5.0.4.2.  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:  IY10481      
* Module Name: sna_v5router
* APAR description: 
* CANNOT CONNECT SESSION
* 
* ERROR Description:
* Intermittent connect failures on RUI_INIT and the following logs
* .15:48:55 CDT  19 Apr 2000 256-2(0-10) E (DGWR02) 
* detected invalid internal status
* FSM status=2   FSM input=13
* 15:48:55 CDT  19 Apr 2000 4096-13(0-10) E (DGWR02)
* ASSERT:
* filename = ../../p/sappn/nlmssfsm.c
* linenumber = 463
*       = FALSE
*
* CAUSE:
* The NLM component within the APPN node of CS/AIX was accessing a
* field in an OPEN_LU_SSCP internal message after the message had    
* been sent on to another component.  This could lead to the wrong 
* value being read from the field, which would cause this assert.  
* The fix is to store the field value in a local variable before 
* sending the message on.                                                       
*
* Also included in this updated module are fixes for the following APARs:
*   
*   iy09529 sna_v5router
*   iy09585 sna_v5router
*   iy09833 sna_v5router
*   iy10278 sna_v5router
*   iy10481 sna_v5router
*
*+----------------------------------------------------------------------------+
*
* INSTALLATION INSTRUCTIONS:
* __________________________
*
*   iy10481.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:
*
*      11924  4001 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 (A or B)
*         
*         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.
*
** A.  Installing the fix on a system that you ARE able to reboot:
*
*      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 version 5
*
*         sna start
*         snaadmin init_node (and so on)...
*
*  --
*  OR
*  --
*
** B.  Installing the fix on a system that you are NOT able to reboot:
*
*      6) Backup your previous versions of the module(s) listed in this readme
*         by copying them.
*
*     cp /usr/lib/sna/drivers/sna_v5router /usr/lib/sna/drivers/sna_v5router.original
*
*      7) Run the following commands (in the indicated order) to remove the
*         existing kernel drivers:
*
*         /usr/sbin/strload -u -d /usr/lib/sna/drivers/snasxmv
*         ddload -u -asktsxm
*         ddload -u -asktsxm6
*         ddload -u -asnapmm
*         ddload -u -atcppmm
*         ddload -u -acmm
*         ddload -u -g
*         ddload -u -s
*         /usr/sbin/strload -u -m /usr/lib/sna/drivers/sna_ddpmgr
*         /usr/sbin/strload -u -d /usr/lib/sna/drivers/sna_v5router
*         ddload -u -t
*
*      Please note, some of the above commands might claim that the given
*      driver was not installed. This is expected and depends on the current
*      configuration of CS/AIX.
*
*      8) Copy the newly delivered file, sna_v5router, into the directory
*         /usr/lib/sna/drivers. It should replace the existing version of 
*         sna_v5router. 
*
*      9) Run the following commands to reinstall the kernel components of
*         CS/AIX:
*
*         ddload -l -t
*         /usr/sbin/strload -d /usr/lib/sna/drivers/sna_v5router
*         /usr/sbin/strload -m /usr/lib/sna/drivers/sna_ddpmgr
*         ddload -l -s
*         ddload -l -g
*         /usr/sbin/strload -d /usr/lib/sna/drivers/snasxm
*
*     10) Restart CS/AIX by issuing the command:    
*
*         sna start
*
* +--------------------------------------------------------------------------+
*
*
* 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 5
*
*
*   (c)Copyright International Business Machines Corporation 1998, 1999, 2000.
*   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.
*
*******************************************************************************

