IBM Support

SI78163 - OSP-COMM-TCPIP-OTHER-UNPRED HOSTTABLE ENTRIES CAPITAL LETTER

PTF Cover Letter


PTF ( Program Temporary Fixes ) Cover letter


Order this fix

Abstract

OSP-COMM-TCPIP-OTHER-UNPRED HOSTTABLE ENTRIES CAPITAL LETTER


Pre/Co-Requisite PTF / Fix List

REQ  LICENSED           PTF/FIX  LEVEL

TYPE PROGRAM  RELEASE   NUMBER   MIN/MAX  OPTION
---- -------- --------- -------  -------  ------
NONE



NOTICE:
-------
Application of this PTF may disable or render ineffective programs that
use system memory addresses not generated by the IBM translator,
including programs that circumvent control technology designed to limit
interactive capacity to purchased levels.  This PTF may be a prerequisite
for future PTFs.  By applying this PTF you authorize and agree to the
foregoing.

This PTF is subject to the terms of the license agreement which
accompanied, or was contained in, the Program for which you are obtaining
the PTF.  You are not authorized to install or use the PTF except as part
of a Program for which you have a valid Proof of Entitlement.

SUBJECT TO ANY WARRANTIES WHICH CAN NOT BE EXCLUDED OR EXCEPT AS EXPLICITLY
AGREED TO IN THE APPLICABLE LICENSE AGREEMENT OR AN APPLICABLE SUPPORT
AGREEMENT, IBM MAKES NO WARRANTIES OR CONDITIONS EITHER EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON INFRINGEMENT,
REGARDING THE PTF.

The applicable license agreement may have been provided to you in printed
form and/or may be viewed using the Work with Software Agreements (WRKSFWAGR)
CL command.


APAR Error Description / Circumvention

-------------------------------------------------
ADDTCPHTE and CHGTCPHTE convert all host names to upper case
characters whether the name is enclosed in apostrophes or not.
Mixed case host names are necessary only for some cross-platform
applications.

CORRECTION FOR APAR 'SE76760' :
-------------------------------
A change has been made that will allow the use of mixed case
host names if it's required by an application. However, most
applications will work correctly with upper case host names.
Refer to the special instructions for this PTF if there is a
specific application requirement for mixed case host names.

CIRCUMVENTION FOR APAR 'SE76760' :
----------------------------------
None.


Activation Instructions

None.




Special Instructions

If mixed case host names are required and your system does not have
jobs using CCSID 5026, run the following command:

ADDENVVAR ENVVAR(QIBM_TOC_HOSTNAME_CASE_SENSITIVE) LEVEL(*SYS)

Adding this environment variable will not change the case of any
existing host table entries. Only entries added or changed after adding
the environment variable are affected.

*** Please note that using mixed case host names on a system with jobs
using CCSID 5026 can cause unpredictable errors. This is an
unsupported environment for IBM i. ***

Removing the QIBM_TOC_HOSTNAME_CASE_SENSITIVE environment variable will
cause host table entries being added or changed to be converted to all
upper case characters.  Host names already in the host table are not
changed.

********************************************************************
THE FOLLOWING ARE SUPERSEDED SPECIAL INSTRUCTIONS. IF THE SUPERSEDED
PTF HAS ALREADY BEEN APPLIED AND ITS SPECIAL INSTRUCTION FOLLOWED,
IT IS NOT NECESSARY TO FOLLOW THAT SPECIAL INSTRUCTION AGAIN.
********************************************************************

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI68743 :
=================================================

Before applying/remove this PTF:
exits any job which calls API QtocLstNetIfc to let the PTF take
effective.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI68599 :
=================================================

After the PTF is applied, it requires a re-login to enable the fix in
the new session.

If the issue has not been experienced, nothing needs to be done.
If the issue has been experienced and the current behavior needs to be
changed, the optional QIBM_TCP_UPDATE_OLD_HOST_TABLE_FILE environment
variable can be added to update /QIBM/USERDATA/OS400/TCPIP/QTOCHOSTS
but not QUSRSYS/QATOCHOST as follows:
ADDENVVAR ENVVAR(QIBM_TCP_UPDATE_OLD_HOST_TABLE_FILE) VALUE('*NO')
LEVEL(*SYS)

To activate or deactivate the changes with the
QIBM_TCP_UPDATE_OLD_HOST_TABLE_FILE environment variable, either:
a) New sessions must be started
b) Existing sessions must Signoff and signon.
c) Any existing jobs that modifying the HOSTS table must be restarted.

Follow these steps to re-sync data to QUSRSYS/QATOCHOST:
a. RMVENVVAR ENVVAR(QIBM_TCP_UPDATE_OLD_HOST_TABLE_FILE) LEVEL(*SYS)
b. CLRPFM FILE(QUSRSYS/QATOCHOST)
c. Add, change or delete host table entries (after deactivating the
change). Then all data will be re-sync to QUSRSYS/QATOCHOST.

Warning: Any applications that reference the QUSRSYS/QATOCHOST file
directly may not behave properly after this option has been enabled.


Default Instructions

THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.



Supersedes

PTF/FIX NO(S).  APAR TITLE LINE
--------------  ------------------------------------------------------------
   SI70461      OSP-COMM-TCPIP CHGTCPHTE TEXT PARAMETER AND LOWERCASE
   SI68758      MSG TCP8A10 (File processing error) didn't show file name.
   SI68743      TCPIP-OTHER-F/QXML4CINT-T/QXML4CINT-MSGMCH3601 QTOCLSTNETIFC
   SI68709      OSP INCORROUT DBCS NOT DISPLAY CORRECTLY FOR CCSID 5026
   SI68599      INCORROUT DBCS CHAR 0X'0E45990F' REPORTED IN CCSID 5035
   SI66610      TCPIP PING WITH HOST NAME FAILS WITH TCP3202
   SI64643      OSP IMPROVE THE PERFORMANCE BUT NOT SYNC DATA TO QUSRSYS/QAT

Summary Information

System..............................  i
Models..............................  
Release.............................  V7R3M0
Licensed Program....................  5770SS1
APAR Fixed..........................  View details for APAR SE76760
Superseded by:......................  
Recompile...........................  N
Library.............................  QSYS
MRI Feature ........................  NONE
Cum Level...........................  C2132730


IBM i Support

IBM disclaims all warranties, whether express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. By furnishing this document, IBM grants no licenses to any related patents or copyrights. Copyright © 1996,1997,1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022 IBM Corporation. Any trademarks and product or brand names referenced in this document are the property of their respective owners. Consult the Terms of use link for trademark information.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.3.0","Product":{"code":"SWG60","label":"IBM i"},"Component":"5770SS1","Edition":"","Line of Business":{"code":"LOB57","label":"Power"}}]

Document Information

Modified date:
25 May 2022