JMS 啟動規格 [設定]

如果要在主控台中檢視這個頁面,請按下列其中一個路徑:
  • 資源 -> JMS -> 啟動規格 -> activation_specification_name
  • 資源 -> JMS -> JMS 提供者 -> a_messaging_provider -> [其他內容] 啟動規格 -> activation_specification_name
Use this panel to browse or change the configuration properties of the selected JMS activation specification for use with the default messaging provider.

如果想要利用訊息驅動 Bean,透過「Java™ EE 連接器架構 (JCA) 1.5」來與預設傳訊提供者通訊,您可以建立一個 JMS 啟動規格。JCA 提供在 WebSphere® Application Server 之類應用程式伺服器和企業資訊系統之間的 Java 連線功能。 它提供將 JMS 提供者與 Java EE 應用程式伺服器整合起來的標準方法,並且也提供與企業系統交換資料的架構,以訊息形式來傳送資料。

在相關聯的 EJB 2.1 或更新版本的訊息驅動 Bean 的部署描述子中,適當命名的啟動配置內容,會置換名稱JNDI 名稱目的地 JNDI 名稱目的地查閱,以及鑑別別名以外的所有啟動規格配置內容。 如果是 EJB 2.0 訊息驅動 Bean,部署描述子中對應的元素會置換 Destination typeSubscription durabilityAcknowledge modeMessage selector 等內容。 不論任何一種 Bean 類型,訊息驅動 Bean 連結中所指定的值都可以置換目的地 JNDI 名稱目的地查閱內容。

The activation specification properties influence how the default messaging provider chooses the messaging engine to which your message-driven bean application connects. 依預設,環境會自動將應用程式連接到匯流排上可用的傳訊引擎。 不過,您可以指定額外的配置詳細資料來影響連線程序;比方說,識別特殊的引導伺服器,或是限制只能連線到某些可用傳訊引擎的子群組,或改進可用性或效能,或確保收到之訊息的循序處理。 For information about why and how to do this, see the topic How JMS applications connect to a messaging engine on a bus.

「配置」標籤

「配置」標籤顯示這個物件的配置內容。 這些內容會保留下來,即使停止並重新啟動執行時期環境也一樣。請參閱資訊中心作業說明,以取得如何將配置變更套用於執行時期環境的相關資訊。

一般內容

範圍

Specifies the highest topological level at which application servers can use this resource object.

Information Value
必要
資料類型 字串

提供者

Specifies a JMS provider, which enables asynchronous messaging based on the Java Message Service (JMS). It provides J2EE connection factories to create connections for specific JMS queue or topic destinations. JMS provider administrative objects are used to manage JMS resources for the associated JMS provider.

Information Value
必要
資料類型 字串

名稱

The required display name for the resource.

Information Value
必要
資料類型 字串

JNDI 名稱

The JNDI name for the resource.

Type the JNDI name that is specified in the bindings for message-driven beans associated with this activation specification.
Information Value
必要
資料類型 字串

說明

An optional description for the resource.

Information Value
必要
資料類型 文字區

目的地類型

Information Value
必要
資料類型 下拉清單
範圍
佇列
訊息驅動 Bean 使用 JMS 佇列。JMS 佇列的 JNDI 名稱指定在 Destination JNDI name 內容中。

主題
訊息驅動 Bean 使用 JMS 主題。JMS 主題的 JNDI 名稱指定在 Destination JNDI name 內容中。

目的地查閱

Type the JNDI name that the message-driven bean uses to look up the JMS destination in the JNDI namespace.

Select the type of destination on the 目的地類型 property.

For resource adapters that support JMS you must associate javax.jms.Destinations with an activation specification, such that the resource adapter can service messages from the JMS destination. In this case, the administrator configures a J2C Administered Object that implements the javax.jms.Destination interface and binds it into JNDI.

You can configure a J2C Administered Object to use an ActivationSpec class that implements a setDestination(javax.jms.Destination) method. In this case, you can specify the Destination lookup (that is, the JNDI name for the J2C Administered object that implements the javax.jms.Destination).

During application start up, when the activation specification is being initialized as part of endpoint activation, the server uses the Destination lookup to look up the destination administered object then set it on the activation specification instance.
Note: The Destination lookup property is referred to as Destination JNDI name in the earlier versions of WebSphere Application Server. In the JMS 2.0 specification, the property name is changed to Destination lookup for the message-driven bean (MDB) to receive messages from the JMS Queue or JMS topic.
Information Value
必要
資料類型 字串

Connection factory lookup

JNDI name of the connection factory.

