******************************************************************************* * * 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: 02/13/2003 * * DESCRIPTION: * ____________ * * README FILE FOR * * IBM Communications Server for AIX temporary fix ("efix") * * (Installs only on PTF level 6.1.0.2) * APAR: IY40548 * * 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.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: IY40548 * Module Name: snatnsrvr_mt * * APAR DESCRIPTION: CSAIX: Hang in TN3270 Server * * ERROR DESCRIPTION: * TN3270 Server hangs and all traffic stops. When the SNA * software is stopped, the snatnsrvr_mt and snatnhlpr processes * do not terminate. The SNA software can not be restarted until * those processes are killed. * * PROBLEM SUMMARY: * USERS AFFECTED: All * * PROBLEM DESCRIPTION: * The problem is triggered by receiving an unexpected extra TN3270E * negoriation message from the TN3270 client: for example "FFFA2803 * 07000204 FFF0". This causes the TN server code to hard loop, * generating error logs and preventing CS/AIX processes from * continuing normally. The sna.err log fills up with error messages: * * TNSERVER Message 4102 - 75, Subcode 0 - 0 * Log category: PROBLEM Cause Type: External * Received Telnet negotiating command 0x0028 in TCP/IP data during * data transfer. * * PROBLEM SUMMARY: * The TN3270 Server has a bug in the error path code that handles the * receipt of the SB TN3270E negotiation message after negotiation has * completed. The TN3270 Server detects the invalid data and generates * an error log message but fails to step past the error, so it loops * as it parses the message. The node scheduler applies bak pressure * when the trace daemon cannot read the error log messages fast enough * to prevent the log/trace arrays from filling up. The back pressure * prevents all other work in the node. * * PROBLEM CONCLUSION: * The TN3270 Server code has been corrected to prevent the looping when * this error condition occurs. Instead, the client connection is closed. * Only a single error log message will be generated, and other users * will be unaffected. * * Also included in this updated module are fixes for the following APARs: * * iy40548 snatnsrvr_mt * *+----------------------------------------------------------------------------+ * * INSTALLATION INSTRUCTIONS: * __________________________ * * iy40548.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: * * * 00205 429 snatnsrvr_mt * * 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/bin/snatnsrvr_mt /usr/bin/snatnsrvr_mt.pre_iy40548 * * 7) Copy this efix's updated module into its/their place(s). * * cp snatnsrvr_mt /usr/bin/snatnsrvr_mt * * * 8) Make sure that the file permissions for the new and original modules * are the same. * * 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 5 * * * (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. * *******************************************************************************