deleteSIBEngine command

Use the deleteSIBEngine command to delete a messaging engine from a service integration bus member.

You should be wary of deleting and recreating messaging engines on bus members for which WS-Notification-administered subscribers have been configured, because in some cases this can leave the remote web service subscription active (and passing notification messages to the local server) even though there is no longer any record of it. For more information, see the WS-Notification troubleshooting tip Problems can occur when deleting administered subscribers and messaging engines.

If you promote a server bus member to a cluster that is not a member of the bus, do not delete then recreate the messaging engine. Use the migrateServerMEtoCluster command instead.

To run the command, use the AdminTask object of the wsadmin scripting client.

Command-line help is provided for service integration bus commands:
  • For a list of the available service integration bus commands in Jython and a brief description of each command, enter the following command at the wsadmin prompt:

    print AdminTask.help('SIBAdminCommands')

  • For overview help on a given command, enter the following command at the wsadmin prompt:

    print AdminTask.help('command_name')

After using the command, save your changes to the master configuration; for example, by using the following command:


AdminConfig.save()

Purpose

This command deletes a messaging engine from a bus member. Any associated configurations of the messaging engine, such as core group policies or destinations, are also deleted. If the messaging engine uses a data store for the message store, objects in the data stores remain so that you can still access them. If you recreate the same messaging engine, you must remove any old data store tables before you start the new messaging engine.

This command also cleans up any mediation execution points that are on the messaging engine as the result of mediating a destination to a WebSphere® MQ server bus member. The command unmediates the destination to which the mediation execution point corresponds.

Target object

A messaging engine.

Required parameters

-bus bus_name
The name of the service integration bus on which the bus member is configured. You can use the listSIBuses command to list the names of existing buses.

Conditional parameters

-node node_name
-server server_name
To delete a messaging engine from an application server that is a bus member, specify both the name of the node on which the server runs and the name of the server.
-engine engine_name
If the bus member has only one messaging engine, you do not need to specify the engine name. If the bus member has several messaging engines, you must specify the name of the engine that you want to delete.

Optional parameters

None.

Example

Delete the messaging engine from server1 on node1 that is a member of a bus1.

AdminTask.deleteSIBEngine ('[-bus bus1 -node node1 -server server1]') 



Related concepts
Message production and consumption by using remote message points
Related tasks
Unmediating a destination
Removing a messaging engine from a bus
Reference topic Reference 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=rjk_cli_me_delete
File name: rjk_cli_me_delete.html