Type JNDI name of the connection factory that the message-driven bean uses to look up the connection factory properties and overwrite them in activation specification properties.
Note: When the connection factory lookup is defined in the activation specification as the JNDI name, the connection factory properties take precedence over the properties defined in the activation specification configuration. For example, a client ID set as part of the connection factory JNDI takes precedence over the client ID defined in the activation specification configuration properties.
Information Value
必要
資料類型 字串

訊息選取器

For example:
JMSType='car' AND color='blue' AND weight>2500

The selector string can refer to fields in the JMS message header and fields in the message properties. Message selectors cannot reference message body values.

A null value (an empty string) indicates that there is no message selector for the message consumer.

Information Value
必要
資料類型 字串

匯流排名稱

Type the name of the service integration bus to which connections are made. This must be the name of the bus on which the destination identified by the 目的地查閱 property is defined.
Information Value
必要
資料類型 自訂

確認模式

The acknowledge mode indicates how a message received by a message-driven bean should be acknowledged.
Note:

刪除訊息時會傳送確認通知。

如果您有非交易式訊息驅動 Bean,系統會在 Bean 啟動或完成時刪除訊息。如果 Bean 產生異常狀況,並因此而沒有完成,系統會採取下列其中一項動作:
  • 如果系統的配置是在 Bean 完成時刪除訊息,則訊息會分派給新的 Bean 實例,因此就有另一次機會可以處理訊息。
  • 如果系統的配置是在 Bean 啟動時刪除訊息,則訊息會遺失。

如果服務品質設為最大努力非持續性,訊息會在 Bean 啟動時刪除。如果是所有的其他服務品質,則會在 Bean 完成時刪除訊息。

Information Value
必要
資料類型 下拉清單
範圍
Auto-acknowledge
階段作業會自動確認訊息的遞送。

Duplicates-ok auto-acknowledge
階段作業會慢慢地確認訊息遞送,這可增進效能,但會導致訊息驅動 Bean 多次接收訊息。

目標

Information Value
必要
資料類型 字串

目標類型

Information Value
必要
資料類型 下拉清單
範圍
匯流排成員名稱
匯流排成員的名稱。這個選項會擷取指定的匯流排成員(應用程式伺服器或伺服器叢集)所管理的作用中傳訊引擎。

自訂傳訊引擎群組名稱
傳訊引擎自訂群組(形成自我宣告的叢集)的名稱。這個選項會擷取登錄在指名自訂群組中的作用中傳訊引擎。

傳訊引擎名稱
傳訊引擎的名稱。這個選項會擷取可用來連接指名的傳訊引擎的端點。

目標重要性

Information Value
必要
資料類型 下拉清單
範圍
偏好的
傳訊引擎最好是選自目標群組。如果目標群組中有可用的傳訊引擎,就會選取它。如果目標群組中沒有可用的傳訊引擎,而在相同的服務整合匯流排中有可用的傳訊引擎,則會選取目標群組外的傳訊引擎。

必要
傳訊引擎必須選自目標群組。如果目標群組中有可用的傳訊引擎,就會選取它。如果目標群組中沒有可用的傳訊引擎,連線程序會失敗。

目標入埠傳輸鏈

如果所選傳訊引擎位於應用程式所在相同伺服器,則會進行直接的進行中連線,且會忽略這個傳輸鏈內容。

傳輸鏈代表在伺服器內作業的網路通訊協定堆疊。 您指定的名稱必須是如伺服器 -> 伺服器類型 -> WebSphere Application Server -> server_name -> [伺服器傳訊] 傳訊引擎入埠傳輸所列,是管理傳訊引擎的伺服器所提供的傳輸鏈之一。 提供的傳輸鏈如下,但您可以在這個畫面中定義您自己的傳輸鏈。
InboundBasicMessaging
這是一個使用標準 TCP/IP 連線 (JFAP-TCP/IP) 的連線導向通訊協定。它支援兩段式交易 (遠端 XA) 流程,所以在用戶端或伺服器系統上執行的訊息生產者或消費者,都可以參與該用戶端或伺服器系統所管理的廣域交易。 XA 流程的特定用途,是支援從執行於某伺服器的應用程式存取在第二部伺服器上的傳訊引擎,原因可能是第一部伺服器沒有適當的傳訊引擎。 如果使用遠端 XA 流程,應用程式必須能夠在本端使用交易協調程式。
InboundSecureMessaging
這是包裝在 SSL 中的 InboundBasicMessaging 通訊協定。
如需這個內容要如何與其他 Connection Factory 內容搭配使用,以管理連線工作量的相關資訊,請參閱「JMS 與匯流排連線的管理內容」主題。
Information Value
必要
資料類型 字串

提供者端點

A comma-separated list of endpoint triplets, with the syntax hostName:portNumber:chainName, used to connect to a bootstrap server. For example Merlin:7276:BootstrapBasicMessaging,Gandalf:5557:BootstrapSecureMessaging.

