deleteSIBDestination command

Use the deleteSIBDestination command to delete a bus destination.

This command deletes the named destination on the named bus, and deletes all related message points.

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

[IBM i][IBM i]The wsadmin scripting client is run from Qshell.

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 by using the following command:

AdminConfig.save()

Purpose

The deleteSIBDestination command deletes the named destination on the named bus, and deletes all related message points. This command also finds and cleans up all destinations that are assigned to IBM MQ server bus members, and all destinations that are mediated to an IBM MQ queue. This command does not delete messages from IBM MQ queues, and it does not delete the queues.

Target object

A bus destination.

Required parameters

-bus
The name of the service integration bus on which the bus destination is configured. You can use the listSIBuses command to list the names of existing buses.
-name
The identifier by which this destination is known for administrative purposes.
-aliasBus
If the destination to be deleted is an alias destination and was created with the aliasBus parameter, then the same value must be used to delete the destination.
-foreignBus
If the destination to be deleted is a foreign destination, then the foreign destination parameter must be supplied.

Conditional parameters

None.

Optional parameters

None.

Example

  • Using Jython:
    wsadmin>AdminTask.deleteSIBDestination("-bus abus -name myqueue")

wsadmin>AdminConfig.save()
  • Using Jacl:
    wsadmin>$AdminTask deleteSIBDestination {-bus abus -name myqueue}

wsadmin>$AdminConfig save