Patch Name: PHNE_9025 Patch Description: s700_800 10.20 SNAplus API R4.4 cumulative patch Creation Date: 97/01/28 Post Date: 97/04/23 Hardware Platforms - OS Releases: s700: 10.20 s800: 10.20 Products: SNAplusAPI R4.4 Filesets: SNAP-API.SNAP-API Automatic Reboot?: No Status: General Superseded Critical: Yes PHNE_9025: HANG Path Name: /hp-ux_patches/s700_800/10.X/PHNE_9025 Symptoms: PHNE_9025: (1) 1653187310 TP hang while processing ATTACH from host. (2) 1653186023 APPC code does not look for attaches after a retry situation has occurred. (3) 1653184184 Appc application hangs due to an incoming attach being processed immedia rather than being queued. This meant that the control blocks for the current conversation were overwritten. (4) 5003318998 LUA application on R4.2/10.01 fails to run. (5) 5000714642 Customer's LUA application was receiving LUA_CANCELLED after issuing an RUI_TERM verb even though the RUI_TERM was finishing properly. Defect Description: PHNE_9025: (1) 1653187310 A build of the code in August 1995 failed to include a previous fix, and problems were found in the async timeer code. There was also an unhelpful error being logged, which has been removed. (2) 1653186023 There is a retry timer in our code which sends attaches from the 2.1 node to the APPC library. This is present for a variety of reasons, but the two primary ones are: - when running client server attaches are sent to the client APPC library using UDP - and so may be lost - attaches for a queued TP are stored within the library of that TP. If the TP exits without processing all attaches, we want to ensure that another copy of the TP can be started and pick up the attaches which were not processed by the previous instance of the TP Customer's TP is running extremely slowly and they have multiple attaches queued up. The node thinks it is not getting a response, and there are multiple retries for each attach queued up within the library. There is a bug in the asynchronous APPC code which means that after we have identified and processed a retry we never look for further attaches for a given receive_allocate. (3) 1653184184 A fix has been written to close the window to ensure that any queued attaches can only be processed once the current conversation has ended and a fresh receive_allocate has been issued. (4) 5003318998 (5) 5000714642 The RUI_TERM finished properly, but an incorrect return code being set. SR: 5003318998 5000714642 1653187310 1653186023 1653184184 Patch Files: /opt/sna/lib/libappc.1 /opt/sna/lib/libcpic.1 /opt/sna/lib/liblua.1 what(1) Output: /opt/sna/lib/libappc.1: A.10.20.203 SNAplus R4.4 APPC Library (PHNE_9025 : 97/01/21 14:01:43) /opt/sna/lib/liblua.1: A.10.20.200 SNAplus R4.4 LUA Library (PHNE_9025 : 97/01/21 14:08:41) /opt/sna/lib/libcpic.1: A.10.20.200 SNAplus R4.4 CPI-C Library (PHNE_9025 : 97/01/21 14:03:42) cksum(1) Output: 545721939 643072 /opt/sna/lib/libappc.1 773960393 143360 /opt/sna/lib/liblua.1 2304375926 290816 /opt/sna/lib/libcpic.1 Patch Conflicts: None Patch Dependencies: None Hardware Dependencies: None Other Dependencies: None Supersedes: None Equivalent Patches: None Patch Package Size: 1110 Kbytes Installation Instructions: Please review all instructions and the Hewlett-Packard SupportLine User Guide or your Hewlett-Packard support terms and conditions for precautions, scope of license, restrictions, and, limitation of liability and warranties, before installing this patch. ------------------------------------------------------------ 1. Back up your system before installing a patch. 2. Login as root. 3. Copy the patch to the /tmp directory. 4. Move to the /tmp directory and unshar the patch: cd /tmp sh PHNE_9025 5a. For a standalone system, run swinstall to install the patch: swinstall -x autoreboot=true -x match_target=true \ -s /tmp/PHNE_9025.depot 5b. For a homogeneous NFS Diskless cluster run swcluster on the server to install the patch on the server and the clients: swcluster -i -b This will invoke swcluster in the interactive mode and force all clients to be shut down. WARNING: All cluster clients must be shut down prior to the patch installation. Installing the patch while the clients are booted is unsupported and can lead to serious problems. The swcluster command will invoke an swinstall session in which you must specify: alternate root path - default is /export/shared_root/OS_700 source depot path - /tmp/PHNE_9025.depot To complete the installation, select the patch by choosing "Actions -> Match What Target Has" and then "Actions -> Install" from the Menubar. 5c. For a heterogeneous NFS Diskless cluster: - run swinstall on the server as in step 5a to install the patch on the cluster server. - run swcluster on the server as in step 5b to install the patch on the cluster clients. By default swinstall will archive the original software in /var/adm/sw/patch/PHNE_9025. If you do not wish to retain a copy of the original software, you can create an empty file named /var/adm/sw/patch/PATCH_NOSAVE. Warning: If this file exists when a patch is installed, the patch cannot be deinstalled. Please be careful when using this feature. It is recommended that you move the PHNE_9025.text file to /var/adm/sw/patch for future reference. To put this patch on a magnetic tape and install from the tape drive, use the command: dd if=/tmp/PHNE_9025.depot of=/dev/rmt/0m bs=2k Special Installation Instructions: None