Network Deployment (Distributed operating systems), v8.0 > Reference > Developer detailed usage information
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 WAS 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 Map 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 properties and SIMessage properties. The first column of the table provides the JMS_IBM property names. The second column provides the equivalent SIMessage property names if available. The third column indicates if the properties can be matched. The fourth column indicates the state of setMessageProperty. The fifth column contains the data type of the SIMessage API property if accessed by a mediation handler or when specifying the selectors for the mediation handler. The sixth column contains the data type of the JMS API property if accessed by a JMS application.
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