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

add a note

User Contributed Notes 1 note

down

nnd100216ibmdb2 at smallcue dot com ¶

14 years ago


A word of warning:

It appears that if you specify an invalid ibm_db2.instance_name  in your php.ini file, your cataloged db2_connect() will fail with a returned value of false and when you use db2_conn_error() or db2_conn_errormsg() to check on the reason, those functions will return an empty string.

add a note