WebSphere WebSphere Application Server Express, Version 6.0.x Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Mediating a bus destination through the command line

Use this command to mediate a bus destination for a service integration bus.

Before you begin

Mediating a destination associates a mediation with a selected bus destination. At run-time, the mediation applies some message processing to the messages handled by the bus destination. Note that you can only mediate a destination with a single mediation at a time. You can mediate more than one destination with the same mediation.

The command described in this topic is run using the AdminTask object of the wsadmin scripting client.

This command is only valid when run against WebSphere Application Server Version 6 application servers. Do not run it against earlier versions.

Command-line help is provided with each of the service integration technologies commands:
  • For a list of all the available service integration bus commands, plus a brief description of each command, type the following command:
    wsadmin> $AdminTask help SIBAdminCommands
  • For detailed help on a given command, enter the following command:
    wsadmin> $AdminTask help command_name

For additional details of the command properties, see the related reference topic.

Purpose

This command mediates a bus destination for a service integration bus.

Command name
mediateSIBDestination
Target
None.
Result
A bus destination object.

To save the changes made by the command, invoke the "save" command on the AdminConfig object.

Required Parameters

-bus busname
The name of the service integration bus on which the bus destination is to be created. You can use the listSIBuses command to list the names of existing buses.
-destinationName destname
The identifier by which this destination is known for administrative purposes.
-mediationName mediation_name
The name of the mediation to be applied to the bus destination. This mediation must exist before this command can be used.

Conditional Parameters

-node nodename -server servername
[Not topic space] To mediate the bus destination to a server bus member, specify both the name of the node on which the server runs and the name of the server.
-cluster cluster
[Not topic space] To mediate the bus destination to a cluster bus member, specify the name of the cluster.

This option should be used only in WebSphere Application Server environments that support server clusters.

Optional Parameters

None.

Example

wsadmin>$AdminTask mediateSIBDestination {-bus abus -destinationName myqueue
 -mediationName filterMed -cluster cluster1}

Reference topic

Terms of Use | Feedback

Last updated: 2 Aug 2005
http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.pmc.express.doc\ref\rjo_cli_dest_mediate.html

© Copyright IBM Corporation 2004, 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)