DS_DitBase – PB Docs 2021

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.

Applies to

ASE, SYC SAP Adaptive Server Enterprise

Syntax

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:softwaresybaseserverSYS11NT

DS_DitBase: SALES:softwaresybaseserver

To set DS_DitBase:

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:

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:

See also

DS_Alias

DS_Copy

DS_Failover

DS_Password

DS_Principal

DS_Provider

DS_TimeLimit

Release