Share via

Journals

  • Article

Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2

Journals

Queue and computer journals are system queues that are automatically created by Message Queuing. When a sending application sends a message, a copy of the message is optionally stored in the computer journal of each computer it passes through. When a receiving application removes the message from the destination queue, a copy of the message is optionally sent to the queue journal. Applications can only read the messages in queue and computer journals. They cannot send messages to queue or computer journals. In contrast, Message Queuing never removes messages from queue or computer journals. It is up to the application reading the messages to clear the messages from the queues. If an application uses journaling and no provisions are made to clean up the journals used, Message Queuing disk storage will quickly be consumed.

Computer journals

A computer journal is created whenever a Message Queuing computer is added to a Windows Server 2003 enterprise. It is used to store copies of all messages successfully sent from the computer. Message Queuing stores copies of the messages sent from the computer whenever positive source journaling is specified by the sending application. For more information, see Source journaling.

Computer journals can be referenced by a machine format name or a direct format name. The following lines show the syntax of these format names:

MACHINE=ComputerGUID;JOURNAL

DIRECT=AddressSpecification\SYSTEM$;JOURNAL (Introduced in MSMQ 2.0)

For instructions on setting the computer journal size, see Set the journal storage size for computers.

A computer journal is not created for computers operating in workgroup mode or virtual servers in clusters. You can set the computer quota of a workgroup computer using the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSMQ\Parameters\MachineCache\MachineJournalQuota registry key. To change the quota for a virtual server, you need to change the analogous registry key for clustered servers. After setting the registry, restart the Message Queuing service for the changes to take effect.

Caution

  • Incorrectly editing the registry may severely damage your system. It is recommended that you back up any valuable data on the computer before making changes to the registry.

Queue journals

Queue journals are created whenever an application queue is created. Message queuing creates the queue journal on the same computer where the messages for the application-generated queue are stored.

Message Queuing stores copies of the messages removed from the application queue whenever target journaling is enabled on the queue. This does not include messages removed from the queue when their time-to-be-received elapses or messages purged from the queue in the Message Queuing MMC snap-in. For more information, see Target journaling.

For instructions on setting the queue journal size, see Set the journal storage size for queues.