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
$connection
] )
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