Configuring custom properties for WebSphere MQ messaging provider JMS resources

In addition to the standard properties that you can define for WebSphere® MQ messaging provider JMS resources, you can configure further WebSphere MQ properties as custom properties. You can configure custom properties for activation specifications, connection factories, and JMS destinations for the WebSphere MQ messaging provider.

About this task

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 that might have properties that are not exposed in WebSphere Application Server.

You can use this task to set custom properties for JMS destinations, connection factories, and activation specifications for the WebSphere MQ messaging provider. For example, you would use this task to set the custom property WAS_EndpointInitialState for an activation specification. WAS_EndpointInitialState determines whether or not message consumption begins from the JMS destination as soon as the activation specification is used for a message-driven bean to connect with the destination.

To specify custom properties for WebSphere MQ messaging provider JMS resources, use the administrative console to complete the following steps:

Procedure

  1. In the navigation pane, click Resources > JMS.
  2. Select the type of JMS resource for which you want create custom properties (JMS destinations, connection factories, or activation specifications).
  3. Optional: Change the Scope setting to the level at which the resource definition is visible to applications.
  4. In the contents pane, select the specific WebSphere MQ messaging provider JMS resource name for which you want to specify the custom property. This displays information about the resource.
  5. To create a custom property, select [Additional Properties] Custom properties.
  6. Click New in the content pane.
  7. Specify the following attributes for the new custom property:
    Name
    The name of the custom property. A property name is required.
    Value
    The value for the custom property.
    Type
    The type of the custom property. Select the custom property type from the list.
  8. Click Apply. This defines the custom property to WebSphere Application Server, and enables you to browse or change additional properties.
  9. Save any changes to the master configuration.
  10. To have the changed configuration take effect, stop then restart the application server.

Example

To set the custom property WAS_EndpointInitialState for an activation specification, specify the following attributes:
  • For Name, specify WAS_EndpointInitialState.
  • For Value, specify one of the following options:
    ACTIVE
    Specify a value of ACTIVE if message consumption is to begin as soon as the message-driven bean connects with the JMS destination.
    INACTIVE
    Specify a value of INACTIVE if message consumption is not to begin until you use the wsadmin tool or the administrative console to activate message consumption for the message-driven bean.
  • For Type, select String.