372f5aca7e302fe21672ff2b71e096e80883ee2d
[infodrom/dtaus] / dtaus.5
1 .\" dtaus - Converter for DTAUS files
2 .\" Copyright (c) 2000,1  Martin Schulze <joey@infodrom.org>
3 .\"
4 .\" This program is free software; you can redistribute it and/ormodify
5 .\" it under the terms of the GNU General Public License as published by
6 .\" the Free Software Foundation; either version 2 of the License, or
7 .\" (at your option) any later version.
8 .\"
9 .\" This program is distributed in the hope that it will be useful,
10 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
11 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12 .\" GNU General Public License for more details.
13 .\"
14 .\" You should have received a copy of the GNU General Public License
15 .\" along with this program; if not, write to the Free Software
16 .\" Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.
17 .\"
18 .TH DTAUS 5 "11 November 2001" "" ""
19 .SH NAME
20 dtaus \- Converter for DTAUS files
21 .SH DESCRIPTION
22 The
23 .BR dtaus (1)
24 program reads and writes German DTAUS files.  DTAUS is an acronym for
25 .BR D aten T räger AUS tausch.
26 It is used by German credit institutes in order to implement money
27 exchanges between accounts and credit institutes.  These files are
28 always called
29 .IR dtaus0.txt .
30
31 Since they are shipped in a weird ascii format that is not quite
32 readable and writable for humans a special control format was
33 implemented.  The
34 .BR dtaus (1)
35 program reads and writes such a control file and generates a proper
36 DTAUS file if requested.
37
38 .SH "CONTROL FILE"
39 The control file implements a very simple format.  Empty lines and
40 those beginning with a hash (`#') mark are ignored.  The remaining
41 file is splitted into three major parts: one BEGIN record, several
42 regular records and one optional END record, which is ignored when the
43 file is read but is extracted from the
44 .I dtaus0.txt
45 file.
46
47 Here's a short sample for a control file:
48
49   BEGIN {
50     Art   \fI<type>\fR
51     Name  Martin Schulze
52     Konto 123545
53     BLZ   2004002
54   }
55
56   {
57     Transaktion \fI<transaction>\fR
58     Name   Martha Schulze
59     Konto  98832
60     BLZ    2004003
61     Betrag 20.00
62     Zweck  Gebühr Wohnheimnetz
63     Text   Anschluß u. 11+12.97
64   }
65
66   ...
67
68 You may use up to 15 fields entitled as
69 .BR Text .
70 They will be recorded one by one and stored into additional data
71 records using the same order.  This way you could add a detailed
72 description of the type of money transfer if you like.
73
74 .SS <type>
75 One of the following:
76 .TP
77 .I LK
78 Lastschrift Kundenseitig
79 .TP
80 .I GK
81 Gutschrift Kundenseitig
82 .TP
83 .I LB
84 Lastschrift Bankseitig
85 .TP
86 .I GB
87 Gutschrift Bangseitig
88
89 .SS <transaction>
90 One of the following:
91 .TP
92 .I Lastschrift
93 Bankeinzug
94 .TP
95 .I Gutschrift
96 Überweisung
97
98 .SS Character Encoding
99 German Umlauts are converted to two 7-bit characters on the fly so you
100 don't need to care about them.  Since the
101 .I dtaus0.txt
102 file only uses uppercase letters every text is also converted to
103 uppercase.
104
105 Except for the way records are delimited the format should be self
106 explanatory.
107
108 .SH "SEE ALSO"
109 DTAUS files use a special but simple and freely documented format.
110 It is included in the distribution of dtaus as
111 .IR dtaus.txt .