WebSphere brand IBM WebSphere Premises Server, Version 6.1.x

Using the Filter and Test Tag agents

The Filter agent allows you to set criteria to determine how tags are passed through other configured agents. In order to use the Test Tag agent, you need to set criteria in the Filter Agent.

The Filter agent is included in the bundle list by default, but must be configured in order to work. For more information on configuring the Filter agent, see the Filter agent topic.

The Test Tag agent must be manually added to the bundle list before it can be configured. For more information on configuring the Test Tag agent, see the Test Tag agent topic.

For more information on bundle lists, see Installing the bundle loader and a bundle list.

Once the Filter agent is configured, tag reads can be passed through the filter agent to the test tag agent if the criteria matches. The Filter agent takes in the tag reads, and then republishes them on the FilterAgent topics.publish if they pass the filter, or topics.publish.rejected if it fails the filter. For example, you can configure a filter that passes the tag to the Test Tag agent if the header of the tag matches the criteria set up in the Filter agent.

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

In the example below, an exclude rule is configured for FF, so that it is excluded and is not passed through the filter. The FilterAgent then publishes it out of topics.publish.rejected. However, the TestTagAgent is listening to topics.publish.rejected, so the TestTagAgent takes a look at the FF to see if it is an FFF. If FFF is found, the agent enters test mode.

Example

The following is an example of a Test Tag agent configuration. In this example, TestTags begin with FFF. Note that the tag topic of the rejectedtags matches the topic coming out of the Filter agent, and the outputTopics matches the topics in the Light Tree agent.

<configuration factoryPid="com.ibm.rfid.agent.testtags.bundle.TestTagsActivator">
					<properties>
						<property key="source.id" value="P1"/>
						<property key="tracing" value="true"/>
						<property key="log.level" value="DEBUG" />
						<property key="portal.id" value="P1"/>
						<property key="portal.name" value="PortalName1"/>
						<property key="qos" value="0"/>
						<property key="lightDelay" value="2000"/>
						<property key="testModeTimeout" value="120000"/>
						<property key="tagTopic" value="P1/dccontroller/report/filter/rejectedtags"/>
						<property key="testTagIds" value="FFF"/>
						<property key="outputTopics" value="P1/dccontroller/command/light/green,P1/dccontroller/command/light/amber,P1/dccontroller/command/light/red"/>
						<property key="tagAggregationTopic" value="R1/RfidInventory/TagAggregationReport"/>
						<property key="aggregationOutputTopics" value="P1/dccontroller/command/light/red,P1/dccontroller/command/light/amber,P1/dccontroller/command/light/green"/>
					</properties>
				</configuration>

				<configuration factoryPid="com.ibm.rfid.agent.filter.bundle.FilterAgentActivator">
					<properties>
						<property key="source.id" value="P1"/>
						<property key="tracing" value="false"/>
						<property key="log.level" value="" />
						<property key="portal.id" value="P1"/>
						<property key="portal.name" value="PortalName1"/>
						<property key="filters" value="Interest"/>
						<property key="interest.include.masks.care" value=""/>
						<property key="interest.include.masks.pattern" value=""/>
						<property key="interest.exclude.masks.care" value="FF"/>
						<property key="interest.exclude.masks.pattern" value="FF"/>
						<property key="topics.publish" value="P1/dccontroller/report/filter/tags"/>
						<property key="topics.subscribe" value="R1/RfidInventory/TagReport"/>
						<property key="duplicates.decay.limit.sec" value="5"/>
						<property key="duplicates.decay.cleanup.sec" value="2"/>
						<property key="trigger.reset.topic" value=""/>
						<property key="trigger.reset.value" value=""/>
						<property key="epc.filter.strategy" value="KeepOnly"/>
						<property key="epc.filter.value" value="0"/>
						<property key="selftestmode" value="false" type="boolean"/>
						<property key="profile.id" value="BDDR"/>
						<property key="topics.publish.rejected" value="P1/dccontroller/report/filter/rejectedtags"/>
					</properties>
				</configuration>

				<configuration factoryPid="com.ibm.rfid.agent.lighttree.bundle.LightTreeAgentActivator">
					<properties>
						<property key="source.id" value="P1"/>
						<property key="agent.name" value="LightTreeAgent"/>
						<property key="tracing" value="false"/>
						<property key="log.level" value="" />
						<property key="portal.id" value="P1"/>
						<property key="portal.name" value="PortalName1"/>
						<property key="gpio.adapter.prefix" value="R1"/>
						<property key="refresh.topic" value="E1/dccontroller/report/diagnostic/heartbeat"/>
						<property key="control.all.topic" value="P1/dccontroller/command/light/all"/>
						<property key="pins.logical.names" value="green,amber,red,aux"/>
						<property key="control.green.topic" value="P1/dccontroller/command/light/accepted,P1/dccontroller/command/light/green"/>
						<property key="duration.green.ms" value="2000"/>
						<property key="invert.green" value="false"/>
						<property key="io.green.pin" value="3"/>
						<property key="active.green.overwrites" value=""/>
						<property key="control.amber.topic" value="P1/dccontroller/command/light/operational,P1/dccontroller/command/light/amber"/>
						<property key="duration.amber.ms" value="-1"/>
						<property key="invert.amber" value="false"/>
						<property key="io.amber.pin" value="2"/>
						<property key="active.amber.overwrites" value=""/>
						<property key="control.red.topic" value="P1/dccontroller/command/light/rejected,P1/dccontroller/command/light/red"/>
						<property key="duration.red.ms" value="2000"/>
						<property key="invert.red" value="false"/>
						<property key="io.red.pin" value="1"/>
						<property key="active.red.overwrites" value="green"/>
						<property key="control.aux.topic" value="P1/dccontroller/command/light/portalerror"/>
						<property key="duration.aux.ms" value="2000"/>
						<property key="invert.aux" value="false"/>
						<property key="io.aux.pin" value="4"/>
						<property key="active.aux.overwrites" value=""/>
					</properties>
				</configuration>
				<configuration factoryPid="com.ibm.rfid.agent.idtransform.bundle.IdTransformationAgentActivator">
					<properties>
						<property key="source.id" value="R1"/>
						<property key="portal.id" value="P1"/>
						<property key="portal.name" value="PortalName1"/>
						<property key="transform.from" value="P1/dccontroller/report/filter/tags,R1/RfidInventory/TagAggregationReport"/>
						<property key="transform.to" value="P1/BDDR/report/TagReport,P1/BDDR/report/TagAggregationReport"/>
						<property key="transform.eventType" value="BDDR/report/TagReport,BDDR/report/TagAggregationReport"/>	
						<property key="transform.sourceId" value="P1,P1"/>
						<property key="qos" value="1" />
						<property value="false" key="tracing"/>
						<property key="log.level" value="" />
					</properties>
				</configuration>

Library | Support | Terms of use

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