Download
Abstract
A tool to view, move, copy, delete, save and restore messages in the default messaging provider for IBM WebSphere Application Server version 8.5.5 and later.
Download Description
The IBM Service Integration Bus Destination Handler tool provides a flexible interface to perform a range of different actions on messages, which would otherwise require custom coding, or a number of separate and time consuming manual steps.
- Download JAR
- Run the JAR, specifying a path to a trust store with the WebSphere server's SOAP port certificate and the trust store password. For example:
java \ -Djavax.net.ssl.trustStore=/IBM/WebSphere/AppServer/profiles/Dmgr01/etc/DummyClientTrustFile.jks \ -Djavax.net.ssl.trustStorePassword=WebAS \ -jar SIBDestinationHandler*.jar
Actions can be run once to perform an individual task, or the tool can be deployed as a WebSphere Application Server scheduler task to regularly check the contents of an exception destination and provide appropriate handling of messages based on the set of rules configured.
A graphical user interface (GUI) is provided to perform actions interactively and create configuration files. The GUI also provides facilities to send test messages to queues or topics. Screenshot below.
The actions which can be performed upon a message by the tool include:
- Printing out the properties and body of messages in a readable form
- Moving messages to a different queue point
- Copying messages to a another destination
- Deleting messages from a queue point or subscription
- Resubmitting messages from an exception destination back to the exception problem destination
- Saving binary copies of messages to files
- Restoring messages from files to destinations
- Sending e-mails to administrators containing details of messages
The actions can be performed on all messages on a particular destination, or on a subset of those messages. Messages can be selected based on JMS headers. Messages containing text can be selected based on their contents, including XPath selection for messages containing XML formatted data.
Possible uses
- Gathering a snapshot of the contents of a queue to send to an application developer, or IBM customer support for investigation
- Searching the contents of a queue for an individual message or group of messages
- Examining the contents of a message which cannot be processed by an application
- Handling a case where a message has been sent to the wrong queue point
- Moving messages from a queue point where no application is available to consume them
- Moving messages to a different bus
- Moving messages that can never be processed from an exception destination to a permanent failure destination
- Resubmitting messages from an exception destination after restarting a database or other system required to process them
- Copying messages from a production bus to a test bus for investigation
- Creating a copy of a set of JMS messages sent by an application to use multiple times in testing
- Loading a set of JMS messages from disk onto a destination as the input for a test
- Configuring an exception destination handler to inform an administrator when certain conditions occur
Skill level required
Experience of using the default messaging provider for WebSphere Application Server.
Release history
A graphical user interface (GUI) is provided to perform actions interactively and create configuration files. The GUI also provides facilities to send test messages to queues or topics. Screenshot below.
The actions which can be performed upon a message by the tool include:
- Printing out the properties and body of messages in a readable form
- Moving messages to a different queue point
- Copying messages to a another destination
- Deleting messages from a queue point or subscription
- Resubmitting messages from an exception destination back to the exception problem destination
- Saving binary copies of messages to files
- Restoring messages from files to destinations
- Sending e-mails to administrators containing details of messages
The actions can be performed on all messages on a particular destination, or on a subset of those messages. Messages can be selected based on JMS headers. Messages containing text can be selected based on their contents, including XPath selection for messages containing XML formatted data.
Possible uses
- Gathering a snapshot of the contents of a queue to send to an application developer, or IBM customer support for investigation
- Searching the contents of a queue for an individual message or group of messages
- Examining the contents of a message which cannot be processed by an application
- Handling a case where a message has been sent to the wrong queue point
- Moving messages from a queue point where no application is available to consume them
- Moving messages to a different bus
- Moving messages that can never be processed from an exception destination to a permanent failure destination
- Resubmitting messages from an exception destination after restarting a database or other system required to process them
- Copying messages from a production bus to a test bus for investigation
- Creating a copy of a set of JMS messages sent by an application to use multiple times in testing
- Loading a set of JMS messages from disk onto a destination as the input for a test
- Configuring an exception destination handler to inform an administrator when certain conditions occur
Skill level required
Experience of using the default messaging provider for WebSphere Application Server.
Release history
Version 2.0.20221122:
- Add -clientTraceSpec command line option for tracing
Off
Technical Support
These downloads are provided as is without any warranty or support. For any issues, contact Kevin Grigorenko (kevin.grigorenko@us.ibm.com) and we'll try to resolve any issues as time permits.
[{"Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"ARM Category":[{"code":"a8m50000000Cd8dAAC","label":"WebSphere Application Server traditional-All Platforms-\u003ESIB JMS-JMS-MQ RA - JMS general"}],"Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF012","label":"IBM i"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"},{"code":"PF035","label":"z\/OS"}],"Version":"8.5.5;9.0.0","Type":"MASTER"},{"Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSQH9M","label":"WebSphere Process Server"},"ARM Category":[{"code":"a8m0z000000cx8DAAQ","label":"Other IBM Software (WAS, MQ, etc), please specify-\u003EWAS"}],"Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"},{"code":"PF035","label":"z\/OS"}],"Version":"7.0.0","Type":"MASTER"},{"Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSSRR3","label":"WebSphere Business Monitor"},"ARM Category":[{"code":"a8m0z000000cx8DAAQ","label":"Other IBM Software (WAS, MQ, etc), please specify-\u003EWAS"}],"Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"7.0.0","Type":"MASTER"},{"Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS7K4U","label":"WebSphere Application Server for z\/OS"},"ARM Category":[{"code":"a8m50000000Cd8dAAC","label":"WebSphere Application Server traditional-All Platforms-\u003ESIB JMS-JMS-MQ RA - JMS general"}],"Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"8.5.5;9.0.5","Type":"MASTER"},{"Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS7J6S","label":"WebSphere Enterprise Service Bus"},"ARM Category":[{"code":"a8m0z000000cx8DAAQ","label":"Other IBM Software (WAS, MQ, etc), please specify-\u003EWAS"}],"Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"},{"code":"PF035","label":"z\/OS"}],"Version":"7.5.1","Type":"MASTER"}]
Was this topic helpful?
Document Information
Modified date:
22 November 2022
UID
swg24021439