Sybase DC35823-01-1500-04 manual How a client uses directory services

CHAPTER 5 Setting Up Communications Across the Network

3Looks in directory services for an entry whose name matches the name found in the steps above.

4It uses the network information provided by the directory services entry it has found to listen for client connections.

How a client uses directory services

When a client connects to a server it:

•Determines the name of the server either programmatically or by referring to the DSQUERY environment variable. If the application user has not set DSQUERY, the runtime value for the server name defaults to the SYBASE environment variable.

•Looks in directory services for an entry whose name matches the name of the server.

•Uses the network information provided by the directory services entry to connect to the server. If the client cannot connect the first time, it makes additional attempts according to the delay and retry numbers indicated in directory services. If no matching entry is found, an error message is written to the client’s standard error file. If multiple networks are supported, the client attempts to connect using the information in the second network address entry for the server.

The Open Client documentation discusses client connections in much greater detail. See the Open/Client Programmer’s Supplement for your client platform or the appropriate Open/Client documentation.

Creating a directory services entry

The installation program, srvbuild, automatically creates a directory services entry for each server installation. You can also use the following Sybase utilities to edit the network information in directory services:

•dsedit – an X-Windows GUI utility.

•dscp – a UNIX command line utility.

For details on using these utilities, see the Adaptive Server Utility Guide.

Configuration Guide 51