Modifying a service integration bus using the wsadmin tool

Use the wsadmin tool to change properties of a service integration bus.

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

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

This command is only valid when used with WebSphere® Application Server Version 6 and later application servers. Do not use it with earlier versions.

Command-line help is provided for service integration bus commands:

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

Purpose

This command modifies the properties of a service integration bus.

Command name
modifySIBus
Target
None.
Result
A bus object (modified).

To save the changes made by the command, type $AdminConfig save.

Required parameters

-bus busname
The name by which the service integration bus is known. You can use the listSIBuses command to list the names of existing buses.

Conditional parameters

None.

Optional parameters

-description text
An optional description for the bus, for administrative purposes.
-secure TRUE | FALSE
Set this option to TRUE to inherit the global security setting of the cell. Set this option to FALSE if you always want to disable bus security.
Set this option to TRUE to enforce the authorization policy for the bus, which also requires administrative security to be enabled. Set this option to FALSE if you always want to disable bus security. If administrative security is disabled the bus is insecure.
-mediationsAuthAlias name
The name of the authentication alias used to authorize mediations to access the bus.
-protocol protocol
The transport chain used for communication between messaging engines in this bus.
-discardOnDelete TRUE | FALSE
Set this option to TRUE if messages on a deleted message point can be discarded. Set this option to FALSE if messages on a deleted message point should be retained at a system exception destination.
-permittedChains ALL | SSL_ENABLED | LISTED
Set one of three options to enforce a transport policy for the bus.
ALL
Allow the use of all defined transport channel chains.
SSL_ENABLED
Restrict the use of defined transport channel chains to those protected by SSL.
LISTED
Restrict the use of defined transport channel chains to the list of protected transports.

Example

wsadmin>$AdminTask modifySIBus {-bus anewbus -description "A bus called anewbus,
 which I have modified"} 
anewbus(cells/9994GKCCell/buses/anewbus|sib-bus.xml)
wsadmin>



Related reference
Buses administrative commands
Reference topic    

Terms of Use | Feedback

Last updated: Aug 29, 2010 9:31:45 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=vela&product=was-nd-mp&topic=rjj_cli_bus_modify
File name: rjj_cli_bus_modify.html