WebSphere brand IBM WebSphere Sensor Events, Version 6.2

Using variables for agent property values

For agent properties, you can specify either strings or variables. If you specify a variable, the string value is retrieved from the configuration database and substituted when the XML configuration files are created.

You can make simple or iterative substitutions. Simple substitutions directly substitute the value in the database that corresponds to the parameter specified.

For example, if the value in the database is edge.name = "%CONTROLLER_ID%", then the value in the Data Capture and Delivery device XML is edge.name = "E1" (for the edge controller named E1).

Iterative substitutions enable values to be enumerated with each value for that substitution.

For example, if the value in the database is topics = "[LOCATIONS]%LOCATIONS%,[/LOCATIONS]", then the value in the Data Capture and Delivery device XML is topics = "P1, P2, P3," (for the locations P1, P2, and P3).

Substitutions for location-based agents

%AGENT_LOG_LEVEL%
Log level of the agent
%AGENT_TRACE%
Trace level of the agent
%CONTROLLER_ID%
The Data Capture and Delivery device ID of the controller
%CONTROLLER_NAME%
The Data Capture and Delivery device name of the controller
%LOCATION_APPLICATION_ID%
The location application ID for the agent on the Data Capture and Delivery device
%LOCATION_ID%
The location ID for the agent on the Data Capture and Delivery device
%LOCATION_NAME%
The location name for the agent on the Data Capture and Delivery device
%READER_ID%
The ID for the tag reader at the location
%READER_COM_PORT%
The com.port for the tag reader at the location
%READER_IP%
The IP address of the tag reader at the location
%READER_REMOTE_PORT%
The port number of the tag reader at the location
%SECONDARY_READER%
The ID of the secondary reader
%SELFTEST_MODE%
Whether the location is set to be in self test mode

Substitutions for controller-based agents

%AGENT_LOG_LEVEL%
Log level of the agent
%AGENT_TRACE%
Trace level of the agent
%CONTROLLER_ID%
The Data Capture and Delivery device ID of the controller
%CONTROLLER_NAME%
The Data Capture and Delivery device name of the controller
%DMS_HOSTNAME%
Name of the server where the bundles are stored, such as the Bundle Repository Server
%LOGGING_THRESHOLD%
The logging threshold of the Data Capture and Delivery device
%LOCATIONS_STR%
The locations associated with the controller
[LOCATIONS]%LOCATION_ID%[/LOCATIONS]
Iterative substitution with all of the values of locations configured on the controller
%PREMISES_IP%
The IP address of the WebSphere® Sensor Events
[READERS]%READER_ID%[/READERS]
Iterative substitution with all of the values of the tag readers configured on the controller
%READERS_STR%
The readers associated with the controller

Library | Support | Terms of use

(c) Copyright IBM Corporation 2004, 2009. All rights reserved.
U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.