******************************************************************************* * * 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: 10/20/2004 * * DESCRIPTION: * ____________ * * README FILE FOR * * IBM Communications Server for AIX temporary fix ("fix") * * (Installs only on PTF level 6.1.0.5) * APAR: IY61677 * * 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 fix is designed for the fileset sna.rte at the specific * level of 6.1.0.5. 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 fix 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 fix. 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 fix. * *+----------------------------------------------------------------------------+ * * * PROBLEM FIXED: IY61677 * Module Name: libnof.o libnof64_5.o libpe.o libpe64_5.o sna.cat sna_v5router * sna_v5router64 snaapitrcfmt snaapitrcfmt snaapitrcfmt64 * snacfgdae snacfgdae64 snatrcfmt snatrcfmt64 * * APAR DESCRIPTION: ADD USER-CONFIGURABLE RTP TUNING * * ERROR DESCRIPTION: * In an HPR environment, when a problem occurs and the link between CS/AIX and * VTAM fails, VTAM attempts to switch the path to an alternate route. There is * no alternate route, so the path switch attempt fails. However, the attempt * takes four minutes before it fails, despite VTAM configuration. During that * time the sessions appear active, and the applications using those sessions * continue to queue transactions for those sessions. The customer wants to * reduce the timeout period for the path switch, but CS/AIX does not expose * the path switch time as a user-configurable parameter. * * PROBLEM SUMMARY: * USERS AFFECTED: All using HPR. * * PROBLEM DESCRIPTION: * CS/AIX does not expose the RTP path switch time parameter for the * user to configure. * * PROBLEM SUMMARY: * CS/AIX does not expose the RTP tuning parameters for the user to * configure. The values for path switch time are hard-coded in CS/AIX * the defaults described section 8.4.4.2 of IBM Redbook "Inside APPN and * HPR", found online at http://www.redbooks.ibm.com/abstracts/sg243669.html * Priority Timeout * LOW 8 minutes * MEDIUM 4 minutes * HIGH 2 minutes * NETWORK 1 minute * * PROBLEM CONCLUSION: * IBM agrees that the current defaults may be higher than necessary on many * modern high-speed networks. CS/AIX has been modified to expose RTP * tuning parameters, which include path switch timers, for user configuration. * Two snaadmin commands have been added: * * define_rtp_tuning allows the default RTP timers to be altered. * Name Type Length/Range * ---- ---- ------------ * Mandatory fields: (none) * Defaulted fields (default in brackets): * path_switch_attempts decimal 1 - 255 (6) * short_req_retry_limit decimal 1 - 255 (6) * path_switch_time_low decimal 1 - 65535 (480) * path_switch_time_medium decimal 1 - 65535 (240) * path_switch_time_high decimal 1 - 65535 (120) * path_switch_time_network decimal 1 - 65535 (60) * * query_rtp_tuning allows the user to query the default RTP timers defined * for the node (defined using define_rtp_tuning). * * Documentation: * The define_rtp_tuning command can be used to modify parameters for * future RTP connections. * * path_switch_attempts * Specifies the number of path switch attempts to set on new RTP * connections.If 0 is specified the default of 6 is used. * * short_req_retry_limit * Specifies the number of times a Status Request will be sent before * determining that an RTP connection is disconnected and starting Path * Switch processing. If 0 is specified the default of 6 is used. * * path_switch_times[4] * Specifies for each transmission priority the length of time (in * seconds) forwhich the node will attempt to Path Switch a * disconnected RTP connection. The value of each Path Switch Time must * not exceed that of lower priority traffic. If 0 is specified for any * of these times, the correspondingdefault value will be used as set * out below. * * Timer Default * path_switch_times[NAP_LOW] 480s * path_switch_times[NAP_MEDIUM] 240s * path_switch_times[NAP_HIGH] 120s * path_switch_times[NAP_NETWORK] 60s * * * Also included in this updated module are fixes for the following APARs: * NONE * *+----------------------------------------------------------------------------+ * * INSTALLATION INSTRUCTIONS: * __________________________ * * iy61677.tar.Z ("this fix" in the steps below) is a compressed tar archive * file containing the updated modules and this readme. * * * To install this fix: * _____________________________ * * ** Downloading the file: * * 1) Be SURE to download this fix in BINARY format. * * 2) Check the output of sum against the updated module after * uncompressing and untarring this fix. You should see: * * 25019 123 libnof.o * 34943 150 libnof64_5.o * 46080 809 libpe.o * 63051 950 libpe64_5.o * 47377 606 sna.cat * 07417 4299 sna_v5router * 55428 4909 sna_v5router64 * 26657 339 snaapitrcfmt * 56865 378 snaapitrcfmt64 * 36180 714 snacfgdae * 25130 806 snacfgdae64 * 04577 887 snatrcfmt * 18620 1006 snatrcfmt64 * * 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. * * mv /usr/lib/sna/libnof.o /usr/lib/sna/libnof.o.original * mv /usr/lib/sna/libnof64_5.o /usr/lib/sna/libnof64_5.o.original * mv /usr/lib/sna/libpe.o /usr/lib/sna/libpe.o.original * mv /usr/lib/sna/libpe64_5.o /usr/lib/sna/libpe64_5.o.original * mv /usr/lib/nls/msg/en_US/sna.cat /usr/lib/nls/msg/en_US/sna.cat.original * mv /usr/lib/nls/msg/C/sna.cat /usr/lib/nls/msg/C/sna.cat.original * mv /usr/lib/sna/drivers/sna_v5router /usr/lib/sna/drivers/sna_v5router.original * mv /usr/lib/sna/drivers/sna_v5router64 /usr/lib/sna/drivers/sna_v5router64.original * mv /usr/bin/snaapitrcfmt /usr/bin/snaapitrcfmt.original * mv /usr/bin/snaapitrcfmt64 /usr/bin/snaapitrcfmt64.original * mv /usr/bin/snacfgdae /usr/bin/snacfgdae.original * mv /usr/bin/snacfgdae64 /usr/bin/snacfgdae64.original * mv /usr/bin/snatrcfmt /usr/bin/snatrcfmt.original * mv /usr/bin/snatrcfmt64 /usr/bin/snatrcfmt64.original * * 7) Copy this fix's updated module into its/their place(s). * * cp ./libnof.o /usr/lib/sna/libnof.o * cp ./libnof64_5.o /usr/lib/sna/libnof64_5.o * cp ./libpe.o /usr/lib/sna/libpe.o * cp ./libpe64_5.o /usr/lib/sna/libpe64_5.o * cp ./sna.cat /usr/lib/nls/msg/en_US/sna.cat * cp ./sna.cat /usr/lib/nls/msg/C/sna.cat * cp ./sna_v5router /usr/lib/sna/drivers/sna_v5router * cp ./sna_v5router64 /usr/lib/sna/drivers/sna_v5router64 * cp ./snaapitrcfmt /usr/bin/snaapitrcfmt * cp ./snaapitrcfmt64 /usr/bin/snaapitrcfmt64 * cp ./snacfgdae /usr/bin/snacfgdae * cp ./snacfgdae64 /usr/bin/snacfgdae64 * cp ./snatrcfmt /usr/bin/snatrcfmt * cp ./snatrcfmt64 /usr/bin/snatrcfmt64 * * 8) Set ownership and permissions properly. * * chown bin.system /usr/lib/sna/libnof.o * chown bin.system /usr/lib/sna/libnof64_5.o * chown bin.system /usr/lib/sna/libpe.o * chown bin.system /usr/lib/sna/libpe64_5.o * chown bin.system /usr/lib/nls/msg/en_US/sna.cat * chown bin.system /usr/lib/nls/msg/C/sna.cat * chown bin.system /usr/lib/sna/drivers/sna_v5router * chown bin.system /usr/lib/sna/drivers/sna_v5router64 * chown bin.system /usr/bin/snaapitrcfmt * chown bin.system /usr/bin/snaapitrcfmt64 * chown bin.system /usr/bin/snacfgdae * chown bin.system /usr/bin/snacfgdae64 * chown bin.system /usr/bin/snatrcfmt * chown bin.system /usr/bin/snatrcfmt64 * * chmod 555 /usr/lib/sna/libnof.o * chmod 555 /usr/lib/sna/libnof64_5.o * chmod 555 /usr/lib/sna/libpe.o * chmod 555 /usr/lib/sna/libpe64_5.o * chmod 444 /usr/lib/nls/msg/en_US/sna.cat * chmod 444 /usr/lib/nls/msg/C/sna.cat * chmod 600 /usr/lib/sna/drivers/sna_v5router * chmod 600 /usr/lib/sna/drivers/sna_v5router64 * chmod 555 /usr/bin/snaapitrcfmt * chmod 555 /usr/bin/snaapitrcfmt64 * chmod 700 /usr/bin/snacfgdae * chmod 700 /usr/bin/snacfgdae64 * chmod 555 /usr/bin/snatrcfmt * chmod 555 /usr/bin/snatrcfmt64 * * 9) Shutdown and reboot your system. * * shutdown -Fr * * 10) Restart Communications Server * * sna start * snaadmin define_rtp_tuning, ... (as shown above) * 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, 2004. * 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. * *******************************************************************************