OA36786: SUBNODE LIST GETS MANGLED FOR MSN LONGER THAN 32 CHARACTERS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• If an agent attempts to register a subnode that is exceeds the
  32 character platform limit, unpredictable behavior can occur
  including TEMS crashes.  When this occurs, the following message
  will be recorded in the RAS1 log:
  
  "The agent generated subnode name <name> exceeds the platform
  limit of 32 characters.  Registration is being blocked to avoid
  unpredictable behavior including crashes."
  
  
  Some of the other messages written to the RAS1 log are:
  
  
    4BA141D2.0000-21:kpxreqhb.cpp,789,"HeartbeatInserter") Remote
    node
    <xxxxxxxx:T3> is ON-LINE.
    (4BA141D2.0001-21:kpxreqhb.cpp,975,"SubnodeInserter")
    SubnodeList freed
    at <4a504b48>
    (4BA141D2.0002-21:kpxreqhb.cpp,978,"SubnodeInserter")
    SubnodeParm
    deleted at <70687070>
  
  
  Detailed Recreation Procedure:
  
    Connect T3 agent without fix in 7.1-FP0003 (shipped Feb 10,
    2010)
  
    Wait for invalid subnode entry to register.
  

Local fix

• The action required is to check and see if an agent APAR exists
  that corrects thie problem. If so, install it. If not, then open
  a PMR against the agent.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All TEMS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: THIS CHANGE BLOCKS THE REGISTRATION OF  *
  *                      SUBNODES WITH NAMES EXCEEDING 32        *
  *                      CHARACTERS ON THE MANAGEMENT SERVER     *
  ****************************************************************
  * RECOMMENDATION: Apply the PTF.                               *
  ****************************************************************
  If an agent attempts to register a subnode whose name
  exceeds the 32 character MSN length, unpredictable behavior
  can occur, including management server crashes.
  

Problem conclusion

• The change added works if the environment variable
  KPX_CTIRA_BLOCK_INVALID_SUBNODE is set to Y on the
  management server, then the registration of subnodes with
  MSN longer than 32 characters will be blocked. This is not
  set by default, but can be turned on as needed.
  
  Install Actions
  
  To enable this function, the variable
  "KPX_CTIRA_BLOCK_INVALID_SUBNODE=Y" should be set in the
  file:
   $CANDLEHOME/config/kbbenv.ini
   or
   %CANDLE_HOME%\CMS\KMSCMS.ini
  
  Change the existing line or add the line
  KPX_CTIRA_BLOCK_INVALID_SUBNODE=Y at the end of the file.
  After this change is made, the management server should be
  reconfigured and restarted to enable that value.
  

Temporary fix

Comments

APAR Information

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

  IZ73109

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

Modules/Macros

• KRANDREG
  

Fix information

• Fixed component name

  MGMT SERVER DS

• Fixed component ID

  5608A2800

Applicable component levels

• R622 PSY UA60941

     UP11/07/13 P F107

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.