Together with the command for opening a database session you can set several options. The following options are possible
Option | Data Type | Description |
Internal Options | ||
COMPNAME | VARCHAR(64) | The component name used to initialise the runtime environment. If it is a runtime library, the name must start with an "R". Otherwise the system considers it an application. |
APPLICATION | CHAR(3) | The application to be connected to the database. Possible values are: CAL | CPC | CON | DOM | LOA | ODB | QUE | SQL | TPL| UTI| XCI. |
APPVERSION | NUMBER(5) | Version of the application. This is computed: major * 10000 + minor * 100 + correction_level. E.g. version 7.6.00 has the version identifier "70600". |
Database Behaviour | ||
SQLMODE | VARCHAR | The SQL Mode. Possible values are: INTERNAL | ORACLE | ANSI | DB2 | SAPR3. The SAPR3 mode implies the following properties:
|
UNICODE | BOOLEAN | TRUE | 1, the connection is an unicode (UCS2) client or FALSE | 0 it is an ASCII client. |
CONNECTTYPE | STRING | The type of connection wanted. If not specified, the instance default is used. See also the description of the database parameter INSTANCE_TYPE The following values are accepted:
|
TIMEOUT | NUMBER | The maximum allowed time of inactivity after which the connection to the database is closed by the system. |
ISOLATIONLEVEL | NUMBER | The ISOLATION LEVEL specifies whether and how shared locks and exclusive locks are implicitly requested or released. For possible values see: setTransactionIsolation() |
KEY | STRING | The XUSER key to use for the connect to the database. |
SPACE_OPTION | BOOLEAN | Whether character values contain at least 1 blank, or are NULL. |
Performance and Optimization Options | ||
PACKETCOUNT | NUMBER | STRING | The number of different request packets used for the connection. Enter a positive number or UNLIMITED for an unlimited number of request packets |
STATEMENTCACHESIZE | NUMBER | STRING | The number of prepared statements to be cached for the connection for re-use. Possible values are: <n>: desired number of statements 0: no statements are cached UNLIMITED: unlimited number of statements is cached. |
CACHE_ALL_STATEMENTS | BOOLEAN | When used, the information for all kinds of prepared statements are cached. Otherwise, only statements that had no parameters bound when they were prepared are cached, as bound parameters may change the semantics of the statement. |
SELECTFETCHOPTIMIZE | INTEGER | When the option has the value 1, the first rows of the result set are transferred to the client already on the execute to save one fetch command. |
VARIABLEINPUT | BOOLEAN | If set, the new protocol to transmit statement parameters which has no space-padded data values is used, if the database kernel supports it. |
OPTIMIZEDSTREAMS | BOOLEAN | If set, the stream handling for stored procedures that sends data for more than stream is enabled. |
Compatibility Options | ||
CURSORPREFIX | STRING | The prefix to use for result tables that are automatically named. |
TRANSLATE_BINARY_AS_ENCODED | BOOLEAN | Enables the conversion from raw bytes to encoded character types (ASCII or UNICODE). If not set, the conversion between binary values and character types is not permitted. The conversion performed is only a copy of the binary values from the application. |
CHOPBLANKS | BOOLEAN | When used, trailing blanks are removed also from CHAR columns. |
DROPPARSEIDDIRECT | BOOLEAN | When used, parse ids of unused commands are dropped immediately. |
The options and the values are case insensitive.
Definition at line 3032 of file SQLDBC.h.
|
Creates an empty set of options. A default allocator is used.
|
|
The copy constructor.
|
|
|
|
The destructor.
|
|
Retrieves an option.
|
|
Sets an option.
|