Property

Description

Ack

Numeric. Specifies the type of acknowledgment messages that the Message Queuing posts in the Administration Queue when acknowledgments are requested. The acknowledgement messages are:

• MQMSG_ACKNOWLEDGMENT_FULL_REACH_QUEUE – Posts a positive or negative acknowledgment, depending on whether or not the message reaches the queue. A negative acknowledgment is posted when the time-to-reach-queue timer of the message expires. The enumeration is 5.

• MQMSG_ACKNOWLEDGMENT_NACK_REACH_QUEUE – Posts a negative acknowledgment when the message cannot reach the queue. A negative acknowledgment is posted when the time-to-reach-queue timer of the message expires. The enumeration is 4.

• MQMSG_ACKNOWLEDGMENT_FULL_RECEIVE – Posts a positive or negative acknowledgment, depending on whether or not the message is retrieved from the queue before its time-to-be-received timer expires. The enumeration is 14.

• MQMSG_ACKNOWLEDGMENT_NACK_RECEIVE – Posts a negative acknowledgment when the message cannot be retrieved from the queue before the message's time-to-be-received timer expires. The enumeration is 12.

• MQMSG_ACKNOWLEDGMENT_NONE – The default. No acknowledgment messages are posted. The enumeration is 0.

AdminPath

Alpha. Specifies the acknowledgement queue to send acknowledgement messages to. This should be used in conjunction with the Ack property and only used if the acknowledgement queue is different from the default. The format of this string is:

<computer name>\<QueueType>\<Queue Name>

For example:

msmq_Comp\private$\ackQ

AppSpecific

Numeric. Application specific implementations. This is useful for only reading certain messages.

Delivery

Numeric. Specifies whether the message remains in the queue after the computer has restarted. The valid values are:

• MQMSG_DELIVERY_EXPRESS – Default. (Enumeration 0). Messages will not be kept.

• MQMSG_DELIVERY_RECOVERABLE – (Enumeration 1). The messages will be kept even after the computer is restarted.

Extension

Vector. This is a Magic xpa vector defined as having a numeric cell of 3 for application-specific implementations. No checks are made by the component or MSMQ.

Journal

Numeric. The parameters that allow you to perform the Journal programs are listed below:

• MQMSG_JOURNAL – Positive source journaling is requested. A copy of the message is stored in the computer journal on the computer when the message was successfully delivered to the next computer, but no copy is stored in the applicable dead-letter queue when the message delivery failed. The enumeration is 2.

• MQMSG_JOURNAL – Positive source journaling is requested. A copy of the message is stored in the computer journal on the computer when the message was successfully delivered to the next computer, but no copy is stored in the applicable dead-letter queue when the message delivery failed. The enumeration is 2.

• MQMSG_DEADLETTER – Negative source journaling is requested. Copies of the message are stored in the applicable dead-letter queue on failure. The enumeration is 1. This is valid for MSMQ 3.0 and above.

• MQMSG_JOURNAL | MQMSG_DEADLETTER – Positive and Negative source journaling is requested. Copies of the message are stored in the computer journal when message delivery was successful and in the applicable dead-letter queue when message delivery failed. The enumeration is 3. This is valid for MSMQ 3.0 and above.

• MQMSG_JOURNAL_NONE – The Source journaling is disabled, and the Message Queuing does not store copies of the message in the computer journal on success nor in the applicable dead - letter queue on failure. The enumeration is 0. This is the default of the MSMQ Journal property.

• MQMSG_DEADLETTER – Negative source journaling is requested. Copies of the message are stored in the applicable dead-letter queue on failure. The enumeration is 1. This is valid for MSMQ 3.0 and above.

• MQMSG_JOURNAL | MQMSG_DEADLETTER - Positive and Negative source journaling is requested. Copies of the message are stored in the computer journal when message delivery was successful and in the applicable dead-letter queue when message delivery failed. The enumeration is 3. This is valid for MSMQ 3.0 and above.

• MQMSG_JOURNAL_NONE – The Source journaling is disabled, and the Message Queuing does not store copies of the message in the computer journal on success nor in the applicable dead - letter queue on failure. The enumeration is 0. This is the default of the MSMQ Journal property.

Label

Alpha. A text value that gives the message a label of up to 250 characters.

LookupId

Alpha (40). This parameter is useful for reading only certain messages, and is only valid for MSMQ 3.0 and above (XP).

MaxTimeToReachQueue

Numeric (9) value in seconds. If this interval elapses before the message reaches its destination, Message Queuing discards the message and acts according to the Journal setting. The default is 90 days, which is 7776000 seconds.

MaxTimeToReceive

Numeric (9) value in seconds. The default is 0, infinite. Specifies a time limit for the message to be retrieved from the target queue. This includes the time spent getting to the destination queue plus the time spent waiting in the queue before it is retrieved by an application.

Priority

Specifies the priority of the message. A numeric value between 0 and 7, where 0 is the lowest priority. The default is 3.