DS_DitBase

Description

When you access a Sybase 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 Sybase has tested with Open Client directory services, see the Open Client documentation.

Applies to

ASE, SYC Sybase 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.

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

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 Sybase Open Client/Server configuration guide.

Set Release parameter For this parameter to take effect, you must also set the Release parameter to 11or higher to specify that your application should use the appropriate version of 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 “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 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: