Microsoft KB Archive/254767

= XGEN: How to Install and Use Archive Sink in Exchange 2000 Server Service Pack 1 or Earlier =

PSS ID Number: 254767

Article Last Modified on 6/17/2003

-

The information in this article applies to:


 * Microsoft Exchange 2000 Server

-



This article was previously published under Q254767



IMPORTANT: This article contains information about modifying the registry. Before you modify the registry, make sure to back it up and make sure that you understand how to restore the registry if a problem occurs. For information about how to back up, restore, and edit the registry, click the following article number to view the article in the Microsoft Knowledge Base:

256986 Description of the Microsoft Windows Registry



SUMMARY
This article provides information about the Exchange 2000 Archive Sink utility.

IMPORTANT: The instructions in the article apply only to Exchange 2000 Service Pack 1 (SP1) and earlier. For additional information about how to configure Archive Sink in Exchange 2000 Service Pack 2 (SP2) and later, click the article number below to view the article in the Microsoft Knowledge Base:

307798 XCON: The Archive Sink Utility Is Available in Service Pack 2



Description
The Exchange 2000 Archive Sink is a transport sink that archives all messages coming in and out of an Exchange 2000 Server computer. Archive Sink output is triggered by the following two transport events:
 * The OnMessageSubmission event. All messages that are submitted to transport by using Simple Mail Transfer Protocol (SMTP), the information store, or other sinks trigger this event. Theoretically, this event can be raised only once for each message, and therefore can be archived only once. This event is raised before the routing or categorizer events. These messages are referred to as "PreCat" messages, or messages that are submitted prior to categorization.
 * The OnPostCategorize event. This event is designed to capture the message after the categorization of a message. Categorization of a message involves looking up the recipients and sender in the directory service and also expanding distribution lists (DLs). Messages can trigger this event one or more times. Messages can only trigger this event more than once when messages (that are already categorized) in a queue are re-enumerated.

When recipients are Internet bound (SMTP one-off addresses or SMTP contacts), those Internet message formats that are administered on the Exchange 2000 server require special content handling for the message. In this case, the categorizer bifurcates or spawns new messages from the original message and moves these recipients into them. These new messages also trigger this event.

Other Features

 * For debugging purposes, you can enable the Dump P1 registry key to dump the P1 recipients in the message.
 * You can enable archival of public folder and system messages by setting the Archive System Messages registry key DWORD value to 1.

Setup
You can obtain a copy of the Archivesink.dll file from the Microsoft Exchange 2000 Server Resource Kit.

To register the Archivesink.dll file:  Copy the Archivesink.dll file to the Exchsrvr\Bin folder. Run the following command at a command prompt:

regsvr32 archivesink.dll



To un-register the Archivesink.dll file, run the following command at a command prompt:

regsvr32 /u archivesink.dll

Control Settings

 * When the Archivesink.dll file is registered, archiving is enabled by default. Archive Sink archives all messages to the system temporary folder (%windir%\Temp) or to the "SMTP Inbound" and "MAPI Inbound" locations, if those locations are defined in the registry.

NOTE: Universal naming convention (UNC) paths are not supported.
 * Only OnMessageSubmission (PreCat) messages are archived.
 * System messages (such as public folder messages, replication messages, and so on) are not archived, unless the Archive System Messages key is set to 1.
 * The dump P1 recipients functionality is enabled by default unless the Dump P1 registry key is set to 0.

Registry Settings
If certain registry key settings are present, you have more flexibility with and control of Archive Sink.

WARNING: If you use Registry Editor incorrectly, you may cause serious problems that may require you to reinstall your operating system. Microsoft cannot guarantee that you can solve problems that result from using Registry Editor incorrectly. Use Registry Editor at your own risk.

 Start Registry Editor (Regedt32.exe). Locate the following key in the registry:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Exchange\ArchiveSink

If the ArchiveSink key does not exist, you must add it:  Select the following key in the registry:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Exchange

</li> On the Edit menu, click Add Key.</li> In the Key Name box, type ArchiveSink .</li> Leave the Class box blank.</li> Click OK.</li></ol> </li> The following registry values are available, and you can add these values under the ArchiveSink key by clicking Add Value on the Edit menu:

Value Name: Smtp Inbound

Data Type: REG_SZ

Value: d:\ArchiveSink\Smtp Inbound

Value Name: Mapi OutBound

Data Type: REG_SZ

Value: d:\ArchiveSink\Mapi Outbound

Value Name: Enable Smtp Inbound

Data Type: REG_DWORD

Radix: Binary

Value: 1

Value Name: Enable Mapi Outbound

Data Type: REG_DWORD

Radix: Binary

Value: 1

Value Name: Enable PreCat

Data Type: REG_DWORD

Radix: Binary

Value: 1

Value Name: Enable PostCat

Data Type: REG_DWORD

Radix: Binary

Value: 0

Value Name: Dump P1

Data Type: REG_DWORD

Radix: Binary

Value: 1

Value Name: Archive System Messages

Data Type: REG_DWORD

Radix: Binary

Value: 0

For the REG_DWORD values, 1 enables the setting and 0 disables the setting. With these keys, you can turn archiving for SMTP inbound messages, MAPI outbound messages, or both on or off.

IMPORTANT: Any registry key setting overrides all default settings.</li> Quit Registry Editor.</li></ol>

Additional Information

 * UNC paths are not supported.
 * Registry settings that you change are applied until you restart the IISadmin service.
 * If all these registry keys are absent, archiving occurs by default in the %windir%\Temp folder.

Additional query words: xmrp x2keventht

Keywords: kbhowto KB254767

Technology: kbExchange2000Search kbExchange2000Serv kbExchange2000ServSearch kbExchangeSearch

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© 2004 Microsoft Corporation. All rights reserved.