Resetting a destination

Use this task to reset a bus destination.

We might need to reset a destination if, for example, it has become corrupt. To reset a destination, use a wsadmin AdminControl command.

If a destination becomes corrupt, a CWSIK0027E message is reported, which indicates a serious error. If we see this message, refer to Diagnose problems (using diagnosis tools) for advice about gathering and reviewing information that might be useful in diagnosing this error. Also refer to the MustGather: Collect troubleshooting data for a Service Integration Bus (SIB) problems document on the Must gather website before opening a PMR.

Tasks

1. Set the name of the messaging engine using a wsadmin AdminControl command of the following form:

   • Use Jython:

     me = AdminControl.queryNames("type=SIBMessagingEngine,name=messaging_engine_name,*" )
     

   • Use Jacl:

     set me [$AdminControl queryNames type=SIBMessagingEngine,name=messaging_engine_name,*]
     

   where messaging_engine_name is the name of the messaging engine.

2. Ensure that the messaging engine is running. Start the messaging engine if it is not already running. Read Starting a messaging engine for more information.
3. Reset the destination using a wsadmin AdminControl command of the following form:

   • Use Jython:

     AdminControl.invoke(me, "resetDestination", ["destination"] )
     

   • Use Jacl:

     $AdminControl invoke $me resetDestination {"destination"}
     

   where destination is the name of the destination.

4. To complete the resetting of the destination, restart the server hosting the messaging engine on which the destination is localized.

The bus destination is reset ready for use.

List bus destinations

Create a bus destination

Configure bus destination properties

Configure mediations

Configure a destination forward routing path

Configure a destination reverse routing path

Configure context properties for a bus destination

Administer destination roles

Deleting a bus destination