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