WebSphere WebSphere Enterprise Service Bus, Version 6.0.1 Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Modifying a foreign bus through the command line

Use this command to change properties of a foreign bus.

Before you begin

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

The command described in this topic is run using the AdminTask object of the wsadmin scripting client.

These command line scripts are run from Qshell. For more information, see the topic "Configure Qshell to run WebSphere Application Server scripts".

Required cleanup: Change to paragraph and flag for WAS6.1-onward (disable for WESB) This command is only valid when run against WebSphere Application Server Version 6.1 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 technologies 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 modifies the properties of a foreign bus. A foreign bus represents a bus in another cell (or within the same cell) or a WebSphere MQ network, with which a service integration bus can exchange messages.

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

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 modify a foreign bus. You can use the listSIBuses command to list the names of existing buses.
-name busname
The name of the foreign bus that you want to modify. You can use the listSIBForeignBuses command to list the names of existing buses.

Conditional Parameters

None.

Optional Parameters

-description text
An optional description for the bus, for administrative purposes.
-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 individual messages arriving from the foreign bus to destinations in the service integration bus. If this is not a secure bus, this property has no affect on messages. You may wish to specify an inbound user ID:
  • if the foreign bus is in a different security domain from this bus and user IDs from the foreign bus are not recognized in this bus
  • to locally-control access of inbound messages to this bus.
If this is a secure bus and the foreign bus is not secure, and no inbound user ID is set, any inbound messages from the foreign bus are 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 modifySIBForeignBus {-bus SCA.SYSTEM.IBM-AA8DA602255Cell01.Bus -name SCA.SYSTEM.IBM-AA8DA602255Cell02.Bus -inboundUserid iuserid -outboundUserid ouserid }
SCA.SYSTEM.IBM-AA8DA602255Cell02.Bus(cells/IBM-AA8DA602255Cell01/buses/SCA.SYSTEM.IBM-AA8DA602255Cell01.Bus|sib-bus.xml#SIBForeignBus_1132530748562)
wsadmin>
Related reference
Foreign bus settings

Reference topic

Terms of Use | Rate this page

Timestamp iconLast updated: 13 Dec 2005
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.websphere.wesb.doc\ref\rjj_fbus_modify.html

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