IV21696: CR/LF IN TAKEACTION CMD ARG WILL TERMINATE COMMAND PREMATURELY

IBM Tivoli Monitoring 6.2.3 Fix Pack 5 (6.2.3-TIV-ITM-FP0005)
IBM Tivoli Monitoring 6.2.3 Fix Pack 2 (6.2.3-TIV-ITM-FP0002)
IBM Tivoli Monitoring 6.2.3 Fix Pack 4 (6.2.3-TIV-ITM-FP0004)

APAR status

• Closed as program error.

Error description

• Severity: 3
  Approver: BG
  Environment: ITM 6.23
               Windows 2008 64_bit
  Compid:      5724C04MS Tivoli Enterprise Management Server
  
  On Windows, a take action command with an argument that contains
  CR/LF will prematurely terminate the command line even if the
  argument value is enclosed in double quotes.  Microsoft
  documents this as a limitation.
  
  
  Detailed Recreation Procedure:
  
  Create a situation that monitors the system event log.  Set up a
  take action to invoke a batch file that echos the arguments.
  Make one of the arguments the event description.  When the
  take action command is executed you will note that the
  argument is truncated at the first cr/lf
  

Local fix

Problem summary

• CRLF in take action command argument will terminate command
  prematurely.
  
  
  On Windows, a take action command with an argument that contains
  CRLF will prematurely terminate the command line even if the
  argument value is enclosed in double quotes. Microsoft documents
  this as a limitation.
  
  In order for this APAR to be properly implemented in your
  environment, a new environment variable has been added.  See the
  "Install Actions" section of the APAR conclusion for more
  details.
  

Problem conclusion

• Install Actions
  
  The code was changed to allow CR and LF characters in take
  action substitution variable values to be removed or replaced by
  another string.
  
  - Set CTIRA_REMAP_CRLF=*DEFAULT to have these characters
    removed.
  - Set CTIRA_REMAP_CRLF=xxxxxxxx to have these characters
    replaced with xxxxxxxx where xxxxxxxx is the replacement
    string.
  
  If CTIRA_REMAP_CRLF is not set then CR and LF characters are not
  removed or replaced, which is the current default behavior.
  
  Note:  When message KFAST003 is printed after the completion of
  a take action command, the message can be garbled and cause
  error messages to appear in the RAS1 log if the message text is
  very long.  This is the result of take action commands that have
  very long argument strings which make the entire command longer
  than approximately 220 characters.  Application of this APAR can
  exacerbate this issue.  APAR IV25075 will correct the problem
  and avoid this issue.
  
  
  The fix for this APAR is contained in the following maintenance
  packages:
  
    | fix pack | 6.2.3-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:

  OA40424

Fix information

• Fixed component name

  TEMS

• Fixed component ID

  5724C04MS

Applicable component levels

• R623 PSY

     UP