Adding a server entry to the libtcl.cfg file

You use the libtcl.cfg files to specify an LDAP (Lightweight Directory Access Protocol) server name, port number, DIT base, user name, and password to connection to an LDAP server.

The default libtcl.cfg file is located in:

%SYBASE%\%SYBASE_OCS%\ini

In its simplest form, the libtcl.cfg file is in this format:

[DIRECTORY]
ldap=libdldap.dll ldapurl

where the ldapurl is defined as:

ldap://host:port/ditbase

When an LDAP server is specified in the libtcl.cfg file, the server information is accessible only from the LDAP server. Adaptive Server ignores the interfaces file. Open Client/Open Server applications that use the -I option at start-up override the libtcl.cfg file and use the interfaces file.

To use a directory service, you must:

Add the location of the LDAP libraries to the path environment variable for your platform.
Configure the libtcl.cfg file to use directory services.

Use any standard ASCII text editor to:
- Remove the semicolon (;) comment markers from the beginning of the LDAP URL lines in the libtcl.cfg file under the [DIRECTORY] entry.
- Add the LDAP URL under the [DIRECTORY] entry. See Configuring Adaptive Server Enterprise for supported LDAP URL values.
WARNING! The LDAP URL must be on a single line.
```
ldap=libdldap.dll ldap://host:port/ditbase??scope??
bindname=username password
```
For example:
```
[DIRECTORY] 
ldap=libdldap.dll ldap://huey:11389/dc=sybase,dc=com??one??
bindname=cn=Manager,dc=sybase,dc=com secret
```
Verify that the appropriate environment variable points to the required third-party libraries. The Netscape LDAP SDK libraries are located in %SYBASE%\%SYBASE_OCS\lib3p. The Windows PATH environment variable must point to this directory.
Once you have edited the libtcl.cfg file, use dsedit to add a server to the directory service:
1. From the Windows task bar, select Start | Programs | Sybase | dsedit.
2. Select LDAP from the list of servers, and click OK.
3. Click Add New Server Entry.
4. Enter:
  - The server name – this is required.
  - Security mechanism – optional. A list of security mechanism OIDs are located in %SYBASE%\%SYBASE_OCS%\ini\objectid.dat.
  - HA server name – optional. This is the name of the high-availability failover server, if you have one.
5. Click Add New Network Transport.
  - Select the transport type from the drop-down list.
  - Enter the host name.
  - Enter the port number.
6. Click OK two times to exit the dsedit utility.

For more information, see Configuring Adaptive Server Enterprise for your platform.