Message Properties

Updated: June 25, 2007

Applies To: Windows Server 2008

In the context of Message Queuing, messages consist of a body and a set of properties, and can be of various types. Message bodies can contain text or any form of binary information, and can be encrypted.

Every message has properties. Some message properties are read-only, and the majority can only be modified programmatically. For more information, refer to the Message Queuing Software Development Kit (SDK).

You can view the properties of messages, and you can choose which message property columns appear by default in the details pane (usually the right pane) of the Computer Management snap-in and in what order. For instructions on how to view message properties, see View Message Properties. You can choose the columns to be displayed by selecting a message in the Computer Management snap-in, and then clicking the View menu, and selecting Add/Remove Columns. The following message properties are available for selection.

 

Message property Explanation

Abort Count

Specifies the number of times that an attempted delivery of a message to a transactional queue has been aborted.

Admin Queue

Specifies the name of the administration queue used for system-generated acknowledgment messages.

Admin queue name length

Indicates the length (in Unicode characters) of the format name buffer of the administration queue.

Application-specific

Specifies application-generated information such as single integer values or application-defined message classes.

Authenticated

Indicates whether the message was authenticated at the request of the sending application.

Correlation

Specifies an application-generated correlation identifier that the receiving application can use to sort messages.

Dead Letter Queue

Specifies that a per application dead letter queue is being used. For more information about per application dead letter queues see Dead-Letter Queues.

Dead letter queue name

Specifies the name of the per application dead letter queue that is being used.

Delivery Mode

Specifies how Message Queuing delivers the message to the queue, in either recoverable, or express mode. For more information, see Message Delivery Methods.

Destination Queue Format Name

Indicates the name of the destination queues to which the message was sent.

Destination Queue Format Name Length

Indicates the length of the format name buffer (in Unicode characters) allocated by the receiving application.

Encrypted

Specifies whether the message body of a private message was encrypted.

Encryption Algorithm

Specifies the encryption algorithm used to encrypt the message body of a private message.

Hash Algorithm

Identifies the hashing algorithm that Message Queuing uses when authenticating the message.

Label

Specifies the label of the message.

Label Length

Identifies the length (in Unicode characters) of the message label buffer.

Message ID

Indicates a unique identifier for each message in your enterprise. This includes application-generated and system-generated messages sent by Message Queuing.

Message Lookup ID

Indicates the lookup identifier of the message. The receiving application can use this identifier to peek at or retrieve the message from the queue without navigating the queue.

Move Count

Inidicates the number of times the message has been moved from the main queue to a subqueue, from a subqueue to a sibling queue, or from a subqueue to the main queue.

Priority

Indicates the message priority. A higher number indicates a higher priority message. The default value is 3.

Recipient Queue

Specifies the queue to which application-generated response messages are returned.

Recipient Queue Name Length

Indicates the length (in Unicode characters) of the response queue format name buffer. This is used by the receiving application to allocate a buffer for the response queue specified by the sending application.

Response Queue

Specifies the response queues used for returning application-generated response messages.

Response Queue Format Name

Specifies the response queues used for returning application-generated response messages.

Response Queue Format Name Length

Indicates the length (in Unicode characters) of the format name buffer allocated by the receiving application.

Response queue name length

Indicates the length (in Unicode characters) of the format name buffer of the response queue format name buffer.

Sender ID

Identifies who sent the message, and used primarily by the receiving queue manager when authenticating a message.

Sender ID exists

Indicates Yes or No to signify whether a Sender ID value exists for the message.

Sender ID Length

Indicates the length of the Sender ID.

Size

Indicates the size of the message body.

Source Computer

Provides the globally unique identifier (GUID) of the computer that sent the message.

Time Arrived

Indicates the date and time that the message was received.

Time Sent

Indicates the date and time that the message was sent by the source.

Tracked

Specifies whether Message Queuing traces the route of the message.

Through the Computer Management snap-in, you can set the default lifetime of messages in your network, also known as the time-to-reach-queue (TTRQ) value. Messages are considered expired when the TTRQ value is reached. If you do not specify a TTRQ value, the following default settings apply:

  • 4 days for messages sent from the following types of computers:

    • Computers running Message Queuing 4.0 or later in workgroup mode.

    • Clients running Message Queuing 4.0 or later that belong to a completely new Windows Server 2008 domain.

    • Clients running Message Queuing 4.0 or later that join an existing domain provided weakened security was not enabled for that forest.

  • 90 days for messages sent from the following types of computers:

    • Any computer in a migrated enterprise and computers running MSMQ 2.0 on Windows 2000.

For information about how to set the lifetime of messages on your network, see Set the Default Lifetime for Messages.

Community Additions

ADD
Show: