Message Properties
Applies To: Windows Server 2008
Message properties
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. |
Default message lifetime
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.