Connection parameters
To indicate which database server the client LIBMI application needs to connect to, the application uses connection parameters. The DataBlade API provides a connection-information descriptor, MI_CONNECTION_INFO, to access connection parameters.
The MI_CONNECTION_INFO data type structure is similar in concept to a file descriptor in UNIX. It identifies the database server for a particular session.
| Field | Data type | Description |
|---|---|---|
| server_name | char * | The name of the default database server This field corresponds to the value of the INFORMIXSERVER environment variable. |
| server_port | mi_integer | This value is ignored. It must always be set to
zero. A client LIBMI application does not need to specify the server port. It only needs to specify a database server by its name (the server_name field). |
| locale | char * | In a C UDR: The name of the server locale This field corresponds to the SERVER_LOCALE environment variable (as set on the computer with the database server). In a client LIBMI application: the name of the database locale This field corresponds to the DB_LOCALE environment variable (as set on the computer with the client LIBMI application). |
| reserved1 | mi_integer | Unused |
| reserved2 | mi_integer | Unused |
The milib.h header file defines the MI_CONNECTION_INFO structure.
| Connection-parameter task | DataBlade API function |
|---|---|
| Access the default connection parameters to determine the database server for the connection | mi_set_default_connection_info(), mi_get_default_connection_info() |
| Obtain current connection parameters for an open connection | mi_get_connection_info() |