modifySIBMediation command
Use the modifySIBMediation command to change the properties of a mediation.
如果要執行這個指令,請使用 wsadmin Scripting 用戶端的 AdminTask 物件。
wsadmin Scripting 用戶端是從 Qshell 執行.
如需相關資訊,請參閱利用 wsadmin Script 配置 Qshell 來執行 WebSphere Script.
- 如需 Jython 中可用的服務整合匯流排指令清單,以及每個指令的簡要說明,請在 wsadmin 提示下,輸入下列指令:
print AdminTask.help('SIBAdminCommands')
- 如需給定指令的概觀說明,請在 wsadmin 提示下,輸入下列指令:
print AdminTask.help('command_name')
AdminConfig.save()
Purpose
This command changes properties of a mediation.
Target object
A mediation.
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
- -globalTransaction TRUE | FALSE
- FALSE
- A local transaction is started for each message processed. You only have 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
- 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
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
- 鑑別器
Compare this property with the selector property. The rule specified by the selector examines the header and properties of the message, whereas 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
- Using Jython:
wsadmin>AdminTask.showSIBMediation("-bus abus -mediationName switchMed") {uuid 39588C4821BB046E} {selector {}} {contextInfo {}} {discriminator {}} {allowConcurrentMediation false} {globalTransaction false} {mediationName switchMed} {handlerListName switchHandler} {description {}} wsadmin>AdminTask.modifySIBMediation(["-bus", "abus", "-mediationName", "switchMed", "-selector", ["JMSXDeliveryCount > 1000"]] ) wsadmin>AdminTask.showSIBMediation("-bus abus -mediationName switchMed") {uuid 39588C4821BB046E} {selector {JMSXDeliveryCount > 1000}} {contextInfo {}} {discriminator {}} {allowConcurrentMediation false} {globalTransaction false} {mediationName switchMed} {handlerListName switchHandler} {description {}}
- Using Jacl:
wsadmin>$AdminTask showSIBMediation {-bus abus -mediationName switchMed} {uuid 39588C4821BB046E} {selector {}} {contextInfo {}} {discriminator {}} {allowConcurrentMediation false} {globalTransaction false} {mediationName switchMed} {handlerListName switchHandler} {description {}} wsadmin>$AdminTask modifySIBMediation {-bus abus -mediationName switchMed -selector {JMSXDeliveryCount > 1000}} wsadmin>$AdminTask showSIBMediation {-bus abus -mediationName switchMed} {uuid 39588C4821BB046E} {selector {JMSXDeliveryCount > 1000}} {contextInfo {}} {discriminator {}} {allowConcurrentMediation false} {globalTransaction false} {mediationName switchMed} {handlerListName switchHandler} {description {}}