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

Creating a service integration bus through the command line

Use this command to create a new service integration bus in the cell.

Before you begin

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 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, invoke the "save" command on the AdminConfig object.

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

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

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