IBM Support

IAM3: WebSphere Message Broker - Node for log4j



IAM3 provides the ability to use the log4j logging framework from within your WebSphere Message Broker flows.

Download Description

This SupportPac allows a message flow to log information using the log4j logging framework. This way it is possible to set a log level for each log message and any destination target that can be defined using log4j.

The target as well as the runtime log level can be configured independent from the flow in the log4j configuration file.

Possible Uses
Use this SupportPac if you need a more flexible logging mechanism than the Trace node provides.

New in this Release
New in v1.2.4a
• Support for App Connect Enterprise V11.0.0.3.
New in v1.2.4
• Under heavy load there was a synchronization issue with loggers.
New in v1.2.3
• Node fails to log ExceptionList in combination with RAW, RAWLF, XML, XMLLF
New in v1.2.2
• Support for IBM Integration Bus V10.0.
• ESQL initLog4j now only returns true if initialization was successful.
New in v1.2.1b
• Support for IBM Integration Bus v9.0
New in v1.2.1
• Improving performance when handling big messages.
• Rework on the XMLLF output style.
• LoggerName and LogLevel can be set by using LocalEnviroment.
• LocalEnvironment supported in LogText.
Fixed in v1.2.1:
• Node fails to log Environment and LocalEnvironment values correctly.

Author: Matthias Nieder, Global Business Services, IBM Germany
Category: 2
Released: 18Nov08
Last updated: 22Oct19
Current SupportPac Version: 1.2.4a
»Please note that the version number shown in the right-hand pane is the version of the IBM MQ or WBI product that this SupportPac applies to. The date is the last web page refresh.

To view the complete portfolio of WebSphere MQ SupportPacs please visit the WebSphere MQ SupportPacs home page.


This SupportPac requires:
• WebSphere Message Broker V6.1 or
• WebSphere Message Broker V7.0
• WebSphere Message Broker V8.0
• IBM Integration Bus V9.0
• IBM Integration Bus V10.0
• IBM App Connect Enterprise V11.0.0.3

WebSphere Message Broker V6.0 should also work.

Installation Instructions

Concerning CVE-2021-44228 and other security related issues we suggest to delete the following classes from the log4j JAR file:
e.g. by running the following:
zip -d log4j-1.2.*.jar org/apache/log4j/net/JMSAppender.class
zip -d log4j-1.2.*.jar org/apache/log4j/net/SocketServer.class
zip -d log4j-1.2.*.jar org/apache/log4j/nt/NTEventLogAppender.class
To install this SupportPac:
1. Copy to a temporary directory.
2. Extract the file and follow the instructions in the User’s guide IAM3.pdf.

If you encounter problems after upgrading the WebSphere Message Broker Toolkit to a new version:
1. Look into $TOOLKIT_INSTALL_DIR\configuration\org.eclipse.update.
2. Save a version of the file platform.xml.
3. Edit the file platform.xml as follows:
Replace the line:
<site enabled="true" policy="USER-EXCLUDE" updateable="true" list="Log4jLoggingPlugin/" url="platform:/base/">
<site enabled="true" policy="USER-EXCLUDE" updateable="true" url="platform:/base/">
4) Restart the toolkit with the -clean option.

[{"INLabel":"iam3.pdf","INLang":"US English","INSize":"247817 B","INURL":""}]
[{"DNLabel":"","DNDate":"22 Oct 2019","DNLang":"US English","DNSize":"898891 B","DNPlat":{"label":"HP-UX","code":"PF010"},"DNURL":"","DNURL_FTP":"","DDURL":null}]

Technical Support

Category 2 SupportPacs are provided in good faith and AS-IS. There is no warranty or further service implied or committed and any supplied sample code is not supported via IBM product service channels.

You may submit a question and return email address using the 'rate this page' below, but a response is not guaranteed.

Please read the license information contained within the zip file of this SupportPac to determine if you want to use it.

[{"Product":{"code":"SSNQK6","label":"IBM Integration Bus"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"SupportPac","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"},{"code":"PF035","label":"z\/OS"}],"Version":"10.0;9.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSKM8N","label":"WebSphere Message Broker"},"Business Unit":{"code":"BU053","label":"Cloud \u0026 Data Platform"},"Component":" ","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"},{"code":"PF035","label":"z\/OS"}],"Version":"6.1;7.0;8.0","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}},{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSDR5J","label":"IBM App Connect Enterprise"},"Component":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"},{"code":"PF035","label":"z\/OS"}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
05 January 2022