Keywords for context or connection properties

When the application calls them, ct_init and ct_connect each read a section of the configuration file if the application has requested external configuration.

If a context property is set when ct_init reads a section, then any calls to ct_con_props to set the same property override the configured setting.

If a property is set when ct_connect reads a section, then calls to ct_con_props to set the same property either:

For example, values for CS_USERNAME and CS_PASSWORD that are set in a configuration section always override hard-coded values in the application code. This is true because the application must set these properties before ct_connect is called.

Table 2-37 lists the keywords that set context or connection properties. For descriptions of what each property controls, see “Properties”.

Table 2-37: Configuration file keywords to set properties

Keyword

Read by

Legal value

CS_ANSI_BINDS

ct_init, ct_connect

CS_TRUE or CS_FALSE

CS_APPNAME

ct_connect

A character string

CS_ASYNC_ NOTIFS

ct_connect

CS_TRUE or CS_FALSE

CS_BULK_LOGIN

ct_connect

CS_TRUE or CS_FALSE

CS_CON_KEEPALIVE

ct_connect

CS_TRUE or CS_FALSE

CS_CON_TCP_NODELAY

ct_connect

CS_TRUE or CS_FALSE

CS_DIAG_TIMEOUT

ct_connect

CS_TRUE or CS_FALSE

CS_DISABLE_POLL

ct_init, ct_connect

CS_TRUE or CS_FALSE

CS_DS_COPY

ct_connect

CS_TRUE or CS_FALSE

CS_DS_DITBASE

ct_connect

A character string

CS_DS_FAILOVER

ct_connect

CS_TRUE or CS_FALSE

CS_DS_PASSWORD

ct_connect

A character string

CS_DS_PRINCIPAL

ct_connect

A character string

CS_DS_PROVIDER

ct_connect

A character string

CS_DS_RAND_OFFSET

ct_config, ct_con_props

CS_TRUE or CS_FALSE

CS_EXPOSE_FMTS

ct_init, ct_connect

CS_TRUE or CS_FALSE

CS_EXTENDED_ENCRYPT_CB

ct_connect

CS_TRUE or CS_FALSE

CS_EXTRA_INF

ct_init, ct_connect

CS_TRUE or CS_FALSE

CS_HAFAILOVER

ct_config, ct_con_props

CS_TRUE or CS_FALSE

CS_HIDDEN_KEYS

ct_init, ct_connect

CS_TRUE or CS_FALSE

CS_HOSTNAME

ct_connect

A character string

CS_IFILE

ct_init

A character string

CS_LOGIN_TIMEOUT

ct_init

An integer value

CS_LOOP_DELAY

ct_connect

An integer value

CS_MAX_CONNECT

ct_init

An integer value

CS_NETIO

ct_init, ct_connect

CS_SYNC_IO, CS_ASYNC_IO, or CS_DEFER_IO

CS_NOAPI_CHK

ct_init

CS_TRUE or CS_FALSE

CS_NO_TRUNCATE

ct_init

CS_TRUE or CS_FALSE

CS_NOINTERRUPT

ct_init

CS_TRUE or CS_FALSE

CS_PACKETSIZE

ct_connect

An integer value

CS_PASSWORD

ct_connect

A character string

CS_PROP_EXTENDEDFAILOVER

ct_config, ct_con_props

CS_TRUE or CS_FALSE

CS_PROP_REDIRECT

ct_config, ct_con_props

CS_TRUE or CS_FALSE

CS_RETRY_COUNT

ct_connect

An integer value

CS_SEC_APPDEFINED

ct_connect

CS_TRUE or CS_FALSE

CS_SEC_CHALLENGE

ct_connect

CS_TRUE or CS_FALSE

CS_SEC_CHANBIND

ct_init, ct_connect

CS_TRUE or CS_FALSE

CS_SEC_CONFIDENTIALITY

ct_init, ct_connect

CS_TRUE or CS_FALSE

CS_SEC_CREDTIMEOUT

ct_init, ct_connect

A positive integer or CS_NO_LIMIT

CS_SEC_DATAORIGIN

ct_init, ct_connect

CS_TRUE or CS_FALSE

CS_SEC_DELEGATION

ct_init, ct_connect

CS_TRUE or CS_FALSE

CS_SEC_DETECTREPLAY

ct_init, ct_connect

CS_TRUE or CS_FALSE

CS_SEC_DETECTSEQ

ct_init, ct_connect

CS_TRUE or CS_FALSE

CS_SEC_ENCRYPTION

ct_connect

CS_TRUE or CS_FALSE

CS_SEC_EXTENDED_ENCRYPTION

ct_connect

CS_TRUE or CS_FALSE

CS_SEC_INTEGRITY

ct_init, ct_connect

CS_TRUE or CS_FALSE

CS_SEC_KEYTAB

ct_connect

A character string

CS_SEC_MECHANISM

ct_init, ct_connect

A character string

CS_SEC_MUTUALAUTH

ct_init, ct_connect

CS_TRUE or CS_FALSE

CS_SEC_NETWORKAUTH

ct_init, ct_connect

CS_TRUE or CS_FALSE

CS_SEC_NON_ENCRYPTION_RETRY

ct_connect

CS_TRUE or CS_FALSE

CS_SEC_SERVERPRINCIPAL

ct_connect

A character string

CS_SEC_SESSTIMEOUT

ct_init, ct_connect

A positive integer or CS_NO_LIMIT.

CS_TDS_VERSION

ct_connect

CS_TDS_40, CS_TDS_42, CS_TDS_46, or CS_TDS_50

CS_TEXTLIMIT

ct_init, ct_connect

An integer value or CS_NO_LIMIT

CS_TIMEOUT

ct_init

An integer value

CS_USERNAME

ct_connect

A string value