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”.
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 |