Devuelve el último mensaje de error de conexión junto con el valor de SQLCODE

# db2_conn_errormsg

(PECL ibm_db2 >= 1.0.0)

db2_conn_errormsg — Devuelve el último mensaje de error de conexión junto con el valor de SQLCODE

### Descripción

function db2_conn_errormsg(?resource `$connection` = `null`): string

db2_conn_errormsg() devuelve un mensaje de error y el valor de SQLCODE que representa la razón por la cual el último intento de conexión a la base de datos ha fallado. Cuando db2_connect() devuelve `false` en caso de un intento de conexión fallido, no se debe pasar ningún argumento a db2_conn_errormsg() para obtener el mensaje de error y el valor de SQLCODE.

Si, por el contrario, la conexión fue exitosa pero se ha vuelto inválida con el tiempo, puede pasarse el argumento de conexión `connection` para obtener el mensaje de error y el valor de SQLCODE para la conexión específica.

### Parámetros

`connection`
  Un recurso de conexión asociado a la conexión que previamente fue exitosa, pero que se ha vuelto inválida con el tiempo.

### Valores devueltos

Devuelve una cadena que contiene el mensaje de error y el valor de SQLCODE resultante de un intento de conexión fallido. Devuelve una cadena vacía si no hay error asociado con el último intento de conexión.

### Ejemplos

Ejemplo #1 Obtención del mensaje de error devuelto por un intento de conexión fallido

El siguiente ejemplo muestra cómo devolver un mensaje de error junto con el valor de SQLCODE después de pasar un argumento inválido a la función db2_connect().

    <?php
    $conn = db2_connect('mauvaisnom', 'mauvaisutilisateur', 'mauvaismotdepasse');
    if (!$conn) {
        print db2_conn_errormsg();
    }
    ?>

El ejemplo anterior mostrará:

    [IBM][CLI Driver] SQL1013N  The database alias name
    or database name "MAUVAISNOM" could not be found.  SQLSTATE=42705
     SQLCODE=-1013

### Ver también

- db2_conn_error() - Devuelve un string que contiene el valor de SQLSTATE devuelto por el último intento de conexión
- db2_connect() - Devuelve una conexión a una base de datos
- db2_stmt_error() - Devuelve un string que contiene el valor de SQLSTATE retornado por una consulta SQL
- db2_stmt_errormsg() - Devuelve el último mensaje de error de una consulta SQL

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open