db2_conn_errormsg
(PECL ibm_db2:1.0-1.6.2)
db2_conn_errormsg —
Returns the last connection error message and SQLCODE value
Description
string db2_conn_errormsg
([ resource $connection
] )
If, however, the connection was successful but becomes invalid over time,
you can pass the connection
parameter to retrieve
the associated error message and SQLCODE value for a specific connection.
Parameters
-
connection
-
A connection resource associated with a connection that initially
succeeded, but which over time became invalid.
Return Values
Returns a string containing the error message and SQLCODE value resulting
from a failed connection attempt. If there is no error associated with the last
connection attempt, db2_conn_errormsg() returns an empty
string.
Examples
Example #1 Retrieving the error message returned by a failed connection attempt
The following example demonstrates how to return an error message and
SQLCODE value after deliberately passing invalid parameters to
db2_connect().
<?php
$conn = db2_connect('badname', 'baduser', 'badpassword');
if (!$conn) {
print db2_conn_errormsg();
}
?>
The above example will output:
[IBM][CLI Driver] SQL1013N The database alias name
or database name "BADNAME" could not be found. SQLSTATE=42705
SQLCODE=-1013