Provider endpoints are not used unless the specified bus cannot be found in the local cell. Message-driven bean (MDB) applications first attempt to connect the specified bus in the local cell. If this attempt fails, provider endpoints are used to allow the applications to consume messages from a remote cell.

If the host name is not specified, localhost is used as a default value.

If the port number is not specified, 7276 is used as the default value.

If the protocol is not specified, a predefined chain such as BootstrapBasicMessaging is used as the default value.

Information Value
必要
資料類型 文字區

批次大小上限

The maximum number of messages in a single batch delivered serially to a single message-driven bean instance. Batching of messages can improve performance particularly when used with 確認模式 set to Duplicates-ok auto-acknowledge. If message-ordering must be retained across failed deliveries, set the batch size to 1.
Information Value
必要
資料類型 整數
範圍 1 through 2147483647

每個端點的並行 MDB 呼叫數目上限

Increasing this number can improve performance but can increase the number of threads that are in use at any one time. If message ordering must be retained across failed deliveries, set the maximum concurrent endpoints to 1. Message ordering applies only if the destination that the message-driven bean is consuming from is not a partitioned destination. Partitioned destinations are used in a workload sharing scenario in a cluster.
Information Value
必要
資料類型 整數
範圍 1 through 2147483647

在重複的訊息失敗時自動停止端點

These parameters enable an endpoint to stop automatically when the number of sequentially failing messages reaches a limit that you specify. This helps to distinguish between one or two messages that fail because of problems with the messages themselves, and a system resource problem that results in many sequentially failing messages.

Stopping the endpoint reduces the number of messages being moved unnecessarily to an exception destination when the problem is not caused by messages that are failing to be processed.

When an endpoint is stopped automatically, its Status on the administrative console panel is red. It must be restarted manually by clicking Resume.

After an endpoint is restarted, any failing messages that caused the endpoint to be stopped are retried. If they continue to fail they are moved to an exception destination, if configured.

啟用

Information Value
必要
資料類型 布林

循序失敗訊息臨界值

This property is not enabled unless the 在重複的訊息失敗時自動停止端點 property is enabled.

Information Value
必要
資料類型 整數

失敗訊息重試的延遲間隔

Setting a delay between failing message retries reduces the number of messages unnecessarily moved to the exception destination before the MDB is stopped. To minimize the number of messages that are moved, make this delay greater than the expected time interval between messages arriving on the destination.

This property is not enabled unless the 在重複的訊息失敗時自動停止端點 property is enabled.

Information Value
必要
資料類型 整數
範圍 The time in milliseconds. A value of 0 indicates no delay between retries.

訂閱延續性

Usually, only one application at a time can have a consumer for a particular durable subscription. This property enables you to override this behavior, to enable a durable subscription to have multiple simultaneous consumers.
Information Value
必要
資料類型 下拉清單
範圍
可延續
傳訊提供者會在訊息驅動 Bean 無法使用時儲存訊息,並在訊息驅動 Bean 重新變成可用時遞送訊息。

不可延續
如果訊息驅動 Bean 無法使用,傳訊提供者就不會儲存和重新遞送訊息。

訂閱名稱

Each JMS subscription is identified by a subscription name (specified on this property). A JMS connection also has an associated client identifier (specified on the 用戶端 ID property), which is used to associate a connection and its objects with the list of messages (on the subscription) that is maintained by the JMS provider for the client.

This subscription name must be unique within a given client identifier.

Information Value
必要
資料類型 字串

用戶端 ID

The value specified is a unique identifier for a client (message-driven bean). The client identifier is used to associate a client connection with the list of messages (on a subscription) that the messaging provider keeps for the client. When a client becomes available again, after a being unavailable, the messaging provider uses the client identifier to redeliver stored messages to the correct client.
Information Value
必要
資料類型 字串

訂閱首頁

Administrators can manage the runtime state of subscriptions through publication points for this messaging engine.
Note: For shared nondurable subscription, the messaging engine name value under the Subscription home field is treated as the target messaging engine. So any messaging engine name that is defined under the Target field is ignored.
Information Value
必要
資料類型 字串

Pass message payload by reference

當傳送大型物件訊息或位元組訊息時,為了序列化、解除序列化及複製訊息有效負載,可能會耗用大量的記憶體和處理器成本。如果您在 Connection Factory 或啟動規格上啟用 pass message payload by reference 內容,您會通知預設傳訊提供者置換 JMS 1.1 規格,這項資料的複製有可能會縮減或略過。
CAUTION:
定義這些內容所略過的 JMS 規格部分,以確保訊息資料的完整性。 任何使用這些內容的 JMS 應用程式,都必須嚴格遵循「依參照傳遞 JMS 訊息有效負載的原因和時機」主題中所說明的規則,否則,會有喪失資料完整性的風險。

