Configuring a message flow at deployment time with user-defined properties

Use user-defined properties (UDPs) to configure message flows at deployment and run time, without modifying program code. You can give a UDP an initial value when you declare it in your program, or when you use the Message Flow editor to create or modify a message flow.

Before you begin

For an overview of user-defined properties, see User-defined properties.

For an example of how to code a UDP statement, see DECLARE statement.

About this task

In ESQL, you can define UDPs at the module or schema level. After a UDP has been defined in the Message Flow editor, you can modify the value before you deploy it.

To configure UDPs, complete the following steps.

Procedure

  1. Open the BAR file.
    The contents of the BAR file are shown on the Manage tab of the BAR File editor. On this tab, you can expand a flow to show the individual nodes that it contains.
  2. Click the relevant message flow or subflow (not the .cmf compiled message flow file).
    The UDPs that are defined in that flow are displayed with their values in the Properties view.
  3. If the value of the UDP is unsuitable for your current environment or task, change it to an appropriate value.
    The value of the UDP is set at the flow level, and is the same for all eligible nodes that are contained in the flow.
    Note: If a subflow includes a UDP that has the same name as a UDP in the main flow, the value of the UDP in the subflow is not changed.
  4. Save your BAR file.

What to do next

Deploy the message flow by following the instructions in Deploying integration solutions to a production environment.