Sec_Sess_Timeout

Description

When you access an SAP Adaptive Server Enterprise database in PowerBuilder through Open Client, Sec_Sess_Timeout is one of several parameters that support login authentication for network-based security services. (For other login authentication parameters, see the See Also section.)

Some security mechanisms allow applications to set session timeout values for connections using network-based login authentication. For these connections, Sec_Sess_Timeout specifies the number of seconds remaining before a session expires. The session timeout period begins when the connection is opened.

By default, Sec_Sess_Timeout specifies that there is no session timeout limit; the session does not expire. You must specify a value for Sec_Sess_Timeout before connecting to the database in PowerBuilder.

Using third-party security mechanisms

For information about the third-party security mechanisms and operating system platforms that has been tested with Open Client security services, see the Open Client documentation.

Applies to

ASE, SYC SAP Adaptive Server Enterprise

Syntax

Sec_Sess_Timeout=value

Parameter

Description

value

Specifies the number of seconds remaining before a session expires. You can also specify 'no_limit' (the default) to indicate that the session does not expire.

A session timeout value set by the security system's administrator supersedes any value you specify for Sec_Sess_Timeout.


Default value

Sec_Sess_Timeout='no_limit'

Usage

CyberSafe Kerberos

If your security mechanism is CyberSafe Kerberos, Sec_Sess_Timeout cannot override the installation default value set for session timeout.

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 Sec_Sess_Timeout or any other parameter supporting Open Client security services, you must meet certain requirements for using security services in your PowerBuilder application. For details, see the section called “Requirements for using Open Client security services” in Connecting to Your Database.

Corresponding CT-Lib connection property

Specifying a value for Sec_Sess_Timeout sets the corresponding SAP Sybase CT-Lib connection property named CS_SEC_SESSTIMEOUT.

Examples

To specify 14,400 seconds (4 hours) remaining before a session expires:

  • Database profile

    Type 14400 in the Session Timeout box on the Security page in the Database Profile Setup dialog box.

  • Application

    Type the following in code:

    SQLCA.DBParm="Sec_Sess_Timeout=14400"

See also

Release

Sec_Channel_Bind

Sec_Cred_Timeout

Sec_Delegation

Sec_Keytab_File

Sec_Mechanism

Sec_Mutual_Auth

Sec_Network_Auth

Sec_Server_Principal