IT33762: THE OUTPUT FILES USED BY THE EXCEPTION LOG CANNOT BE CONFIGURED

APAR status

• Closed as program error.

Error description

• The Exception Log uses a set of four rotating log files, each
  of which can be up to 25MB in size. There is no way to
  configure how many files are used nor how large any individual
  file can be.
  
  Additionally, the log files contain the UUID of
  the integration server rather the name of the integration
  server. There should be an option to use the name rather than
  the UUID for ease of discoverability.
  
  Lastly the log files are
  written to the same folder as other trace files, e.g.
  /var/mqsi/common/log. This may be undesirable and should be
  configurable.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All users of the exception log in IBM Integration Bus v10 and
  IBM App Connect Enterprise v11	
  
  
  Platforms affected:
  MultiPlatform, z/OS
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  The Exception Log uses a set of four rotating log files, each of
  which can be up to 25MB in size. There is no way to configure
  how many files are used nor how large any individual file can
  be.
  
  Additionally, the log files contain the UUID of the integration
  server rather the name of the integration server. There should
  be an option to use the name rather than the UUID for ease of
  discoverability.
  
  Lastly the log files are written to the same folder as other
  trace files, e.g. /var/mqsi/common/log. This may be undesirable
  and should be configurable.
  

Problem conclusion

• The exception log now has the following configurable properties:
  
  * exceptionLog - This property sets the file path and name of
  the rotating log files used by the exception log. The default
  value is
  [iib.system-common-log-dir]/[iib.system-node-label].[iib.system-
  server-uuid].exceptionLog.txt at v10 and
  [iib.system-common-log-dir]/[iib.system-node-label].[iib.system-
  server-label].exceptionLog.txt at v11. Setting this value to the
  empty string at v10 will restore the default value.
  
  * exceptionLogFileSize - This sets the maximum size in megabytes
  that a single log file should occupy. The default value is 25.
  The value must be a positive integer.
  
  * exceptionLogFileCount - This sets the number of rotating log
  files that should be used. The default value is 4. The value
  must be a positive integer.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v10.0      10.0.0.23
  v11.0      11.0.0.11
  
  The latest available maintenance can be obtained from:
  http://www-01.ibm.com/support/docview.wss?rs=849&uid=swg27006041
  
  If the maintenance level is not yet available,information on
  its planned availability can be found on:
  http://www-1.ibm.com/support/docview.wss?rs=849&uid=swg27006308
  ---------------------------------------------------------------
  

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

  INTEGRATION BUS

• Fixed component ID

  5724J0540

Applicable component levels