Specifying the server name with Open Client directory services
When you are using Open Client directory services in a PowerBuilder application,
you must use the syntax required by your directory service provider
when specifying the server name in a database profile or PowerBuilder
application script to access the database.
Different directory service providers require different syntax
based on the format they use for specifying directory entry names.
Directory entry names can be fully qualified or relative to the
default (active) Directory Information Tree base (DIT base) specified
in the Open Client/Server™ configuration utility.
The DIT base is the starting node for
directory searches. Specifying a DITbase is analogous to setting
a current working directory for UNIX or MS-DOS file systems. (You
can specify a nondefault DIT base with the DS_DitBase DbParameter.
For information, see DS_DitBase in the online Help.)
Windows registry server name example
This example shows typical server name syntax if your directory
service provider is the Windows registry.
1 |
Node name: SALES:softwaresybaseserverSYS12<br>DIT base: SALES:softwaresybaseserver<br>Server name: SYS12 |
To specify the server name in a database profile:
-
Type the following in the Server box on
the Connection tab in the Database Profile Setup dialog box. Do not start
the server name with a backslash ().1SYS12
To specify the server name in a PowerBuilder application
script:
-
Type the following. Do not start
the server name with a backslash ().1SQLCA.ServerName = "SYS12"If you specify a value in the Server box in your database
profile, this syntax displays on the Preview tab in the Database
Profile Setup dialog box. You can copy the syntax from the Preview
tab into your script.
DCE/CDS server name example
This example shows typical server name syntax if your directory
service provider is Distributed Computing Environment Cell Directory
Services (DCE/CDS).
1 |
Node name: /.../boston.sales/dataservers/sybase/SYS12<br>DIT base: /../boston.sales/dataservers<br>Server name: sybase/SYS12 |
To specify the server name in a database profile:
-
Type the following in the Server box on
the Connection tab in the Database Profile Setup dialog box. Do not start
the server name with a slash (/).1sybase/SYS12
To specify the server name in a PowerBuilder application
script:
-
Type the following. Do not start
the server name with CN=.1SQLCA.ServerName = "SYS12"If you specify a value in the Server box in your database
profile, this syntax displays on the Preview tab in the Database
Profile Setup dialog box. You can copy the syntax from the Preview
tab into your script.