modifySIBLink command

Use the modifySIBLink command to modify the properties of a service integration bus link.

如果要執行這個指令,請使用 wsadmin Scripting 用戶端AdminTask 物件

[IBM i][IBM i]wsadmin Scripting 用戶端是從 Qshell 執行. [IBM i]如需相關資訊,請參閱利用 wsadmin Script 配置 Qshell 來執行 WebSphere Script.

服務整合匯流排指令有指令行說明:
  • 如需 Jython 中可用的服務整合匯流排指令清單,以及每個指令的簡要說明,請在 wsadmin 提示下,輸入下列指令:

    print AdminTask.help('SIBAdminCommands')

  • 如需給定指令的概觀說明,請在 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
這個內容是依照 JMS Connection Factory 設定中的 Provider endpoint 內容的相同方式來設定的。 如需相關資訊,請參閱Configuring a connection to a non-default bootstrap server中,關於設定引導端點的步驟。

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.
系統
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.
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.
指定
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 已啟動
Range
已停止
當啟動相關的傳訊引擎時,閘道鏈結在已停止的狀態中,無法處理任何新的連線要求。
已啟動
啟動相關聯的傳訊引擎時,閘道鏈結處於已啟動狀態,且可以處理任何新的連線要求。
-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 Server7.0 版或更新版本 server or client, and that is connected to a messaging engine running on WebSphere Application Server7.0 版或更新版本 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]')

指出主題類型的圖示 參照主題



時間戳記圖示 前次更新: July 9, 2016 11:12
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjj_siblink_modify
檔名:rjj_siblink_modify.html