~rdoering/ubuntu/karmic/erlang/fix-535090

« back to all changes in this revision

Viewing changes to lib/cosTransactions/doc/src/ch_introduction.xml

  • Committer: Bazaar Package Importer
  • Author(s): Sergei Golovan
  • Date: 2009-02-15 16:42:52 UTC
  • mfrom: (1.1.13 upstream)
  • mto: (3.3.1 squeeze)
  • mto: This revision was merged to the branch mainline in revision 17.
  • Revision ID: james.westby@ubuntu.com-20090215164252-dxpjjuq108nz4noa
Upload to unstable after lenny is released.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<?xml version="1.0" encoding="latin1" ?>
 
2
<!DOCTYPE chapter SYSTEM "chapter.dtd">
 
3
 
 
4
<chapter>
 
5
  <header>
 
6
    <copyright>
 
7
      <year>1999</year>
 
8
      <year>2007</year>
 
9
      <holder>Ericsson AB, All Rights Reserved</holder>
 
10
    </copyright>
 
11
    <legalnotice>
 
12
  The contents of this file are subject to the Erlang Public License,
 
13
  Version 1.1, (the "License"); you may not use this file except in
 
14
  compliance with the License. You should have received a copy of the
 
15
  Erlang Public License along with this software. If not, it can be
 
16
  retrieved online at http://www.erlang.org/.
 
17
 
 
18
  Software distributed under the License is distributed on an "AS IS"
 
19
  basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
 
20
  the License for the specific language governing rights and limitations
 
21
  under the License.
 
22
 
 
23
  The Initial Developer of the Original Code is Ericsson AB.
 
24
    </legalnotice>
 
25
 
 
26
    <title>Introduction to cosTransactions</title>
 
27
    <prepared>Niclas Eklund</prepared>
 
28
    <docno></docno>
 
29
    <date>1999-04-26</date>
 
30
    <rev></rev>
 
31
  </header>
 
32
 
 
33
  <section>
 
34
    <title>Overview</title>
 
35
    <p>The cosTransactions application is a Transaction Service compliant with the <url href="http://www.omg.org">OMG</url> 
 
36
      Transaction Service CosTransactions 1.1.
 
37
      </p>
 
38
 
 
39
    <section>
 
40
      <title>Purpose and Dependencies</title>
 
41
      <p><em>cosTransactions</em> is dependent on  <em>Orber version 3.0.1</em> or later(see the Orber
 
42
        documentation), which provides CORBA functionality in an Erlang environment.</p>
 
43
      <p><em>cosTransactions</em> is dependent on  <em>supervisor/stdlib-1.7</em> or later.</p>
 
44
      <p>Basically, cosTransaction implements a <em>two-phase commit protocol</em> and allows objects running
 
45
        on different platforms to participate in a transaction.</p>
 
46
    </section>
 
47
 
 
48
    <section>
 
49
      <title>Prerequisites</title>
 
50
      <p>To fully understand the concepts presented in the
 
51
        documentation, it is recommended that the user is familiar
 
52
        with distributed programming, CORBA and the Orber application.
 
53
        </p>
 
54
      <p>Recommended reading includes <em>CORBA, Fundamentals and Programming - Jon Siegel</em> and <em>Open Telecom Platform Documentation Set</em>. It is also helpful to  have read
 
55
        <em>Concurrent Programming in Erlang</em> and, for example, <em>Transaction Processing: concepts and techniques - Jim Gray, Andreas Reuter</em>.</p>
 
56
      <note>
 
57
        <p>The cosTransaction application is compliant with the OMG CosTransactions specification 1.1. Using
 
58
          other vendors transaction service, compliant with the OMG CosTransactions specification 1.0, may
 
59
          not work since the <c>'TRANSACTION_REQUIRED', 'TRANSACTION_ROLLEDBACK'</c> and <c>'INVALID_TRANSACTION'</c>
 
60
          exceptions have been redefined to be system exceptions, i.e., used to be transaction-specific ('CosTransactions_Exc').</p>
 
61
      </note>
 
62
    </section>
 
63
  </section>
 
64
</chapter>
 
65