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
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