The Archive Sink utility is a custom script that enables the
archiving of all messages coming into and moving out of a specific folder on a
Microsoft Exchange Server 2003 computer. By default, when Archive Sink is
enabled, all messages and their recipients are archived to an .eml file, except
for Bcc recipients.
Archive Sink is a transport event sink that
archives all incoming and outgoing messages on an Exchange computer. Archive
Sink uses the following two transport events:
The OnMessageSubmission event - All messages submitted to transport by Simple Mail
Transfer Protocol (SMTP), by the information store, or by any other sinks
trigger this event. Theoretically, this event can be raised one time for each
message, and this event can be archived only one time. The OnMessageSubmission event is raised before the routing or categorizer events.
Therefore, these messages are referred to as PreCat messages. By default,
messages are archived for this event when the Active Sink utility is installed.
Messages that are archived for this event contain the prefix file name:
The OnPostCategorize event - This event is designed to capture the message after the
categorization of a message occurs. Messages can trigger this event more than
one time, but this can only occur when a message has been categorized, queued,
and then enumerated again. By default, messages are not archived for this event
unless specified in the registry. Messages that are archived for this event
contain the prefix file name: ARCH_POSTCAT_random
Only use Archive Sink for troubleshooting purposes because
archiving may affect server performance and possibly fill up disk space. You
must manually delete archived messages.
How to Obtain Microsoft Support Files from Online Services
Microsoft scanned this file for viruses. Microsoft used the most
current virus-detection software that was available on the date that the file
was posted. The file is stored on security-enhanced servers that help to
prevent any unauthorized changes to the file.
There are four files that are included in the
Archivesink.exe file that you must extract to the C:\Program Files\Exchsrvr\bin
folder. These files are named ArchiveSink.doc, ArchiveSink_setup.vbs,
ArchiveSink.dll and eula.txt.
You must enable archiving by running the
archivesink_setup.vbs script. To do this, follow these steps:
Click Start, click
Run, type cmd, and then click
In the C:\Program Files\Exchsrvr\bin folder, type
cscript archivesink_setup.vbs, and then press ENTER.
You receive the following output.
C:\Program Files\Exchsrvr\BIN>cscript archivesink_setup.vbs
Microsoft (R) Windows Script Host Version 5.6
Copyright (C) Microsoft Corporation 1996-2001. All rights reserved.
Not enough command line arguments given.
Syntax: archivesink_setup [install/uninstall/display] [Virtual Server ID] <archivelocation>
Example: To install, cscript archivesink_setup.vbs install 1 d:\archivesink
Example: To uninstall, cscript archivesink_setup.vbs uninstall 1
Example: To display bindings, cscript archivesink_setup.vbs display 1
With this setup script, you can install Archive Sink on a specific SMTP
virtual server and indicate the path of the file system where the archiving
must occur. To do this, type cscript archivesink_setup.vbs install
Virtual Server IDarchive
location, and then press ENTER. In this command,
Virtual Server ID is the virtual server number of
the virtual server to be archived, and archive
location is the folder where you want to put your files.
Note To install Archive Sink on more than one virtual server, you must
run the cscript archivesink_setup.vbs install command on each
virtual server. To remove Archive Sink from Exchange Server 2003, you must run
the cscript archivesink_setup.vbs uninstall command on each
server. For example, you must type cscript archivesink_setup.vbs
uninstall 1 at the command prompt in the
When you install Archive Sink, the required registry
subkeys are created for advanced archiving controls. To enable logging for
detailed message information, you must change the value of the Enable Message
Logging subkey to 1. To do this, follow these steps.
Important This section, method, or task contains steps that tell you how to modify the registry. However, serious problems might occur if you modify the registry incorrectly. Therefore, make sure that you follow these steps carefully. For added protection, back up the registry before you modify it. Then, you can restore the registry if a problem occurs. For more information about how to back up and restore the registry, click the following article number to view the article in the Microsoft Knowledge Base:
Right-click Enable Message Logging in
the right-pane, and then click Modify.
In the Value data box, type
1, and then click OK.
Close Registry Editor.
Restart the IIS Admin Service. To do this, follow these
Click Start, point to All
Programs, point to Administrative Tools, and then
Right-click IIS Admin Service in the
right-pane, and then click Restart.
After you install Archive Sink, the script automatically creates
registry key settings for advanced archiving controls. The following example
shows registry key default settings after Archive Sink is installed on virtual
server number 1.
Name: Archive System Messages Data Type: REG_DWORD Radix: Binary
Value Name: Dump P1 Data Type:
REG_DWORD Radix: Binary Value: 0
Name: Enable Mapi-Gateway Messages Data Type: REG_DWORD Radix: Binary
Value Name: Enable PostCat Data
Type: REG_DWORD Radix: Binary Value: 0
Value Name: Enable PreCat Data Type: REG_DWORD
Radix: Binary Value: 1
Value Name: Enable
Smtp Messages Data Type: REG_DWORD Radix: Binary Value: 1
Value Name: Mapi Gateway Messages Data Type:
REG_SZ Value: d:\ArchiveSink\Mapi Outbound
Name: Smtp Messages Data Type: REG_SZ Radix: Binary Value:
For the REG_DWORD values, 1
enables the setting, and 0 disables the setting. With these registry entries,
you can turn archiving on or off for SMTP inbound messages, MAPI outbound
messages, or both. By default, when Archive Sink is installed on a virtual
server, archiving is on. Archive Sink archives all messages to the archive
location that is specified in the registry. By default, if the archive location
is not specified in the registry, archiving uses the system Temp folder. For
most Microsoft Windows 2000-based computers, the default location is the
The following default settings also apply if the
settings have not been changed:
Only OnMessageSubmission (PreCat) messages are archived.
System messages, such as public folder messages and
replication messages, are not archived.
The "Dump P1" registry key is
Universal Naming Convention (UNC) paths are not supported.
You cannot create a file that includes a UNC path.
Dynamically changed registry settings are not picked up
until you restart the IIS Admin Service.
For debugging purposes, you can enable the "Dump
P1" registry key to dump the P1 recipients in the message.
By default, Archive Sink does not archive public folder and