Fixes are available
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 number
IV07417
Reported component name
TEMS
Reported component ID
5724C04MS
Reported release
622
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2011-09-09
Closed date
2011-10-19
Last modified date
2012-06-05
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
[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SSCTLMP","label":"ITM Tivoli Enterprise Mgmt Server V6"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"622","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
05 June 2012