PROPID_Q_JOURNAL

Optional. The PROPID_Q_JOURNAL property specifies if messages retrieved from the queue are also copied to its journal queue.

Type Indicator

VT_UI1

PROPVARIANT Field

bVal

Property Values

This property can be set to one of the following values:

MQ_JOURNAL

All messages removed from the specified queue are stored in its journal queue.

MQ_JOURNAL_NONE

The default. Messages are not stored in a journal queue. All messages removed from the specified queue are discarded.

Remarks

The PROPID_Q_JOURNAL property does not create a journal, it specifies whether or not messages removed from the queue are stored in the journal queue. Journal queues are system queues created by MSMQ (for information on journal queues, see Journal Queues). The application can only read the messages in a journal.

To save removed messages in a journal queue, pass PROPID_Q_JOURNAL to MQCreateQueue when creating the queue.

To start or stop storing messages in the journal queue, pass PROPID_Q_JOURNAL to MQSetQueueProperties. When the property value is changed, the remaining messages retrieved from the specified queue will be stored or discarded according to the new setting.

To determine if removed messages are being stored in the journal queue, pass PROPID_Q_JOURNAL to MQGetQueueProperties and examine its returned value.

To specify the size of a queue journal, see PROPID_Q_JOURNAL_QUOTA.

See Also

MQCreateQueue, MQGetQueueProperties, MQSetQueueProperties, PROPID_Q_JOURNAL_QUOTA

© 1997 by Microsoft Corporation. All rights reserved.