WebSphere brand IBM WebSphere Premises Server 6.1 Feature Pack for Sensor Event Services

EPC

The EPC Reusable Component provides methods for working with EPC values, including generation of valid EPC values that can be written to tags. It also supports a query to decode an EPC value into its constituent fields.

The ruc.targetBackend values of ruc.premises, which uses the WebSphere® Premises Server API, and ruc.rfidic support the generation of EPC values.

The input payload attributes for the epcgen call for the ruc.targetBackend value of ruc.premises are:
Table 1.
Attribute Description
EPCRUCConstants.EPC_RUC_PROFILE_NAME This attribute is a print profile name defined in WebSphere Premises Server
EPCRUCConstants.EPC_RUC_PACK_TYPE  
EPCRUCConstants.EPC_RUC_ASSET_TYPE  
EPCRUCConstants.EPC_RUC_TAG_QUANTITY This attribute is optional, and defaults to 1.
The input payload attributes for the epcgen call for the ruc.targetBackend value of ruc.rfidic are:
Table 2.
Attribute Description
EPCRUCConstants.EPC_RUC_PROFILE_NAME This optional attribute is a print profile name defined in WebSphere Premises Server
EPCRUCConstants.EPC_RUC_PACK_TYPE This attribute is optional, and required only if the profile name is given.
EPCRUCConstants.EPC_RUC_ASSET_TYPE This attribute is optional, and required only if the profile name is given.
EPCRUCConstants.EPC_RUC_TAG_QUANTITY This attribute is optional, and defaults to 1.
EPCRUCConstants.EPC_RUC_ENCODING_FORMAT This attribute is optional.
EPCRUCConstants.EPC_RUC_REQUEST_SOURCE This attribute is optional.
EPCRUCConstants.EPC_RUC_RANDOM This attribute is optional.
EPCRUCConstants.EPC_RUC_ALPHANUMERIC This attribute is optional.
EPCRUCConstants.EPC_RUC_COMPANY_PREFIX This attribute is optional, and required only if the profile name is not given.
EPCRUCConstants.EPC_RUC_FILTER_VALUE This attribute is optional, and required only if the profile name is not given.
EPCRUCConstants.EPC_RUC_GTIN14 This attribute is optional, and required only if the encoding format is EPCRUCConstants.EPC_INPUT_TYPE_SGTIN96.
EPCRUCConstants.EPC_RUC_EXTENSION_DIGIT This optional attribute defaults to 0, and is required only if the encoding format is EPCRUCConstants.EPC_INPUT_TYPE_SSCC96.

WebSphere Premises Server configuration

Table 3. EPC agent properties
Name Description PID Agent properties
EPCAgent RUC EPC Agent com.ibm.premises.reusable.epc.EPCAgent
  • ruc.targetBackend=ruc.premises
  • gen.output.success=rucresponse/epc/gen/success
  • gen.output.failure=rucresponse/epc/gen/failure
  • decode.output.success=rucresponse/epc/decode/success
  • decode.output.failure=rucresponse/epc/decode/failure

WebSphere Application Server configuration

Table 4. Activation specification values
Name JNDI name Destination type Destination JNDI name Message selector Bus name
EPCRUCAS eis/EPCRUCAS Topic jms/ibmse ibmse LIKE ‘rucaction/epc/%’ OR ibmse LIKE ‘%/rucaction/epc/%’ ibmsensorevent

Methods

Using the EPC Reusable Component

To invoke epcgen using IBM® Sensor Events or XML, the payload must include:
  • EPCRUCConstants.EPC_RUC_PROFILE_NAME
  • EPCRUCConstants.EPC_RUC_PACK_TYPE
  • EPCRUCConstants.EPC_RUC_ASSET_TYPE
To invoke epcdecode using IBM Sensor Events or XML, the payload must include:
  • PassiveRFIDTagRead
  • PassiveRFIDAggregatedTagRead
Generic payload created from a map can also be used. It must include either of the following:
  • EPCRUCConstants.TAG_KEY_INOUT
  • EPCRUCConstants.TAGLIST_KEY_INOUT
Note: TAG_KEY_INOUT takes a String value. TAGLIST_KEY_INOUT takes a value of java.util.List populated with Strings.
To publish to Reusable Components MDBs, set the following values for the JMS topic and eventType. For multi-action Reusable Components, the topic is checked in the message selector and in the MDB code.
  • epcgen: profileid/rucaction/epc/gen
  • epcdecode: profileid/rucaction/epc/decode
The JMS topic and eventType for the MDB output from the Reusable Component comes from the agent properties. Default output topics for success and failure for each action are shown in Table 1. The payload includes:
  • epcgen: EPCRUCConstants.EPC_RUC_RESULTEPC_KEY_OUT
  • epcdecode: EPCRUCConstants.EPC_RUC_RESULTMAP_KEY_OUT

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.