modifySIBWMQServerBusMember command

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

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

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:

After using the command, save your changes to the master configuration; for example, by using the following command:
 $AdminConfig save

Purpose

You use a WebSphere MQ server to configure a direct (single bus) connection to a WebSphere MQ for z/OS® queue manager or queue sharing group. This command modifies the attributes of a WebSphere MQ server bus member.

Target object

A selected WebSphere MQ server bus member.

Required parameters

-name
The name of the WebSphere MQ server bus member. This value is the name specified in the -name parameter when creating the WebSphere MQ server definition.
-bus
The name of the service integration bus of which the WebSphere MQ server is a member.

Conditional parameters

None

Optional parameters

-host
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 WebSphere MQ server represents. The value is a string and must be one of the following:
  • Symbolic host name
  • IPv4 address
  • IPv6 address
-port
New value for the overridden port attribute. This value is the TCP/IP port number where the queue manager or queue sharing group that this WebSphere MQ server represents listens. The default value is 1414.
-channel
New value for the overridden channel attribute. This value is the WebSphere MQ client channel name to use when connecting to the queue manager or queue sharing group that this WebSphere MQ server represents. The default value is SYSTEM.DEF.SVRCONN.
-securityAuthAlias
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
New value for the overridden transportChain attribute. This value is the outbound transport chain to use when establishing a connection with WebSphere MQ. The default is OutboundBasicWMQClient.
-trustUserIds TRUE | FALSE
New value for the overridden trustUserIds attribute. Determines whether or not user identifiers received in messages from WebSphere MQ are propagated into the message or not (that is, whether or not 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 you set this value to FALSE, the user identifier is overwritten with the WebSphere MQ server's 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

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



Related reference
SIBAdminCommands: WebSphere MQ server administrative commands for the AdminTask object
Reference topic Reference topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 30, 2013 8:21:57 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-express-iseries&topic=rjfp_cli_mqserver_busm_mod
File name: rjfp_cli_mqserver_busm_mod.html