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 Sybase has
tested with Open Client directory services, see the Open Client
documentation.
Controls
-
ASE, SYC SAP Adaptive
Server Enterprise
Syntax
|
1 |
DS_Copy=<span>value</span> |
|
Parameter |
Description |
|---|---|
|
value |
For those directory services providers
|
Default
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 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_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 “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
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:
1SQLCA.DbParameter="DS_Copy=0"