Patch Name: PHNE_20810 Patch Description: s700_800 10.20 R6.10.20 TN3270 cumulative patch Creation Date: 00/01/19 Post Date: 01/07/25 Hardware Platforms - OS Releases: s700: 10.20 s800: 10.20 Products: TN3270 R6.10.20; 3270-Common R6.10.20 Filesets: TN3270.TN3270,R6.10.20.000,R6.10.20.010 3270-Common.MANAGERS,R6.10.20.000,R6.10.20.010 3270-Common.3270,R6.10.20.000,R6.10.20.010 Automatic Reboot?: No Status: General Release Critical: No (superseded patches were critical) PHNE_17704: ABORT Path Name: /hp-ux_patches/s700_800/10.X/PHNE_20810 Symptoms: PHNE_20810: (1) JAGab84956/8606112613 A customer application linked with libmgrdce.1 library stopped working with no errors reported. (2) JAGab83645/8606110894 Application cannot reconnect to HLLAPI session after killing 3270 program. The hllapi verb connect_ps() fails with HARC_SYSTEM_ERROR, and extended error code1 = 2000 and extended error code2 = 0000. (3) JAGab76502/8606106970 Error logs SNA0447 (R4) activating session in xsnap3270 and processes not cleaned up on termination. (4) JAGab71689/8606105222 The following message is noted periodically in sna.err file: 10:07:29 EDT 09 Aug 1999 4096-5(0-0) P (UH2010D3) PID 3733 (snaperrlog)Log parameter mismatch. Message number = 512 - 137 The message 512 - 137 then follows with a question mark for the sense code. (5) JAGab70700/8606106276 If you are using 3270 with LANG set to de_DE.roman8 on a character terminal, then the terminal goes into file transfer mode whenever the host locks the 3270 keyboard. This is a revisit of SR 165300756 - the fix for this SR should have also been applied to the MOTIF emulators, the CSV library and the style file printers. Other symptoms that have been seen include the sending of incorrect control fields to the host during file transfer - i.e. additions of P() and H() parameters to the IND$FILE command. (6) JAGab68603/8606102678 Shell constructs do not work in 3270 printer menu (for example, set printer name to 'tail -2 | lp' - this fails) (7) JAGab65305/1653308163 Trying to use the -fasttype option on xsnap3270 SNAPLUS2 R6.0 results in the following: Warning: I18NOpenFile: Could not open file mainnlsf.uid - MrmNOT_FOUND Could not open Motif Mrm hierarchy The emulator then fails to start. This option worked on the SNAPLUS 9.04 version of xsnap3270. PHNE_18919: (1) JAGab65525 If you have a window where you use 'rlogin' to get to a machine, and start tn3270 in the background then exit from the rlogin shell, the CPU usage of tn3270 increases to 100%. The problem does not occur if you perform the same test using telnet to log in to the machine. (2) JAGab65522 A difference in behaviour of snap3270 between SNAplus2 and SNAplus occurs when running with the option not to display the status bar at startup. In SNAplus running on HP-UX 9.04, the bar is displayed when a 'Do not enter: wait' condition (symbolised by 'X()') occurs. (This is typically when the user has entered a command to the host and is waiting for a response.) In SNAplus2 R6, the status bar is not brought up in these circumstances (although it is displayed for most other 'Do not enter' conditions, such as trying to type text on a part of a host screen that is outside an entry field). (3) JAGab65398 Issuing HA_COPY_PS immediately after a PAUSE verb completes can occasionally return LOCKED when this is not true. (4) JAGab65392 This is a potential problem that applies to any SNAPlus2 multi-threaded application that requires to use signals and can cause the application to fail because of incorrect signal handling behaviour. (5) JAGab65297 A customer defines more than 16 LU0-3 type LUs, then stops and starts SNAplus2 but does not activate the node. Subsequent attempts to start xsnapadmin cause the config daemon to terminate. (6) JAGab65295 If you are using 3270 with LANG set to de_DE.roman8 on a character terminal, then the terminal goes into file transfer mode whenever the host locks the 3270 keyboard. (7) JAGab65289 Invokable TP failing to start with following error messages logged. ------------- 10:52:14 GMT 10 Feb 1999 ---------------- NODE Message 16384 - 0, Subcode: 10 - 10 Log category: EXCEPTION Cause Type: Internal System: LR1875 Internal system error. Errno = 7 Action: Provide support services with the audit and error log files, and trace files if available. ------------- 10:52:14 GMT 10 Feb 1999 ---------------- APPN Message 512 - 257, Subcode: 0 - 10 Log category: PROBLEM Cause Type: Config System: LR1875 Dynamic load of TP failed. Sense code = 0x07000000 LU alias = DFKC TP name = lr229bci PHNE_17704: (1) 5003455253 When a SIGTERM signal is sent to HLLAPI program it core dumps, and cma_dump.log is produced. (2) 5003434563 In Motif versions of 3270, attempts to move cursor with mouse do not work on formatted screens. (3) 4701421081 Running a SNAPlus2 API using Java Native Interface (JNI) within a Java Virtual Machine (JVM) will hang, calling getmsg() in the path manager. The problem is seen when using CPI-C within HP JVM. The problem is that even though the path manager calls fcntl to make the stream to the router non-blocking, this does not affect getmsg() and so the path manager still hangs. (4) 4701414615 File transfer in the background mode triggers a core dump. (5) 4701405316 Updated binaries required for patching the latest R6 release of SNAplus2. (6) 1653297457 When 'suppress host screens at startup' 3270 style file option is turned on, HLLAPI verb HA_DISPLAY_ON turns display on but does not re-enable the keyboard. PHNE_15720: (1) 5003420414 If you have an unformatted PLU screen, you cannot enter a double byte character. (2) 5003420364 Customer had an SNAPlus application which used SIGUSR1. This is not officially supported in SNAplus2 (and this is clearly documented). (3) 5003418913 If you have START_HOST_NOTIFY in operation, and issue a PAUSE verb (with IPAUSE selected), then the PAUSE verb can complete - and QUERY_HOST_UPDATE will return PS_UPDATED but COPY_PS shows no change. (4) 4701396408 Japanese Motif 3270 exits when you enter the RTM screen. (5) 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. PHNE_14649: (1) 4701387142 tn3270 does not work if $LANG set to Japanese - you get a message saying that the file /opt/tn3270/lib/nls/msg/$LANG/mesg3270 cannot be found ($LANG can be any of the Japanese language settings). Defect Description: PHNE_20810: (1) JAGab84956/8606112613 A call to sigprocmask was added to the libmgrdce.1 library ( see SR4701424069 ). This fix was put in to stop signals flowing up the path manager or HLLAPI threads. This was to ensure that signals would only be processed by the user's application not by SNAplus2 libraries. However, the behaviour of sigprocmask under DCE threads is different to that under kernel threads. With kernel threads the call blocks only signals on the particular thread. Under DCE threads, the call blocks signals for the entire process resulting in the customer's signal catcher never being called. Resolution: Modify the previous fix to take into account situations where we are using DCE threads. On 10.20 this is straight forward as we know at compile time whether a library is to be used with DCE threads or not. On 11.0 use the _CMATHREADS macro to make a run-time decision on whether we are using DCE threads or not. If using DCE, don't do any signal blocking, otherwise block signals as in the previous fix. (2) JAGab83645/8606110894 Shared memory not correctly detached from library following unload/load of 3270 program. Resolution: Correctly detach shared memory from library and then connect to fresh shared memory. (3) JAGab76502/8606106970 Error in application of a previous fix, 1653208215. In a slow environment such as with Motif emulator it is possible that the code does not retry getting the semaphore that locks keyboard access between the emulator and UI. Resolution: Corrected code to ensure a retry is always attempted when getting the semaphore . (4) JAGab71689/8606105222 From the code it appears that there is not really a parameter mismatch, but it looks as though the problem is due to us trying to log more text than we actually allow. We are limited by a 600 byte array of log text in nba_pd_print_var. Resolution: The log parameters are limited to 600 bytes to allow all of the log datagram to fit in a 1k buffer for use by the SLIM. Consequently, we can't change this 600 byte limit. Instead, for the particular log mentioned in this defect, we should ensure that the sense code gets put into the buffer before the error data (that way we will ensure we get all of the sense code). This will also stop the erroneous messages in the log file as we will be logging all of the parameters. (5) JAGab70700/8606106276 A problem in the ASCII to EBCDIC translation tables used for German meant that the symbol ')' which we write to the screen when the host locks the 3270 keyboard was not being translated correctly to ASCII. The incorrect translation meant that we output a control code instead of ')', and this caused the terminal to switch into the file transfer state! When using German ISO88591 the problem was not as serious, but the bug still existed - the '()' symbol is displayed as '(-' instead. Resolution: Correct the EBCDIC to ASCII translation code for German codepage 273. (6) JAGab68603/8606102678 Caused by incorrect parsing of the string which means that we call 'exec' with the entire string, rather than invoking a shell to parse the string. Resolution: Invoke a shell to parse the command string and run the command - rather than executing the program directly. (7) JAGab65305/1653308163 In Release 4 and previous of SNAPLUS, the F3, F5 and F6 keys acted as 'accelerator keys' to jump to 'File/Exit', 'Customise/Key Definitions' and 'Control/File Transfer' menus. Obviously this functionality was not desired once in a session to the host, where the function keys are used as PF keys. The fasttype option stopped the behaviour once in session. On R6 the accelerator functionality was removed, but there was still code in the emulator to parse the fasttype option and attempt to act on it. The missing UID file referred to is the UID file that was supposed to be used with the fasttype option. As R6 did not require this functionality, the UID file was not supplied for this release. Resolution: The fasttype option has now been retired, but for compatability the option will still be allowed as an option on the xsnap3270 command. No action will be taken when this option is set, and in particular, the loading of the alternate UID file will not be performed. PHNE_18919: (1) JAGab65525 There is a problem with the select() call, where once the login shell has terminated, if you pass select() a file descriptor for the keyboard it returns 'data available' rather than an error condition. Resolution: To workaround the problem with the select() call, we have simply made a fix to tn3270 to prevent it from passing the keyboard file descriptor to select() if we are running in the background. This ensures that the issue will never be hit. (2) JAGab65522 This behaviour is one of the 3270 emulator options that can be turned on and off at compile time through a compiler #define flag -- ie a -D option for cc. It seems that, at some stage during the development of SNAplus2 a change was made to default the emulator behaviour to the opposite of what it was in SNAplus. Resolution: A minor modification to one of the scripts used to build the product is all that is required to turn this compile option on again. (3) JAGab65398 If a HLLAPI application issues HA_COPY_PS immediately after issuing PAUSE, then on a fast MP machine there is a tiny timing window where the COPY_PS verb is processed by the emulator before it has finished processing the message which casued the PAUSE verb to complete. This means that the emulator has not yet unlocked the keyboard/PS, despite the fact that the host message contained an unlock instruction - and so incorrect status can be returned on the COPY_PS verb (although the PS is correctly returned). Resolution: Check for EBI on a received message, and unlock immediately upon processing, rather than waiting for the internal BETB message from the bracket FSM. (4) JAGab65392 The issue stems from the way signals are handled in a multi-threaded process. The default signals behaviour in a multi-threaded environment is that any thread of a process can be interrupted by the OS to run a signal handler when an externally-generated signal is received for that process. In particular, this means that any threads created for internal use by the SNAplus2 libraries (eg in the path manager to wait for messages to appear at the stream head) could be interrupted and used by the OS to handle a signal sent to a multi-threaded user application. This could potentially happen at a point where the application has masked off its own threads from being interrupted by signals. In such a case, the application might fail because its signal processing routine was being run when it did not want it to be. Resolution: The fix is to modify the multi-threaded path manager and HLLAPI libraries so that the new threads they create protect themselves against being interrupted by external signals. To do this, we just need to make the appropriate call to sigprocmask() at the start of the new thread of execution. (5) JAGab65297 SNAplus2 is getting an error with errno set to ERANGE on a STREAMS call in the path manager. It turned out this error is because the customer's machine is configured to have the maximum STREAMS message size (STRMSGSZ) of 8K configured in the kernel. The solution is to remove this limit (or set it to at least 64K). Resolution: The resolution for the customer is to increase the STRMSGSZ kernel parameter.However the SNAPlus error log was incorrectly recorded. The correct log message was already included in the code,but did not reach the sna.err file because it was being made after the call to vpm_error_event(). The solution is simply to move it from the subsequent line to the preceding one. This ensures that the error log does get written out correctly as follows.- SNAPATH Message 16388 - 13, Subcode: 1 - 1 Log category: EXCEPTION Cause Type: External System: borg Process ID: 1155 (snapcfgdae) I/O Error writing message to Stream. Errno = 34 (Result too large) Cause: The Stream to the SNA Subsystem has reported a write error. Action: Check the operating system error code shown, and retry the operation that led to this message. If the problem persists, provide support services with the audit and error log files, and trace files if available. (6) JAGab65295 A problem in the ASCII to EBCDIC translation tables used for German meant that the symbol ')' which we write to the screen when the host locks the 3270 keyboard was not being translated correctly to ASCII. The incorrect translation meant that we output a control code instead of ')', and this caused the terminal to switch into the file transfer state. When using German ISO88591 the problem was not as serious, but the bug still existed - the '()' symbol is displayed as '(-' instead. Resolution: Correct the EBCDIC to ASCII translation code for German codepage 273. (7) JAGab65289 The TP is failing to start because the userid under which it is running has been misconfigured so that it can't retrieve its own group name. This may be due to local access to the group file or with running NIS (Network Information Service) to share user and group IDs across more than one machine. There are two reasons for the cryptic error logs recorded by SNAplus2:- - Failure of the getpwuid() or getgrgid() system calls was not logged as an error message. - The VSM_AS_TP_FAILURE internal error code was not getting put in the right part of the DLOAD_RSP_ERR message sent from the Service Manager to the APPC Stub. This meant that the APPC stub was misinterpreting it as an APPC sense code. Resolution: The root cause of the problem is to correctly configure the Unix user/group under which the TP is to be run. However changes to SNAplus2 have been made to improve the logging in this area as follows:- In vpm_build_user_info() in vr/vpmu.c we add error logs for the cases where getpwuid() or getgrgid() system calls fail. However, failure of these system calls leads to a path failure. So to make sure these new error logs actually reach the sna.err log file, we also modify vlm_user_write_log() in vdiag/vlmuser.c so that even if we fail to open a path we still attempt to send the datagram containing the log (in addition to attempting to write it locally). In the error reply arm of vsm_rcv_dload_confirm() in vr/vsmdload.c we put the error code in the dld_status field rather than the ld_sense_data field of the DLOAD_RSP_ERR message -- because this is where the vas_datagrams() routine in the APPC Stub expects to find it. We also change the exception logged in vsm_rcv_dload_confirm() from the generic one, with its rather misleading reference to errno to a new specific error. Texts of the new logs are in the vdiag/*.txt files. PHNE_17704: (1) 5003455253 The SIGTERM signalling problem is caused by an interaction with the DCE threaded library which the HLLAPI library is linked with. We need to provide a single-threaded R6 version of the HLLAPI library for HP-UX 10.20. Resolution: Currently we provide the following objects: HP-UX 10.20 ----------- libhapi.0 R5 compatible, single threaded libhapi.1 (libhapi.sl link) R6 multi-threaded (DCE threads) HP-UX 11.0 ---------- libhapi.0 R5 compatible, single threaded libhapi.1 R6 10.20 compatible (DCEthreads) libhapi.2 (libhapi.sl link) R6 multi-mode pa20_64/libhapi.2 R6 multi-mode 64-bit. Fix is to modify the build system etc so we build the following: HP-UX 10.20 ----------- libhapi.0 R5 compatible, single threaded libhapi.1 (libhapi.sl link) R6 single threaded libhapi_r.1 (libhapi_r.sl link) R6 multi-threaded (DCE threads) HP-UX 11.0 ---------- libhapi.0 R5 compatible, single threaded libhapi.1 R6 10.20 compatible, single threaded libhapi_r.1 (libhapi_r.sl link) R6 10.20 compatible (DCE threads) libhapi.2 (libhapi.sl link) R6 multi-mode pa20_64/libhapi.2 R6 multi-mode 64-bit. (2) 5003434563 In motif versions of 3270, mouse control of the cursor did not work. Resolution: Code changed to ensure that the delimeters of the current field are also set up when the cursor is moved with the mouse. (3) 4701421081 The root cause of this Java hang is believed to be a bug in the HP JVM ,however a workaround has been found by implementing a code change in the SNAPlus2 library. Note that since the workaround within SNAPlus2 requires changes to the customer's code, other customers may also hit the same issue and so we should still pursue a fix for the underlying JVM problem with the Java team. Resolution: This fix is a workaround to the problem. It forces the path manager not to rely on the stream being non-blocking. In particular, vpm_sleep() should check the wait condition after every call to vpm_rcv_from_stream(). This can be done by using the vpm_io_limit to limit the number of calls to vpm_rcv_from_stream which we make before checking the wait condition. This requires the application to call SNA_SET_IO_LIMIT(1); before it makes any call to the API libraries. (4) 4701414615 In the NLS version of all SNAplus 3270 emulators we attempt to free off two blocks of memory during character translation. However, it is possible to reach these free() calls in error cases where either or both these memory blocks has not been successfully allocated, causing a situation where a core dump can occur. Resolution: Solution is a code change to initialise the pointers to NULL and check whether they still hold this value before attempting to free them. (5) 4701405316 Updated binaries provided for combined patching of latest R6 release ,as documented in SR text. Resolution: Updated binaries for patching on SNAplus2 releases R6.10.20.100 and R6.11.00.100. (6) 1653297457 Cause of problem: The style file option turns off the screen by doing the equivalent of the HA_DISPLAY_OFF HLLAPI verb at start of day. However, it turns off the keyboard by doing only part of what the HA_START_KEYBOARD_INTERCEPT HLLAPI verb would do. It creates a keyboard intercept buffer, but does not assign it an owning process. (It can't do this because the HLLAPI program won't necessarily be running at the time the emulator screen is enabled.) So if a HLLAPI program wants to access the keyboard it must still issue HA_START_KEYBOARD_INTERCEPT. Resolution: This fix is is based on the assumption that the HLLAPI program should issue HA_DISPLAY_ON when it wants to turn on the keyboard and display ,that have been disabled by the 'Host screens suppressed at startup' style file option. So, the first time this is issued the emulator must enable the keyboard too -- unless another application is using the keyboard intercept buffer (ie has issued HA_START_KEYBOARD_INTERCEPT in the meantime). PHNE_15720: (1) 5003420414 It is unclear from IBM's documentation whether or not this should be allowed. However, if the character is invalid according to the host application then it will be rejected. SNAplus2 or tn3270 preventing the user from entering it. (2) 5003420364 Add an environment variable 'DISABLEPAUSEFIX' which removes the fix for SR 1653206698 (this altered the way SNAplus2 uses signals) and returns the behaviour of the code to the way it worked in SNAPlus R3/R4. The environment variable must be set = 1 ie. DISABLEPAUSEFIX=1 to get this behaviour. (3) 5003418913 Code change to ensure we do not notify HLLAPI application unless the PS has actually been altered. (4) 4701396408 Code change made to initialize a floating variable that is used to select the UI font. This fixes a bug where Japanese Motif 3270 exits when you enter the RTM screen. (3179g and tn3270 also recompiled because they could hit the bug if the app-defaults file was deleted.) (5) 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 PHNE_14649: (1) 4701387142 The tn3270 product was not localised for Japanese, so code changed to not look for the localised files! Use the English versions. SR: 8606112613 8606110894 8606106970 8606106276 8606105222 8606102678 5003455253 5003434563 5003420414 5003420364 5003418913 4701421081 4701414615 4701405316 4701396408 4701387142 1653308163 1653297457 1653206698 Patch Files: /opt/sna/include/values_c.h /opt/tn3270/samples/TN3270_patch.notes /opt/tn3270/sna_log.msg /opt/sna/bin/snapprtsty /opt/sna/lib/libcsv.1 /opt/sna/lib/libhapi.0 /opt/sna/lib/libhapi.1 /opt/sna/lib/libhapi_r.1 /opt/sna/lib/libsna.1 /opt/tn3270/bin/X11/xtn3270 /opt/tn3270/bin/X11/xtn3270ui /opt/tn3270/bin/tn3270 /opt/tn3270/bin/tn3270ui /opt/tn3270/lib/libmgr.1 what(1) Output: /opt/tn3270/bin/tn3270: HP92453-02A.10.00 HP-UX SYMBOLIC DEBUGGER (END.O) $R evision: 74.03 $ ]R6.10.20.108 SNAplus2 R6 3270 Emulator program - TN 3270 only - NLS ] (PHNE_20810 : 99/10/26 18:21:22) ] /opt/tn3270/bin/tn3270ui: HP92453-02A.10.00 HP-UX SYMBOLIC DEBUGGER (END.O) $R evision: 74.03 $ ]R6.10.20.103 SNAplus2 R6 3270 User Interface progra m - TN3270 only - NLS ] (PHNE_20810 : 99/10/26 18:24:34) ] /opt/tn3270/bin/X11/xtn3270: HP92453-02A.10.00 HP-UX SYMBOLIC DEBUGGER (END.O) $R evision: 74.03 $ ]R6.10.20.107 SNAplus2 R6 3270 Emulator program - TN 3270 only - Motif - NLS ] (PHNE_20810 : 99/10/26 19:27:41) ] /opt/tn3270/bin/X11/xtn3270ui: HP92453-02A.10.00 HP-UX SYMBOLIC DEBUGGER (END.O) $R evision: 74.03 $ ]R6.10.20.104 SNAplus2 R6 3270 User Interface progra m - TN3270 only - Motif - NLS ] (PHNE_20810 : 99/10/26 19:33:04) ] /opt/sna/lib/libhapi.0: ]R6.10.20.102 SNAplus2 R6 HLLAPI Verb Library -- Sin gle-threaded, R5 compatible ] (PHNE_20810 : 99/11/22 16:33:08) ] /opt/sna/lib/libhapi.1: ]R6.10.20.102 SNAplus2 R6 HLLAPI Verb Library -- Sin gle-threaded ] (PHNE_20810 : 99/11/22 16:31:18) ] /opt/sna/lib/libhapi_r.1: ]R6.10.20.104 SNAplus2 R6 HLLAPI Verb Library -- DCE multi-threaded ] (PHNE_20810 : 99/12/06 12:04:41) ] /opt/sna/bin/snapprtsty: HP92453-02A.10.00 HP-UX SYMBOLIC DEBUGGER (END.O) $R evision: 74.03 $ ]R6.10.20.101 SNAplus2 R6 3270 Style File Text Outpu t - NLS ] (PHNE_20810 : 99/08/20 15:52:02) ] /opt/tn3270/lib/libmgr.1: ]R6.10.20.102 SNAplus2 R6 Path Manager and support l ibraries (V3 Signals) ] (PHNE_18919 : 99/04/22 11:11:56) ] /opt/sna/lib/libsna.1: ]R6.10.20.103 SNAplus2 R6 Standard Path Manager and support libraries, User Space ] (PHNE_18919 : 99/04/22 11:03:35) ] /opt/sna/lib/libcsv.1: ]R6.10.20.101 SNAplus2 R6 Common Service Verb Librar y Routines ] (PHNE_20810 : 99/08/20 16:01:10) ] /opt/sna/include/values_c.h: None /opt/tn3270/sna_log.msg: ]6.0.0-Wed_Sep_15_19:06:52_BST_1999_Message_file /opt/tn3270/samples/TN3270_patch.notes: None cksum(1) Output: 762677412 736896 /opt/tn3270/bin/tn3270 3678648987 372352 /opt/tn3270/bin/tn3270ui 3848849604 847488 /opt/tn3270/bin/X11/xtn3270 3808684933 519808 /opt/tn3270/bin/X11/xtn3270ui 3291621192 118784 /opt/sna/lib/libhapi.0 1232856600 118784 /opt/sna/lib/libhapi.1 1805568415 122880 /opt/sna/lib/libhapi_r.1 2257651432 102016 /opt/sna/bin/snapprtsty 1453696510 315392 /opt/tn3270/lib/libmgr.1 3704193804 311296 /opt/sna/lib/libsna.1 1567016166 98304 /opt/sna/lib/libcsv.1 2934331960 182482 /opt/sna/include/values_c.h 2445621088 693253 /opt/tn3270/sna_log.msg 2963682441 1966 /opt/tn3270/samples/TN3270_patch.notes Patch Conflicts: None Patch Dependencies: None Hardware Dependencies: None Other Dependencies: None Supersedes: PHNE_14649 PHNE_15720 PHNE_17704 PHNE_18919 Equivalent Patches: None Patch Package Size: 4510 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_20810 5a. For a standalone system, run swinstall to install the patch: swinstall -x autoreboot=true -x match_target=true \ -s /tmp/PHNE_20810.depot By default swinstall will archive the original software in /var/adm/sw/patch/PHNE_20810. 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_20810.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_20810.depot of=/dev/rmt/0m bs=2k Special Installation Instructions: If you are using SNAplus2 on your system, please stop the SNA daemon before installing this patch (snap stop). After the installation has completed start the SNA daemon (snap start). NOTE: If you are using the HLLAPI library and do not have SNAplus2-3270 installed, please read the information in the /opt/tn3270/samples/TN3270_patch.notes file after installing this patch. NOTE: This TN3270 patch includes libhapi.0, libhapi.1, and libhapi_r.1 HLLAPI libraries and snapprtsty which are also sometimes used by SNAplus2-3270 product. It also includes libsna.1 and libcsv.1 libraries and values_c.h file used by SNAplus2-Common product. If your system has SNAplus2 installed then this patch will not install these files to avoid any impact on the SNAplus2 operation - if you need to update these files, please install the latest SNAplus2 patches. If your system does not have SNAplus2 then no further action is required.