db2_conn_errormsg

(PECL ibm_db2 >= 1.0.0)

db2_conn_errormsg — Retorna a última mensagem de erro de conexão e o valor SQLCODE

Descrição

db2_conn_errormsg(?resource $connection = null): string

db2_conn_errormsg() retorna uma mensagem de erro e um valor SQLCODE representando o motivo da falha da última tentativa de conexão com o banco de dados. Como db2_connect() retorna false no caso de uma falha na tentativa de conexão, não deve ser passado nenhum parâmetro para db2_conn_errormsg() para recuperar a mensagem de erro associada e o valor SQLCODE.

Se, no entanto, a conexão foi bem-sucedida, mas se torna inválida ao longo do tempo, pode ser passado o parâmetro connection para recuperar a mensagem de erro associada e o valor SQLCODE para uma conexão específica.

Parâmetros

connection: Um recurso de conexão associado a uma conexão que inicialmente foi bem-sucedida, mas que com o tempo se tornou inválida.

Valor Retornado

Retorna uma string contendo a mensagem de erro e o valor SQLCODE resultante de uma tentativa de conexão com falha. Se não houver erro associado à última tentativa de conexão, db2_conn_errormsg() retornará uma string vazia.

Exemplos

Exemplo #1 Recuperando a mensagem de erro retornada por uma tentativa de conexão com falha

O exemplo a seguir demonstra como retornar uma mensagem de erro e valor SQLCODE após passar deliberadamente parâmetros inválidos para db2_connect().

<?php
$conn = db2_connect('nome_invalido', 'usuario_invalido', 'senha_invalida');
if (!$conn) {
    print db2_conn_errormsg();
}
?>

O exemplo acima produzirá:

[IBM][CLI Driver] SQL1013N  The database alias name
or database name "NOME_INVALIDO" could not be found.  SQLSTATE=42705
 SQLCODE=-1013

Veja Também

db2_conn_error() - Retorna uma string contendo o SQLSTATE retornado pela última tentativa de conexão
db2_connect() - Retorna uma conexão com um banco de dados
db2_stmt_error() - Retorna uma string contendo o SQLSTATE retornado por uma instrução SQL
db2_stmt_errormsg() - Retorna uma string contendo a última mensagem de erro da instrução SQL