# db2_conn_errormsg

(PECL ibm_db2 >= 1.0.0)

db2_conn_errormsg — Devolver el último mensaje de error de la conexión y su valor SQLCODE

### Descripción

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

db2_conn_errormsg() devuelve un mensaje de error y el valor SQLCODE que representa el motivo por el que el último intento de conexión a la base de datos falló. Como db2_connect() devuelve `false` en caso de que un intento de conexión falle, no es necesario pasar argumentos a db2_conn_errormsg() para extrer el mensaje de error y el valor SQLCODE asociados.

Si, de todod modos, la conexión fue exitosa pero en algún momento dejó de ser válida, se puede pasar el parámetro `connection` para obtener el mensaje de error y el valor SQLCODE asociados a una conexión especifica.

### Parámetros

`connection`

  Un recurso de conexión asociado a la conexión que inicialmente fue exitosa, pero que en algún momento llego a ser inválida.

### Valores devueltos

Devuelve una cadena que contiene el mensaje de error y el valor SQLCODE derivados de un intento de conexión fallido. Si no hay algún error asociado con el último intento de conexión, db2_conn_errormsg() devuelve una cadena vacía.

### Ejemplos

Ejemplo #1 Extrayendo el mensaje de error devuelto por un intento de conexión fallido

El siguiente ejemplo muestra como devolver un mensaje de error y el valor SQLCODE después de pasar parámetros inválidos intencionalmente a db2_connect().

`<?php
$conn = db2_connect('badname', 'baduser', 'badpassword');
if (!$conn) {
print db2_conn_errormsg();
}
?>`

El resultado del ejemplo sería:

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

### Ver también

- db2_conn_error() - Devolver una cadena que contenga el valor SQLSTATE devuelto por el último intento de conexión.
- db2_connect() - Devolver una conexión a la base de datos
- db2_stmt_error() - Returns a string containing the SQLSTATE returned by an SQL statement
- db2_stmt_errormsg() - Returns a string containing the last SQL statement error message