(PECL ibm_db2 >= 1.0.0)
db2_conn_errormsg — Devolver el último mensaje de error de la conexión y su valor SQLCODE
$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.
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.
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