HOWTO: Add Message Tracking to the EDK Gateway

• 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:

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 kbfaq kbGrpMsg
Version : WINDOWS:5.0,5.5
Platform : WINDOWS
Issue type : kbhowto