<?xml version="1.0" encoding="utf-8"?>

<!-- EN-Revision: 2d8dcd319217fa3e6140bfc976d98e03a2c6ae37 Maintainer: martin.koeditz@it-syn.de Status: ready -->

<!-- Reviewed: no -->

<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ibase-trans">

<refnamediv>

<refname>ibase_trans</refname>

<refpurpose>Startet eine Transaktion</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type>resource</type><methodname>ibase_trans</methodname>

<methodparam choice="opt"><type>int</type><parameter>trans_args</parameter></methodparam>

<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam>

</methodsynopsis>

<methodsynopsis>

<type>resource</type><methodname>ibase_trans</methodname>

<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam>

</methodsynopsis>

<simpara>

Startet eine Transaktion

</simpara>

<note>

<simpara>

Der erste Aufruf von <function>ibase_trans</function> gibt nicht die Standardtransaktion einer

Verbindung zurück. Alle Transaktionen, die mittels <function>ibase_trans</function> gestartet

wurden, werden am Ende des Skripts rückgängig gemacht, sofern diese nicht mit <function>ibase_commit</function>

festgeschrieben oder mit <function>ibase_rollback</function> rückgängig gemacht wurden.

</simpara>

</note>

<note>

<simpara>

Diese Funktion akzeptiert mehrere <parameter>trans_args</parameter>-

und <parameter>link_identifier</parameter>-Argumente. Dies erlaubt Transaktionen über

mehrere Datenbankverbindungen, die mittels eines 2-Phasen-Commit-Algorithmus festgeschrieben werden.

Dies bedeutet, dass Sie sich darauf verlassen können, dass die Aktualisierungen

entweder in jeder Datenbank erfolgreich sind oder in jeder Datenbank fehlschlagen. Es bedeutet NICHT,

dass Sie Tabellen aus verschiedenen Datenbanken in derselben Abfrage verwenden können!

</simpara>

<simpara>

Wenn Sie Transaktionen über mehrere Datenbanken hinweg verwenden, müssen Sie die Parameter

<parameter>link_id</parameter> und <parameter>transaction_id</parameter>

in den Aufrufen von <function>ibase_query</function> und <function>ibase_prepare</function> verwenden.

</simpara>

</note>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<variablelist>

<varlistentry>

<term><parameter>trans_args</parameter></term>

<listitem>

<simpara>

<parameter>trans_args</parameter> darf eine Kombination aus

<constant>IBASE_READ</constant>,

<constant>IBASE_WRITE</constant>,

<constant>IBASE_COMMITTED</constant>,

<constant>IBASE_CONSISTENCY</constant>,

<constant>IBASE_CONCURRENCY</constant>,

<constant>IBASE_REC_VERSION</constant>,

<constant>IBASE_REC_NO_VERSION</constant>,

<constant>IBASE_WAIT</constant> und

<constant>IBASE_NOWAIT</constant> sein.

</simpara>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>link_identifier</parameter></term>

<listitem>

<simpara>

Eine InterBase/Firebird-Verbindungskennung. Wenn nicht angegeben, wird der zuletzt geöffnete Link angenommen.

</simpara>

</listitem>

</varlistentry>

</variablelist>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<simpara>

Gibt ein Transaktions-Handle zurück oder &false; on bei einem Fehler.

</simpara>

</refsect1>

</refentry>

<!-- Keep this comment at the end of the file

Local variables:

mode: sgml

sgml-omittag:t

sgml-shorttag:t

sgml-minimize-attributes:nil

sgml-always-quote-attributes:t

sgml-indent-step:1

sgml-indent-data:t

indent-tabs-mode:nil

sgml-parent-document:nil

sgml-default-dtd-file:"~/.phpdoc/manual.ced"

sgml-exposed-tags:nil

sgml-local-catalogs:nil

sgml-local-ecat-files:nil

End:

vim600: syn=xml fen fdm=syntax fdl=2 si

vim: et tw=78 syn=sgml

vi: ts=1 sw=1

-->