Mapping JMS provider-specific fields
The following notes refer to the mapping of JMS provider-specific fields into IBM® WebSphere® MQ messages.
- JMS_IBM_Report_<name> to MQMD Report
- A JMS application can set the MQMD Report options, using the following
JMS_IBM_Report_XXX properties. The single MQMD is mapped to several
JMS_IBM_Report_XXX properties. The application must set the value
of these properties to the standard IBM WebSphere MQ MQRO_
constants (included in com.ibm.mq.MQC). So, for example, to request
COD with full Data, the application must set JMS_IBM_Report_COD to
the value CMQC.MQRO_COD_WITH_FULL_DATA.
- JMS_IBM_Report_Exception
- MQRO_EXCEPTION or
MQRO_EXCEPTION_WITH_DATA or
MQRO_EXCEPTION_WITH_FULL_DATA - JMS_IBM_Report_Expiration
- MQRO_EXPIRATION or
MQRO_EXPIRATION_WITH_DATA or
MQRO_EXPIRATION_WITH_FULL_DATA - JMS_IBM_Report_COA
- MQRO_COA or
MQRO_COA_WITH_DATA or
MQRO_COA_WITH_FULL_DATA - JMS_IBM_Report_COD
- MQRO_COD or
MQRO_COD_WITH_DATA or
MQRO_COD_WITH_FULL_DATA - JMS_IBM_Report_PAN
- MQRO_PAN
- JMS_IBM_Report_NAN
- MQRO_NAN
- JMS_IBM_Report_Pass_Msg_ID
- MQRO_PASS_MSG_ID
- JMS_IBM_Report_Pass_Correl_ID
- MQRO_PASS_CORREL_ID
- JMS_IBM_Report_Discard_Msg
- MQRO_DISCARD_MSG
- JMS_IBM_MsgType to MQMD MsgType
- Value maps directly onto MQMD MsgType. If the application has
not set an explicit value of JMS_IBM_MsgType, a default value is used.
This default value is determined as follows:
- If JMSReplyTo is set to an IBM WebSphere MQ queue destination, MSGType is set to the value MQMT_REQUEST
- If JMSReplyTo is not set, or is set to anything other than an IBM WebSphere MQ queue destination, MsgType is set to the value MQMT_DATAGRAM
- JMS_IBM_Feedback to MQMD Feedback
- Value maps directly onto MQMD Feedback.
- JMS_IBM_Format to MQMD Format
- Value maps directly onto MQMD Format.
- JMS_IBM_Encoding to MQMD Encoding
- If set, this property overrides the numeric encoding of the Destination Queue or Topic.
- JMS_IBM_Character_Set to MQMD CodedCharacterSetId
- If set, this property overrides the coded character set property of the Destination Queue or Topic.
- JMS_IBM_PutDate from MQMD PutDate
- The value of this property is set, during send, directly from the PutDate field in the MQMD. Any value that is set into the JMS_IBM_PutDate property before a send is overwritten. This field is a String of eight characters, in the IBM WebSphere MQ Date format of YYYYMMDD. This property can be used with the JMS_IBM_PutTime property to determine the time the message was put according to the queue manager.
- JMS_IBM_PutTime from MQMD PutTime
- The value of this property is set, during send, directly from the PutTime field in the MQMD. Any value that is set into the JMS_IBM_PutTime property before a send is overwritten. This field is a String of eight characters, in the IBM WebSphere MQ Time format of HHMMSSTH. This property can be used with the JMS_IBM_PutDate property to determine the time the message was put according to the queue manager.
- JMS_IBM_Last_Msg_In_Group to MQMD MsgFlags
- For point-to-point messaging, this Boolean value maps to the MQMF_LAST_MSG_IN_GROUP flag in the MQMD MsgFlags field. It is normally used with the JMSXGroupID and JMSXGroupSeq properties to indicate to a legacy IBM WebSphere MQ application that this message is the last in a group. This property is ignored for publish/subscribe messaging.