Patch Name: PHNE_13428 Patch Description: s700_800 10.20 R5.1 SNAplus2 Common patch Creation Date: 97/12/05 Post Date: 98/02/27 Hardware Platforms - OS Releases: s700: 10.20 s800: 10.20 Products: SNAplus2-Common R5.1 Filesets: SNAplus2-Common.SNAP2-CORE SNAplus2-Common.SNAP2-ADMIN SNAplus2-Common.SNAP2-ADM-MAN Automatic Reboot?: Yes Status: General Superseded Critical: No (superseded patches were critical) PHNE_9664: HANG PHNE_9652: ABORT Path Name: /hp-ux_patches/s700_800/10.X/PHNE_13428 Symptoms: PHNE_13428: (1) 1653227165 If the plu_un_name parameter is blank, then we will send out a INITSELF with a blank LU name. (2) 4701375600 If you issue a query_lu_0_to_3 NOF API verb with a buffer greater than 65535 bytes, then we return incomplete data. PHNE_12955: (1) 4701370064 If you migrate an SNAplus config file which contains RJE LUs, these are migrated as unrestricted - rather than RJE. No functional problem, but confusing for some users. PHNE_11962: (1) 4701359679 when using snapadmin to issue initialise_session_limits command, specifying the auto_act parameter gives you an error. Also, auto_act does not appear in the detailed help. PHNE_9889: (1) 4701356899 Enhancement to expose R5.2 version of application based scheduling API in R5.0 and R5.1 PHNE_9664: (1) 1653205914 CPIC conversation ID's are not logged to help with debugging. (2) 1653207431 CMINIT hangs - no return for OPEN_FILE (3) 1653208215 If there are not enough semaphore UNDO structures available, 3270 can hang when the user tries to activate a session. (4) 5003352336 Enhancement - allow a non queued tp to loop round and reissue a receive allocate verb. If an attach comes in, a new TP will be forked and exec'd ONLY if an existing TP isn't sitting with a rcv alloc outstanding. PHNE_9652: (1) 1653205898 Problem: User can enter a full-stop in the LU alias field on the CPIC side-information dialog . (2) 1653206284 xsnapadmin coredumps when selecting partner LU using partner LU selection dialog in APPC Session Level Secur. dialog. (3) 1653205625 Problem: Partner LUs would not be converted to remote LU records because they had the same aliases as local LUs. (4) 5003361048 Large IO configurations make SNAplus2 SAM core dumping at initialisation ie when SNAplus2 Installation is launched from Network & Communication screen. (5) 1653206987 If a back level client with an RJE workstation name of less than 4 characters is on the network, it will not work through the BL slim. (6) 1653206995 Choosing detailed help (snapadmin -h -d) for one of the following commands : define_adjacent_len_node define_cn define_lu_pool define_rje_wkstn define_userid_password delete_adjacent_len_node delete_cn delete_emulator_user delete_lu_pool delete_userid_password you get multiple identical lines, around 250 for connection network commands. (7) 1653207001 Usability problem in the display of first fields lines, where a carriage return is missing after the ':' part. This display is the same for every command. (8) 1653207019 If you go into the LS configuration screen, and the ask for HELP, reading the information on SAP shows: 'Enter the SAP of the remote token ring station' (9) 1653207068 xsnapadmin crashes if you have 250 3270 sessions configured. (10) 1653207076 Status_connectivity may loop forever if: 1) there are more than two LSs defined on a port 2) there are other types of LSs defined apart from just ethernet LSs (11) 1653207118 If you run snaptrcfmt -W, then the program core dumps. No formatting of the trace file occurs. (12) 4701345124 Occasionally a non-queued invoked TP just hangs. (13) 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. (14) 1653189522 The problem is that online help is not available in xsnapadmin. (15) 1653196386 Symptoms of problem: End user application can register a signal catcher, and then find that it is deregistered by SNA. (16) 5003349969 Symptoms of problem: When migrating a V4 config file containing non queued TPs, snapmigrate produces entries in the TPs file with TIMEOUT values. This results in error logs when the system is started - non queued TPs don't have timeouts. (17) 4701345199 Issue snaptrcfmt -W and you get a core dump. (18) 4701325506 Symptoms of problem: If you migrate a config file from R3 to R5.x, the paths for RJE devices are not updated from '/usr/lib/sna' to '/var/opt/sna'. (19) 5003331611 Release 3 of SNAplus supported no pacing, which was configured by setting the pacing on an APPC mode to 0. Release 4 and Release 5 do not support this. (20) 5003344358 If sna_tps file has more than 21 TPs then daemon appears not to start. In fact it starts and core dumps within a few seconds. Memory corruption occurs when 17 TPs are configured. (21) 5003333922 When installing SNAplus2 and trying to run the SNAplus2 Installation portion in SAM, SAM died with a core dump. This prevented installation of SNAplus2. The following error was reported: 'Unexpected exit: process /usr/sam/lbin/samx -C -p 3181 /opt/sna/sam/C/mainmenu.ui exited with a non-zero exit status. sh: 3326 (memory fault coredump)' (22) 4701337444 It is difficult to get an overview of the node configuration using snapadmin. (23) 4701325696 After the installation of patch PHCO_6349 on 800 systems, the addition or deletion of PSI cards would not stay updated after exiting and reentering the 'SAM SNAplus2 Installation' area (during a single SAM invocation). (24) 4701326249 SAM SNAplus configuration failed when trying to configure a machine as a client. (25) 4701325514 RJE users migrating from SNAplus to SNAplus2 will run into a problem after running snapmigrate to generate the SNAplus2 configurations and RJE style files. The '.sty' files will not be there as stated in the migration guide. Defect Description: PHNE_13428: (1) 1653227165 Code change made to ensure that we never set the plu_un_name to blanks, but to all zeros if it is not specified by the user. (2) 4701375600 Code change to allow buffer size greater than 2 bytes PHNE_12955: (1) 4701370064 Code change to Migrate the LUs as RJE LUs PHNE_11962: (1) 4701359679 Code changed to ensure auto_act parameter listed as valid for this command. PHNE_9889: (1) 4701356899 Tidy up macroing of function to make it easier to use. R5.0, 5.1 and 5.2 now support the same variant of the application based scheduling API - refer to the documentation in the 'additional items' manual being produced for R5.2 by ENSD. PHNE_9664: (1) 1653205914 Code modified to add Conversation ID to logs. (2) 1653207431 Code change made to resolve a problem introduced by the 10.30 kernel threads development - problem caused by code which calls thrd_cond_wait and subsequently remove the main path manager lock. Need to reset our internal variables to take note that the PM is no longer locked. (3) 1653208215 The code has been changed to log an error when this problem occurs, and return control to the User Interface. (4) 5003352336 Code change made to provide Enhancement as per Problem description. PHNE_9652: (1) 1653205898 Fix is to add a modify/verify callback to the text field (2) 1653206284 The Fix applied is to remove the declaration and subsequent free-ing of a string pointer that was never used (and hence never defined). (3) 1653205625 Details of fix applied: Two list are maintained in snamigrate: (1) a list of local LUs (2) a list of partner LUs There was processing to remove partner LUs that were also local LUs to prevent the migration tool outputting REMOTE_LU records for them. This was bugged because to find them it was comparing the partner LU alias with the local LU name. Changed file: cmigrate/miggtfld.c in mig_output_appc_lus (4) 5003361048 SNAplus2 SAM is not made for more than 50 IO devices, as listed by ioscan -F; previous patch increased to 128, but large configuration can go up to 1000s. (5) 1653206987 Correct check in BL slim. (6) 1653206995 Resolve the problem - only produce one line of output (7) 1653207001 Details of fix applied: correct the formatting of the help output. (8) 1653207019 Details of fix applied: Correct the text! (9) 1653207068 The GUI issues a request for detailed information for all 250 sessions. However only a subset of this information will be returned, so the GUI reissues its request for the remaining sessions. However this new request was for summary rather than detailed information. The fix is to ensure that the new request is also for detailed information. (10) 1653207076 The problem is with the Configuration Daemon. The symptoms as seen by a NOF API programmer are that a query_port or query_ls may loop forever. The conditions for the loop are that 1) the initial buffer space available for receiving the data is too small for all of the entities 2) the buffer space available is the same as or just a little bit bigger than the buffer space that is used in packing the data 3) there are more than one type of port (ls) defined. (11) 1653207118 Details of fix applied: Ensure we don't try to write to the dump file, since the user doesn't want one! (12) 4701345124 Details of fix applied: The use of the popen() call is dangerous, not just in a DCE thread environment. Signals can be lost, and the process can just hang. It is also very expensive on performance to issue the popen() call, as this causes about 5-6 new processes to be spawned. The call has been replaced by a system specific call to get the process name. (13) 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. (14) 1653189522 The problem is caused by the non-existence of two soft links; /etc/vhelp/volumes/C/Help4SNAadmin.hv and /etc/vhelp/families/C/snaplus.hf are missing. (15) 1653196386 Details of fix applied: Remove the use of signals altogether in this library. (16) 5003349969 Details of fix applied: only generate the timeout line for queued TPs. (17) 4701345199 The code was writing to the dump file, even although it had not opened it. (18) 4701325506 Details of fix applied: Code changed to perform the extra migration step. (19) 5003331611 Snapmigrate did not take of the possible R3 value of 0 for pacing in the MODE. (20) 5003344358 Details of fix applied: Correct the code that grows the data structure as more TPs are configured (the memory is allocated for 16 TPs at a time). (21) 5003333922 The cause of the problem was that SAM/SNA could only support a maximum of 50 IO cards. (22) 4701337444 Snapadmin does not have a command which allows the user to get an overview of the node configuration. The user is required to use several query commands to get information about nodes, ports, link stations, etc. (23) 4701325696 With at least one PSI card already in the kernel, if the user adds at least one more PSI card and then exits the 'SAM SNAplus2 Installation', deferring kernel changes, that PSI card will not display correctly upon reentering the SNAplus2 Installation screen. (24) 4701326249 The reason for the failure in this case is that SAM thought the machine should be a server if the SNAplus2-Link product was installed. (25) 4701325514 The reason the .sty file won't exist is because snapmigrate incorrectly put the on the system as .RJE files. The user can simply copy the files to the correct name, or install the latest SNAplus2-Common patch which fixes snapmigrate. SR: 5003361048 5003352963 5003352336 5003349969 5003344358 5003333922 5003331611 4701375600 4701370064 4701359679 4701356899 4701345199 4701345124 4701337444 4701326249 4701325696 4701325514 4701325506 1653227165 1653208215 1653207431 1653207118 1653207076 1653207068 1653207019 1653207001 1653206995 1653206987 1653206284 1653205914 1653205898 1653205625 1653196386 1653189522 Patch Files: /opt/sna/conf/lib/libsixc.a /opt/sna/help/Help4SNAadmin.hv /opt/sna/help/Help4SNAadmin00.ht /opt/sna/help/Help4SNAadmin01.ht /opt/sna/help/Help4SNAadmin02.ht /opt/sna/help/Help4SNAadmin03.ht /opt/sna/help/Help4SNAadmin04.ht /opt/sna/help/Help4SNAadmin05.ht /opt/sna/help/Help4SNAadmin06.ht /opt/sna/help/Help4SNAadmin07.ht /opt/sna/help/Help4SNAadmin08.ht /opt/sna/help/Help4SNAadmin09.ht /opt/sna/help/snaplus.hf /opt/sna/lib/X11/uid/XSnapadmin/xsnadlg.uid /opt/sna/share/man/man8/snapadmin.8 /opt/sna/sna.cat /opt/sna/sna_log.msg /opt/sna/bin/X11/xsnapadmin /opt/sna/bin/snapadmin /opt/sna/bin/snapcfgdae /opt/sna/bin/snaperrlog /opt/sna/bin/snaprunbck /opt/sna/bin/snapmigrate2 /opt/sna/bin/snaptrcfmt /opt/sna/lib/libmgr.1 /opt/sna/lib/libmgrdce.1 /opt/sna/lib/libnof.1 /opt/sna/lib/libpe.1 /opt/sna/lib/libxp.1 /opt/sna/sam/C/SNA_SAM.sl /opt/sna/bin/snapdaemon what(1) Output: /opt/sna/bin/snapadmin: ]B.10.20.101 SNAplus2 R5.1 command line administrati on tool ] (PHNE_11962 : 97/07/17 14:16:21) ] /opt/sna/share/man/man8/snapadmin.8: None /opt/sna/bin/X11/xsnapadmin: ]B.10.20.101 SNAplus2 R5.1 Motif Administration prog ram ] (PHNE_13428 : 97/09/03 11:09:19) ] /opt/sna/bin/snapcfgdae: ]B.10.20.002 SNAplus2 R5.1 Config Daemon ] (PHNE_9652 : 97/03/11 12:45:51) ] /opt/sna/bin/snapdaemon: ]B.10.20.002 SNAplus2 R5.1 daemon ] (PHNE_9664 : 97/04/30 10:03:44) ] /opt/sna/bin/snapmigrate2: ]B.10.20.100 SNAplus2 R5.1 Config file migration too l ] (PHNE_12955 : 97/06/03 16:08:46) ] /opt/sna/bin/snaprunbck: ]B.10.20.001 SNAplus2 R5.1 Back Level SLIM ] (PHNE_9652 : 97/03/11 12:39:38) ] /opt/sna/bin/snaptrcfmt: ]B.10.20.002 SNAplus2 R5.1 trace formatting tool ] (PHNE_9652 : 97/03/11 12:50:06) ] /opt/sna/lib/libmgrdce.1: ]B.10.20.100 SNAplus2 R5.1 Path, Handle, Table and M emory Managers with Threads support ] (PHNE_9889 : 97/06/03 15:07:17) ] /opt/sna/lib/libmgr.1: ]B.10.20.100 SNAplus2 R5.1 Signal-based Path, Handle , Table and Memory Managers, User Space ] (PHNE_9889 : 97/06/03 15:05:16) ] /opt/sna/lib/libnof.1: ]B.10.20.002 SNAplus2 R5.1 NOF library ] (PHNE_9652 : 96/10/30 10:45:22) ] /opt/sna/lib/libpe.1: ]B.10.20.102 SNAplus2 R5.1 parsing engine ] (PHNE_11962 : 97/07/16 11:39:36) ] /opt/sna/conf/lib/libsixc.a: ]B.10.20.004 SNAplus2 R5.1 Client Router in the kern el ] (PHNE_13428 : 97/11/25 15:04:29) ] /opt/sna/lib/libxp.1: ]B.10.20.001 SNAplus2 R5.1 XP Codex library ] (PHNE_9652: 96/10/04 14:58:29) ] /opt/sna/sam/C/SNA_SAM.sl: SNAplus2 R5.x SAM/HP-UX 10.X/Rev.A.1.3 date:03/19/9 7 16:23:39 /opt/sna/sna.cat: None /opt/sna/bin/snaperrlog: ]B.10.20.002 SNAplus2 R5.1 Trace Daemon ] (PHNE_9652 : 97/02/17 16:54:07) ] /opt/sna/sna_log.msg: 5.1.2-Tue_Apr_29_17:17:52_BST_1997_Message_file /opt/sna/help/Help4SNAadmin.hv: None /opt/sna/help/Help4SNAadmin00.ht: None /opt/sna/help/Help4SNAadmin01.ht: None /opt/sna/help/Help4SNAadmin02.ht: None /opt/sna/help/Help4SNAadmin03.ht: None /opt/sna/help/Help4SNAadmin04.ht: None /opt/sna/help/Help4SNAadmin05.ht: None /opt/sna/help/Help4SNAadmin06.ht: None /opt/sna/help/Help4SNAadmin07.ht: None /opt/sna/help/Help4SNAadmin08.ht: None /opt/sna/help/Help4SNAadmin09.ht: None /opt/sna/help/snaplus.hf: None /opt/sna/lib/X11/uid/XSnapadmin/xsnadlg.uid: None cksum(1) Output: 2279061766 81920 /opt/sna/bin/snapadmin 1518933299 4774 /opt/sna/share/man/man8/snapadmin.8 1932782777 1077248 /opt/sna/bin/X11/xsnapadmin 2701318259 262144 /opt/sna/bin/snapcfgdae 921572955 65536 /opt/sna/bin/snapdaemon 3060485902 147456 /opt/sna/bin/snapmigrate2 3535816154 221184 /opt/sna/bin/snaprunbck 526740197 634880 /opt/sna/bin/snaptrcfmt 3273494178 274432 /opt/sna/lib/libmgrdce.1 3618931441 266240 /opt/sna/lib/libmgr.1 3490306798 118784 /opt/sna/lib/libnof.1 3200087905 634880 /opt/sna/lib/libpe.1 3760005832 441416 /opt/sna/conf/lib/libsixc.a 95617434 331776 /opt/sna/lib/libxp.1 3945138114 253952 /opt/sna/sam/C/SNA_SAM.sl 974987615 123068 /opt/sna/sna.cat 4017456805 86016 /opt/sna/bin/snaperrlog 2772650915 595836 /opt/sna/sna_log.msg 3257810127 36408 /opt/sna/help/Help4SNAadmin.hv 2231434372 2776 /opt/sna/help/Help4SNAadmin00.ht 1160669853 36785 /opt/sna/help/Help4SNAadmin01.ht 2615187876 5561 /opt/sna/help/Help4SNAadmin02.ht 2778000727 2163 /opt/sna/help/Help4SNAadmin03.ht 3829152468 17961 /opt/sna/help/Help4SNAadmin04.ht 622179249 12436 /opt/sna/help/Help4SNAadmin05.ht 3757705431 77636 /opt/sna/help/Help4SNAadmin06.ht 3182918061 121476 /opt/sna/help/Help4SNAadmin07.ht 2005183579 53140 /opt/sna/help/Help4SNAadmin08.ht 2858504774 33752 /opt/sna/help/Help4SNAadmin09.ht 3772269416 573 /opt/sna/help/snaplus.hf 2687518457 438272 /opt/sna/lib/X11/uid/XSnapadmin/ xsnadlg.uid Patch Conflicts: None Patch Dependencies: s700: 10.20: PHNE_13427 s800: 10.20: PHNE_13427 Hardware Dependencies: None Other Dependencies: None Supersedes: PHNE_9652 PHNE_9664 PHNE_9889 PHNE_11962 PHNE_12955 Equivalent Patches: None Patch Package Size: 6400 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_13428 5a. For a standalone system, run swinstall to install the patch: swinstall -x autoreboot=true -x match_target=true \ -s /tmp/PHNE_13428.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_13428.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_13428. 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_13428.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_13428.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).