db2_conn_errormsg

(no version information, might be only in CVS)

db2_conn_errormsg --  Returns the last connection error message and SQLCODE value

説明

string db2_conn_errormsg ( [resource connection] )

警告

この関数は、 実験的なステータスにあります。これは、この関数の 動作、関数名、ここで書かれていること全てがPHPの将来のバージョンで予告 なく変更される可能性があることを意味します。注意を喚起するとともに自分 のリスクでこの関数を使用してください。

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.

パラメータ

connection

A connection resource associated with a connection that initially succeeded, but which over time became invalid.

戻り値

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.

例 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();
}
?>

上の例の出力は以下となります:

Msg:[IBM][CLI Driver] SQL1013N  The database alias name
or database name "BADNAME" could not be found.  SQLSTATE=42705
 Err Code: -1013

以下も参照ください

db2_conn_error()
db2_connect()
db2_stmt_error()
db2_stmt_errormsg()