WebSphere Application Server supports the use of custom properties to define WebSphere MQ properties. This is useful because it enables WebSphere Application Server to work with later versions of WebSphere MQ which might have properties that are not exposed in the WebSphere Application Server administrative console.
For instructions on how to create a new custom property, see Configuring custom properties for the WebSphere MQ messaging provider.
In WebSphere Application Server Version 6.1, the custom properties that you define are validated by the WebSphere MQ client jar files contained in WebSphere Application Server. In previous versions, this was done within WebSphere Application Server itself, and then by the WebSphere MQ client jar files. If you have defined a property that is not valid for WebSphere MQ, the WebSphere MQ client jar files create an exception, which is caught by WebSphere Application Server, and logged in the Systemout.log and SystemErr.log. Examples of error messages are given at the end of this topic.
When a later version of WebSphere MQ is available that is supported by the WebSphere Application Server installation, new 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 WebSphere MQ client jars. You can also configure WebSphere Application Server to point to the WebSphere MQ client jars in the external JMS provider, as described in Installing WebSphere MQ to interoperate with WebSphere Application Server.
For information on valid values for WebSphere MQ properties, refer to WebSphere MQ Using Java or WebSphere MQ System Administration, which are available from the IBM Publications Center.
The following scenarios illustrate how different cell configurations might be affected.
[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 PropertyNamewhere PropertyName is the name of the invalid property.