Resetting a destination

Use this task to reset a bus destination.

About this task

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

Note: If a destination becomes corrupt, a CWSIK0027E message is reported, which indicates a serious error. If you 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.

Procedure

  1. Set the name of the messaging engine by using a wsadmin AdminControl command of the following form:
    • Using Jython:
      me = AdminControl.queryNames("type=SIBMessagingEngine,name=messaging_engine_name,*" )
    • Using 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 by using a wsadmin AdminControl command of the following form:
    • Using Jython:
      AdminControl.invoke(me, "resetDestination", ["destination"] )
    • Using 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.
Task topic Task topic    

Terms of Use | Feedback

Last updatedLast updated: Sep 19, 2011 6:15:55 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=matt&product=was-express-dist&topic=tjo_reset_dest
File name: tjo_reset_dest.html