Some of the content described in this article is available in meshIQ Manage versions 11.1.1 and later. See meshIQ platform Highlights v11.1 for an overview of feature changes.

This topic covers field descriptions for the following message properties tabs:

Vertical tabs on the left side of the dialog: General, MD (Message Descriptor) properties), MDE (Message Descriptor Extension) properties, DLH (Dead Letter Header) properties, XQH (Transmission Queue) properties, and PMO (Put Message Options). (The MD1 vertical tab is identical to the MD tab, but without a Group tab.)
Horizontal tabs on the Message Descriptor Properties dialog: General (see MD properties), Identity, Origin, Reports, and Group.

Vertical Tabs

The vertical tabs allow you to add and edit message headers.

General tab

Edit Message – General tab
Control	Description	States and Conditions
Message size (bytes)	Displays size of message without headers.	Always enabled.
Remove original	If checked, removes all original message headers when submitted.
Preserve context	If checked, preserves message context.
Contains headers	Selects which header(s) will be available in the message.
MD button	Displays Message Descriptor Properties window where user can view/edit MD header of message.	Enabled only if MD1 checkbox is not selected.
MD1 button	Displays Message Descriptor Properties window where user can view/edit MD1 header of message.	Enabled only if MD1 checkbox is selected.
MDE button	Displays Message Descriptor Extension window where user can edit MDE header of message.	Enabled only if MDE checkbox is selected.
DLH button	Displays Dead Letter Queue Header window where user can view/edit DLH header of message.	Enabled only if DLH checkbox is selected.
XQH button	Displays Transmission Queue Header window where user can view/edit XQH header of message.	Enabled only if XQH checkbox is selected.
File attachment	Input file name to attach to this message.	Always enabled.
Message Criteria	Select from the Criteria list to apply Message Criteria. By default, the Message Criteria from User Settings or Global Settings is selected. You can also select other Message Criteria records.
RFH2 headers	Edit raw RFH2 or JMS header data.	Enabled only if RFH2 checkbox is selected. (Also allows you to edit messages that were created using the JMS checkbox.)
Data button	Displays Message Data window where user can view/edit message data.	Always enabled.

MD (Message Descriptor) Header

Message Descriptor Properties – General
Control	Description	States and Conditions
Version	Select MD version from the list.	Always enabled.
Application message type	Input application message type.	Editable only if APPLICATION message type is selected from the Message Type drop-down menu.
Message type	Select message type from the list.	Always enabled.
Application feedback code	Input application feedback code.	Editable only if APPLICATION feedback code is selected from the Feedback drop-down menu.
Message format	Select message format from the list. If either the RFH2 or the JMS option is selected on the General tab, then the MQHRF2 list item is automatically selected in the Message format list on the Message Descriptor Properties tab. If either option is later unselected, the Message format is reset to its previous value.	Always enabled.
Encoding	Provides message data encoding.	Read only.
Feedback	Select message feedback code from the list.	Always enabled.
CCSID	Provides message coded character set identifier.	Read only.
Expiry	Input message expiry. For messages that have a positive expiry interval, the countdown toward expiration begins as soon as the message is created.	Always enabled.
Priority	Input message priority.	Always enabled.
Backout count	Provides backout counter.	Read only.
Persistent	Set message persistence.	Always enabled.
Put date	Provides date when message was put.	Always enabled.
Put time	Provides time when message was put.
Reply to queue	Input name of a message queue to which the reply or report message should be sent.
Reply to QM	Input name of the queue manager to which the reply or report message should be sent.

MDE (Message Descriptor Extension) Header

Message Descriptor Extension Properties
Control	Description
Version	Select version from the list.
Structure length	Specify structure length.
Encoding	Specify message data encoding.
Coded charset id	Specify message coded character set identifier.
Format	Select message format from the list.
Flags	Specify a value for flags.
Group id	Edit group identifier.
Message sequence number	Input sequence number of logical message within group.
Offset	Input offset of data in physical message from the start of the logical message.
Message flags	Input flags that specify attributes of the message.
Original length	Input length of original message.

DLH (Dead Letter Header)

Dead Letter Queue Header
Control	Description
Version	Select version from the list.
Reason	Input reason code.
Dest q name	Input name of destination queue.
Dest q manager name	Input name of destination queue manager.
Encoding	Specify message data encoding.
Coded chartset id	Specify message coded character set identifier.
Format	Select message format from the list.
Put appl type	Input put application type.
Put appl name	Input put application name.
Put date	Provides date when message was put.
Put time	Provides time when message was put.

XQH (Transmission Queue) Header – General

