db2_conn_errormsg
(PECL ibm_db2 >= 1.0.0)
db2_conn_errormsg — Повертає останнє повідомлення про помилку підключення та значення SQLCODE
Опис
db2_conn_errormsg(?resource $connection = null): string
Повертає повідомлення про помилку та значення SQLCODE, що є причиною, через яку остання спроба підключення до бази даних завершилася невдачею. Оскільки db2_connect() повертає false у разі невдалої спроби підключення, не потрібно передавати жодних параметрів у db2_conn_errormsg() для отримання відповідного повідомлення про помилку та значення SQLCODE.
Однак, якщо з'єднання було успішним, але згодом стало недійсним, можна передати параметр connection, щоб отримати відповідне повідомлення про помилку та значення SQLCODE для конкретного з'єднання.
Список параметрів
connection
Ресурс підключення, пов'язаний із підключенням, яке спочатку було успішним, але згодом стало недійсним.
Значення, що повертаються
Повертає рядок, що містить повідомлення про помилку та значення SQLCODE, отримане внаслідок невдалої спроби підключення. Якщо при останній спробі помилок не виникло, db2_conn_errormsg() повертає порожній рядок.
Приклади
Приклад #1 Отримання повідомлення про помилку, повернутий у разі невдалої спроби підключення
У цьому прикладі показано, як повернути повідомлення про помилку та значення SQLCODE після навмисної передачі неприпустимих параметрів db2_connect()
Результат виконання наведеного прикладу:
[IBM][CLI Driver] SQL1013N The database alias name
or database name "BADNAME" could not be found. SQLSTATE=42705
SQLCODE=-1013
Дивіться також
- db2_conn_error() - Повертає рядок, що містить значення SQLSTATE, повернене останньою спробою підключення
- db2_connect() - Повертає з'єднання з базою даних
- db2_stmt_error() - Повертає рядок, що містить SQLSTATE, повернутий SQL-оператором
- db2_stmt_errormsg() - Повертає рядок, що містить останнє повідомлення про помилку SQL-виразу