******************************************************************************* * * 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: 03/25/2002 * * DESCRIPTION: * ____________ * * README FILE FOR * * IBM Communications Server for AIX temporary fix ("efix") * * (Installs only on PTF level 6.0.1.1) * APAR: IY29364 * * 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 * * * PTF: This efix is designed for the fileset sna.rte at the specific * level of 6.0.1.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: IY29364 * Module Name: sna_v5router libpe.o * APAR description: * * ERROR Description: * An application using the LUA API is in in-bracket state when a * Begin Bracket (BB) is received. CS/AIX intercepts that as an * error and generates and returns sense code 08130000 to the * remote host. The application programmers expect CS/AIX to * recognize the received BB as an error, but to pass this to the * application in an Exception Request (EXR) (as described in the * CS/AIX LUA Programmer's Guide) to allow the application to * modify the sense code to 08140000, which is also valid for this * situation. * * SPECIAL INSTRUCTIONS: * * After this APAR is installed, it adds the ability to have CS/AIX * pass the BB to the application in an EXR to allow the application * to modify the sense code. * * Since this may potentially break many existing LUA applications, * this function will default to behaving as it always has. To * activate the modified behavior on a node, a configuration change * must be made. Issue the command: * snaadmin query_node * and check the parameter "ptf_flags". Normally, this is set to * "NONE". To make the change, stop the node: * snaadmin term_node * Then, make the configuration change: * A) If ptf_flags = NONE * snaadmin -c define_node, ptf_flags=LUA_PASSTHRU_BB_RACE * B) If ptf_flags = xxxxx * snaadmin -c define_node, ptf_flags = xxxxx + LUA_PASSTHRU_BB_RACE * Then stop and restart the SNA software: * sna stop * sna start * * * Also included in this updated module are fixes for the following APARs: * * iy24955 sna_v5router * iy25760 sna_v5router * iy28866 sna_v5router * iy29135 sna_v5router * iy28890 sna_v5router * iy29364 libpe.o sna_v5router * *+----------------------------------------------------------------------------+ * * INSTALLATION INSTRUCTIONS: * __________________________ * * iy29364.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: * * 40605 813 libpe.o * 20984 4440 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/libpe.o /usr/lib/sna/libpe.o.original * 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 libpe.o /usr/lib/sna/libpe.o * 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/libpe.o /usr/lib/sna/libpe.o.original * 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. * * cp libpe.o /usr/lib/sna/libpe.o * cp sna_v5router /usr/lib/sna/drivers/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 6 * * * (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. * *******************************************************************************