db2_autocommit

(PECL ibm_db2 >= 1.0.0)

db2_autocommit Возвращает или устанавливает режим автоподтверждения транзакций для соединения

Описание

db2_autocommit ( resource $connection , bool $value = ? ) : mixed

Возвращает или устанавливает режим автоподтверждения транзакций для указанного соединения.

Список параметров

connection

Переменная содержащая активный ресурс подключения, полученный с помощью db2_connect() или db2_pconnect().

value

Одна из следующих констант:

DB2_AUTOCOMMIT_OFF

Отключает автоподтверждение.

DB2_AUTOCOMMIT_ON

Включает автоподтверждение.

Возвращаемые значения

Если в db2_autocommit() передать только параметр connection, она вернет значение текущего режима для этого соединения в виде целого числа принимающего значение DB2_AUTOCOMMIT_OFF, если автоподтверждение отключено и DB2_AUTOCOMMIT_ON, если включено.

Если в db2_autocommit() переданы оба параметра, connection и autocommit, она попытается установить для заданного соединения указанный режим автоподтверждения. Возвращает true в случае успешного завершения или false в случае возникновения ошибки.

Примеры

Пример #1 Получение текущего режима автоподтверждения транзакций

В следующем примере мы создадим соединение с отключенным автоподтверждением и проверим его с помощью db2_autocommit().

<?php
$options 
= array('autocommit' => DB2_AUTOCOMMIT_OFF);
$conn db2_connect($database$user$password$options);
$ac db2_autocommit($conn);
if (
$ac == DB2_AUTOCOMMIT_OFF) {
    print 
"$ac -- автоподтверждение включено.";
} else {
    print 
"$ac -- автоподтверждение отключено.";
}
?>

Результат выполнения данного примера:

0 -- автоподтверждение отключено.

Пример #2 Установка режима автоподтверждения транзакции

В следующем примере мы создадим соединение с отключенным автоподтверждением, после чего его включим и проверим.

<?php
$options 
= array('autocommit' => DB2_AUTOCOMMIT_OFF);
$conn db2_connect($database$user$password$options);

// Включаем автоподтверждение
$rc db2_autocommit($connDB2_AUTOCOMMIT_ON);
if (
$rc) {
    print 
"Автоподтверждение успешно включено.\n";
}

// ппроверяет текущий режим
$ac db2_autocommit($conn);
if (
$ac == DB2_AUTOCOMMIT_OFF) {
    print 
"$ac -- автоподтверждение включено.";
} else {
    print 
"$ac -- автоподтверждение отключено.";
}
?>

Результат выполнения данного примера:

Автоподтверждение успешно включено.
1 -- автоподтверждение включено.

Смотрите также