db2_autocommit

(no version information, might be only in CVS)

db2_autocommit --  Returns or sets the AUTOCOMMIT state for a database connection

説明

mixed db2_autocommit ( resource connection [, bool value] )

警告

この関数は、 実験的なステータスにあります。これは、この関数の 動作、関数名、ここで書かれていること全てがPHPの将来のバージョンで予告 なく変更される可能性があることを意味します。注意を喚起するとともに自分 のリスクでこの関数を使用してください。

Sets or gets the AUTOCOMMIT behavior of the specified connection resource.

パラメータ

connection

A valid database connection resource variable as returned from db2_connect() or db2_pconnect().

value

One of the following constants:

DB2_AUTOCOMMIT_OFF

Turns AUTOCOMMIT off.

DB2_AUTOCOMMIT_ON

Turns AUTOCOMMIT on.

戻り値

When db2_autocommit() receives only the connection parameter, it returns the current state of AUTOCOMMIT for the requested connection as an integer value. A value of 0 indicates that AUTOCOMMIT is off, while a value of 1 indicates that AUTOCOMMIT is on.

When db2_autocommit() receives both the connection parameter and autocommit parameter, it attempts to set the AUTOCOMMIT state of the requested connection to the corresponding state. 成功した場合に TRUE を、失敗した場合に FALSE を返します。

例 1. Retrieving the AUTOCOMMIT value for a connection

In the following example, a connection which has been created with AUTOCOMMIT turned off is tested with the db2_autocommit() function.

<?php
$options
= array('autocommit' => DB2_AUTOCOMMIT_OFF);
$conn = db2_connect($database, $user, $password, $options);
$ac = db2_autocommit($conn);
if (
$ac == 0) {
    print
"$ac -- AUTOCOMMIT is off.";
} else {
    print
"$ac -- AUTOCOMMIT is on.";
}
?>

上の例の出力は以下となります:

0 -- AUTOCOMMIT is off.

例 2. Setting the AUTOCOMMIT value for a connection

In the following example, a connection which was initially created with AUTOCOMMIT turned off has its behavior changed to turn AUTOCOMMIT on.

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

// Turn AUTOCOMMIT on
$rc = db2_autocommit($conn, DB2_AUTOCOMMIT_ON);
if (
$rc) {
    print
"Turning AUTOCOMMIT on succeeded.\n";
}

// Check AUTOCOMMIT state
$ac = db2_autocommit($conn);
if (
$ac == 0) {
    print
"$ac -- AUTOCOMMIT is off.";
} else {
    print
"$ac -- AUTOCOMMIT is on.";
}
?>

上の例の出力は以下となります:

Turning AUTOCOMMIT on succeeded.
1 -- AUTOCOMMIT is on.

以下も参照ください

db2_connect()
db2_pconnect()
db2_setoption()