DS_Password

Description

When you access an SAP Adaptive Server Enterprise database in PowerBuilder through Open Client 12.5 or higher software, DS_Password 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.)

Some directory service providers and drivers require an authenticated principal (user ID) name and password to control an application's access to directory entries. For those providers and drivers, DS_Principal and DS_Password specify the principal name and password your application should use to identify you to the directory service provider.

You must specify a value for DS_Password before connecting to the database in PowerBuilder.

Applies to

ASE, SYC SAP Adaptive Server Enterprise

Syntax

DS_Password='password'

Parameter

Description

password

The password associated with the principal (user ID) name you specified in the DS_Principal parameter.


Default value

None

PowerBuilder does not set DS_Password or the corresponding SAP Sybase Open Client Client-Library (CT-Lib) connection parameter CS_DS_PASSWORD if you do not specify a value.

Usage

When to use

If your directory service provider requires an authenticated principal name for directory access, set DS_Password to the password that goes with your directory service principal name.

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_Password or any other parameter supporting Open Client 12.5 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_Password sets the corresponding SAP Sybase CT-Lib connection property named CS_DS_PASSWORD.

Examples

To specify MYPASS as your application's password:

  • Database profile

    Type the following in the Password box on the Directory Services page in the Database Profile Setup dialog box:

    MYPASS
  • Application

    Type the following in code:

    SQLCA.DBParm="DS_Password='MYPASS'"

    To specify MYPASS as your application's password, type MYPASS in the Password box on the Directory Services page in the Database Profile Setup dialog box.

See also

DS_Alias

DS_Copy

DS_DitBase

DS_Failover

DS_Principal

DS_Provider

DS_TimeLimit

Release