Configuring MQEndpoint, MQTTSubscribe, or MQTTPublish policies with the IBM Integration Toolkit

Use the Policy tab in the message flow node Properties view to generate new policies and store the policy documents in the Integration Registry, and to attach and detach policies.

Before you begin

Create a message flow that contains at least one node type that supports policy. For more information about message flow creation, see Developing message flows.

Procedure

  1. Select the node that you want to use to generate a policy document. In the Properties view for this node, click the Policy tab.
  2. Click Generate new policy to open the Policy editor.
  3. Edit the values of the operational properties as required.
  4. Click Save, enter a policy name, select the target integration node, and click Finish to store the policy document in the Integration Registry.
    Note: By default, the generated policy is attached to this message flow node at run time. To save the policy without attaching it to the node, clear the Attach the generated policy to the node check box.

Results

A policy document that contains the required operational property values for the node is generated. If the policy is attached to this message flow node, the Policy URL field in the Policy tab is populated, and the property values that are specified in this policy are used at run time. These values override any values that were configured in the Properties view for the node when the message flow was developed.

If the policy is not attached to this message flow node, the Policy URL field is blank, but the new policy is listed in the Integration Registry view.

To attach a saved policy to a message flow node, enter the URL of the policy you require into the Policy URL field on the Policy tab of the message flow node.
Tip: You can find out the URL of a saved policy by viewing the policy in the web user interface (UI). In the navigation tree, expand Operational Policy followed by the policy type, and select the policy name that you want to view. The format of a policy URL is /apiv1/policy/policy type/policy name. For example, /apiv1/policy/MQTTSubscribe/Policy1.

What to do next

If you want to revert to using the operational properties that are set on an MQTTSubscribe or MQTTPublish message flow node, instead of using a policy document, you can detach the policy document by deleting the URL listed in the Policy URL field.

If you want to revert to defining connection details explicitly for an MQ node, instead of using an MQEndpoint policy document, clear the value in the Policy URL field. You can then use the connection details on MQ Connections tab. Alternatively, you can use the connection details of the queue manager that is specified for the integration node. For more information, see Configuring connections to WebSphere MQ.

Note: If you attach or detach a policy, you must redeploy your resources for the change to take effect.