db2_conn_errormsg
Returns the last connection error message and SQLCODE value
&reftitle.description;
stringdb2_conn_errormsg
resourceconnection
db2_conn_errormsg returns an error message 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
message and SQLCODE value.
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.
&reftitle.parameters;
connection
A connection resource associated with a connection that initially
succeeded, but which over time became invalid.
&reftitle.returnvalues;
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.
&reftitle.examples;
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.
]]>
&example.outputs;
&reftitle.seealso;
db2_conn_error
db2_connect
db2_stmt_error
db2_stmt_errormsg