More than one Directory Server may be installed for your organization. This document describes how Software AG products determine which Directory Server to use.

The Directory Server implementation diagram is shown below.

Software AG products obtain the address of the Directory Server by searching the following sources in the specified order:

1. The environment variable xtsdsurl. For example,

   set xtsdsurl=tcpip://dshost:port

2. An xtsdsurl parameter passed by an application call.

3. The well-known names SAGXTSDShost and SAGXTSDSport.

   Port "4952" is used if the well-known name SAGXTSDSport is not defined.

   The well-known names can be defined to a DNS server or as an alternative they can be defined in a local "hosts" file. Use of the local "hosts" file implies manual reconfiguration should the Directory Server host change, but it has the advantage of supporting different Directory Servers per computer. Using xtsdsurl has the advantage of using different Directory Servers per process.

   The following table defines the well known names, their purpose, and encoding requirements.

   Name	Purpose
   SAGXTSDShost	Specifies the IP address of the Directory Server.
   SAGXTSDSport	Specifies, through an encoded IP address, the listen port of the Directory Server. The encoded IP address is in the following format: nnnn.mmmm.0.0 ""where: nnnn = port / 256 mmmm = port % 256 (256 modulus) The default port is "4952", therefore the encoded default port is "19.88.0.0" .