The MS Mail (AppleTalk) Email Address Generator
-----------------------------------------------

The purpose of the MS Mail (AppleTalk) Email Address Generator (macproxy.dll) is to
automatically generate email addresses of type "MSA" to all recipient objects (like 
the pre-installed "MS", "SMTP", and "X400" address types).

This will allow the MS Mail Connector to match MSA addresses sent from MS Mail (AppleTalk)
to Exchange recipient objects that have that MSA address (if any).

Steps to Install
----------------

On one server in each site requiring MSA email addresses for recipient objects :

1. Use addrinst.exe to install the address object as follows :

addrinst /sitedn=/o=<orgname>/ou=<sitename> /name=macproxy /machine=<platform> /type=MSA /proxydll=macproxy.dll /server=<server> "/gwproxy=MSA:Exchange Connection"

   where <orgname> is the organization name
         <sitename> is the site name
         <platform> is one of "i386", "MIPS", "ALPHA"

2. copy macproxy.dll to <exchsrvr>\address\msa\<platform>\macproxy.dll

   where <exchsrvr> is the root directory of Exchange Server
         <platform> is one of "i386", "MIPS", "ALPHA"
  
3. Add the registry key :
\Registry
    MACHINE
     	SYSTEM
            CurrentControlSet
	        Services
		    EventLog
			Application
			    MacProxy
			      EventMessageFile = REG_EXPAND_SZ "<exchsrvr>\address\msa\<platform>\macproxy.dll"

   where <exchsrvr> is the root directory of Exchange Server
         <platform> is one of "i386", "MIPS", "ALPHA"

Notes
-----

1. MSA addresses will only be assigned to recipient objects that are created after the
   macproxy.dll is installed.

2. The macproxy.dll generates MSA addresses as "DisplayName@GatewayName". When it 
   attempts to create an MSA address that already exists (because another
   recipient object already has the same DisplayName) it will force the address to be unique
   by assigning a sequence number to it e.g. DisplayName2@GatewayName. When it does this
   it logs a Warning Event (ID=5) with details as follows :

   MSA email address with user name "DisplayName" already exists. "DisplayName2" will be used
   instead. 

   Since MSExchangeDX forces Exchange DisplayNames passed to MS Mail (appleTalk) to be unique it
   is possible that the incorrect MSA address is created for the affected objects. In these
   cases mail sent from MS Mail (appleTalk) to Exchange will be non-delivered due to unknown
   address until the MSA address is changed to match the DisplayName generated by MSExchangeDX