WebSphere brand IBM WebSphere Sensor Events, Version 6.2

Test Tags agent

The Test Tags agent is a location type agent that provides self-test functionality for store operators to verify that sensors and light trees are working correctly.

Once the tag reaches the Test Tags agent, the tag data is checked to see if it matches any of the prefixes defined in the testTagIdPrefixes. If there is a match, the agent enters test mode.

The agent then begins to play the sequence of topics defined in the outputTopics property. A delay defined in the lightDelay property occurs between each of the topics defined in the outputTopics property.

The agent remains in test mode until it receives the topic configured in the tagAggregationTopic property or until the number of milliseconds defined in the testModeTimeout property has been reached, whichever occurs first. If the tag aggregation topic occurs before the timeout value, the agent exits test mode and begins to play the sequence of topics defined in the aggregationOutputTopics. The same delay defined in the lightDelay property occurs between each of those topics. If the timeout value is reached but no tag aggregation topic is received, then agent exits test mode but does not continue to wait for the topic.

Note: In order to properly use this agent, you need to set the Filter Agent so that it subscribes to the TagReports topic and publishes to the tagTopic defined in the Test Tags agent.

Properties

For the properties below, you can enter either strings or variables. If you enter a variable, the value is substituted from the database when the XML configuration file is generated. Refer to Using variables for agent property values for details on what variables can be substituted.

Table 1. Test Tags agent properties
Property Description
aggregationOutputTopics The sequence of topics that the agent will output when exiting test mode
lightDelay Delay in milliseconds that occurs between each of the topics listed in the aggregationOutputTopics property. This property must be greater than or equal to the duration delays defined in the Light Tree agent for each of the lights, or the behavior is undefined.
log.level The level of logging to use with this agent. If the value is empty then the system log level will be used.
outputTopics The sequence of topics that the agent will output when entering test mode
portal.id The portal ID associated with this agent.
portal.name The portal name associated with this agent.
qos Messaging Quality of Service. A value of 0 means at most once. A value of 1 means at least once. A value of 2 means exactly once.
source.id The source ID for generic events in this agent.
tagAggregationTopic The topic that signals the end of the test mode
tagTopic The topic that this agent listens for entering test mode
testModeTimeout A number in milliseconds that signals the end of the test mode
testTagIdPrefixes Any prefix up to and including the full tag id. The agent will enter test mode if any tagId starts with this string.
tracing Displays trace output.

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.