Accessing integration node properties from ESQL
You can access integration node properties, at run time, from the ESQL modules in your message flow nodes.
About this task
You can use integration node properties on the right side
of regular SET statements. For example:
DECLARE mybroker CHARACTER;
SET mybroker = BrokerName;
where BrokerName
is
the integration node property that contains the name of the integration
node on which the message flow is running. However, you cannot use
integration node properties on the left side of SET statements. This
restriction exists because, at run time, integration node properties
are constants: they cannot be modified, therefore their values cannot
be changed by SET statements. If a program tries to change the value
of an integration node property, the error message Cannot
assign to a symbolic constant
is issued.Integration
node properties:
- Are grouped by integration node, integration server, flow, and node.
- Are case sensitive. Their names always start with an uppercase letter.
- Return NULL if they do not contain a value.
If your ESQL code already contains a variable with the
same name as one of the integration node properties, your variable
takes precedence; that is, your variable masks the integration node
property. To access the integration node property, use the form SQL.<broker_property_name>
.
For example: SQL.BrokerName
.
Integration node properties that are accessible from ESQL, the Mapping node, and Java shows the integration node, flow, and node properties that are accessible from ESQL and indicates which properties are also accessible from Java.