republishEDMessages command
Use the republishEDMessages to republish the messages from the exception destination to the actual destination that they are originally produced for. This command can move messages from Exception destination to either a queue or a topic space. Based on the destination provided, the command determines the corresponding exception destination even if it is a custom exception destination. The messages that are to be moved can also be filtered through the selection criteria, which can be passed as an optional parameter in the command. In addition, the command also accepts timeout parameter, which can be used to limit the time that the operation can run on the messaging engine..
This command republishes the messages from the exception destination to the actual destination that they are produced for.
Target object
None.
Required Parameters
- -busName
- Name of the bus to which the destination and its exception destination belong.
- -destination
- The name of the destination for which the messages must be fetched from the corresponding exception destination.
Conditional Parameters
- -subscriptionId
- The subscription name for which the messages must be picked up. This is a mandatory parameter when the destination provided in the command is a Topic Space. User can specify both durable and nondurable subscription IDs. Note that the nondurable subscription changes with each restart.
Optional Parameters
- -messageSelector
- The selection criteria is used to filter the messages in the Exception destination, in addition to the Destination Name and Subscription ID.
JMS_IBM_ExceptionProblemDestination and JMS_IBM_ExceptionTimestamp parameters are not allowed in the selection criteria.
- -timeout
- The maximum duration of time the command can run on the messaging engine. The value needs to be specified in seconds.
Example
- Use Jython:
wsadmin>print AdminTask.republishEDMessages('[-busName TestBus -destination Queue1]') wsadmin>print AdminTask.republishEDMessages('[-busName TestBus -destination Default.Topic.Space -subscriptionId ClientID##SubID -messageSelector "color=\'blue\'" -timeout 10]')