JMS_IBM properties and equivalent SI_system properties
Support is provided by the SIMessage interface and the mediation configuration selector for JMS_IBM properties and the equivalent SI_system properties. We can access JMS_IBM_ properties through the JMS API. Many of the values held by JMS_IBM_ properties apply to an SIMessage and have SI_ synonyms. We can access all these properties through the SIMessage interface, and can match and set many of them. We cannot set exception properties because they are controlled by the messaging engine.
We can match SI_ExceptionReason, JMS_IBM_ExceptionReason and JMS_IBM_ExceptionTimestamp. The method clearMessageProperties() does not clear properties that cannot be set.
Where the data types are different, the equivalent values are modified before being returned to the JMS API caller. For example with JMS_IBM_Report_XXX, the JMS_IBM_Report... and JMS_IBM_Feedback values are modified before being returned to the JMS API caller. The values used by service integration and WebSphere Application Server are different, however they are modified before being returned by the JMS API caller, so that they can then be passed to IBM MQ.
For information about the mapping of message fields and properties between IBM MQ and JMS see Mapping the message header fields and properties to and from IBM MQ format.
In the following table, the SIMessage API data type column indicates the data type of the property if accessed by a mediation handler, or when specifying the selectors for a mediation handler. The JMS API data type column indicates the data type of the property if accessed by a JMS application, either when specifying selectors or when using the get and set property methods:
JMS_IBM property name Equivalent SIMessage property Can be matched? setMessageProperty SIMessage API data type JMS API data type JMS_IBM_Format
Yes Yes String String JMS_IBM_MsgType
Yes Yes Integer Integer JMS_IBM_Feedback SI_ReportFeedback Yes Yes Integer Integer JMS_IBM_PutApplType
Yes Yes Integer Integer JMS_IBM_Report_Exception SI_ReportException Yes Yes Byte Integer JMS_IBM_Report_Expiration SI_ReportExpiry Yes Yes Byte Integer JMS_IBM_Report_COA SI_ReportCOA Yes Yes Byte Integer JMS_IBM_Report_COD SI_ReportCOD Yes Yes Byte Integer JMS_IBM_Report_PAN SI_ReportPAN Yes Yes Boolean Integer JMS_IBM_Report_NAN SI_ReportNAN Yes Yes Boolean Integer JMS_IBM_Report_Pass_Msg_ID SI_ReportPassMsgID Yes Yes Boolean Integer JMS_IBM_Report_Pass_Correl_ID SI_ReportPassCorrelID Yes Yes Boolean Integer JMS_IBM_Report_Discard_Msg SI_ReportDiscardMsg Yes Yes Boolean Integer JMS_IBM_Last_Msg_In_Group
Yes Yes Boolean Boolean JMS_IBM_PutDate
Yes Yes String String JMS_IBM_PutTime
Yes Yes String String JMS_IBM_Encoding
Yes Yes Integer Integer JMS_IBM_Character_Set
Yes Yes String String JMS_IBM_ExceptionMessage
No No String String JMS_IBM_ExceptionTimestamp SI_ExceptionTimestamp Yes No Long Long JMS_IBM_ExceptionReason SI_ExceptionReason Yes No Integer Integer JMS_IBM_ExceptionProblemDestination SI_ExceptionProblemDestination Yes No String String N/A SI_ExceptionInserts No No List of strings n/a JMS_IBM_System_MessageID SI_SystemMessageID Yes No String String