(PECL ibm_db2 >= 1.0.0)
db2_conn_errormsg — Devuelve el último mensaje de error de conexión junto con el valor de SQLCODE
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.
connectionUn recurso de conexión asociado a la conexión que previamente fue exitosa, pero que se ha vuelto inválida con el tiempo.
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.
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
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.