modifySIBWMQServerBusMember command
Use the modifySIBWMQServerBusMember command to modify the attributes of a IBM MQ server bus member.
Para executar o comando, utilize o objeto AdminTask do cliente de script wsadmin.
O cliente de script wsadmin é executado do Qshell.
Para obter informações adicionais, consulte Configurando o Qshell para Executar Scripts do WebSphere Usando o Script wsadmin.
A ajuda da linha de comandos é fornecida para comandos do barramento de integração de serviços:
- Para obter uma lista dos comandos de barramento de integração de
serviços disponíveis no Jython e uma breve descrição de cada comando, digite o seguinte
comando no prompt wsadmin:
print AdminTask.help('SIBAdminCommands')
- Para obter ajuda de visão geral sobre um determinado comando, digite o seguinte comando no prompt wsadmin:
print AdminTask.help('command_name')
Após utilizar o comando, salve suas alterações na configuração principal, utilizando o seguinte comando:
AdminConfig.save()
Purpose
A IBM MQ server bus member is used for assigning queue points and mediation points to IBM MQ queues. This command modifies the attributes of a IBM MQ server bus member.
Target object
A selected IBM MQ server bus member.
Required parameters
- -name
- 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 value is the name of the Service Integration bus. If this bus name is not a valid name for a 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 a IBM MQ queue manager.
- Deve conter entre 1 e 48 caracteres.
- Deve estar em conformidade com as regras de nomenclatura de fila do IBM MQ (consulte o tópico Regras para objetos de nomenclatura do IBM MQ no centro de informações do IBM MQ).
- -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 value 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 value 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 value is OutboundBasicWMQClient.
- -trustUserIds TRUE | FALSE
- The new value for the overridden trustUserIds attribute.
This value determines whether user identifiers that are received in messages
from IBM MQ are propagated
into the message (that is, whether user identifiers that are 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 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.
Example
- Using Jython:
wsadmin>AdminTask.modifySIBWMQServerBusMember(["-name", "Finance dept QM-Bus1", "-bus", "Bus1", "-trustUserIds", "false"])
- Using Jacl:
wsadmin>$AdminTask modifySIBWMQServerBusMember {-name "Finance dept QM-Bus1" -bus Bus1 -trustUserIds false}