Microsoft KB Archive/254767: Difference between revisions
(importing KB archive) |
m (Text replacement - """ to """) |
||
Line 73: | Line 73: | ||
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 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 | * 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.<br /> | * 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.<br /> | ||
<br /> | <br /> | ||
Line 106: | Line 106: | ||
=== Control Settings === | === 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 | * 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.<br /> | ||
<br /> | <br /> | ||
'''NOTE''': Universal naming convention (UNC) paths are not supported. | '''NOTE''': Universal naming convention (UNC) paths are not supported. |
Latest revision as of 13:52, 21 July 2020
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
MORE INFORMATION
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
- On the Edit menu, click Add Key.
- In the Key Name box, type ArchiveSink.
- Leave the Class box blank.
- Click OK.
- Select the following key in the registry:
- 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 InboundValue Name: Mapi OutBound
Data Type: REG_SZ
Value: d:\ArchiveSink\Mapi OutboundValue Name: Enable Smtp Inbound
Data Type: REG_DWORD
Radix: Binary
Value: 1Value Name: Enable Mapi Outbound
Data Type: REG_DWORD
Radix: Binary
Value: 1Value Name: Enable PreCat
Data Type: REG_DWORD
Radix: Binary
Value: 1Value Name: Enable PostCat
Data Type: REG_DWORD
Radix: Binary
Value: 0Value Name: Dump P1
Data Type: REG_DWORD
Radix: Binary
Value: 1Value Name: Archive System Messages
Data Type: REG_DWORD
Radix: Binary
Value: 0For 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.
- Quit Registry Editor.
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