DS_TimeLimit

Description

When you access an SAP Adaptive Server Enterprise database in PowerBuilder through Open Client, DS_TimeLimit 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 time limits for a directory search. For those providers and drivers, DS_TimeLimit specifies the maximum number of seconds that a directory search lasts.

By default, DS_TimeLimit specifies that there is no time limit for a directory search.

You must specify a value for DS_TimeLimit 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_TimeLimit='value'

Parameter

Description

value

Specifies the maximum number of seconds that you want a directory search to last. You can also specify 'no_limit' (the default) to indicate that there is no time limit for the directory search.

If the specified time limit expires and the target has not been found, the directory search is unsuccessful and the PowerBuilder connection fails.


Default value

DS_TimeLimit='no_limit'

Usage

Set Release parameter

For DS_TimeLimit 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_TimeLimit 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_TimeLimit sets the corresponding SAP Sybase CT-Lib connection property named CS_DS_TIMELIMIT.

Examples

To specify that you want the directory search to last a maximum of 120 seconds (2 minutes):

  • Database profile

    Type 120 in the Directory Search Time Limit box on the Directory Services page in the Database Profile Setup dialog box.

  • Application

    Type the following in code:

    SQLCA.DBParm="DS_TimeLimit=120"

See also

DS_Alias

DS_Copy

DS_DitBase

DS_Failover

DS_Password

DS_Principal

DS_Provider

Release