DF_DRIVER_FIND_CACHE_TIMEOUT

The timeout (in milliseconds) of the find cache.

Level

Driver

Supported by

The DataFlex SQL Drivers (SQL Server, DB2, and ODBC), revision 5 and higher.

Type

Integer, temporary.

Access

Read/Write.

Values

0..

Syntax

Use cli.pkg
Get_Attribute DF_DRIVER_FIND_CACHE_TIMEOUT of {driverNumber} to {IntegerVariable}
Set_Attribute DF_DRIVER_FIND_CACHE_TIMEOUT of {driverNumber} to {IntegerVariable}

Driver Configuration Keyword

Find_Cache_Timeout

Remarks

Sets up the find cache timeout (in milliseconds). When the time between two find operations using the same cache is larger than the timeout, the driver will fetch data instead of reading from the cache. See Database cursors for more information.

This default value is copied to the database level when logging in to the database. The actual value in use for an active connection is that on the database level. This attribute merely reflects a default.

Sample Code

The sample code below shows the current setting for a given driver.

Function DriverIndex String sDriver Returns Integer
    String sCurrentDriver
    Integer iNumberOfDrivers iDriver iCount

    Move 0 to iDriver
    Get_Attribute DF_NUMBER_DRIVERS to iNumberOfDrivers

    For iCount From 1 To iNumberOfDrivers
        Get_Attribute DF_DRIVER_NAME of iCount To sCurrentDriver
        If (Uppercase(sCurrentDriver) = Uppercase(sDriver)) Begin
            Move iCount to iDriver
        End
    Loop

    Function_Return iDriver
End_Function // DriverIndex

Procedure ShowDriverAttribute
    Integer iAttribValue iDriver

    Get DriverIndex "MSSQLDRV" to iDriver
    Get_Attribute DF_DRIVER_FIND_CACHE_TIMEOUT of iDriver to iAttribValue
    Showln "Find cache timeout: " iAttribValue
End_Procedure