Patch Name: PHNE_6056 Patch Description: s700_800 10.0X SNAplusAPI R4 APPC cumulative patch Creation Date: 95/09/12 Post Date: 95/10/24 Hardware Platforms - OS Releases: s700: 10.00 10.01 s800: 10.00 10.01 Products: SNAplusAPI R4 Filesets: SNAP-API.SNAP-API Automatic Reboot?: No Status: General Release Critical: No (superseded patches were critical) PHNE_5539: OTHER APPC header file (appc_c.h) was not the latest. receive_allocate VCB has been changed. Path Name: /hp-ux_patches/s700_800/10.X/PHNE_6056 Symptoms: PHNE_6056: (1) 5003272328 After recycling SNAplus, CPI-C cminit() fails with CM_PROGRAM_PARAMETR_ERROR. Only recyling the SNAplus deamon will get the CPI-C application out of this state. (2) 1653130575 Cannot use the AP_SAME parameter without having to issue a receive_allocate first. (3) 5003265041 This SR is a duplicate of SR-1653130575. Please see above. (4) 1653093716 The problem reported in SR-1653093716, which has been fixed before, occurs again. PHNE_5539: (1) 4701291591 In most cases, there is no real symptom when you compile and link your APPC application using the R4 APPC header file appc_c.h. That is, your application would probably compile and run with no compile-time or run-time error message. However, if your application is referencing any of the following variables : pip_incoming (in the VCB of the receive_allocate verb) password (in the VCB of the receive_allocate verb) your application program would probably get some compile-time error messages. The cause of this problem is that the R4 APPC header file appc_c.h is not the latest one. The following is the difference between the latest APPC header file appc_c.h and the R4 APPC header file appc_c.h : In the VCB of receive_allocate (latest version of appc_c.h) ============================== unsigned char reserv3[25]; unsigned char pip_incoming; unsigned char reserv4[4]; unsigned char password[10]; In the VCB of receive_allocate (R4 version of appc_c.h) ============================== unsigned short pip_dlen; unsigned char *pip_dptr; unsigned char reserv3[22]; Even if your application program does not reference the two variables mentioned above, it is very important that you use the latest APPC header file appc_c.h provided in this patch. As we mentioned earlier, in this case, your program would probably run without any problem. However, by using the latest header file, you would maximize the binary compatibility of your application with the next release of SNAplus. PHNE_5448: (1) 4701289355 In R4 of SNAplus, an API application cannot link with the archive API library. Defect Description: PHNE_6056: (1) 5003272328 When a CPI-C application is running and the SNAplus transport layer (node/connection/link) is brought down, the CPI-C application's cminit() will fail even after the transport layer is brought up gain. This is a flaw in the way SNAplus handles shared memory and the logical connection between the CPI-C application and the lower level component in the described scenario. (2) 1653130575 The function requested in this SR is not a defect. (3) 5003265041 The function requested in this SR is not a defect. (4) 1653093716 This is a regression problem of SR-1653093716. PHNE_5539: (1) 4701291591 The APPC header file appc_c.h delivered with R4 is not the latest version. The latest appc_c.h has some changes in the VCB of the receive_allocate verb. It is important that R4 APPC application program uses the latest header file. PHNE_5448: (1) 4701289355 Since the archive library of the SNAplusAPI was not shipped in the R4 product, if an application is linked with the archive library, an link time error message will be issued. SR: 5003272328 5003265041 4701291591 4701289355 1653130575 1653093716 Patch Files: /usr/include/sna/appc_c.h /opt/sna/lib/libappc.1 /opt/sna/lib/libsna.a what(1) Output: /usr/include/sna/appc_c.h: None /opt/sna/lib/libsna.a: A.10.00.002 SNAplus R4 APPC Library (PHNE_6056: 95/09/11 13:06:17) A.10.00.002 SNAplus R4 CSV Library (PHNE_6056: 95/09/11 15:23:59) A.10.00.003 SNAplus R4 HLLAPI Library (PHNE_6056: 95/09/11 15:11:38) A.10.00.002 SNAplus R4 NM-API Library (PHNE_6056: 95/09/11 15:50:04) A.10.00.002 SNAplus R4 COV Library (PHNE_6056: 95/09/11 13:49:01) A.10.00.002 SNAplus R4 CPI-C Library (PHNE_6056: 95/09/11 15:17:53) A.10.00.002 SNAplus R4 LUA Library (PHNE_6056: 95/09/11 15:36:55) A.10.00.002 SNAplus R4 Tools Library (PHNE_6056: 95/09/11 16:16:53) /opt/sna/lib/libappc.1: A.10.00.002 SNAplus R4 APPC Library (PHNE_6056: 95/09/11 16:29:11) cksum(1) Output: 3920851229 102326 /usr/include/sna/appc_c.h 2189595683 668016 /opt/sna/lib/libsna.a 1950027576 569344 /opt/sna/lib/libappc.1 Patch Conflicts: None Patch Dependencies: None Hardware Dependencies: None Other Dependencies: None Supersedes: PHNE_5448 PHNE_5539 Equivalent Patches: None Patch Package Size: 1370 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_6056 5a. For a standalone system, run swinstall to install the patch: swinstall -x autoreboot=true -x match_target=true \ -s /tmp/PHNE_6056.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_6056.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. The cluster clients must be shut down as described in step 5b. By default swinstall will archive the original software in /var/adm/sw/patch/PHNE_6056. 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_6056.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_6056.depot of=/dev/rmt/0m bs=2k Special Installation Instructions: None