(PECL ibm_db2 >= 1.0.0)
db2_conn_errormsg — Devolver el último mensaje de error de la conexión y su valor SQLCODE
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.
connectionUn recurso de conexión asociado a la conexión que inicialmente fue exitosa, pero que en algún momento llego a ser inválida.
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.
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
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.