IBM MQ custom properties

WebSphere® Application Server supports the use of custom properties to define IBM MQ properties. This is useful because it enables WebSphere Application Server to work with later versions of IBM MQ that might have properties that are not available in the WebSphere Application Server administrative console.

For WebSphere Application Server 7.0 版或更新版本, the custom properties that you define are validated by the IBM MQ resource adapter contained in WebSphere Application Server. In earlier releases, this was done within WebSphere Application Server itself, and then by the IBM MQ client jar files. If you have defined a property that is not valid for IBM MQ, the IBM MQ resource adapter creates an exception, which is caught by WebSphere Application Server, and logged in the Systemout.log and SystemErr.log files. Examples of error messages are given at the end of this topic.

When a later version of IBM MQ is available that is supported by the WebSphere Application Server installation, new IBM MQ properties might be created that are not known to WebSphere Application Server. You can configure these as custom properties through WebSphere Application Server so that they are recognized by the IBM MQ resource adapter. You can also configure WebSphere Application Server to point to the IBM MQ resource adapter in the external JMS provider, as described in Configuring the IBM MQ messaging provider with native libraries information.

For information on valid values for IBM MQ properties, refer to the Using Java and System Administration sections of the IBM MQ information center.

Note: 這個主題參照一或多個應用程式伺服器日誌檔。 此外,在分散式和 IBM® i 系統上,另外也建議您可以配置伺服器來使用「高效能可延伸記載 (HPEL)」日誌和追蹤基礎架構,而不使用 SystemOut.logSystemErr.log, trace.logactivity.log 檔案。HPEL 與原生 z/OS® 記載機能也可以一起使用。如果您使用 HPEL,則可以從伺服器設定檔 bin 目錄,利用 LogViewer 指令行工具來存取您所有的日誌和追蹤資訊。請參閱有關利用 HPEL 疑難排解應用程式的資訊,以取得更多使用 HPEL 的相關資訊。

The following scenarios illustrate how different cell configurations might be affected.

Mixed node scenario

In this mixed node scenario, a cell consists of a WebSphere Application Server, 9.0 版 deployment manager, two WebSphere Application Server, 第 6 版 nodes, and two WebSphere Application Server, 9.0 版 nodes. If a IBM MQ connection factory is defined at cell level and has custom properties defined that exploit the new fields available in IBM MQ, then the connection factory is only bound into the WebSphere Application Server cells that are at 9.0 版 level. The WebSphere Application Server, 第 6 版 nodes do not know about the new IBM MQ properties and do not bind into the Java™ Naming and Directory Interface (JNDI). The enhancements made to WebSphere Application Server, 9.0 版 allow validation of the properties to be deferred to the IBM MQ resource adapter.
Figure 1. Mixed node scenario

WebSphere MQ Version 7 or later scenario

In this scenario a cell consists of WebSphere Application Server, 9.0 版 deployment manager and nodes. The IBM MQ messaging provider is running at a level later than 第 6 版. WebSphere Application Server is using the default IBM MQ resource adapter shipped with WebSphere Application Server 9.0 版. In this scenario the IBM MQ resource adapter is not aware of the new IBM MQ properties so the validation fails and the connection factory does not bind into the JNDI.
Figure 2. Future version of IBM MQ scenario

Correctly configured scenario

In this scenario, which is similar to the previous one, a cell consists of WebSphere Application Server, 9.0 版 deployment manager and nodes. The IBM MQ messaging provider is running at a level later than 第 6 版. To successfully use the new IBM MQ properties it is necessary to configure the WebSphere Application Server to point to the IBM MQ resource adapter associated with the later version of IBM MQ.
Figure 3. Correctly configured scenario

Error message example

The exception created by the resource adapter contains error messages similar to the following example:
[09/02/06 15:40:06:377 GMT] 0000000a ContainerImpl E   WSVR0501E: Error creating
component null [class com.ibm.ws.runtime.component.ApplicationServerImpl]
com.ibm.ws.exception.RuntimeWarning: com.ibm.ws.runtime.component.binder.
ResourceBindingException: invalid configuration passed to resource binding logic.
REASON: Failed to create connection factory: Error raised constructing AdminObject,
error code: XAQCF PropertyName : XAQCF PropertyName
where PropertyName is the name of the invalid property.

指出主題類型的圖示 概念主題



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