IZ62541: INSTALLER BROKE THE PARSING FOR AGENTS THAT USE % IN THEIR .INI

APAR status

• Closed as program error.

Error description

• Environment:
  ITM 6.20 unix/linux
  
  Problem Description:
       The problem is caused by sed command using % as delimter
       while % is part of the string being replaced
  
  Detailed Recreation Procedure:
       (1) install and config ITM 6.2 ud agent
       (2) run command
             itmcmd history -C ud -i <instance>
       (3) an error message like the following will display
    sed: 0602-404 Function s%$1%"/opt/IBM/ITM/aix526/ud/hist/%
  (DB2INSTANCE)"% cannot be parsed.
       (4) related entries in ud.ini and ud.env
   in ud.ini
  
  CTIRA_HIST_DIR=$CANDLEHOME$/$BINARCH$/$PRODUCTCODE$/hist/%(DB2IN
  STANCE)
   in ud.env
    CTIRA_HIST_DIR=/opt/IBM/ITM/aix526/ud/hist/%(DB2INSTANCE)
  

Local fix

• Workaround:
  replace the following line in ud.ini
  
  CTIRA_HIST_DIR=$CANDLEHOME$/$BINARCH$/$PRODUCTCODE$/hist/%(DB2IN
  STANCE)
  
  with
  CTIRA_HIST_DIR=$CANDLEHOME$/$BINARCH$/$PRODUCTCODE$/hist/actuali
  nstance
  
  where acutalinstance is the actual name of the instance.
  

Problem summary

• When the CandleHistory command is invoked for the ud agent
  without an instance name, it returns the error:
  
  sed: 0602-404 Function
  s%$1%"/opt/IBM/ITM/aix526/ud/hist/%(DB2INSTANCE)"% cannot be
  parsed.
  
  When the CandleHistory command is invoked for the ud agent with
  a valid instance name, it returns the error:
  
  CANDLEHOME/config/ud_${instance}.config does not exist
  

Problem conclusion

• Two issues are addressed in this fix:
  #1 When the instance name is not specified, display a meaningful
  error message.
  
  #2 when the instance name is correctly specified, use the
  correct config file CANDLEHOME/config/ud.config
  
  The fix for this APAR is included in the following maintenance
  vehicle:
      | interim fix | 6.2.0.3-TIV-ITM-IF0003
      | fix pack | 6.2.1-TIV-ITM-FP0002
      | fix pack | 6.2.2-TIV-ITM-FP0002
  

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

  OMEG DIST INSTA

• Fixed component ID

  5608A41CI

Applicable component levels

• R620 PSY

     UP