利用這個啟動規格來接收訊息的應用程式必須遵循下列規則:

  • 應用程式不會修改從 JMS 物件訊息取得的資料物件。資料物件是當作唯讀來處理。

Information Value
必要
資料類型 布林

利用這個啟動規格來重新傳送原來收到的訊息之應用程式必須遵循下列規則:

  • 如果資料物件尚未設在訊息中,應用程式可以取代 JMS 物件訊息中的資料物件。 在訊息內設定資料物件之後,應用程式就不會修改或取代資料物件。
  • 應用程式可以取代 JMS 位元組訊息中的位元組陣列,但必須是尚未在訊息內設定位元組訊息,且只能使用對於 writeBytes(byte[]) 的單一呼叫。在訊息內設定位元組陣列之後,應用程式就不會修改或取代位元組陣列。

Information Value
必要
資料類型 布林

共用可延續訂閱

Usually, only one session at a time can have a TopicSubscriber for a particular durable subscription. This property enables you to override this behavior, to enable a durable subscription to have multiple simultaneous consumers, one on each application server in the server cluster.
Information Value
必要
資料類型 下拉清單
範圍
在叢集中
在伺服器叢集中建立連線時,容許共用可延續訂閱。

一律共用
各連線可以共用可延續的訂閱。

絕不共用
各連線絕不共用可延續的訂閱

與 CMP 共用資料來源

這個選項用在「使儲存器管理持續性 (CMP) Entity Bean 能夠共用傳訊引擎的資料儲存庫所用的資料庫連線」的作業中。 經過評估,這有可能使整體通訊量增進 15% 的效能,不過,只適用於連接至傳訊引擎所在的應用程式伺服器之 Entity Bean。 不可對使用檔案儲存庫作為其資料儲存庫的傳訊引擎啟用這個選項。

如需使用這個選項的相關資訊,請參閱「啟用 CMP Entity Bean 和傳訊引擎資料儲存庫以共用資料庫連線」主題。

Information Value
必要
資料類型 布林

先讀

指派給消費者的訊息已在伺服器上鎖定,而該目的地的任何其他消費者都無法使用那些訊息。指派給消費者的訊息,如果在這個消費者關閉之前都未使用,之後便會在伺服器中解開鎖定,任何其他消費者都可以接收它。

您可以設定個別 JMS 目的地的 Read ahead 內容來置換 JMS 目的地的這個內容。

Information Value
必要
資料類型 下拉清單
範圍
預設值
訊息提供者會事先將訊息指派給不可延續的訂閱和非共用的可延續訂閱的消費端。也就是說,必須在只能有單一消費端時,才會開啟先讀最佳化。

已啟用
傳訊提供者會事先將訊息指派給消費端。這會改進滿足消費者要求所花的時間。

已停用
傳訊提供者不會事先將訊息指派給消費端。

一律在所有伺服器中啟動 MDB

This property is only used when the MDB application is running on a server that is a member of the bus that the application is targeting. It has no effect when the MDB is running on a server that is not a member of the target bus.

If the MDB application is running on a server that is a member of the target bus, enabling this option allows the MDB application to process messages whether or not the server also hosts a running messaging engine. If this option is not enabled, then MDB applications on servers that do not have a local ME running do not process messages.

For MDB applications connecting to a cluster bus member, you can also use this option to enable either of the following additional configurations:
  • 叢集內的所有伺服器都可以從 MDB 應用程式接收訊息,以充分運用叢集的處理能力。
  • 每次只有一部伺服器能夠接收來自 MDB 應用程式的訊息,以確保會循序處理訊息。
To enable all servers in the cluster to receive messages from the MDB application, select this option. To enable just one server at a time to receive messages from the MDB application, check that this option is not selected and select the receive exclusive option on the destination.

For more information, see the topic How a message-driven bean connects in a cluster.

Information Value
必要
資料類型 布林

重試間隔

Information Value
必要
資料類型 整數
範圍 1 through 2147483647

鑑別別名

A Java Platform, Enterprise Edition (Java EE) Connector Architecture (JCA) authentication alias specifies the user ID and password that is used to authenticate the creation of a new connection to the JMS provider.

The user name and password custom properties fields must be left unspecified if the authentication alias field used. Authentication alias properties set as part of application deployment take precedence over properties set on an activation specification administrative object.

Only the authentication alias is ever written to file in an unencrypted form, even for purposes of transaction recovery logging. The security service is used to protect the real user name and password.

During application startup, when the activation specification is being initialized as part of endpoint activation, the server uses the authentication alias to retrieve the real user name and password from security then set it on the activation specification instance.

Information Value
必要
資料類型 下拉清單

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



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