WebSphere WebSphere Application Server Version 6.1.x Feature Pack for Web Services Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows, z/OS

Creating a foreign bus using the wsadmin tool

Use this command to create a new foreign bus.

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

For i5/OS platforms The wsadmin scripting client is run from Qshell. For more information, see the topic "Configure Qshell to run WebSphere Application Server scripts".

This command is only valid when used with WebSphere Application Server Version 6.1 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 creates a new foreign bus for a specified service integration bus. A foreign bus represents a service integration bus, with which another service integration bus can exchange messages.

Command name
createSIBForeignBus
Target
None.
Result
A foreign bus object.

To save the changes made by the command, invoke the "save" command on the AdminConfig object.

Required parameters

-bus busname
The name of the service integration bus for which you want to create the foreign bus. You can use the listSIBuses command to list the names of existing buses.
-name busname
The name by which you want the foreign bus to be known.
Notes:
  • When you create a foreign bus that represents another service integration bus, the name of the foreign bus must match the name of the other service integration bus.
  • When you intend to link two buses directly, you must assign them unique names.
  • You must not change the name of a foreign bus name after it has been configured.
-routingType Direct | Indirect
Create a foreign bus with the physical link (also known as the routing type) specified:
Direct
A service integration bus link from a messaging engine in the local bus to a messaging engine in the foreign bus.
Indirect
An indirect link, that is, a link that is made through one or more intermediate foreign buses.

Conditional parameters

None.

Optional parameters

-description text
An optional description for the bus, for administrative purposes.
-type MQ | SIBus
Create a foreign bus with the type specified:
MQ
Create a foreign bus to link the service integration bus to a WebSphere MQ network.
SIBus
Create a foreign bus to link the service integration bus to another service integration bus.
-sendAllowed True | False
(Default: True) Whether or not producers can send messages to the foreign bus.
False
Producers cannot send messages to the foreign bus.
True
Producers can send messages to the foreign bus.
-inboundUserid userID
The inbound user ID is used to authorize inbound messages sent from a foreign bus to destinations in a secure service integration bus. If the bus is not secure, the inbound user ID property has no affect on messages. You may want to specify an inbound user ID for use in the following scenarios:
  • The foreign bus and the secure service integration bus are in different security domains, and the foreign bus user IDs are not recognized by the secure bus.
  • You want local control over access to the secure bus by inbound messages.
Note that if the receiving service integration bus is secure but the foreign bus is not secure, and an inbound user ID is not set, an inbound message from the foreign bus is only authorized to destinations that allow unauthenticated users access.
-outboundUserid userID
The outbound user ID replaces the user ID that identifies the source of a message in all messages being sent to the foreign bus. This user ID is also used by the foreign bus to authorize the message to its destination if both buses are secure buses and the foreign bus has not overridden the user ID with its own inbound user ID.
-nextHopBus bus_name
(If -routingType is Indirect) The name of the next service integration bus in the sequence of connected buses. An intermediate bus can be a WebSphere MQ system rather than a service integration bus.

Example

wsadmin>$AdminTask createSIBForeignBus {-bus SCA.SYSTEM.IBM-AA8DA602255Cell01.Bus -name SCA.SYSTEM.
IBM-AA8DA602255Cell02.Bus -routingType Direct -type SIBus}
SCA.SYSTEM.IBM-AA8DA602255Cell02.Bus(cells/IBM-AA8DA602255Cell01/buses/SCA.SYSTEM.IBM-AA8DA602255Cell01.
Bus|sib-bus.xml#SIBForeignBus_1132530748562)
wsadmin>

Reference topic

Terms of use | Feedback


Timestamp icon Last updated: 27 November 2008
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.pmc.wsfep.multiplatform.doc/ref/rjj_fbus_create.html

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