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!

Storing Messages in a Journal Queue

There are two ways you can set up the use of journal queues for sent messages—you can set a default property for your MessageQueue component so that all messages sent by it will use journals, or you can establish journal queue recording for individual messages you are sending.

For an overview of journal storage, see Message Queue Journal Storage.

To use journals for all messages sent by an instance of the MessageQueue component

  1. Create an instance of the MessageQueue component and set its Path property to the queue to which you want to refer. For details, see Creating MessageQueue Components.
  2. Set the UseJournalQueue property for your MessageQueue component to true.
    Tip   You can do this in code by setting the UseJournalQueue property on the DefaultPropertiestoSend class for your component to true.

To set journal recording for an individual message

  1. Create the message you want to send.
  2. In code, set the UseJournalQueue property to true. Your code might look like this:
    [Visual Basic]
    Message1.UseJournalQueue = True
    [C#]
    Message1.UseJournalQueue = true;

To set journal recording for messages removed from a queue

  1. Create an instance of the MessageQueue component and set its Path property to the queue to which you want to refer. For details, see Creating MessageQueue Components.
  2. Set the UseJournalQueue property for the MessageQueue component that references that queue to true. Your code might look like this:
    [Visual Basic]
    MessageQueue1.UseJournalQueue = True
    [C#]
    MessageQueue1.UseJournalQueue = true;

To set the maximum size for a journal queue

  1. Create an instance of the MessageQueue component and set its Path property to the journal queue you want to refer to. For details, see Creating MessageQueue Components.
  2. Set the MaximumJournalSize property to the capacity, in kilobytes, that you want to use for your journal queue.

See Also

Sending and Serializing Messages | Message Queue Journal Storage | Purging a Queue's Contents | Default Message Properties | Requesting Acknowledgment for a Message | Sending and Serializing Messages | Creating MessageQueue Components