DS_Copy

database parameter

Description

When you access an SAP Adaptive Server Enterprise database in
PowerBuilder through Open Client, DS_Copy 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 use of
caching. Caching allows a directory service provider to use cached
information while searching a directory instead of making a request to
the directory server agent for information.

For those directory service providers and drives that support
caching, DS_Copy specifies whether the provider is allowed to use cached
information during a directory search. The default behavior is to allow
providers that support this feature to use cached information.

You must specify a value for DS_Copy 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_Copy=value

1	DS_Copy=value

Parameter	Description
value	For those directory services providers and drivers that support caching, specifies whether the provider is allowed to use cached information when making a directory search. Values are: 0 Prohibit provider from using cached information during a directory search. You can also specify ‘No’ or ‘False’ to set this value. 1 (Default) Allow provider to use cached information when making a directory search. You can also specify ‘Yes’ or ‘True’ to set this value.

Parameter

Description

value

For those directory services providers and drivers
that support caching, specifies whether the provider is allowed
to use cached information when making a directory search. Values
are:

0

Prohibit provider from using cached information
during a directory search. You can also specify ‘No’ or
‘False’ to set this value.
1

(Default) Allow provider to use cached information
when making a directory search. You can also specify ‘Yes’
or ‘True’ to set this value.

Default value

DS_Copy=1

Usage

When to use

Allowing providers to use cached information during directory
searches makes the searches faster, but does not ensure that the
provider is using the most up-to-date directory information.

To ensure that the application gets the most recent changes to
directory entries when it requests directory information, set DS_Copy to
0 to prohibit providers that support caching from using cached
information 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_Copy 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_Copy sets the corresponding SAP Sybase
CT-Lib connection property named CS_DS_COPY.

Examples

To prohibit directory service providers that support caching from
using cached information during a directory search:

Database profile

Clear the Use Caching check box on the Directory Services page
in the Database Profile Setup dialog box.
Application

Type the following in code:

PowerBuilder

SQLCA.DBParm="DS_Copy=0"

1

SQLCA.DBParm="DS_Copy=0"