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

Creating a service integration bus using the wsadmin tool

Use the wsadmin tool to create a new service integration bus in the cell.

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 and later application servers. Do not run it against earlier versions.

Command-line help is provided with each of the commands:

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

Purpose

This command creates a new service integration bus in the cell.

Command name
createSIBus
Target
None.
Result
A bus object.

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

Required Parameters

-bus busname
The name by which you want the service integration bus to be known. Choose a unique name.

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.

The transport chain must correspond to one of the transport chains defined in the Messaging engine inbound transports settings for the server. All servers automatically have a number of transport chains defined to them, and it is also possible to create new transport chains.

The default transport chain is InboundBasicMessaging.

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

Example

wsadmin>$AdminTask createSIBus {-bus anewbus -description "A new bus called anewbus"}
anewbus(cells/9994GKCCell/buses/anewbus|sib-bus.xml#SIBus_1097531651175)
wsadmin>
Related concepts
Access control for multiple buses
Related tasks
Adding a foreign bus

Reference topic

Terms of Use | Feedback

Last updated: 15 Mar 2007
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.pmc.nd.doc\ref\rjj_cli_bus_create.html

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