Start of change

Configuring a message flow node

Before you start:

When you have included an instance of a node in your message flow, you can configure its properties to customize how it works. The node can be a built-in node, a user-defined node, or a subflow node. You can choose whether the properties appear in the Properties view below the Message Flow editor, or in the Properties dialog box. By default, properties are shown in the Properties view. To switch to the Properties dialog box, take the following steps:

  1. Click Window > Preferences to open the Preferences dialog box.
  2. Expand Broker Development and click Message Flow Editor.
  3. Select Show node properties in a Properties Dialog.

Viewing a node's properties

To view a node's properties:

  1. Switch to the Broker Application Development perspective.
  2. Open the message flow with which you want to work.
  3. Click Selection above the node palette.
  4. Right-click a node and click Properties to open the Properties view or Properties dialog box, depending on your preference.
    For nodes that do not have an associated resource, you can also double-click the node to display the properties. However, if you double-click any of the nodes in the following table, you open the associated resource:
    Node Result of double-clicking the node
    Compute node Opens an ESQL file
    Database node Opens an ESQL file
    DataDelete node Opens the New Message Map dialog box
    Datalnsert node Opens the New Message Map dialog box
    DataUpdate node Opens the New Message Map dialog box
    Extract node Opens the New Message Map dialog box
    JavaCompute node Opens the New JavaCompute Node Class wizard
    Mapping node Opens the New Message Map dialog box
    Warehouse node Opens the New Message Map dialog box
    XMLTransformation node Opens the XSL Selection dialog box

Editing a node's properties

Properties are organized into related groups and displayed on tabs. Each tab is listed on the left of the Properties view or Properties dialog box. Click each tab to view the properties that you can edit.

For details of how to configure each individual built-in node, see the node description. You can find a list of the nodes, with links to the individual topics, in Built-in nodes.

If you have included a user-defined node, refer to the documentation that came with the node to understand if, and how, you can configure its properties.

Promoted properties

You can promote node properties to their containing message flow. Use this technique to set some values at the message flow level, without having to change individual nodes. This can be useful, for example, when you embed a message flow in another flow, and want to override some property such as output queue or data source with a value that is correct in this context.

Overriding properties at deploy time

A small number of node property values can be overridden when a message flow is deployed. These are known as configurable properties, and you can use these to modify some characteristics of a deployed message flow without changing the message flow definitions. For example, you can update queue manager and data source information.

Even though you can set values for configurable properties at deploy time, you must set values for these properties within the message flow if they are mandatory.

Related reference
Built-in nodes
End of change