Transmission Queue Header – General
Control	Description	States and Conditions
Remote q name	The name of the remote queue.	Always enabled.
Remote q manager name	The name of the remote queue manager.
MD Version	Select the MD version from the list.
Application message type	Input application message type.	Editable only if APPLICATION message type is selected in Message Type combo box.
Message type	Select message type from the list.	Always enabled.
Application feedback code	Input application feedback code.	Editable only if APPLICATION feedback code is selected in Feedback combo box.
Message format	Select message format from the list.	Always enabled.
Encoding	Provides message data encoding.	Read only.
Feedback	Select message feedback code from the list.	Always enabled.
CCSID	Provides message coded character set identifier.	Read only.
Expiry (1/10sec)	Input message expiry. For messages that have a positive expiry interval, the countdown toward expiration begins as soon as the message is created.	Always enabled.
Priority	Input message priority.	Always enabled.
Backout count	Provides backout counter.	Read only.
Persistent	Select message persistence.	Always enabled.
Put date	Input date when message was put.
Put time	Input time when message was put.
Reply to queue	Input name of a message queue to which the reply or report message should be sent.
Reply to QM	Input name of the queue manager to which the reply or report message should be sent.

XQH (Transmission Queue) Header – Identity

Transmission Queue Header – Identity
Control	Description	States and Conditions
Message identifier	Edit message identifier.	Always enabled.
Correlation identifier	Edit message correlation identifier.
User identifier	Enter user identifier.
Application identity data	Enter application identity data.
Accounting token	Edit message accounting token.

XQH (Transmission Queue) Header – Origin

Transmission Queue Header – Origin
Control	Description	States and Conditions
Put application type	Input put application type.	Always enabled.
Application origin data	Input application origin data.
Put application name	Input put application name.

XQH (Transmission Queue) Header – Report

Additional options for XQH messages are available to configure.

Transmission Queue Header - Report
Control	Description	States and Conditions
Exception	Select an exception report message type from the list.	Always enabled.
Expiration	Select an expiration report message type from the list.
Confirm on arrival	Select confirm-on-arrival report message type from the list.
Confirm on delivery	Select confirm-on-delivery report message type from the list.
Message ID	Specify how the Message ID of the report message (or the reply message) is to be set.
Correlation ID	Specify how the Correlation ID of the report message (or the reply message) is to be set.
Disposition options	Specify message disposition type when a message cannot be delivered to its destination queue.

PMO (Put Message Options)

Message Put Options
Control	Description	States and Conditions
No Put Options	Specifies that no options are used.	Disabled if another entry is selected.
Syncpoint	Operate within the normal unit-of-work protocols.	Enabled only when No Put Options is NOT selected.
No Syncpoint	Operate outside the normal unit-of-work protocols.
New Message ID	Used to identify a new message identifier.
New Correlation ID	Used to identify a new correlation identifier.
No Context	Context field in MQMD are set to blanks, nulls, and zeros.
Default Context	Message will have default context associated with it.
Pass Identity Context	Passes identity context information from the original message to a new message.
Pass All Context	Passes identity and origin context information from the original message to a new message.
Set Identity Context	Sets identity context information from the original message to a new message.
Set All Context	Sets identity and origin context information from the original message to a new message.	Enabled only when No Put Options is NOT selected.
AlternateUserAuthority	User identifier to validate authority to messages on the queue.
Fail if Quiescing	Forces MQPUT or MQPUT1 call to fail if queue manager in quiescing state.
Logical Order	Puts groups and segment information in logical order rather than physical order.

Horizontal tabs

General tab

See MD (Message Descriptor) Header.

Identity tab

Message Descriptor Properties – Identity
Control	Description	States and Conditions
Message identifier	Edit message identifier.	Always enabled.
Correlation identifier	Edit message correlation identifier.
User identifier	Enter user identifier.
Application identity data	Enter application identity data.
Accounting token	Edit message accounting token.

Origin tab

Message Descriptor Properties – Origin
Control	Description	States and Conditions
Put application type	Input put application type.	Always enabled.
Application origin data	Input application origin data.
Application name	Input put application name.

Reports tab

Message Descriptor Properties – Reports
Control	Description	States and Conditions
Exception	Select an exception report message type from the list.	Always enabled.
Expiration	Select an expiration report message type from the list.
Confirm on arrival	Select confirm on arrival report message type from the list.
Confirm on delivery	Select confirm on delivery report message type from the list.
Message ID	Specify how the Message ID of the report message (or the reply message) is to be set.
Correlation ID	Specify how the Correlation ID of the report message (or the reply message) is to be set.
Disposition options	Specify message disposition type when a message cannot be delivered to its destination queue.

Group tab

Message Descriptor Properties – Group
Control	Description	States and Conditions
Group identifier	Edit group identifier.	Always enabled.
Message sequence number	Input sequence number of the logical message within the group.
Message flags	Input message flags.
Data offset	Input offset of data in physical message from the start of the logical message.
Original length	Input length of original message.