Description
When you access an SAP Adaptive Server Enterprise database in PowerBuilder through Open Client, DS_Alias 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 support the creation of alias entries. An alias entry provides a link to a primary directory entry in a hierarchy, thereby giving users multiple ways to access the primary entry while searching the directory structure for a particular network entity.
For those directory service providers and drivers that support aliases, DS_Alias specifies whether the provider is allowed to follow links for (expand) alias entries while searching the directory hierarchy. The default behavior is to allow expansion of alias entries for providers that support this feature.
You must specify a value for DS_Alias 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_Alias=value
|
Parameter |
Description |
|---|---|
|
value |
For those directory services providers and drivers that support aliases, specifies whether the provider is allowed to expand alias entries while searching a directory hierarchy. Values are:
|
Default value
DS_Alias=1
Usage
When to use
To prevent access to your data through directory alias entries, set DS_Alias to 0. This prohibits directory service providers that support aliases from expanding alias entries during a directory search.
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_Alias 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_Alias sets the corresponding SAP Sybase CT-Lib connection property named CS_DS_EXPANDALIAS.
Examples
To prohibit directory service providers that support aliases from expanding alias entries during a directory search:
-
Database profile
Clear the Directory Alias Entries check box on the Directory Services page in the Database Profile Setup dialog box.
-
Application
Type the following in code:
SQLCA.DBParm="DS_Alias=0"
See also
