Create a JMS Model Defining the JMS Datastores

JMS 24-9

24.7 JMS Standard Properties

This section describes the JMS properties contained in the message header and how to use them. In Oracle Data Integrator, pseudo-columns corresponding to the JMS Standard properties should be declared in accordance with the descriptions provided in Table 24–3 . The JMS type and access mode columns refer to the use of these properties in Oracle Data Integrator or in Java programs. In Oracle Data Integrator, some of these properties are used through the IKM options, and the pseudo-column values should not be set by the interfaces. For more details on using these properties in a Java program, see http:java.sun.comproductsjms . Table 24–3 Standard JMS Properties of Message Headers Property JMS Type Access ReadWrite Description JMSDestination JMS String R Name of the destination topic or queue of the message. JMSDeliveryMode JMS Integer RW set by IKM option Distribution mode: 1 = Not Persistent or 2 = Persistent. A persistent message is never lost, even if a router crashes. When sending messages, this property is set by the JMSDELIVERYMODE KM option. JMSMessageID JMS String R Unique Identifier for a message. This identifier is used internally by the router. JMSTimestamp JMS Long R Date and time of the message sending operation. This time is stored in a UTC standard format 1. JMSExpiration JMS Long RW set by IKM option Message expiration date and time. This time is stored in a UTC standard format 1. To set this property the JMSEXPIRATION KM option must be used. JMSRedelivered JMS Boolean R Indicates if the message was resent. This occurs when a message consumer fails to acknowledge the message reception. JMSPriority JMS Int RW Name of the destination topic or queue the message replies should be sent to. JMSCorrelationID JMS String RW Correlation ID for the message. This may be the JMSMessageID of the message this message generating this reply. It may also be an application-specific identifier. 24-10 Oracle® Fusion Middleware Connectivity and Knowledge Modules Guide for Oracle Data Integrator Table 24–4 lists the optional JMS-defined properties in the JMS standard. 1: The UTC Universal Time Coordinated standard is the number of milliseconds that have elapsed since January 1st, 1970

24.7.1 Using JMS Properties

In addition to their contents, messages have a set of properties attached to them. These may be provider-specific, application-specific user defined or JMS Standard Properties . JMS properties are used in Oracle Data Integrator as complementary information to the message, and are used, for example, to filter the messages. JMSType JMS String RW set by IKM option Message type label. This type is a string value describing the message in a functional manner for example SalesEvent, SupportProblem. To set this property the JMSTYPE KM option must be used. Table 24–4 Standard JMS Properties of Message Headers Property JMS Type Access ReadWrite Description JMSXUserID JMS String R Client User ID. JMSXAppID JMS String R Client Application ID. JMSSXProducerTXI D JMS String R Transaction ID for the production session. This ID is the same for all the messages sent to a destination by a producer between two JMS commit operations. JMSSXConsumerTX ID JMS String R Transaction ID for current consumption session. This ID is the same of a batch of message read from a destination by a consumer between two JMS commit read operations. JMSXRcvTimestam p JMS Long R Message reception date and time. This time is stored in a UTC standard format 1. JMSXDeliveryCoun t JMS Int R Number of times a message is received. Always set to 1. JMSXState JMS Int R Message state. Always set to 2 Ready. JMSXGroupID JMS String RW ID of the group to which the message belongs. JMSXGroupSeq JMS Int RW Sequence number of the message in the group of messages. Table 24–3 Cont. Standard JMS Properties of Message Headers Property JMS Type Access ReadWrite Description