MSMQQueueInfo.Journal

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This property object specifies the journaling level of the destination queue. The journaling level determines whether messages retrieved from the destination queue are stored in the journal of the queue.

Syntax

HRESULT get_Journal( 
  long* plJournal 
);
HRESULT put_Trace( 
  long lJournal
);

Parameters

• plJournal or lJournal
  Specifies the journaling level of the destination queue. The following table shows the possible values.

  Value	Description
  MQ_JOURNAL	When a message is removed from the queue, it is stored in the queue journal.
  MQ_JOURNAL_NONE	The default. Messages are not stored in a queue journal when they are removed from the queue.

Return Value

The following table describes the common return values.

Remarks

The MSMQQueueInfo.Journal property is used to enforce target journaling for the destination queue.

When target journaling is enabled, Message Queuing stores a copy of each message removed from the queue in the destination queue's journal.

The size of the queue journal can be set using the MSMQQueueInfo.JournalQuota property.

Setting the MSMQQueueInfo.Journal property does not create a queue journal. Queue journals are system queues generated by MSMQ.

Setting and Retrieving the Journaling Level

To specify the journaling level when creating the queue, set the MSMQQueueInfo.Journal property and call the MSMQQueueInfo.Create method.

To reset the journaling level of an open queue, set MSMQQueueInfo.Journal to a new level and call the MSMQQueueInfo.Update method. This method updates the queue information stored by Message Queuing.

For public queues, this information is stored in the directory service.

For private queues, this information is stored on the computer where the messages of the queue are stored.

To retrieve the stored journaling level of a queue, call the MSMQQueueInfo.Refresh method and inspect the MSMQQueueInfo.Journal property.

Equivalent Function Property

When using function calls, the journaling level of the queue can be set and retrieve using the PROPID_Q_JOURNAL property.

Requirements