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

Modifying a mediation through the command line

Use this command to change properties of a mediation.

Before you begin

This command provides only a subset of the properties available. If you want to set other properties, you need to use the administrative console or wsadmin and JACL

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 changes properties of a mediation.

Command name
modifySIBMediation
Target
None.
Result
A mediation object (modified).

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 mediation is to be created. You can use the listSIBuses command to list the names of existing buses.
-mediationName mediation_name
The name by which this mediation is known for administrative purposes.

Conditional Parameters

None.

Optional Parameters

-description text
An optional description for the mediation, for administrative purposes.
-handlerListName
The name of the handler list that was defined when the mediation was deployed.
-globalTransaction TRUE | FALSE
Whether or not a global transaction is started for each message processed.
FALSE
A local transaction is started for each message processed. You only need to select this option for mediations that access other resource managers such as databases, or interact with enterprise beans that require a global transaction.
TRUE
A global transaction is started for each message processed.
-allowConcurrentMediation TRUE | FALSE
Select this option (setting it to true) to apply the mediation to multiple messages concurrently. Message ordering is not preserved. The default option is false.
TRUE
Apply the mediation to multiple messages concurrently, and preserve message ordering.
FALSE
Apply the mediation to a single message at a time. This setting is required to ensure that message ordering is preserved.
-selector text
Controls which messages are sent to the mediation. If a message matches the rule defined by the selector text string, then the mediation is applied to the message.

If the message does not match the rule defined by the selector text string, then the message is not mediated. If a message contains both Selector and Discriminator, it must match both rules for the message to be mediated. If either the Selector or the Discriminator rule does not match, the message is not mediated.

-discriminator text
Discriminator

Compare this property with the selector property. The rule specified by the selector examines the header and properties of the message, while the discriminator examines the topic of the message. If a message contains both selector and discriminator, it must match both rules for the message to be mediated. If either the selector or the discriminator rule does not match, the message is not mediated.

Example

wsadmin>$AdminTask showSIBMediation {-bus abus -mediationName switchMed}
{uuid 39588C4821BB046E}
{_Websphere_Config_Data_Version {}}
{_Websphere_Config_Data_Id cells/9994GKCCell01/buses/abus|sib-mediations.xml#SIBDestinationMediation_1098220051588}
{selector {}}
{contextInfo {}}
{discriminator {}}
{allowConcurrentMediation false}
{globalTransaction false}
{_Websphere_Config_Data_Type SIBDestinationMediation}
{mediationName switchMed}
{handlerListName switchHandler}
{description {}}

wsadmin>$AdminTask modifySIBMediation {-bus abus -mediationName switchMed -selector {JMSXDeliveryCount > 1000}}

wsadmin>$AdminTask showSIBMediation {-bus abus -mediationName switchMed}
{uuid 39588C4821BB046E}
{_Websphere_Config_Data_Version {}}
{_Websphere_Config_Data_Id cells/9994GKCCell01/buses/abus|sib-mediations.xml#SIBDestinationMediation_1098220051588}
{selector {JMSXDeliveryCount > 1000}}
{contextInfo {}}
{discriminator {}}
{allowConcurrentMediation false}
{globalTransaction false}
{_Websphere_Config_Data_Type SIBDestinationMediation}
{mediationName switchMed}
{handlerListName switchHandler}
{description {}}

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\rjp_cli_med_modify.html

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