Sybase DC35823-01-1500-04 - Manual (Page 67)

CHAPTER 5 Setting Up Communications Across the Network
Configuration Guide 51
3 Looks in directory services for an entry whose name matches the name
found in the steps above.
4 It 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.