createSIBMediation command

Use the createSIBMediation command to create a new mediation.

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

(iSeries) (iSeries) The wsadmin scripting client is run from Qshell. (iSeries) See Configure Qshell to run WebSphere scripts .

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 at the wsadmin prompt:

  print AdminTask.help('SIBAdminCommands')

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

  print AdminTask.help('command_name')

After using the command, save the changes to the master configuration using the following command:

AdminConfig.save()

This command creates a new mediation.

Target object

None.

Required parameters

-bus busname

The name of the service integration bus on which the mediation is to be created. 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.

-handlerListName

The name of the handler list that was defined when the mediation was deployed.

Conditional parameters

None.

Optional parameters

-description text

An optional description for the mediation, for administrative purposes.

-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. We 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

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, 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

• Use Jython:

  wsadmin>AdminTask.createSIBMediation("-bus abus -mediationName switchMed
   -handlerListName switchHandler")
  '(cells/9994GKCCell01/buses/abus|sib-mediations.xml#SIBDestinationMediation_1098219493014)'
  

• Use Jacl:

  wsadmin>$AdminTask createSIBMediation {-bus abus -mediationName switchMed
   -handlerListName switchHandler}
  (cells/9994GKCCell01/buses/abus|sib-mediations.xml#SIBDestinationMediation_1098219493014)