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:

Get replaced by the file’s value if the ct_con_props call occurs before ct_connect, or
Replace the file’s value if the ct_con_props call occurs after ct_connect.

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