Configuring a message flow at deployment time using UDPs

User-defined properties (UDPs) give you the opportunity to configure message flows at deployment time, without modifying program code.

A UDP is a user-defined constant that you can use in your ESQL or Java programs. You can give the 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.

In ESQL, you can define UDPs at the module or schema level.

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

After a UDP has been defined by the Message Flow editor, you can modify its value before you deploy:

  1. From the workbench, switch to the Broker Administration perspective.
  2. Double click your bar file in the Broker Administration Navigator view. The contents of the bar file are shown in the Content editor.
  3. Select the Configure tab at the bottom of the Content editor pane. This shows the names of your message flows; these can be expanded to show the individual nodes that are contained in the flow.
  4. Click on a message flow name. The UDPs that are defined in that message flow are displayed with their values.
  5. If the value of the UDP is unsuitable for your current environment or task, change it to the value that you want. 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. 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.

Now you are ready to deploy the message flow. See Deploying a broker archive file.

Related concepts
Message flows overview
ESQL overview
User-defined properties
Related tasks
Designing a message flow
Defining message flow content
Editing configurable properties
Deploying a broker archive file
Promoting a property
Related reference
Compute node
Database node
DECLARE statement
Broker Archive editor
Message Flow editor
Configurable message flow properties