トップページ　→関数リファレンス　→データベース関連　→ベンダー固有のモジュール　→IBM DB2　→IBM DB2 関数

関数・クラス解説

db2_autocommit

version:PECL ibm_db2 >= 1.0.0 (公式)

データベース接続の AUTOCOMMIT の状態を取得または設定する

公式リファレンス

書式

db2_autocommit ( resource $connection [, bool $value ] ) : mixed

説明

指定した接続リソースについての AUTOCOMMIT の状態を設定あるいは取得します。

パラメータ

connection

db2_connect() あるいは db2_pconnect() が返した有効なデータベース接続リソース。

value

以下の定数のいずれか。

DB2_AUTOCOMMIT_OFF: AUTOCOMMIT を無効にします。
DB2_AUTOCOMMIT_ON: AUTOCOMMIT を有効にします。

返値

db2_autocommit() に connection パラメータのみを渡した場合、指定した接続の AUTOCOMMIT の状態を整数値で返します。 DB2_AUTOCOMMIT_OFF の場合は無効、 DB2_AUTOCOMMIT_ON の場合は有効です。 db2_autocommit() に connection および autocommit の両方のパラメータを渡した場合、指定した接続の AUTOCOMMIT を対応する状態に設定します。成功した場合に TRUE を、失敗した場合に FALSE を返します。

サンプル

例1 接続の AUTOCOMMIT 値の取得
  以下の例では、AUTOCOMMIT を無効にした接続について db2_autocommit() 関数で調べます。  

$options = array('autocommit' => DB2_AUTOCOMMIT_OFF);
$conn = db2_connect($database, $user, $password, $options);
$ac = db2_autocommit($conn);
if ($ac == DB2_AUTOCOMMIT_OFF) {
    print "$ac -- AUTOCOMMIT は無効です。";
} else {
    print "$ac -- AUTOCOMMIT が有効です。";
}

 上の例の出力は以下となります。 
0 -- AUTOCOMMIT は無効です。
 例2 接続の AUTOCOMMIT 値の設定
  以下の例では、AUTOCOMMIT を無効にして作成した接続の AUTOCOMMIT を変更し、有効にします。  

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

// AUTOCOMMIT を有効にします
$rc = db2_autocommit($conn, DB2_AUTOCOMMIT_ON);
if ($rc) {
    print "AUTOCOMMIT を有効にしました。\n";
}

// AUTOCOMMIT の状態を調べます
$ac = db2_autocommit($conn);
if ($ac == DB2_AUTOCOMMIT_OFF) {
    print "$ac -- AUTOCOMMIT は無効です。";
} else {
    print "$ac -- AUTOCOMMIT が有効です。";
}

 上の例の出力は以下となります。 
AUTOCOMMIT を有効にしました。
1 -- AUTOCOMMIT が有効です。