modifySIBLink command
Use the modifySIBLink command to modify the properties of a service integration bus link.
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.
- 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')
AdminConfig.save()
Purpose
The modifySIBLink command modifies the properties of a service integration bus link.
Target object
None.
Required parameters
- -bus
- The name of the service integration bus for which you want to modify the service integration bus link. You can use the listSIBuses command to list the names of existing buses.
- -messagingEngine
- The name of the messaging engine for which you want to modify the service integration bus link. The service integration bus link connects a messaging engine to another messaging engine in a different service integration bus, thereby providing a bridge between two service integration buses.
- -name
- The name by which you want the service integration bus link to be known.
- -foreignBusName
- The name of the foreign bus that defines the remote service integration bus for the service integration bus link. You can use the listSIBForeignBuses command to list the names of existing foreign buses.
Conditional parameters
None.
Optional parameters
- -bootstrapEndpoints
- Esta propriedade é configurada da mesma forma que a propriedade do Nó de Extremidade do Fornecedor nas configurações do connection factory JMS. Para obter mais informações, consulte as etapas relacionadas à configuração de terminais de autoinicialização no Configurando uma Conexão com um Servidor de Auto-inicialização Não-padrão.
The port for the bootstrap endpoint is the port defined on the SIB endpoint address that is configured on the target application server on the foreign bus.
- -remoteMessagingEngineName
- -description
- An optional description for the bus, for administrative purposes.
- -protocolName
The transport chain name must be the name of the transport chain as defined on the server on which the target messaging engine is hosted.
- -authAlias
You must have predefined a J2C authentication alias.
- -exceptionDestination
- The destination for an inbound message when the service integration
bus link cannot deliver the message to its target destination, or
to the exception destination that is configured for that target destination,
or when the target destination does not exist.
- System
- The service integration bus link uses the default exception destination. All messages that cannot be delivered to the bus destination are rerouted automatically to the system default exception destination for the messaging engine that this link is assigned to: _SYSTEM.Exception.Destination.messaging_engine_name.
- Nenhum
- The service integration bus link has no exception destination. Undeliverable messages are not rerouted to an exception destination and can block the processing of other messages waiting for delivery to the same destination. This option can be used to preserve message ordering.
- Especificar
- The service integration bus link uses the exception destination specified here. If this is not possible, it uses the system exception destination.
- -initialState Started | Stopped
- The state of the gateway link, which shows whether the link is
started automatically when the messaging engine is started.
Information Value Default Started Range - Parado
- Quando o mecanismo do sistema de mensagens associado é iniciado, o link de gateway está em um estado parado e não pode processar novos pedidos de conexões.
- Started
- Quando o mecanismo do sistema de mensagens associado é iniciado, o link de gateway está em um estado iniciado e pode processar novos pedidos de conexões.
- -preferLocal TRUE | FALSE
- Indicates whether the link prefers to send incoming messages to
the queue point of the target destination that is located on the same
messaging engine as the link, if available. The link must be owned
by a messaging engine running on a WebSphere® Application
Server Version 7.0 or later server.
This option is supported only when used by a JMS application that is running with a WebSphere Application ServerVersão 7.0 ou posterior server or client, and that is connected to a messaging engine running on WebSphere Application ServerVersão 7.0 ou posterior server. Use on previous versions of WebSphere Application Server will result in an exception to the application.
Information Value Default TRUE Range - TRUE
- Send each incoming message to the queue point of the target destination that is located on the same messaging engine as the link, if available.
- FALSE
- Send incoming messages to any queue points of the target destinations.
Examples
wsadmin>AdminTask.showSIBLink('[-bus bus1 -messagingEngine node01.server1-bus1 -sibLink
mySIBLink]')
'{bootstrapEndpoints=host1:1111:chain1, protocolName=null, authAlias=null,
preferLocalQueuePoints=true, name=mySIBLink, uuid=34647E59163B253D,
remoteMessagingEngineName=node02.server2-bus2, description=null,
targetUuid=BAD49BA75CD36D740E366978, initialState=STARTED,
exceptionDestination=$DEFAULT_EXCEPTION_DESTINATION}'
wsadmin>AdminTask.modifySIBLink('[-bus bus1 -messagingEngine node01.server1-bus1
-name MySIBLink -foreignBusName -bus2
-bootstrapEndpoints anotherhost:2222:BootstrapBasicMessaging]')
wsadmin>AdminTask.showSIBLink('[-bus bus1 -messagingEngine node01.server1-bus1 -sibLink
mySIBLink]')
'{bootstrapEndpoints=anotherhost:2222:BootstrapBasicMessaging, protocolName=null,
authAlias=null, preferLocalQueuePoints=true, name=mySIBLink, uuid=34647E59163B253D,
remoteMessagingEngineName=node02.server2-bus2, description=null,
targetUuid=BAD49BA75CD36D740E366978, initialState=STARTED,
exceptionDestination=$DEFAULT_EXCEPTION_DESTINATION}'
Modify a service integration bus link so that there is no preference for which queue points to use.
AdminTask.modifySIBLink('[-bus bus1 -messagingEngine cluster1.000-bus1 -name MyLink
-foreignBusName -FB1 bootstrapEndpoints host1:1111:chain1 -remoteMessagingEngineName
-cluster2.000-FB1 -preferLocal FALSE]')