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

# 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

function 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open