DS_DitBase – PB Docs 126

  2. Powerbuilder Documentation
  3. Powerbuilder Documentation Older
  4. Powerbuilder Documentation 12.6
  5. DS_DitBase – PB Docs 126

DS_DitBase database parameter

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.

note.png 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.

Controls

  • ASE, SYC SAP Adaptive
    Server Enterprise

Syntax

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

  • DS_DitBase: SALES:softwaresapserver

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 ():

  • Application

    Type the following in code. Do not end
    the DS_DitBase value with a backslash ():

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/sap/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 (/):

  • Application

    Type the following in code. Do not end
    the DS_DitBase value with a slash (/):

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=sap

  • DS_DitBase: OU=miami.OU=sales.O=sap

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:

  • Application

    To specify DS_DitBase in code, type the following:

See Also

Document get from Powerbuilder help
Thank you for watching.
Powerbuilder Documentation 12.6
and Functions Events Objects and Controls PB Docs 126 PowerBuilder .NET Powerbuilder Documentation Powerbuilder Documentation 12.6 Powerbuilder Documentation Older PowerBuilder Extension Reference PowerBuilder New Features 12.6 PowerDesigner Integration System Object Properties Using the ADO.NET Interface
August 14, 2023
Was this article helpful?
0
0
Subscribe
Notify of
guest
0 Comments
Inline Feedbacks
View all comments
0
Would love your thoughts, please comment.x
()
x