.\" dtaus - Converter for DTAUS files
.\" Copyright (c) 2000,1  Martin Schulze <joey@infodrom.org>
.\"
.\" This program is free software; you can redistribute it and/ormodify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.
.\"
.TH DTAUS 5 "11 November 2001" "" ""
.SH NAME
dtaus \- Converter for DTAUS files
.SH DESCRIPTION
The
.BR dtaus (1)
program reads and writes German DTAUS files.  DTAUS is an acronym for
.BR D aten T räger AUS tausch.
It is used by German credit institutes in order to implement money
exchanges between accounts and credit institutes.  These files are
always called
.IR dtaus0.txt .

Since they are shipped in a weird ascii format that is not quite
readable and writable for humans a special control format was
implemented.  The
.BR dtaus (1)
program reads and writes such a control file and generates a proper
DTAUS file if requested.

.SH "CONTROL FILE"
The control file implements a very simple format.  Empty lines and
those beginning with a hash (`#') mark are ignored.  The remaining
file is splitted into three major parts: one BEGIN record, several
regular records and one optional END record, which is ignored when the
file is read but is extracted from the
.I dtaus0.txt
file.

Here's a short sample for a control file:

  BEGIN {
    Art   \fI<type>\fR
    Name  Martin Schulze
    Konto 123545
    BLZ   2004002
  }

  {
    Transaktion \fI<transaction>\fR
    Name   Martha Schulze
    Konto  98832
    BLZ    2004003
    Betrag 20.00
    Zweck  Gebühr Wohnheimnetz
    Text   Anschluß u. 11+12.97
  }

  ...

You may use up to 15 fields entitled as
.BR Text .
They will be recorded one by one and stored into additional data
records using the same order.  This way you could add a detailed
description of the type of money transfer if you like.

.SS <type>
One of the following:
.TP
.I LK
Lastschrift Kundenseitig
.TP
.I GK
Gutschrift Kundenseitig
.TP
.I LB
Lastschrift Bankseitig
.TP
.I GB
Gutschrift Bangseitig

.SS <transaction>
One of the following:
.TP
.I Lastschrift
Bankeinzug
.TP
.I Gutschrift
Überweisung

.SS Character Encoding
German Umlauts are converted to two 7-bit characters on the fly so you
don't need to care about them.  Since the
.I dtaus0.txt
file only uses uppercase letters every text is also converted to
uppercase.

Except for the way records are delimited the format should be self
explanatory.

.SH "SEE ALSO"
DTAUS files use a special but simple and freely documented format.
It is included in the distribution of dtaus as
.IR dtaus.txt .