APAR status
Closed as program error.
Error description
On Non Windows platforms, XX.environment files containing multiple = after the export are broken after installing SP9 This causes the itmcmd agent/server command to fail to stop or start the component with the XX.environment file containing an entry with multiple = on a single line. RECREATE INSTRUCTIONS: 1) Install the 6.3.0.7 TEMS. 2) Apply any SP less than SP9 3) Configure the TEMS 4) Create the file <CANDLEHOME>/config/ms.environment 5) Add the following line to ms.environment KBB_RAS1=$KBB_RAS1 (UNIT:kshdsr,entry:'login' DET)(UNIT:kshdsr,entry:'create' STATE)(UNIT:kshdhtp,Entry='getHeaderValue' all)(UNIT:kshprs,Entry:'WSQL_ParsePostRequest' ALL)(UNIT:kpxreqi,Entry:'checkForStaleBinding' NONE) 6) Start the TEMS 7) NOTICE: It starts successfully. 8) Stop the TEMS 9) NOTICE: It stops successfully. 10) Apply SP9 11) Start the TEMS 12) ERROR: It fails to start. 13) Review the <CANDLEHOME>/logs/ms.env file 14) ERROR: the KBB_RAS1 variable shows an empty value.
Local fix
1) Make a backup copy of <CANDLEHOME>/bin/sourceEnv.sh 2) Modify <CANDLEHOME>/bin/sourceEnv.sh 3) Locate the line with the following text: sourceEnv_sed="${sourceEnv_sed};s/\(^export.*\)=\(.*\)/\1=\"\2 \"/"; 4) Replace the line with the following text: sourceEnv_sed="${sourceEnv_sed};s/\(^export[^=]*\)=\(.*\)/\1=\ "\2\"/"; 5) Save <CANDLEHOME>/bin/sourceEnv.sh
Problem summary
On Non Windows platforms, XX.environment files containing multiple = after the export are broken after installing SP9 This causes the itmcmd agent/server command to fail to stop or start the component with the XX.environment file containing an entry with multiple = on a single line.
Problem conclusion
The script sourceEnv.sh has been changed to fix the problem. The fix for this APAR is contained in the following maintenance packages: | service pack | 6.3.0.7-TIV-ITM-SP0010
Temporary fix
Comments
APAR Information
APAR number
IJ36972
Reported component name
OMEG DIST INSTA
Reported component ID
5608A41CI
Reported release
630
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2022-01-05
Closed date
2022-02-01
Last modified date
2022-02-01
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
OMEG DIST INSTA
Fixed component ID
5608A41CI
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