Description
When you access an SAP Adaptive Server Enterprise database in PowerBuilder through Open Client, DS_DitBase is one of several parameters that you can set to enable network-based directory services in your application. (For other directory services parameters, see the See Also section.)
When you use Open Client directory services, a default (active) directory information tree base (DIT base) is specified in the Open Client/Server Configuration utility. The DIT base is the directory node where directory searches start. This is analogous to the current working directory in MS-DOS file systems.
DS_DitBase lets you specify the name of the directory node where you want searches for directory entries to start. The DS_DitBase value you specify must be a fully qualified name that uses the syntax required by your directory service provider and driver (see the Examples section for illustrations).
The default value for DS_DitBase is the DIT base currently specified as active in the Open Client/Open Server Configuration utility.
You must specify a value for DS_DitBase before connecting to the database in PowerBuilder.
Using third-party directory service providers
For information about the third-party directory service providers and operating system platforms that has been tested with Open Client directory services, see the Open Client documentation.
Applies to
ASE, SYC SAP Adaptive Server Enterprise
Syntax
DS_DitBase='dit_base'
|
Parameter |
Description |
|---|---|
|
dit_base |
The name of the directory node where you want directory searches to start. By default, this is the DIT base currently specified as active in the Open Client/Open Server Configuration utility. The value for dit_base must be a fully qualified name that uses the syntax required by your directory service provider and driver. The syntax for specifying the DIT base varies for different providers; see your provider's documentation for details. For examples of how to specify dit_base for different directory service providers, see the Examples section. |
Default value
The default value for DS_DitBase is the DIT base currently specified as active in the Open Client/Open Server Configuration utility.
Usage
When to use
Set DS_DitBase to specify a starting node for directory searches other than the DIT base node specified as active in the Open Client/Open Server Configuration utility. For instructions on using the Open Client/Open Server Configuration utility, see your SAP Sybase Open Client/Server configuration guide.
Set Release parameter
For this parameter to take effect, you must also set the Release parameter to 11 or higher to specify that your application should use the appropriate version of SAP Sybase Open Client Client-Library (CT-Lib) behavior. See the description of the Release parameter for more information.
Requirements for use
To use DS_DitBase or any other parameter supporting Open Client directory services, you must meet certain requirements for using directory services in your PowerBuilder application. For details, see the section called “Requirements for using Open Client directory services” in Connecting to Your Database.
Corresponding CT-Lib connection property
Specifying a value for DS_DitBase sets the corresponding SAP Sybase CT-Lib connection property named CS_DS_DITBASE.
Examples
About these examples
The examples that follow show how to specify a DS_DitBase value for different directory service providers.
See your directory service provider's documentation for complete information about the format your provider requires for specifying the DIT base.
Example 1 (Windows NT Registry)
This example shows the syntax for DS_DitBase if your directory service provider is the Windows NT Registry:
Node name: SALES:software\sybase\server\SYS11NT
DS_DitBase: SALES:software\sybase\server
To set DS_DitBase:
-
Database profile
Type the following in the DIT Base box on the Directory Services page in the Database Profile Setup dialog box. Do not end the DS_DitBase value with a backslash (\):
SALES:software\sybase\server
-
Application
Type the following in code. Do not end the DS_DitBase value with a backslash (\):
SQLCA.DBParm = "DS_DitBase='SALES:software\sybase\server'"
Example 2 (DCE/CDS)
This example shows the syntax for DS_DitBase if your directory service provider is Distributed Computing Environment Cell Directory Services (DCE/CDS):
Node name: /.../boston.sales/dataservers/sybase/SYS11
DS_DitBase: /.../boston.sales/dataservers
To set DS_DitBase:
-
Database profile
Type the following in the DIT Base box on the Directory Services page in the Database Profile Setup dialog box. Do not end the DS_DitBase value with a slash (/):
/.../boston.sales/dataservers
-
Application
Type the following in code. Do not end the DS_DitBase value with a slash (/):
SQLCA.DBParm = "DS_DitBase='/.../boston.sales/dataservers'"
Example 3 (Novell NDS)
This example shows the syntax for DS_DitBase if your directory service provider is Novell NetWare Directory Services (NDS):
Node name: CN=SYS11.OU=miami.OU=sales.O=sybase
DS_DitBase: OU=miami.OU=sales.O=sybase
To set DS_DitBase:
-
Database profile
Type the following in the DIT Base box on the Directory Services page in the Database Profile Setup dialog box:
OU=miami.OU=sales.O=sybase
-
Application
To specify DS_DitBase in code, type the following:
SQLCA.DBParm = "DS_DitBase='OU=miami.OU=sales.O=sybase'"
See also
