******************************************************************************* * * 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: 04/04/2008 * * DESCRIPTION: * ____________ * * README FILE FOR * * IBM Communications Server for Linux temporary fix ("efix") * (Installs only on PTF level 6.2.3.0) * APARS: LI73328 * * 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 (on linux for zSeries) * * * PTF: This efix is designed for the rpm ibm-commserver at the specific * level of 6.2.3.0. 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 for more information. * * * No other prerequisites are required for the installation of this efix. * *+----------------------------------------------------------------------------+ * * PROBLEM FIXED: LI73328 * Module Name: snatnsrvr_mt * * APAR DESCRIPTION: * TN3270 server fails to unlock keyboard * * ERROR DESCRIPTION: * The TN3270 Server fails to unlock the keyboard on the tn3270 * client, leaving the client to appear hung. * * PROBLEM SUMMARY: * * USERS AFFECTED: All users of TN3270 Server. * * PROBLEM DESCRIPTION: * The TN3270 Server fails to unlock the keyboard on the tn3270 * client, leaving the client to appear hung. * * PROBLEM SUMMARY: * When the 3270 datastream received by the TN3270 Server includes * NULL RUs with EB and CD, and the keyboard has not been explicitly * unlocked by the content of the datastream, the TN3270 Server needs * to generate a keyboard reset to be sent to the tn3270 client. * * PROBLEM CONCLUSION: * The TN3270 Server has been modified to generate a keyboard reset * when the scenario described above occurs. * * * Also included in this package are fixes for the following APARs: * LI73048 snaslim * LI73050 Driver.o * LI73052 Driver.o * LI73103 Driver.o snagetpd snatnsrvr_mt tn3270dev.dat (LI72818+LI72957) * LI73153 snatnsrvr_mt * LI73175 Driver.o * LI73202 snatnsrvr_mt * LI73324 snaslim * LI73328 snatnsrvr_mt * * Only snatnsrvr_mt was modified for this specific problem. * * This package contains fixes for multiple APARs. For detailed information * about each individual APAR, go to http://www.ibm.com and enter the APAR * number in the search box at the top of the page. * * *+----------------------------------------------------------------------------+ * * INSTALLATION INSTRUCTIONS: * __________________________ * * li73328.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 /opt/ibm/sna/drivers/snapixr/Driver.o \ * /opt/ibm/sna/drivers/snapixr/Driver.o.pre_li73328 * cp -p /opt/ibm/sna/bin/snagetpd \ * /opt/ibm/sna/bin/snagetpd.pre_li73328 * cp -p /opt/ibm/sna/bin/snatnsrvr_mt \ * /opt/ibm/sna/bin/snatnsrvr_mt.pre_li73328 * cp -p /opt/ibm/sna/bin/sna/samples/tn3270dev.dat \ * /opt/ibm/sna/bin/sna/samples/tn3270dev.dat.pre_li73328 * cp -p /opt/ibm/sna/bin/snaslim \ * /opt/ibm/sna/bin/snaslim.pre_li73328 * * 5) Uncompress and untar the efix package: * cd /tmp * gunzip li73328.tar.gz * tar -xvf li73328.tar * * 6) Check the output of sum against the updated modules. * sum Driver.o * sum snagetpd * sum snatnsrvr_mt * sum tn3270dev.dat * sum snaslim * You should see: * 52435 4253 Driver.o * 34273 49 snagetpd * 26762 236 snatnsrvr_mt * 33251 3 tn3270dev.dat * 05989 205 snaslim * * 7) Copy the updated files into the appropriate directories and * set the permissions and ownership: * cp -p Driver.o /opt/ibm/sna/drivers/snapixr/Driver.o * chown root.root /opt/ibm/sna/drivers/snapixr/Driver.o * chmod 600 /opt/ibm/sna/drivers/snapixr/Driver.o * cp -p snagetpd /opt/ibm/sna/bin/snagetpd * chown bin.sna /opt/ibm/sna/bin/snagetpd * chmod 550 /opt/ibm/sna/bin/snagetpd * cp -p snatnsrvr_mt /opt/ibm/sna/bin/snatnsrvr_mt * chown bin.sna /opt/ibm/sna/bin/snatnsrvr_mt * chmod 700 /opt/ibm/sna/bin/snatnsrvr_mt * cp -p tn3270dev.dat /opt/ibm/sna/samples/tn3270dev.dat * chown root.root /opt/ibm/sna/samples/tn3270dev.dat * chmod 644 /opt/ibm/sna/samples/tn3270dev.dat * cp -p snaslim /opt/ibm/sna/bin/snaslim * chown bin.sna /opt/ibm/sna/bin/snaslim * chmod 700 /opt/ibm/sna/bin/snaslim * * 8) Restart SNA * sna start * * * +--------------------------------------------------------------------------+ * * * * IBM COPYRIGHT INFORMATION: * __________________________ * * IBM Communications Server for Linux, Version 6.2.3 * * * (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. * *******************************************************************************