IV68574: IN TAKEACTION, COMMAND OF MULTI-BYTE CHARACTERS WHICH HAVE 0XBA OR 0XBB IS TRANSLATED TO LOCAL CODE PAGE INCORRECTLY.

Tivoli Log File Agent, Version 6.3.0 Fix Pack 01 (6.3.0-TIV-ITM_LFA-FP0001)
Tivoli Log File Agent, Version 6.3.0 Interim Fix 04 6.3.0-TIV-ITM_LFA-IF0004
Tivoli Log File Agent, Version 6.3.0 Fix Pack 02 (6.3.0-TIV-ITM_LFA-FP0002)
Tivoli Log File Agent, Version 6.3.0 Interim Fix 05 6.3.0-TIV-ITM_LFA-IF0005

APAR status

• Closed as program error.

Error description

• In takeAction processing, a command with multi-byte characters
  0xBA or 0xBB is translated to local code page incorrectly.
  0xBA and 0xBB are incorrectly replaced with "[" and "]",
  respectively.
  
  Affected Versions:
  The problem exists on Log File Agent v6.3.0 Interim Fix 0003
  and earlier releases.
  Platform independent.
  
  Problem Determination:
  On the LO agent system, enable:
  KBB_RAS1= ERROR (UNIT:Logmonitor ALL) (UNIT:Kumprmfr ALL)
  (UNIT:kum0nget ALL) (UNIT:command ALL) (UNIT:Task ALL)
  
  
  
  The agent RAS1 log
  <hostname>_lo_[instance]_kloagent_<timestamp>-<nn>.log
  contains trace entries similar to the following:
  
  ...
  ...
  <timestamp>:kum0nget.c,419,"TranslateStringToUTF8")
  Converting string buffer from ibm-943_P15A-2003 to UTF-8
  <timestamp>:kum0nget.c,482,"TranslateStringToUTF8")
  Buffersize 31158 bytes; Translated size 4 ; Copied 31158
  characters readBuffer 1113EE3B0
  <timestamp>:kum0nget.c,498,"TranslateStringToUTF8") Exit:
  0x113EE3B0
  <timestamp>:kum0nget.c,397,"KUM0_Fgets") Exit: 0x113EE3B0
  <timestamp>:kumprmfr.c,449,"KUMP_ReadMonitorFileUnicodeRec
  ord")
  <0x1113EE3B0,0x4> ?
  +5492C8B8.000A     00000000   E3819D0A
  ...
  ...
  << The event is submitted to EIF - it still looks correct >>
  (5492C8B8.005F-1B:logmonitorqueryclass.cpp,2433,"LogMonitorQuery
  Class::s
  etInstanceData") Submitting EIF event:
  +5492C8B8.005F SOTEST_Event;C1='&#65478;  ';
                                  E89 << hex character values>>
                                  31D
  
  ...
  ...
  <timestamp>:tasklibrary.cpp,1531,"ConvertCommandToLocal")
  Converting UTF-8 command to codepage 932
  <timestamp>:tasklibrary.cpp,1554,"ConvertCommandToLocal")
  Exit: 0x10F4BBF0
  ...
  ...
  << However when it is translated back from UTF-8 to codepage 943
  it becomes incorrect:>>
  <timestamp>:tasklibrary.cpp,749,"executeTaskRequest") Entry
  <timestamp>:tasklibrary.cpp,791,"executeTaskRequest")
  taskInfo.name = print
  <timestamp>:tasklibrary.cpp,841,"executeTaskRequest") Did
  not find Task name 'print'.  Going to run 'system' on the
  request print -r ' ?]
  '>>/LFA/49806/sotestout.txt .
  
  RECREATE INSTRUCTIONS:
  1. create situation which has the following in its System
  Command and configure to execute it on LFA.
  print -r ' &{KLO_LOGFILEEVENTS.CustomSlot1} '>>/tmp/outfile.txt
  2. create an event whose CustomSlot1 has the multi-byte
  characters which includes 0xBA or 0xBB.
  3. The outfile will not be updated or will have different
  characters.
  
  Approver Initials: LD
  

Local fix

Problem summary

• In takeAction processing, multi-byte characters 0x82BA or 0x82BB
  in a command are translated to local code page incorrectly.
  They are incorrectly replaced with "[" and "]", respectively.
  

Problem conclusion

• Only substitute the [ and ] characters on the 390 platform.
  
  The fix for this APAR is included in the following maintenance
  vehicle:
  
  | interim fix | 6.3.0-TIV-ITM_LFA-IF0004
  
  available at
  http://www.ibm.com/support/docview.wss?uid=swg24039388
  

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 LOG FILE AG

• Fixed component ID

  5724C04LF

Applicable component levels

• R630 PSY

     UP