git.infodrom.org Git - infodrom/dtaus/blob - 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 .SS <type>
  69 One of the following:
  70 .TP
  71 .I LK
  72 Lastschrift Kundenseitig
  73 .TP
  74 .I GK
  75 Gutschrift Kundenseitig
  76 .TP
  77 .I LB
  78 Lastschrift Bankseitig
  79 .TP
  80 .I GB
  81 Gutschrift Bangseitig
  82
  83 .SS <transaction>
  84 One of the following:
  85 .TP
  86 .I Lastschrift
  87 Bankeinzug
  88 .TP
  89 .I Gutschrift
  90 Überweisung
  91
  92 .SS Character Encoding
  93 German Umlauts are converted to 7-bit on the fly so you don't need to
  94 care about them.  Since the
  95 .I dtaus0.txt
  96 file only uses uppercase letters every text is also converted to
  97 uppercase.
  98
  99 Except for the way records are delimited the format should be self
 100 explanatory.
 101
 102 .SH "SEE ALSO"
 103 DTAUS files use a special but simple and freely documented format.
 104 It is included in the distribution of dtaus as
 105 .IR dtaus.txt .