NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

MessageQueue.UseJournalQueue

Gets or sets a value indicating whether retrieved messages are copied to the journal queue.

[Visual Basic]
Overridable Public Property UseJournalQueue As Boolean
[C#]
public bool UseJournalQueue {virtual get; virtual set;}
[C++]
public: __property virtual bool get_UseJournalQueue();
public: __property virtual void set_UseJournalQueue(bool);
[JScript]
public function get UseJournalQueue() : Boolean;
public function set UseJournalQueue(Boolean);

Property Value

true if messages retrieved from the queue are copied to its journal queue; otherwise, false.

Exceptions

Exception Type Condition
ArgumentException The UseJournalQueue property could not be set by the application.
MessageQueueException The attempt to get or set the UseJournalQueue setting generated an internal error on the message queue component. The error is specified by the given status message.

Remarks

Journals are automatically created by the Message Queuing application whenever an application queue is created. Message Queuing creates the queue journal where the new queue is located. The queue journal is used to track the messages removed from a queue.

Note   This does not include message removed from the queue when their time-to-be-received timer expires, or messages purged from the queue using the Message Queuing directory service (Information Store or Active Directory).

Applications cannot send messages to queue journals. Applications are limited to read-only access to these queues. In addition, Message Queuing never removes messages from a journal. It is up to the application using the queue to clear the messages of a journal queue by retrieving them or by purging the queue.

Example

See Also

MessageQueue Class | MessageQueue Members | System.Messaging Namespace | MaximumJournalSize