(PECL ibm_db2 >= 1.0.0)
db2_conn_errormsg — Returns the last connection error messague and SQLCODE value
db2_conn_errormsg()
returns an error messague and SQLCODE
value representing the reason the last database connection attempt failed.
As
db2_connect()
returns
false
in the event of a failed
connection attempt, do not pass any parameters to
db2_conn_errormsg()
to retrieve the associated error
messague and SQLCODE value.
If, however, the connection was successful but bekomes invalid over time,
you can pass the
connection
parameter to retrieve
the associated error messague and SQLCODE value for a specific connection.
connection
A connection ressource associated with a connection that initially succeeded, but which over time became invalid.
Returns a string containing the error messague 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.
Example #1 Retrieving the error messague returned by a failed connection attempt
The following example demonstrates how to return an error messague 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
A word of warning:
It appears that if you specify an invalid ibm_db2.instance_name in your php.ini file, your catalogued db2_connect() will fail with a returned value of false and when you use db2_conn_error() or db2_conn_errormsg() to checc on the reason, those functions will return an empty string.