APAR status
Closed as program error.
Error description
The 06300700 Monitoring Server fails to start on zLinux platforms. The TRANSFER Shared Library fails to load with the following eror message displayed in the Server's OpsLog file, /opt/IBM/ITM/REMOTE_czzptm1i_1/ls3266/ms/bin/kdsmain: symbol lookup error: /opt/IBM/ITM/REMOTE_czzptm1i_1/ls3266/ms/lib/TRANSFER: undefined symbol: _Z4HashIN3KT16StringEEjRKT_i The failure to start the TRANSFER Shared Library impacts using SDA, putfile, getfile and executecommand functionality.
Local fix
Modify the following line in the Management Server's configuration file to remove the loading of the TRANSFER Shared Library until the fix is applied. Change the line KDS_RUN="KSMOMS.KSMOMS;KRANDREG.KRANDREG;KSHCMS.WEBSQL;DEPLOY.DE PLOY;KCFFEPRB.KCFCCTII;KQMM.KARM;TRANSFER.TRANSFER" to look like this KDS_RUN="KSMOMS.KSMOMS;KRANDREG.KRANDREG;KSHCMS.WEBSQL;DEPLOY.DE PLOY;KCFFEPRB.KCFCCTII;KQMM.KARM"
Problem summary
The Tivoli Management Server does not fully start on zLinux. The Management Server's Shared Library "TRANSFER" is not loaded during Monitoring Server startup resulting limited functionality of the Management Server. The limitation disables using SDA, putfile, getfile and executecommand functionality. On zLinux the Tivoli Management Server version 06.30.07.00 does not start because it cannot load its required TRANSFER Shared Library. The following error message is displayed in the Management Server's OpsLog ($CANDLEHOME/logs/<hostname>_ms_<epoch time>.log), /opt/IBM/ITM/REMOTE_czzptm1i_1/ls3266/ms/bin/kdsmain: symbol lookup error: /opt/IBM/ITM/REMOTE_czzptm1i_1/ls3266/ms/lib/TRANSFER: undefined symbol: _Z4HashIN3KT16StringEEjRKT_i
Problem conclusion
The C Language Macro used to formulate the name of the function referenced by the Monitoring Server has been fixed to generate the function's correct symbol table reference value. The fix for this APAR is contained in the following maintenance packages: | service pack | 6.3.0.7-TIV-ITM-SP0001
Temporary fix
Modify the following line in the Management Server's configuration file to remove the loading of the TRANSFER Shared Library until the fix is applied. Change the line KDS_RUN="KSMOMS.KSMOMS;KRANDREG.KRANDREG;KSHCMS.WEBSQL;DEPLOY.DE PLOY;KCFFEPRB.KCFCCTII;KQMM.KARM;TRANSFER.TRANSFER" by removing the reference to TRANSFER such that the line after the modification will resemble the following line KDS_RUN="KSMOMS.KSMOMS;KRANDREG.KRANDREG;KSHCMS.WEBSQL;DEPLOY.DE PLOY;KCFFEPRB.KCFCCTII;KQMM.KARM"
Comments
APAR Information
APAR number
IJ00577
Reported component name
TEMS
Reported component ID
5724C04MS
Reported release
630
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2017-10-11
Closed date
2019-05-06
Last modified date
2019-05-06
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
[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSTFXA","label":"Tivoli Monitoring"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"630","Line of Business":{"code":"LOB45","label":"Automation"}}]
Document Information
Modified date:
08 March 2023