modifySIBWMQServerBusMember command

Use the modifySIBWMQServerBusMember command to modify the attributes of a IBM MQ server bus member.

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

(iSeries) (iSeries) The wsadmin scripting client is run from Qshell. (iSeries) See Configure Qshell to run WebSphere scripts .

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

• For a list of the available service integration bus commands in Jython and a brief description of each command, enter at the wsadmin prompt:

  print AdminTask.help('SIBAdminCommands')

• For overview help on a given command, enter at the wsadmin prompt:

  print AdminTask.help('command_name')

After using the command, save the changes to the master configuration using the following command:

AdminConfig.save()

An IBM MQ server bus member is used for assigning queue points and mediation points to IBM MQ queues. This command modifies the attributes of an IBM MQ server bus member.

Target object

A selected IBM MQ server bus member.

Required parameters

-name

The administrative name of the IBM MQ server bus member. This value is the name specified in the -name parameter when creating the IBM MQ server definition.

-bus

The name of the service integration bus of which the IBM MQ server is a member.

Conditional parameters

None

Optional parameters

-virtualQueueManagerName

When sending messages to IBM MQ, the IBM MQ gateway queue manager sees the bus as a remote queue manager. The virtual queue manager name is the name that is passed to IBM MQ as the name of this remote queue manager.

The default is the name of the Service Integration bus. If this bus name is not a valid name for an IBM MQ queue manager, or if another IBM MQ queue manager already has the same name, replace the default value with a unique, valid name for an IBM MQ queue manager.

• It must contain between 1 and 48 characters.
• It must conform to the IBM MQ queue naming rules (see the Rules for naming IBM MQ objects topic in the IBM MQ information center).

-host

The new value for the overridden host attribute. This value is the name or the IP address of the host to which a connection is established for communicating with a queue manager or queue-sharing group that this IBM MQ server represents. The value is a string and must be one of the following:

• Symbolic host name
• IPv4 address
• IPv6 address

-port

The new value for the overridden port attribute. This value is the TCP/IP port number on which the queue manager or queue-sharing group that this IBM MQ server represents listens. The default is 1414.

-channel

The new value for the overridden channel attribute. This value is the IBM MQ client channel name to use when connecting to the queue manager or queue-sharing group that this IBM MQ server represents. The default is SYSTEM.DEF.SVRCONN.

-securityAuthAlias

The new value for the overridden securityAuthAlias attribute. This value is the authentication alias to use when connecting to a queue manager or queue-sharing group. This parameter is not the same as the discovery authentication alias.

-transportChain

The new value for the overridden transportChain attribute. This value is the outbound transport chain to use when establishing a connection with IBM MQ. The default is OutboundBasicWMQClient.

-trustUserIds TRUE | FALSE

The new value for the overridden trustUserIds attribute. This value determines whether user identifiers received in messages from IBM MQ are propagated into the message (that is, whether user identifiers received as part of message data are used in the service integration bus). The application user identifier is always set from the jsAppUserId RFH2 value. If this is not present (either because the key/value pair is not present in the RFH2 header, or because the message does not have a RFH2 header), this field is not set. If we set this value to FALSE, the user identifier is overwritten with the IBM MQ server name. This parameter has two possible values:

TRUE

User identifiers are propagated into messages.

FALSE

User identifiers are not propagated into messages.

The default is TRUE.

Example

• Use Jython:

  wsadmin>AdminTask.modifySIBWMQServerBusMember(["-name", "Finance dept QM-Bus1", 
  "-bus", "Bus1", "-trustUserIds", "false"])
  

• Use Jacl:

  wsadmin>$AdminTask modifySIBWMQServerBusMember {-name "Finance dept QM-Bus1"
   -bus Bus1 -trustUserIds false}