db2_autocommit
Returns or sets the AUTOCOMMIT state for a database connection
&reftitle.description;
mixeddb2_autocommit
resourceconnection
boolvalue
Sets or gets the AUTOCOMMIT behavior of the specified connection resource.
&reftitle.parameters;
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.
&reftitle.returnvalues;
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.
&return.success;
&reftitle.examples;
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.
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.";
}
?>
]]>
&example.outputs;
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.
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.";
}
?>
]]>
&example.outputs;
&reftitle.seealso;
db2_connect
db2_pconnect