(PECL ibm_db2 >= 1.0.0)
db2_conn_errormsg — Retorna a última mensagem de erro de conexão e o valor SQLCODE
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.
connectionUm recurso de conexão associado a uma conexão que inicialmente foi bem-sucedida, mas que com o tempo se tornou inválida.
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.
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
A word of warning:
It appears that if you specify an invalid ibm_db2.instance_name in your php.ini file, your cataloged db2_connect() will fail with a returned value of false and when you use db2_conn_error() or db2_conn_errormsg() to check on the reason, those functions will return an empty string.