Reset 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 Diagnosing 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.

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

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

   • 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 Start a messaging engine for more information.

3. Reset the destination by using a wsadmin AdminControl command of the following form:

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

   • 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 that is hosting the messaging engine on which the destination is localized.

Results

The bus destination is reset ready for use.

Related tasks

Listing 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

Delete a bus destination