IBM Support

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

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

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 number

    IT33762

  • Reported component name

    INTEGRATION BUS

  • Reported component ID

    5724J0540

  • Reported release

    A00

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2020-08-03

  • Closed date

    2020-12-13

  • Last modified date

    2020-12-13

  • 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

[{"Line of Business":{"code":"LOB36","label":"IBM Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSNQK6","label":"IBM Integration Bus"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"10.0"}]

Document Information

Modified date:
14 December 2020