Support is provided by the SIMessage interface and the mediation configuration selector for JMS_IBM properties and the equivalent SI_system properties. You 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. You can access all these properties through the SIMessage interface, and can match and set many of them. You cannot set exception properties because they are controlled by the messaging engine.
You 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 WebSphere MQ.
For information about the mapping of message fields and properties between WebSphere MQ and JMS see Mapping the message header fields and properties to and from WebSphere 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 |