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
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