This topic describes the support provided by the SIMessage interface and the mediation configuration selector for JMS_IBM properties and the equivalent SI_system properties.
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® 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 How service integration converts 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:
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 |