Mapping JMS provider-specific fields

The following notes refer to the mapping of JMS provider-specific fields into IBM MQ messages.

    JMS_IBM_Report_XXX 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 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 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 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 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 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 MQ application that this message is the last in a group. This property is ignored for publish/subscribe messaging.

Parent topic: Mapping JMS fields onto IBM MQ fields (outgoing messages)