Fixes are available
IBM Tivoli Monitoring Agent Builder Language Package 6.3.5-TIV-ITM_ABLDR-LP0001
IBM Agent Builder Interim Fix 01 6.3.5-TIV-ITM_ABLDR-IF0001
IBM Agent Builder Interim Fix 02 6.3.5-TIV-ITM_ABLDR-IF0002
IBM Agent Builder Interim Fix 03 6.3.5-TIV-ITM_ABLDR-IF0003
IBM Agent Builder Interim Fix 03 6.3.5-TIV-ITM_ABLDR-IF0004
APAR status
Closed as program error.
Error description
Generating an agent with the Agent Builder Japanese Language Pack installed, results in a k<pc>_resources.jar, where <pc> is the product code of the agent, with no class files. Application support installation may complete without a visible error. However, after installing the TEMS and TEPS support for the agent results in one of the following symptoms: 1. The Tivoli Enterprise Portal displays the internal keys of the attribute group names. 2. The Java Web Start portal fails to start up. 3. Attribute Group and Attribute items of the agent do not match in Situation Editor. Reviewing the TraceKQZ.log in the Agent Builder workspace .metadata\tivoli\KQZ\logs directory, you can see that an error occurred when compiling the application support because a unicode character is split/truncated, when the line is continued to the next line. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ... 2018-03-22T16:19:26.968-04:00] - MID - 9 - ModalContext - com.ibm.tivoli.monitoring.util.ProcUtil.runProcess - Entry, parm 1 = C:\Program Files (x86)\IBM\AgentBuilder_635\jre\bin\javac [2018-03-22T16:19:27.665-04:00] - MIN - 9 - Thread-17 - com.ibm.tivoli.monitoring.util.ProcUtil$StreamHandler.logLines - C:\Program Files (x86)\IBM\AgentBuilder_635\jre\bin\javac stderr ??: [options] ???????????????? -source 1.4 ????????????? ??: [options] ???? 1.4 ???????????????????? ??: [options] ?????? 1.4 ???????????????????? ??: [options] ?????????????????????????-Xlint:-options ??????? C:\PMRS\TS000047672\k19\ira\agent\common\odi2rb\package\candle\k 19\resources\K19Bundle.java:53: ???: Unicode ??????????????? { K191008, "\u300c\u30d1\u30d5\u30a9\u30fc\u30de\u30f3\u30b9\u30fb\u30aa\u3 0d6\u30b8\u30a7\u30af\u30c8\u72b6\u6cc1\u300d\u5c5e\u6027\u30b0\ u30eb\u30fc\u30d7\u306b\u306f\u4ed6\u306e\u5c5e\u6027\u30b0\u30e b\u30fc\u30d7\u306e\u72b6\u6cc1\u3092\u53cd\u6620\u3059\u308b\u6 0c5\u5831\u304c\u542b\u307e\u308c\u3066\u3044\u308b\u305f\u3081\ u3001\u3053\u306e\u30a2\u30d7\u30ea\u30b1\u30fc\u30b7\u30e7\u30f 3\u3092\u69cb\u6210\u3059\u308b\u3059\u3079\u3066\u306e\u30d1\u3 0d5\u30a9\u30fc\u30de\u30f3\u30b9\u30fb\u30aa\u30d6\u30b8\u30a7\ u30af\u30c8\u306e\u72b6\u6cc1\u3092\u307e\u3068\u3081\u3066\u4e0 0\u62ec\u8868\u793a\u3059\u308b\u3053\u3068\u304c\u3067\u304d\u3 07e\u3059\u3002\u3053\u308c\u3089\u306e\u4ed6\u306e\u30d1\u30d5\ u30a9\u30fc\u3" + ^^ (Half a unicode character preceding quote) C:\PMRS\TS000047672\k19\ira\agent\common\odi2rb\package\candle\k 19\resources\K19Bundle.java:55: ???: Unicode ??????????????? "\u5c5e\u6027\u30b0\u30eb\u30fc\u30d7\u306e\u72b6\u6cc1\u306b\u3 06f\u3001\u305d\u306e\u5c5e\u6027\u30b0\u30eb\u30fc\u30d7\u306b\ u3064\u3044\u3066\u306e\u6700\u5f8c\u306e\u30c7\u30fc\u30bf\u53c e\u96c6\u306e\u8a66\u884c\u7d50\u679c\u304c\u53cd\u6620\u3055\u3 08c\u308b\u305f\u3081\u3001\u30a8\u30fc\u30b8\u30a7\u30f3\u30c8\ u304c\u30c7\u30fc\u30bf\u53ce\u96c6\u3092\u6b63\u3057\u304f\u5b9 f\u884c\u3057\u3066\u3044\u308b\u304b\u3069\u3046\u304b\u3092\u7 8ba\u8a8d\u3067\u304d\u307e\u3059\u3002\u4ed6\u306e\u5c5e\u6027\ u30b0\u30eb\u30fc\u30d7\u3068\u306f\u7570\u306a\u308a\u3001\u300 c\u30d1\u30d5\u30a9\u30fc\u30de\u30f3\u30b9\u30fb\u30aa\u30d6\u3 0b8\u30a7\u30af\u30c8\u72b6\u6cc1\u300d\u5c5e\u6027\u30b0\u30eb\ u30fc\u30d7\u3" ^^ [2018-03-22T16:17:23.556-04:00] - MIN - 9 - Thread-11 - com.ibm.tivoli.monitoring.util.ProcUtil$StreamHandler.logLines - C:\Program Files (x86)\IBM\AgentBuilder_635\jre\bin\javac stderr ??? 2 ? ?? 4 ? [2018-03-22T16:17:23.559-04:00] - MID - 9 - ModalContext - com.ibm.tivoli.monitoring.util.ProcUtil.runProcess - Exit, return value = 1 .... [2018-03-22T16:19:33.737-04:00] - MIN - 9 - Thread-18 - com.ibm.tivoli.monitoring.util.ProcUtil$StreamHandler.logLines - C:\Program Files (x86)\IBM\AgentBuilder_635\jre\bin\jarsigner.exe stdout jarsigner: jar????????: java.io.IOException: DER input not a UTF8 string ... - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - In the K<pc>Bundle.java generated by the builder, which is located in the agent package in ...\ira\agent\common\odi2rb\package\candle\k<pc>\resources, you can see where the "Performance Object Status" strings are broken into pieces and split in the middle of a UNICODE character (see above ^^) { K101007, "Performance Object Status" }, { K101008, "\u300c\u30d1\u30d5\u30a9\u30fc\u30de\u30f3\u30b9\u30fb\u30aa\u3 0d6\u30b8\u30a7\u30af\u30c8\u72b6\u6cc1\u300d\u5c5e\u6027\u30b0\ u30eb\u30fc\u30d7\u306b\u306f\u4ed6\u306e\u5c5e\u6027\u30b0\u30e b\u30fc\u30d7\u306e\u72b6\u6cc1\u3092\u53cd\u6620\u3059\u308b\u6 0c5\u5831\u304c\u542b\u307e\u308c\u3066\u3044\u308b\u305f\u3081\ u3001\u3053\u306e\u30a2\u30d7\u30ea\u30b1\u30fc\u30b7\u30e7\u30f 3\u3092\u69cb\u6210\u3059\u308b\u3059\u3079\u3066\u306e\u30d1\u3 0d5\u30a9\u30fc\u30de\u30f3\u30b9\u30fb\u30aa\u30d6\u30b8\u30a7\ u30af\u30c8\u306e\u72b6\u6cc1\u3092\u307e\u3068\u3081\u3066\u4e0 0\u62ec\u8868\u793a\u3059\u308b\u3053\u3068\u304c\u3067\u304d\u3 07e\u3059\u3002\u3053\u308c\u3089\u306e\u4ed6\u306e\u30d1\u30d5\ u30a9\u30fc\u3" + ^^ "0de\u30f3\u30b9\u5c5e\u6027\u30b0\u30eb\u30fc\u30d7\u306f\u305d \u308c\u305e\u308c\u3001\u3053\u306e\u8868 (\u307e\u305f\u306f\u4ed6\u306e\u30bf\u30a4\u30d7\u306e\u30d3\u3 0e5\u30fc) \u306e\u884c\u306b\u3088\u3063\u3066\u8868\u3055\u308c\u307e\u30 59\u3002 " + "\u5c5e\u6027\u30b0\u30eb\u30fc\u30d7\u306e\u72b6\u6cc1\u306b\u3 06f\u3001\u305d\u306e\u5c5e\u6027\u30b0\u30eb\u30fc\u30d7\u306b\ u3064\u3044\u3066\u306e\u6700\u5f8c\u306e\u30c7\u30fc\u30bf\u53c e\u96c6\u306e\u8a66\u884c\u7d50\u679c\u304c\u53cd\u6620\u3055\u3 08c\u308b\u305f\u3081\u3001\u30a8\u30fc\u30b8\u30a7\u30f3\u30c8\ u304c\u30c7\u30fc\u30bf\u53ce\u96c6\u3092\u6b63\u3057\u304f\u5b9 f\u884c\u3057\u3066\u3044\u308b\u304b\u3069\u3046\u304b\u3092\u7 8ba\u8a8d\u3067\u304d\u307e\u3059\u3002\u4ed6\u306e\u5c5e\u6027\ u30b0\u30eb\u30fc\u30d7\u3068\u306f\u7570\u306a\u308a\u3001\u300 c\u30d1\u30d5\u30a9\u30fc\u30de\u30f3\u30b9\u30fb\u30aa\u30d6\u3 0b8\u30a7\u30af\u30c8\u72b6\u6cc1\u300d\u5c5e\u6027\u30b0\u30eb\ u30fc\u30d7\u3" + ^^ "06f\u30e2\u30cb\u30bf\u30fc\u5bfe\u8c61\u30a2\u30d7\u30ea\u30b1 \u30fc\u30b7\u30e7\u30f3\u306e\u72b6\u614b\u3092\u53cd\u6620\u30 57\u307e\u305b\u3093\u3002 \u3053\u306e\u5c5e\u6027\u30b0\u30eb\u30fc\u30d7\u304c\u6700\u30 82\u983b\u7e41\u306b\u4f7f\u7528\u3055\u308c\u308b\u306e\u306f\u 3001\u3044\u305a\u308c\u304b\u306e\u30d1\u30d5\u30a9\u30fc\u30de \u30f3\u30b9\u5c5e\u6027\u30b0\u30eb\u30fc\u30d7\u306b\u95a2\u30 59\u308b\u30c7\u30fc\u30bf\u304c\u5165\u624b\u3067\u304d\u306a\u 3044\u7406\u7531\u3092\u5224\u5225\u3059\u308b\u5834\u5408\u3067 \u3059\u3002" }, ... RECREATE INSTRUCTIONS: 1. From an agent project, select the 'Generate Agent Wizard'. 2. Check 'Create TAR file' only. 3. Confirm the file size of ira\agent\common\odi2rb\package\k<pc>_resources.jar in the generated file. The size of incorrect jar file is about 3KB. Environment: Agent Builder v6.3.4 or v6.3.5 with the Japanese Language Pack installed.
Local fix
1. Uninstall the Japanese Language Pack. 2. Regenerate the agent. 3. Install the application support files for the Monitoring Server and Portal, either via the Agent Builder GUI or command line. The resulting application support is in English.
Problem summary
Generating an agent with the Agent Builder Japanese Language Pack installed, results in an invalid and empty k<pc>_resources.jar. This is due to a JAVA compile failure which results from the splitting or truncation of a unicode character in the Performance Object Status strings in the resource bundle file.
Problem conclusion
The resource bundle strings were reformatted so that they now compile. In addition, in future releases of the builder, it will no longer manage the length of the strings when building resource files. The fix for this APAR is included in the following maintenance vehicle: | interim fix | 6.3.5-TIV-ITM_ABLDR-LP0001 Note: The fix is available atavailable at http://www.ibm.com/support/docview.wss?uid=swg24044857 | interim fix | 6.3.5-TIV-ITM_ABLDR-IF0001 available at https://www-01.ibm.com/support/docview.wss?uid=ibm10885314 . Note: Search the IBM technical support web site for maintenance package availability.
Temporary fix
Comments
APAR Information
APAR number
IJ05369
Reported component name
ITM AGENT BUILD
Reported component ID
5724C04BR
Reported release
630
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2018-03-29
Closed date
2018-06-05
Last modified date
2019-06-18
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
ITM AGENT BUILD
Fixed component ID
5724C04BR
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