IV07417: ADDSYSTEM DATA LEADS TO INDEXOUTOFBOUNDS

IBM Tivoli Monitoring 6.2.2 Fix Pack 8 (6.2.2-TIV-ITM-FP0008)
IBM Tivoli Monitoring 6.2.2 Fix Pack 9 (6.2.2-TIV-ITM-FP0009)

APAR status

• Closed as program error.

Error description

• If the configuration information specified in an addSystems CLI
  request is improperly formatted, then the TEMS will crash.  The
  TEMS log will show the error message "IndexOutOfBounds
  occurred,throwing exception."
  
  The following is one case of an invalid configuration syntax:
  
  tacmd  addsystem -t lo -p INSTANCE=TEST
  LOG_FILE_ADAPTER_CONFIGURATION.
  KLO_FORMAT_FILE=/opt/IBM/ITM/custom/cfg/genericlog.fmt
  LOG_FILE_ADAPTER_CONFIGURATION.KLO_SEND_EIF_EVENTS=No
  LOG_FILE_ADAPTER_CONFIGURATION.KLO_SEND_ITM_EVENTS=Yes
  LOG_FILE_ADAPTER_CONFIGURATION.
  KLO_CONF_FILE=/opt/IBM/ITM/custom/cfg/genericlog_TEST .config
  ITM_ATTRIBUTE_CONFIGURATION.KLO_CUSTOM_SLOT1=custom_timestamp
  ITM_ATTRIBUTE_CONFIGURATION.KLO_CUSTOM_SLOT2=custom_timezone
  ITM_ATTRIBUTE_CONFIGURATION.KLO_CUSTOM_SLOT3=hostname
  ITM_ATTRIBUTE_CONFIGURATION.KLO_CUSTOM_SLOT4=custom_script
  ITM_ATTRIBUTE_CONFIGURATION.KLO_CUSTOM_SLOT5=custom_errorcode
  ITM_ATTRIBUTE_CONFIGURATION.KLO_CUSTOM_SLOT6=custom_itceras
  ITM_ATTRIBUTE_CONFIGURATION.KLO_CUSTOM_SLOT7=info -n
  hmsdetr03:LZ
  
  This command contains a typing error. The error is the blank
  between
  /opt/IBM/ITM/custom/cfg/genericlog_TEST   and .config
  
  
  RECREATE INSTRUCTIONS:
  
  
  1. Install TEMS 622.
  2. Add the KLO Agent to the TEMS' Depot
      - tacmd addbundles -i <KLO Agent CD-Image>
  3. Add KLO application support to TEMS
  4. Install  622 OS Agent on endpoint
  5. Issue following command to add KLO to endpoint in (4) above.
  
  tacmd  addsystem -t lo -p INSTANCE=TEST
  LOG_FILE_ADAPTER_CONFIGURATION.
  KLO_FORMAT_FILE=/opt/IBM/ITM/custom/cfg/genericlog.fmt
  LOG_FILE_ADAPTER_CONFIGURATION.KLO_SEND_EIF_EVENTS=No
  LOG_FILE_ADAPTER_CONFIGURATION.KLO_SEND_ITM_EVENTS=Yes
  LOG_FILE_ADAPTER_CONFIGURATION.
  KLO_CONF_FILE=/opt/IBM/ITM/custom/cfg/genericlog_TEST .config
  ITM_ATTRIBUTE_CONFIGURATION.KLO_CUSTOM_SLOT1=custom_timestamp
  ITM_ATTRIBUTE_CONFIGURATION.KLO_CUSTOM_SLOT2=custom_timezone
  ITM_ATTRIBUTE_CONFIGURATION.KLO_CUSTOM_SLOT3=hostname
  ITM_ATTRIBUTE_CONFIGURATION.KLO_CUSTOM_SLOT4=custom_script
  ITM_ATTRIBUTE_CONFIGURATION.KLO_CUSTOM_SLOT5=custom_errorcode
  ITM_ATTRIBUTE_CONFIGURATION.KLO_CUSTOM_SLOT6=custom_itceras
  ITM_ATTRIBUTE_CONFIGURATION.KLO_CUSTOM_SLOT7=info -n
  hmsdetr03:LZ
  
  This command contains a typing error. The error is the blank
  between
  /opt/IBM/ITM/custom/cfg/genericlog_TEST   and .config
  
  Observe TEMS abnormal termination.
  Examine TEMS log and locate error message :
  (4E688770.0189-15:kdystr.cpp,693,"find") IndexOutOfBounds
  occurred, throwing exception
  

Local fix

• Reformat submitted addSystems command to not include space
  character in any configuration parameter key/value pair.
  
  tacmd  addsystem -t lo -p INSTANCE=TEST
  LOG_FILE_ADAPTER_CONFIGURAT
  KLO_FORMAT_FILE=/opt/IBM/ITM/custom/cfg/genericlog.fmt
  LOG_FILE_ADAPTER_CONFIGURATION.KLO_SEND_EIF_EVENTS=No
  LOG_FILE_ADAPTER_CONFIGURATION.KLO_SEND_ITM_EVENTS=Yes
  LOG_FILE_ADAPTER_CONFIGURATION.
  KLO_CONF_FILE=/opt/IBM/ITM/custom/cfg/genericlog_TEST.config
  ITM_ATTRIBUTE_CONFIGURATION.KLO_CUSTOM_SLOT1=custom_timestamp
  ITM_ATTRIBUTE_CONFIGURATION.KLO_CUSTOM_SLOT2=custom_timezone
  ITM_ATTRIBUTE_CONFIGURATION.KLO_CUSTOM_SLOT3=hostname
  ITM_ATTRIBUTE_CONFIGURATION.KLO_CUSTOM_SLOT4=custom_script
  ITM_ATTRIBUTE_CONFIGURATION.KLO_CUSTOM_SLOT5=custom_errorcode
  ITM_ATTRIBUTE_CONFIGURATION.KLO_CUSTOM_SLOT6=custom_itceras
  ITM_ATTRIBUTE_CONFIGURATION.KLO_CUSTOM_SLOT7=info -n
  hmsdetr03:LZ
  

Problem summary

• The management server crashes with the error message
  IndexOutOfBounds showing up in the log.
  
  Specifying an illegal syntax for addSystem or ConfigureSystem
  configuration parameter will result in a memory access
  violation, abnormally terminating the monitoring server.
  

Problem conclusion

• The affected commands now catch these kind of syntax errors.
  
  The error is applicable to any agent that allows parameter
  specification.
  
  
  
  The fix for this APAR is contained in the following maintenance
  packages:
  
     | fix pack | 6.2.2-TIV-ITM-FP0007
     | fix pack | 6.2.3-TIV-ITM-FP0001
  

Temporary fix

• Specify key values that does not include spaces, or enclose the
  value text in double quotes (").
  

Comments

APAR Information

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

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

Fix information

• Fixed component name

  TEMS

• Fixed component ID

  5724C04MS

Applicable component levels

• R622 PSY

     UP