. Updated description according to wha I got from one bank
[infodrom/dtaus] / dtaus.1
1 .\" dtaus - Converter for DTAUS files
2 .\" Copyright (c) 1995  Martin Schulze <Martin.Schulze@Linux.DE>
3 .\"
4 .\" This file is part of the sysklogd package, a kernel and system logdaemon.
5 .\"
6 .\" This program is free software; you can redistribute it and/ormodify
7 .\" it under the terms of the GNU General Public License as published by
8 .\" the Free Software Foundation; either version 2 of the License, or
9 .\" (at your option) any later version.
10 .\"
11 .\" This program is distributed in the hope that it will be useful,
12 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
13 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14 .\" GNU General Public License for more details.
15 .\"
16 .\" You should have received a copy of the GNU General Public License
17 .\" along with this program; if not, write to the Free Software
18 .\" Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.
19 .\"
20 .TH DTAUS 1 "5 July 1998" "" ""
21 .SH NAME
22 dtaus \- Converter for DTAUS files
23 .SH SYNOPSIS
24 .B dtaus
25 .RB [ " \-d "
26 .IR dtaus " ]"
27 .RB [ " \-c "
28 .IR control " ]"
29 .RB [ " \-b "
30 .IR begleit " ]"
31 .RB [ " \-o "
32 .IR kontroll " ]"
33 .BR -dtaus " | " -control
34 .SH DESCRIPTION
35 This program can read and write german DTAUS files.  DTAUS is an
36 acronym for 
37 .BR D aten T räger AUS tausch.
38 It is used by german credit institutes in order to manage money
39 exchanges between accounts and credit institutes.
40
41 .SH OPTIONS
42 You have to specify at one of
43 .BR \-dtaus " or " \-control .
44
45   -dtaus        Erzeugt eine Bankdatei
46   -control      Liest eine Bankdatei und erzeugt die Kontrolldateien
47
48   -d <dtaus>    Bankdatei [dtaus0.txt]
49   -c <control>  Steuerdatei [dtaus0.ctl]
50   -b <begleit>  Begleitzettel für die Bank dtaus0.doc]
51   -o <kontroll> Kontrolldatei zum Abheften [dtaus0.sik]
52
53 .SH "CONTROL FILE"
54 The control file has a very simple format.  Empty lines and those
55 beginning with a hash mark are ignored.  The remainder is splitted
56 into three parts, one BEGIN record, several regular records and one
57 END record, which is being ignored and created by the program.
58
59 For a complete description please refer to
60 .I dtaus.txt
61 from this distribution.  Here's a short example for a control file:
62
63   BEGIN {
64     Art   LK
65     Name  Martin Schulze
66     Konto 123545
67     BLZ   2004002
68   }
69
70   {
71     Transaktion Einzug
72     Name   Martha Schulze
73     Konto  98832
74     BLZ    2004003
75     Betrag 20.00
76     Zweck  Gebühr Wohnheimnetz
77     Text   Anschluss u. 11+12.97
78   }
79
80   ...
81
82 If you think this description suxx or isn't enough please sit down for
83 some hours and write something better.  I'll get included if it's
84 appropriate.
85
86 .SH "RETURN VALUES"
87 On success, zero is returned.  On error, 1  is  returned.
88
89 .SH "SEE ALSO"
90 DTAUS files use a special but simple and freely documented format.
91 It is included in the distribution of dtaus as dtaus.txt.