Platform SDK: Exchange Server

Installing Addressing Objects

Installing the new address type for your gateway on Microsoft Exchange Server requires the creation of two objects on the server: the Address-Template object and the Addr-Type object. The Address-Template object includes the display table that describes the controls appearing on the dialog box for entering a new custom address. The display table is generated by the binary template file described in Address Entry Template Binary Data. The Addr-Type object has an attribute, Proxy-Generator-DLL, set to the file name of the proxy generation DLL. The Addr-Type object must be installed in order for the gateway to support its address type. The custom address template is optional for the gateway’s execution; however, it provides a friendly interface for the Administrator program user to create custom recipients for the foreign system.

To install a new address type

  1. Create the Address-Template object in the Addressing directory container.
  2. Create the Addr-Type object in the Addressing directory container.
  3. Copy the proxy generation DLL file to the Microsoft Exchange Server Address directory.

The addressing objects can be installed by using the TMPLINST.EXE and ADDRINST.EXE utilities supplied with the Microsoft Exchange Server SDK. These utilities create .CSV files necessary for batch imports to create the addressing objects.

The following example uses TMPLINST.EXE to create the Address-Template object using the PROFSADT.BLT and PROFSADT.OEL files, as described in Address Entry Template Binary Data.

TMPLINST /SITEDN=/o=microsoft/ou=apps-wga
/DISPLAY_NAME=proftmp /NAME=PROFS Address
/TYPE=PROFS /SYNTAX=c:\temp\profsadt.oel /SERVER=myserver
/MESSAGE_DT=c:\temp\profspmt.blt /RECIPIENT_DT=c:\temp\profsprt.blt
/ADDRESS_DT=c:\temp\profsadt.blt /LANGUAGE=409
/DATA16=profs16.hlp /DATA32=profs32.hlp /FILE=profs.hlp

This operation creates the directory object and uses the information in PROFSADT.OEL and PROFSADT.BLT to fill in the address syntax and address display table attributes for the Address-Template object. An installation program does not need to copy the .OEL and .BLT files into the Microsoft Exchange Server directory on the file system.

The following example uses ADDRINST to create the PROFS Addr-Type object:

ADDRINST /SITEDN=/o=microsoft/ou=apps-wga
/NAME=PROFS Proxy Generator /MACHINE=i386 /TYPE=PROFS
/PROXYDLL=\\myserver\address\PROFS\i386\proxygen.dll
/SERVER=myserver /GWPROXY=PROFS:

This utility does not copy the PROXYGEN.DLL file into the appropriate place in the Microsoft Exchange Server directory. A setup program must do that separately. For the preceding example, the directory for the DLL is

\MYSERVER\ADDRESS\PROFS\I386

The \PROFS\I386 directory will probably not exist yet on the server; the installation program creates the directory before copying the PROXYGEN.DLL file to it.

Keep in mind the following points when installing an Addr-Type object:

In this scenario, both the gateway and its XXX Addr-Type object are installed at site A and are associated by the GWART at site A. Address templates and a proxy generation DLL are also associated with the XXX address type at site A. Clients at site A can see in their address books that addresses of type XXX are allowed, and they can use the address templates to create addresses of type XXX. New users on site A automatically receive proxy addresses of type XXX.

The XXX gateway is not installed at site B, so there are no address entry templates and no proxy generation DLL there. However, replication occurs between the sites, and users at site B can send mail to a type XXX address. In this case, the message will be replicated at site A and sent through the gateway to the intended recipient. A problem occurs when a new user is added at site B. This user will not receive an XXX proxy address and therefore cannot receive mail from XXX addresses. You need to install the Addr-Type object at site B so that new users there will receive type XXX proxy addresses.