Patch Name: PHNE_9758 Patch Description: s700_800 10.10 SNAPlus TN3270 R4.3 cumulative patch Creation Date: 97/09/18 Post Date: 98/04/18 Hardware Platforms - OS Releases: s700: 10.10 s800: 10.10 Products: TN3270 A.10.10.000 Filesets: TN3270.TN3270 Automatic Reboot?: No Status: General Release Critical: Yes PHNE_9758: ABORT HANG PHNE_7772: ABORT CORRUPTION PHNE_7230: ABORT Path Name: /hp-ux_patches/s700_800/10.X/PHNE_9758 Symptoms: PHNE_9758: (1) 1653184846 After cutting some text from the emulator window, you cannot successfully paste it back into the same window - you get corrupted characters. (2) 1653185942 TN3270 does not allow a NOP (No Operation in the datastream. The RFC854 Telnet Protocol Specification defines this as a valid operation and is used by some servers to test for the continued presence of a TN3270 client. (3) 1653192138 Symptoms of problem: TN3270 can core dump when sending data to the host. An API trace will show the last thing to be sent > 1K (4) 1653195859 The Motif emulator pull down menus (and the menubar itself) refer to function keys - however these do not work when a session is active, because the keys are remapped to be host PF keys. (5) 1653201095 In xtn3270 an underline is not cleared when the screen is overwritten with some fonts. (6) 1653205682 Poor performance in tn3270 (4.3),particularly when compared to xtn3270. (7) 1653206698 When an application has issued START_HOST_NOTIFY and then issues a PAUSE verb, the PAUSE verb only polls for status changes once every second. Delays can be seen between something happening and the PAUSE completing. (8) 1653208215 If there are not enough semaphore UNDO structures available, 3270 can hang when the user tries to activate a session. (9) 5003360552 If you have a HLLAPI application doing keyboard intercept, then after the 128th key is pressed by the emulator user, further calls to getkey by the hllapi app will return immediately (whether or not a key is pressed) - and the keys returned will cycle through the 128 you have just typed. (10) 5003368696 If a host sends RMA in 3270 datastream it will be bounced by TNSERVER and the session unbound. If RMA ever sent by another TN Server to our TN3270 client it will be rejected. (11) 5003368910 After the patch was installed two problems were encountered: 1-The snap3270 and xsnap3270 executables were deleted. 2-libmgr.1 was replaced by libtnmgr.1. (12) 5003371435 Style file print utility doesn't work with back level style files. (13) 5003386763 If TN3270 is unable to get an LU from TN Server, then it's CPU utilisation increases because it enters a hard loop retrying PHNE_7772: (1) 1653132407 TN3270 records a PROGRAM error 472 when receiving a write structured field (WSF) query request. When the failure occurs the following is logged in the client sna.aud file: 05/19 09:01:15 sna 3270 10 SNA0420: (30C) PROG check 472 reported (2) 1653166561 When using the tn3270 external table option '-t', previously saved keymappings are not used. (3) 1653166819 xtn3270 (motif tn3270) cannot map keys to keys that pertain to the numeric keypad. (4) 1653169169 HLLAPI applications using TN3270 running in background, lose communication with the emulator when the parent shell is exited. TN3270 is launched using the '-b' option. The HLLAPI applications receive the return code: HARC_STR_NOT_FOUND_UNFM_PS (5) 1653172395 A TN3270 process launched in the background ('-b' option) consumes 98% of CPU when the shell that launched the process dies. (6) 4701313593 There was a limitation that COPYPROT was not available in HLLAPI. (7) 5000714089 Customer's printouts were not formatted correctly due to form feeds being added at the SNALU1MPP default values. (8) 5000715680 Printing double byte datastream can result in print jobs appearing to hang. If printing is performed to a file, the formatted or unformatted output file grows indefinitely. Problem is very intermittent and dependent on the datastream from the host. (9) 5003312686 When sending numeric data to a protected numeric field, snaplus hllapi failed with a sendkey error 9. (10) 5003316075 R3 snaplus 3270 print filters put CR/FF sequence in output file when only a single FF is received from the host. (11) 5003324368 TN3270 core dump when F3 or Enter is pressed while entering formatted fields. (12) 1653153494 The keypad does not work with xtn3270. This patch fixes that problem. PHNE_7230: (1) 1653140194 snap3270 still is not able to print up to 250 characters like it is supposed to. the max is apparently 197 characters per line. (2) 1653147942 The HLLAPI WAIT function exhibits a delay (5, 10, 15 seconds) when it should return immediately. This delay only occurs when the PS goes from being locked to being unlocked. Also, the PAUSE timeout value is interpreted as seconds instead of half seconds as documented. (3) 1653152595 3270 core dumps when trying to open a style file after having opened the snap3270.stu style file. (4) 1653155689 Extended characters were not usable within Motif version of 3270. (5) 1653160846 The user runs xsnap3270. Then goes to Key definitions in the Customize menu to change the mapping of characters. Then selects one character to redefine the mapping. The window pops up where the user is asked to press the key which should correspond to the character. After he has pressed the key xsnap3270 dumps if the session is active. If the session is not active xsnap3270 first hangs and dumps after the user pressed a key several times. (6) 1653163006 The print functions of snap3270 do not work in the R4.2 release. (7) 4701307876 The command line programs, snapsend and snapreceive only allowed a total command line length of 129 characters which was not enough for some customers' needs. (8) 5003285031 The customer is distracted by the movement of the focus along the function keys. (9) 5003301358 3270 is not allowing spaces to be valid input in numeric fields. (10) 5003304451 The snap3270 program core dumps when trying to deal with READ BUFFER command from host. (11) 5003307512 R3 snaplus 3270 print filters put CR/LF sequence in output file when only single LF is received from the host. Defect Description: PHNE_9758: (1) 1653184846 Items from the screen are stored in the cut buffer in ASCII. The fix was to ensure that these are converted back into EBCDIC before putting onto the emulator screen when the user hits paste. (2) 1653185942 This functionality was missing from our implementation of TN3270. The code has been modified so that we support the NOP command. (3) 1653192138 A fix had previously been applied which was ported from snap3270 to increase the maximum inbound RU size . Unfortunately this does not apply to tn3270 ,and so the fix has been backed out. (4) 1653195859 Remove references to the function keys from the menu bar. (5) 1653201095 Corrected cell height so we do not draw underline below the cell (we draw on bottom line of the cell). Also corrected typing on top of underlined text which can cause dotted line (lost pixel) with some fonts by removing incorrect offset of lbearing. (6) 1653205682 The code was modified to not call select if there was inbound work pending. (7) 1653206698 Modify the emulator so that it signals the HLLAPI application using SIGUSR1 every time the PS or OIA is updated if the HLLAPI application has issued a start_host_notify verb on the session which was updated. Note that this means that a signal will be issued whether or not the application is actually sitting in a PAUSE verb (8) 1653208215 The code has been changed to log an error when this problem occurs, and return control to the User Interface. (9) 5003360552 The code change has been made to correctly put keystrokes into the cyclic keyboard buffer, rather than spilling off the end. (10) 5003368696 Pass through RMA unmodified if received at TN Server or TN3270. (11) 5003368910 The problem was caused by the patch postinstall script which checked for existence of SNAplus fileset SNAP-3270 and SNAP-3179 via the command: 'swlist -l product | grep SNAP-3270' (not exact syntax). This failed with SNAplus2 because the 3270 fileset is named SNAplus2-3270. (12) 5003371435 Remove Error messages and print helpful message telling user how to update the style file. (13) 5003386763 The code has now been changed to implement the retry on a timer, rather than indefinitely. PHNE_7772: (1) 1653132407 Code change needed to resolvee RPQ (Read Partition Query) response. (2) 1653166561 tn3270 was coded so that previously saved keymappings were not read in from the style file when the '-t' option was used. (3) 1653166819 The xtn3270 code did not intercept key symbols generated by pressing keys on the numeric keypad. This happens only with xtn3270 (a Motif environment). (4) 1653169169 This fix required coding changes. (5) 1653172395 The tn3270 code handling input for the keyboard and TCP/IP sockets needed to be modified. (6) 4701313593 There was a limitation that COPYPROT was not available in HLLAPI. (7) 5000714089 The printer filter files forced form feeds at the SNALU1MPP default value even if host application did not call for one. (8) 5000715680 The problem here is a straightforward bug in 3270's handling of double byte LU1 datastream. If a double byte character is split across the segment or RU boundary, then the scheduler within 3270 does not correctly handle this - the code gets into the wrong state, and loops infinitely continually outputing incorrect characters. (9) 5003312686 There is a limitation in the R3 version of the hllapi function Send Key. (10) 5003316075 The Form Feed code was converted to a CR/FF instead of just a FF in R3 and R4 versions of the printer filter programs. (11) 5003324368 Field formatting done incorrectly. (12) 1653153494 The keypad does not work with xtn3270. However, the keypad works with tn3270. PHNE_7230: (1) 1653140194 3270 line buffer was not large enough to handle 250 characters. It has been enlarged to do so. (2) 1653147942 3270 was occasionally missing a signal so it waited until the 5 second ticker timed out. The problem has now been fix so that signals are not missed. And the Pause timeout value is now correctly interpreted as half-seconds. (3) 1653152595 Opening the snap3270.stu style file was causing some corruption that resulted in a core dump the next time a style file was opened. (4) 1653155689 Extended characters were not properly handled within the Motif version of 3270. (5) 1653160846 Motif version of 3270 was not doing key-mapping properly for extended characters. (6) 1653163006 This was due to a limitation in the R4.2 version of the program. (7) 4701307876 snapsend only had enough space to take in 129 characters off the command line. This has been increased to 250. (8) 5003285031 When the pointer is outside the emulator window, the UI also picks up and interprets when arrow keys are pressed. This causes the focus to change to the next (previous) button in the application. (9) 5003301358 This is due to a limitation in the 3270 versions R3 and R4. (10) 5003304451 The R4.1 version of snap3270 program has a limitation trying to deal with READ BUFFER command from host. (11) 5003307512 The NL code was converted to a CR/LF instead of just a LF in R3 and R4 versions of the filter programs. SR: 5003386763 5003371435 5003368910 5003368696 5003360552 5003324368 5003316075 5003312686 5003307512 5003304451 5003301358 5003285031 5000715680 5000714089 4701313593 4701307876 1653208215 1653206698 1653205682 1653201095 1653195859 1653192138 1653185942 1653184846 1653172395 1653169169 1653166819 1653166561 1653163006 1653160846 1653155689 1653153494 1653152595 1653147942 1653140194 1653132407 Patch Files: /opt/tn3270/lib/X11/C/uid/XTn3270/main.uid /opt/tn3270/lib/X11/C/uid/XTn3270/mainf.uid /usr/include/sna/tnhapi_c.h /usr/include/sna/tnsvconfig.h /opt/tn3270/bin/tnprtsty /opt/sna/lib/libtnhapi.1 /opt/sna/lib/libtnmgr.1 /opt/tn3270/bin/X11/xtn3270 /opt/tn3270/bin/X11/xtn3270ui /opt/tn3270/bin/tn3270 /opt/tn3270/bin/tn3270ui /opt/tn3270/bin/tnreceive /opt/tn3270/bin/tnsend what(1) Output: /opt/tn3270/bin/tnsend: A.10.10.201 SNAplus R4.3 Command-line File Transfer SEND (TN) (PHNE_9758 : 96/12/05 19:13:18) /opt/tn3270/bin/tnreceive: A.10.10.201 SNAplus R4.3 Command-line File Transfer RECEIVE (TN) (PHNE_9758 : 96/12/05 18:54:45) /opt/tn3270/bin/tn3270: A.10.10.302 SNAplus R4.3 TN3270 Emulator program (PHNE_9758 : 97/09/15 15:22:57) A.10.10.300 SNAplus R4.3 Utility Library (PHNE_9758 : 97/06/03 17:42:29) /opt/tn3270/bin/X11/xtn3270: A.10.10.302 SNAplus R4.3 Motif TN3270 Emulator progr am (PHNE_9758 : 97/09/15 15:32:16) A.10.10.300 SNAplus R4.3 Utility Library (PHNE_9758 : 97/06/03 17:42:29) /opt/tn3270/bin/tn3270ui: A.10.10.301 SNAplus R4.3 TN3270 User Interface progr am (PHNE_9758 : 97/09/15 15:29:59) A.10.10.300 SNAplus R4.3 Character Windows Library (PHNE_9758 : 97/06/03 17:15:54) A.10.10.300 SNAplus R4.3 Help Engine Library (PHNE_9758 : 97/06/03 17:18:22) A.10.10.300 SNAplus R4.3 Utility Library (PHNE_9758 : 97/06/03 17:42:29) /opt/tn3270/bin/X11/xtn3270ui: A.10.10.301 SNAplus R4.3 Motif TN3270 User Interface program (PHNE_9758 : 97/09/15 15:43:06) A.10.10.300 SNAplus R4.3 Help Engine Library (PHNE_9758 : 97/06/03 17:18:22) A.10.10.300 SNAplus R4.3 Utility Library (PHNE_9758 : 97/06/03 17:42:29) A.10.10.300 SNAplus R4.3 Character Windows Library - Motif version (PHNE_9758 : 97/06/03 19:17:54) /opt/tn3270/lib/X11/C/uid/XTn3270/main.uid: None /opt/tn3270/lib/X11/C/uid/XTn3270/mainf.uid: None /opt/sna/lib/libtnhapi.1: A.10.10.203 SNAplus R4.3 HLLAPI Library (PHNE_9758 : 97/04/03 13:34:41) /opt/sna/lib/libtnmgr.1: A.10.10.201 SNAplus R4.3 Tools Library (PHNE_9758 : 96/12/13 10:56:24) /usr/include/sna/tnsvconfig.h: None /usr/include/sna/tnhapi_c.h: None /opt/tn3270/bin/tnprtsty: A.10.10.300 SNAplus R4.3 TN3270 Style File Text Outp ut (PHNE_9758 : 97/06/12 16:43:54) cksum(1) Output: 1716504224 20480 /opt/tn3270/bin/tnsend 2113748077 20480 /opt/tn3270/bin/tnreceive 2195960511 499712 /opt/tn3270/bin/tn3270 862108736 581632 /opt/tn3270/bin/X11/xtn3270 948035086 356352 /opt/tn3270/bin/tn3270ui 1468234794 495616 /opt/tn3270/bin/X11/xtn3270ui 4023978946 49152 /opt/tn3270/lib/X11/C/uid/XTn3270/main.uid 1301195471 49152 /opt/tn3270/lib/X11/C/uid/XTn3270/mainf.uid 2942956622 77824 /opt/sna/lib/libtnhapi.1 2486267181 106496 /opt/sna/lib/libtnmgr.1 3598023028 1373 /usr/include/sna/tnsvconfig.h 1168398094 10568 /usr/include/sna/tnhapi_c.h 4188266204 90235 /opt/tn3270/bin/tnprtsty Patch Conflicts: None Patch Dependencies: None Hardware Dependencies: None Other Dependencies: None Supersedes: PHNE_7230 PHNE_7772 Equivalent Patches: None Patch Package Size: 2380 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_9758 5a. For a standalone system, run swinstall to install the patch: swinstall -x autoreboot=true -x match_target=true \ -s /tmp/PHNE_9758.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_9758.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_9758. 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_9758.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_9758.depot of=/dev/rmt/0m bs=2k Special Installation Instructions: Please NOTE: This patch is for OS release 10.10 TN3270 version A.10.10.000 only. If you have this TN3270 version installed on your 10.20 system, then please update to Dart34 TN3270 version A.10.20.001 and apply 10.20 TN3270 patches. No SNAplus 3270/3179G fixes are included in this patch. If you require fixes to these products, please also install patch PHNE_7873.