WebSphere WebSphere Application Server Express, Version 6.0.x Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Mapping of WebSphere MQ message fields and properties to JMS

This topic describes how the WebSphere MQ message fields and properties map to JMS and are converted by the WebSphere MQ link.

The JMS API defines the set of fields and properties available on a JMS message. The message originating from WebSphere MQ is translated into a form used by the service integration bus. This content is accessed using the methods defined by the JMS javax.jms.Message class and subclasses. For example, the text body of a WebSphere MQ message received by the WebSphere MQ link engine is accessed using the getText method of the resulting javax.jms.TextMessage object. Additionally, a set of JMS provider-specific properties are present that reflect the message's underlying WebSphere MQ representation. These properties are relevant only to applications designed to be WebSphere MQ-aware.

The tables below show the mapping of MQMD V1 and V2 fields.

Table 1. Mapping between message descriptor field V1 and JMS fields and properties.
WebSphere MQ MQMD V1 field in original message WebSphere Application Server JMS message field or property Type
StrucId V1 -  
Version -  
Report

JMS_IBM_Report_COA
JMS_IBM_Report_COD
JMS_IBM_Report_Expiration
JMS_IBM_Report_Exception
JMS_IBM_Report_PAN
JMS_IBM_Report_NAN
JMS_IBM_Report_Pass_Msg_ID
JMS_IBM_Report_Pass_Correl_ID
JMS_IBM_Report_Discard_Msg

s
s
s
s
s
s
s
s
s

MsgType JMS_IBM_MsgType s
Expiry JMSExpiration h
Feedback JMS_IBM_Feedback s
Encoding JMS_IBM_Encoding s
CodedCharSetId JMS_IBM_Character_Set s
Format JMS_IBM_Format s
Priority JMSPriority h
Persistence JMSDeliveryMode h
MsgId JMSMessageID h
CorrelId JMSCorrelationID h
BackoutCount JMSXDeliveryCount p
ReplyToQ JMSReplyTo h
ReplyToQMgr JMSReplyTo h
UserIdentifier JMSXUserID p
AccountingToken -  
ApplIdentityData -  
PutApplType JMS_IBM_PutApplType s
PutApplName JMSXAppID p
PutDate

JMSTimestamp
JMS_IBM_PutDate

h
s

PutTime

JMSTimestamp
JMS_IBM_PutTime

h
s

ApplOriginData -  

Key:
h=message header field
p=message property
s=provider-specific property

Table 2. Mapping between message descriptor field V2 and JMS fields and properties.
WebSphere MQ MQMD V2 field in original message WebSphere Application Server JMS message field or property Type
GroupId JMSXGroupID p
MsgSeqNumber JMSXGroupSeq p
Offset -  
MsgFlags JMS_IBM_Last_Msg_In_Group s
OriginalLength -  

Key:
p=message property
s=provider-specific property


Reference topic

Terms of Use | Feedback

Last updated: 2 Aug 2005
http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.pmc.express.doc\ref\rjc0007_.html

© Copyright IBM Corporation 2004, 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)