cvs: peardoc /en/package/database/mdb2 intro-transaction.xml

takagi Tue Aug 1 21:39:32 2006 UTC Modified files: /peardoc/en/package/database/mdb2 intro-transaction.xml Log: fix build. http://cvs.php.net/viewvc.cgi/peardoc/en/package/database/mdb2/intro-transaction.xml?r1=1.1&r2=1.2&diff_format=u Index: peardoc/en/package/database/mdb2/intro-transaction.xml diff -u peardoc/en/package/database/mdb2/intro-transaction.xml:1.1 peardoc/en/package/database/mdb2/intro-transaction.xml:1.2 --- peardoc/en/package/database/mdb2/intro-transaction.xml:1.1 Tue Aug 1 21:37:27 2006 +++ peardoc/en/package/database/mdb2/intro-transaction.xml Tue Aug 1 21:39:32 2006 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <!-- @@ -27,7 +27,7 @@ three methods optionally accept a string name of a savepoint to set, release or rollback to respectively. The method <ulink url="http://pear.php.net/package/MDB2/docs/latest/MDB2/MDB2_Driver_Common.html#methodinTransaction"> - <function>inTransaction</function> may be used to check if a transaction is + <function>inTransaction</function></ulink> may be used to check if a transaction is currently open. </para> @@ -98,35 +98,35 @@ <para> MDB2 also supports "nested" transactions using the <ulink url="http://pear.php.net/package/MDB2/docs/latest/MDB2/MDB2_Driver_Common.html#methodbeginNestedTransaction"> - <function>beginNestedTransaction</function> method. Actually these are not + <function>beginNestedTransaction</function></ulink> method. Actually these are not true nested transactions as they are natively supported in Interbase for example. MDB2 maintains a counter of opened nested transactions. The transaction is finished once that counter is decremented back to 1 with <ulink url="http://pear.php.net/package/MDB2/docs/latest/MDB2/MDB2_Driver_Common.html#methodcompleteNestedTransaction"> - <function>completeNestedTransaction</function> calls. If the RDBMS supports + <function>completeNestedTransaction</function></ulink> calls. If the RDBMS supports savepoints then MDB2 will automatically set a savepoint on every call of the <ulink url="http://pear.php.net/package/MDB2/docs/latest/MDB2/MDB2_Driver_Common.html#methodbeginNestedTransaction"> - <function>beginNestedTransaction</function> method after the initial call + <function>beginNestedTransaction</function></ulink> method after the initial call and will return the name. These savepoints are automatically released by the <ulink url="http://pear.php.net/package/MDB2/docs/latest/MDB2/MDB2_Driver_Common.html#methodcompleteNestedTransaction"> - <function>completeNestedTransaction</function> method. The name of these + <function>completeNestedTransaction</function></ulink> method. The name of these automatic savepoints are determined by the "savepoint_format" (default: 'MDB2_SAVEPOINT_%s') option and the nested transaction counter. - <para> - </para> + + <para> If after initial opening of the nested transaction an unexpected PEAR error is raised on the MDB2 instance the transaction is rolled back, otherwise it is commited at this point. Using the <ulink url="http://pear.php.net/package/MDB2/docs/latest/MDB2/MDB2_Driver_Common.html#methodgetNestedTransactionError"> - <function>getNestedTransactionError</function> method it is possible to check + <function>getNestedTransactionError</function></ulink> method it is possible to check if there has been an error inside the transaction. Alternatively an rollback can be forced using the the <ulink url="http://pear.php.net/package/MDB2/docs/latest/MDB2/MDB2_Driver_Common.html#methodcompleteNestedTransaction"> - <function>failNestedTransaction</function>. This method optionally accepts + <function>failNestedTransaction</function></ulink>. This method optionally accepts a mixed parameter which will set the error to return if the <ulink url="http://pear.php.net/package/MDB2/docs/latest/MDB2/MDB2_Driver_Common.html#methodgetNestedTransactionError"> - <function>getNestedTransactionError</function> method is called as well as + <function>getNestedTransactionError</function></ulink> method is called as well as a second boolean parameter that optionally forces an immidiate rollback. </para> @@ -175,7 +175,7 @@ but supports a higher more strict isolation level, then MDB2 silently uses that higher transaction level. Some RDBMS support additional options which are silently ignored if they are not supported. - <para> + </para> <example> <title>Setting the transaction isolation level</title>