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 You may use up to 62 fields entitle
  69 .BR Text .
  70 They will be recorded one by one and stored into additional data
  71 records.  This way you could add a detailed description of the type of
  72 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 7-bit on the fly so you don't need to
 100 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 .