# db2_client_info

(PECL ibm_db2 >= 1.1.1)

db2_client_info — Devuelve un objeto cuyas propiedades describen cliente de una base de datos DB2

### Descripción

db2_client_info(resource `$connection`): object

Esta función devuelve un objeto, con propiedades de sólo lectura, con información sobre el cliente de base de datos DB2. La siguiente tabla lista las propiedades del cliente DB2:

DB2 client properties
Nombre de la propiedad | Tipo devuelto | Descripción
--- | --- | ---
APPL_CODEPAGE | int | Código de página de la aplicación.
CONN_CODEPAGE | int | Código de página de la conexión activa.
DATA_SOURCE_NAME | string | Nombre fuente de datos (DSN) usado para crear la conexión actual a la base de datos.
DRIVER_NAME | string | Nombre de la biblioteca que implementa la especificación de la Interfaz a nivel de Llamada (CLI) de DB2.
DRIVER_ODBC_VER | string | Versión de ODBC que soporta el cliente DB2. Devuelve un string del tipo "MM.mm" donde MM es la versión principal y mm la secundaria. El cliente DB2 siempre devuelve "03.51".
DRIVER_VER | string | Versión del driver, en forma de string "MM.mm.uuuu" donde MM es la versión principal, mm es la versión secundaria, y uuuu la actualización. Por ejemplo, "08.02.0001" representa la versión principal 8, versión secundaria 2, actualización 1.
ODBC_SQL_CONFORMANCE | string | Nivel de gramática SQL ODBC soportado por el cliente. MINIMUM Soporta la gramática mínima ODBC SQL. CORE Soporta la gramática de tipo core de ODBC SQL. EXTENDED Soporta la gramática extendida de ODBC SQL.
ODBC_VER | string | Versión de ODBC que soporta el gestor de drivers de ODBC. Devuelve un strong del tipo "MM.mm.rrrr" donde MM es la versión principal, mm es la versión secundaria, y rrrr es la edición. El cliente DB2 siempre devuelve "03.01.0000".

### Parámetros

`connection`

  Especifica una conexión de cliente DB2 activa.

### Valores devueltos

Devuelve un objeto en caso de éxito. Devuelve `false` en caso de error.

### Ejemplos

Ejemplo #1 Ejemplo de db2_client_info()

Para consultar información del cliente, se debe proporcionar un recurso de conexión a base de datos válido a db2_client_info().

`<?php
$conn = db2_connect( 'SAMPLE', 'db2inst1', 'ibmdb2' );
$client = db2_client_info( $conn );
if ($client) {
echo "DRIVER_NAME: "; var_dump( $client->DRIVER_NAME );
echo "DRIVER_VER: "; var_dump( $client->DRIVER_VER );
echo "DATA_SOURCE_NAME: "; var_dump( $client->DATA_SOURCE_NAME );
echo "DRIVER_ODBC_VER: "; var_dump( $client->DRIVER_ODBC_VER );
echo "ODBC_VER: "; var_dump( $client->ODBC_VER );
echo "ODBC_SQL_CONFORMANCE: "; var_dump( $client->ODBC_SQL_CONFORMANCE );
echo "APPL_CODEPAGE: "; var_dump( $client->APPL_CODEPAGE );
echo "CONN_CODEPAGE: "; var_dump( $client->CONN_CODEPAGE );
}
else {
echo "Error al consultar información del cliente.
Es posible que la conexión a base de datos sea inválida.";
}
db2_close($conn);
?>`

El resultado del ejemplo sería:

    DRIVER_NAME: string(8) "libdb2.a"
    DRIVER_VER: string(10) "08.02.0001"
    DATA_SOURCE_NAME: string(6) "SAMPLE"
    DRIVER_ODBC_VER: string(5) "03.51"
    ODBC_VER: string(10) "03.01.0000"
    ODBC_SQL_CONFORMANCE: string(8) "EXTENDED"
    APPL_CODEPAGE: int(819)
    CONN_CODEPAGE: int(819)

### Ver también

- db2_server_info() - Returns an object with properties that describe the DB2 database server