HOWTO: Add Message Tracking to the EDK Gateway

ID: Q224560

The information in this article applies to:

Exchange Development Kit (EDK), versions 5.0, 5.5

SUMMARY

The Exchange Development Kit (EDK) sample gateway can be modified to log tracking information for messages processed. There are three functions that are included in the \Mssdk\Include\EDKTrack.lib that can be used to add tracking functionality.

Following are the functions:

HrTrackInitLog - This function opens the gateway event tracking module.

HrTrackUninitLog - This function closes the gateway event tracking module.

HrTrackWriteLog - This function logs a gateway tracking event.

MORE INFORMATION

The Platform SDK and Microsoft Developer Network (MSDN) include a sample console application TRACK that demonstrates how to use these functions to log tracking information to the file \Exchsrvr\Traking.log\Yyyymmdd.log. The sample is a standalone program that does not require a gateway to run. It does not actually track any messages. It does, however, demonstrate how to use these three functions to write tracking information to a file.

When you run the sample TRACK program, you will be required to enter in a valid event type. Valid event types are listed here and defined in the file \Mssdk\Include\RpcPub.h:

Event type Event Description

1001 Backbone message going to Microsoft Exchange Server

1002 Backbone message going to a foreign system

1003 Gateway message going to Microsoft Exchange Server

1004 Gateway message going to a foreign system

1005 Gateway Report message going to Microsoft Exchange Server

1006 Gateway Report message going to a foreign system

1007 Report of gateway activity

The following is an example of the log entered for a message sent from an Exchange User, "User1," to two EDK recipients, "EDKUser1" and "EDKUser2." The priority is 3, mts-id = 1111-11111, gateway name is SGW, remote system is "REMOTE", priority = 1, length is 20, cost = 3,subject mts-id = 2222-22222, and number of recipients = 2:

Event type	Event Description
1001	Backbone message going to Microsoft Exchange Server
1002	Backbone message going to a foreign system
1003	Gateway message going to Microsoft Exchange Server
1004	Gateway message going to a foreign system
1005	Gateway Report message going to Microsoft Exchange Server
1006	Gateway Report message going to a foreign system
1007	Report of gateway activity

1111-11111 1004 1999.3.30 18:13:0 SGW REMOTE USER1 1 20 3 0 2222-22222 2 EDKUser1 EDKUser2

REFERENCES

Additional information can be found in the Microsoft Developer Network.

Additional query words:


Keywords          : kbMsg kbEDK500 kbEDK550 kbGrpMsg 
Version           : WINDOWS:5.0,5.5
Platform          : WINDOWS 
Issue type        : kbhowto

Last Reviewed: May 24, 1999