Patch Name: PHNE_8796 Patch Description: s700_800 10.10 R5 SNAplus2 API cumulative patch Creation Date: 97/04/16 Post Date: 97/06/17 Hardware Platforms - OS Releases: s700: 10.10 s800: 10.10 Products: SNAplus2-API R5 Filesets: SNAplus2-API.SNAP2-API Automatic Reboot?: No Status: General Superseded Critical: No Path Name: /hp-ux_patches/s700_800/10.X/PHNE_8796 Symptoms: PHNE_8796: (1) 1653184192 RUI PURGE call failed on SNAPLUS2 on 10.10., but originally worked on SNAPLUS R4.X. Program code that fails is as follows :- void rui_purge_call( read_verb) LUA_VERB_RECORD *read_verb; { LUA_VERB_RECORD verb; verb.common.lua_data_ptr = ( char * ) ( read_verb ); RUI( &verb ); .......... (2) 1653195636 The problem was that an application issues cminic and then cmacci and gets return code of parameter check with log 8195-5 (0) CPI-C conversation id unknown. (3) 1653196402 Symptoms of problem: coredump when linking with the libmgrdce library and calling cmcanc while other verbs in progress. (4) 1653205906 Issuing cmsltp followed by cmacci (non-blocking) and then cmrltp results in in cmetpn returning NULLs for the TP name. (5) 1653205914 CPIC conversation ID's are not logged to help with debugging. (6) 1653207050 There is no method in CPIC for the application to specify the local LU that it wants to use. In some cases, this results in an application only being able to have one conversation active at a time. (7) 4701325530 CPI-C TP gives the following message when run: dld/sl: Unresolved symbol: nof (code) from /opt/sna/lib/libcpic.1 IOT trap (core dumped) (8) 4701326454 When using R5 SNAplus2 on HPUX B.10.10, the following compiler errors occured when compiling fxhpsnap.c: cc: 'fxhpsnap.c', line 2049: error 1574: Unknown size for 'getstate'. cc: 'fxhpsnap.c', line 2056: error 1594: The sizeof operator cannot be applied to types with unknown size. cc: 'fxhpsnap.c', line 2057: error 1530: Undefined struct or union. cc: 'fxhpsnap.c', line 2057: error 1588: 'AP_GET_STATE' undefined. cc: 'fxhpsnap.c', line 2058: error 1530: Undefined struct or union. cc: 'fxhpsnap.c', line 2058: warning 563: Argument #1 is not the correct type. cc: 'fxhpsnap.c', line 2058: error 1530: Undefined struct or union. Stop. The definition of the 'getstate' structure, as well as a definition of AP_GET_STATE appears to be missing. (9) 5003304865 Unable to allow API header files to be multiply included (10) 5003352963 Service TP names are incorrectly specified in CPI-C Side info. If you have a TP such as 21F0F0F8 (one of the NVDM/6000 TPs), you actually have to configure it as 21303038, because the first charcter gets passed through unchanged, but all subsequent characters get converted from ASCII to EBCDIC. Defect Description: PHNE_8796: (1) 1653184192 The problem was caused by an incorrect test in the code when it checked what it should delete. The test has now been corrected. (2) 1653195636 Details of fix applied: Correct previous fix (SFR 21718 / SR4701336701 ) Remove check for fTpActive in SCC_find_cccb. (3) 1653196402 Details of fix applied: The fix is to recheck the conversation id following a cmcanc call as this can invalidate it. (4) 1653205906 Changed the cmacci callback to fill in the side info TP name field when an incoming call is accepted. This brings it in line with the code for allocating a call. The cmetpn routine is now simplified to just extract the TP name from the side info field whether we accepted the conversation or allocated it. (5) 1653205914 Code modified to add Conversation ID to logs. (6) 1653207050 Changes have been made to the following CPIC verbs :- cminit cmslln cmallc cmdeal cmaccp (7) 4701325530 This error occurs after migrating from an R4.X SNAplus release to R5.X. The R5 CPI-C library was not correctly linking in the NOF library at runtime. (8) 4701326454 APPC AP_GET_STATE verb was not included in the R5 API. (9) 5003304865 Details of Fix applied: Enhance product to allow API header files to be multiply included. (10) 5003352963 Fix made to GUI admin and CPI-C library to take service TP names in the ASCII format 21F0F1F2 to represent the HEX format eg ASCII 21F0F1F2 will represent HEX 0x21F0F1F2. SR: 5003352963 5003304865 4701326454 4701325530 1653207050 1653205914 1653205906 1653196402 1653195636 1653184192 Patch Files: /opt/sna/include/acssvcc.h /opt/sna/include/appc_c.h /opt/sna/include/cmc.h /opt/sna/include/lua_c.h /opt/sna/include/ms_c.h /opt/sna/include/nof_c.h /opt/sna/include/values_c.h /opt/sna/lib/libappc.1 /opt/sna/lib/libcpic.1 /opt/sna/lib/libcsv.1 /opt/sna/lib/liblua.1 what(1) Output: /opt/sna/lib/libappc.1: ]B.10.10.003 SNAplus2 R5 LU 6.2 Verb Library Routine s ] (PHNE_8796: 96/09/19 15:26:40) ] /opt/sna/lib/libcpic.1: ]B.10.10.012 SNAplus2 R5 CPI-C Library Routines ] (PHNE_8796 : 97/04/03 14:57:19) ] /opt/sna/lib/libcsv.1: ]B.10.10.001 SNAplus2 R5 Common Service Verb Library Routines ] (PHNE_8796: 96/09/03 15:47:30) ] /opt/sna/lib/liblua.1: ]B.10.10.003 SNAplus2 R5 LUA Verb Library Routines ] (PHNE_8796: 96/09/19 15:27:51) ] /opt/sna/include/acssvcc.h: None /opt/sna/include/appc_c.h: None /opt/sna/include/cmc.h: None /opt/sna/include/lua_c.h: None /opt/sna/include/ms_c.h: None /opt/sna/include/nof_c.h: None /opt/sna/include/values_c.h: None cksum(1) Output: 3966200994 90112 /opt/sna/lib/libappc.1 2408529042 299008 /opt/sna/lib/libcpic.1 2728431541 90112 /opt/sna/lib/libcsv.1 1316319546 69632 /opt/sna/lib/liblua.1 2804311915 17911 /opt/sna/include/acssvcc.h 2254730343 42238 /opt/sna/include/appc_c.h 899626265 23161 /opt/sna/include/cmc.h 2498438717 28120 /opt/sna/include/lua_c.h 3383145800 17894 /opt/sna/include/ms_c.h 3492369629 472426 /opt/sna/include/nof_c.h 2022196398 136369 /opt/sna/include/values_c.h Patch Conflicts: None Patch Dependencies: None Hardware Dependencies: None Other Dependencies: None Supersedes: None Equivalent Patches: None Patch Package Size: 1320 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_8796 5a. For a standalone system, run swinstall to install the patch: swinstall -x autoreboot=true -x match_target=true \ -s /tmp/PHNE_8796.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_8796.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_8796. 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_8796.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_8796.depot of=/dev/rmt/0m bs=2k Special Installation Instructions: Stop SNA daemon before installing patch (snap stop). After installing the patch start the SNA daemon (snap start).