When you access a Sybase 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.
ASE, SYC Sybase Adaptive Server Enterprise
DS_Copy=value
DS_Copy=1
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.
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:
SQLCA.DBParm="DS_Copy=0"
