IJ05369: JAPANESE APPLICATION SUPPORT FILE IS INCORRECT AND FAILS TO INSTALL

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 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