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