OA26792: APP SUPPORT UPGRADE FAILS WHEN VARIABLES ARE ADDED TO KDC_FAMILIES

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• While installing TEMS application support for a new fixpack
  level, the installer fails with rc = -3 (ERR_CONFIG_NOT_FOUND).
  This is because the installer is failing to find the port number
  when a variable has been inserted between the protocol and port
  number of the KDC_FAMILIES string (for example, adding in
  EPHEMERAL:Y).
  
  RECREATION STEPS:
  
  1. Insert a variable such as EPHEMERAL:Y into the KDC_FAMILIES
  string between the port number and the protocol.
  
  For example, KDC_FAMILIES=IP.PIPE PORT:1918 now becomes
  KDC_FAMILIES=IP.PIPE EPHEMERAL:Y PORT:1918
  
  2. Run the application support installer for the TEMS and it
  will fail.
  
  RELATED FILES/OUTPUT:
  
  ksminst.log shows the following at the end:
  
  (455B7942.0020-1EF0:ko4inst.cpp,974,"Installer610::init")
  port........<>
  (455B7942.0021-1EF0:ko4inst.cpp,975,"Installer610::init") cms
  name....<>
  (455B7942.0022-1EF0:ko4inst.cpp,976,"Installer610::init")
  binarch.....<win32>
  (455B7942.0023-1EF0:ko4inst.cpp,977,"Installer610::init")
  rc..........<-3>
  (455B7942.0024-1EF0:ko4inst.cpp,979,"Installer610::init") Exit:
  0xFFFFFFFD
  (455B7942.0025-1EF0:ko4inst.cpp,2448,"main") Exiting with rc
  <-3>
  (455B7942.0026-1EF0:ko4inst.cpp,2449,"main") Exit: 0xFFFFFFFD
  
  APPROVER: bdm
  

Local fix

• Rearrange the KDC_FAMILIES string so that the transport protocol
  (for example IP.PIPE) is immediately followed by the PORT
  number.
  
  Regardless of what the KDC_FAMILIES is set to in KBBENV, this
  change should actually be made in the Windows registry:
  
  1) open the
  HKEY_LOCAL_MACHINE\Software\Candle\CMS\KMS\TEMS1\Environment
  key in the registry.
  2) Change the value in KDC_FAMILIES from "IP.PIPE  EPHEMERAL:Y
  PORT:1918"   to   "EPHEMERAL:Y  IP.PIPE  PORT:1918"  instead
  3) run the installation again and app. support should succeed
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All TEMS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Application support upgrades fail when  *
  *                      EPHEMERAL:Y is added between the        *
  *                      protocol and port number in the         *
  *                      KDE_TRANSPORT environment variable.     *
  ****************************************************************
  * RECOMMENDATION: Apply this PTF.                              *
  ****************************************************************
  Application support upgrades fail when KDE_TRANSPORT looks
  like this:
     IP.PIPE EPHEMERAL:Y PORT:1918 ...
  The problem does not exist when KDE_TRANSPORT looks like
  this:
     IP.PIPE PORT:1918 EPHEMERAL:Y ...
  

Problem conclusion

• The code was change to correctly parse the value of the
  KDE_TRANSPORT environment variable.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

  IY93504

• APAR is sysrouted TO one or more of the following:

Modules/Macros

• KDSMAIN
  

Fix information

• Fixed component name

  MGMT SERVER DS

• Fixed component ID

  5608A2800

Applicable component levels

• R620 PSY UA44295

     UP08/11/05 P F811

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.