Adjusted the copyright note
[infodrom/dtaus] / dtaus.1
diff --git a/dtaus.1 b/dtaus.1
index 99605a5..f609988 100644 (file)
--- a/dtaus.1
+++ b/dtaus.1
@@ -1,7 +1,5 @@
 .\" dtaus - Converter for DTAUS files
-.\" Copyright (c) 1995  Martin Schulze <Martin.Schulze@Linux.DE>
-.\"
-.\" This file is part of the sysklogd package, a kernel and system logdaemon.
+.\" Copyright (c) 1998,2001  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
@@ -17,7 +15,7 @@
 .\" along with this program; if not, write to the Free Software
 .\" Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.
 .\"
-.TH DTAUS 1 "5 July 1998" "" ""
+.TH DTAUS 1 "17 November 2001" "" ""
 .SH NAME
 dtaus \- Converter for DTAUS files
 .SH SYNOPSIS
@@ -28,64 +26,202 @@ dtaus \- Converter for DTAUS files
 .IR control " ]"
 .RB [ " \-b "
 .IR begleit " ]"
+.RB [ " \-l "
+.RI " [" begleit "] ]"
 .RB [ " \-o "
 .IR kontroll " ]"
 .BR -dtaus " | " -control
 .SH DESCRIPTION
-This program can read and write german DTAUS files.  DTAUS is an
-acronym for 
+This program can read and write German DTAUS files.  DTAUS is an
+semi-acronym for 
 .BR D aten T räger AUS tausch.
-It is used by german credit institutes in order to manage money
-exchanges between accounts and credit institutes.
-
-.SH OPTIONS
-You have to specify at one of
-.BR \-dtaus " or " \-control .
-
-  -dtaus        Erzeugt eine Bankdatei
-  -control      Liest eine Bankdatei und erzeugt die Kontrolldateien
+It is used by German credit institutes in order to manage mass money
+exchanges between customer accounts and credit institutes.
 
-  -d <dtaus>    Bankdatei [dtaus0.txt]
-  -c <control>  Steuerdatei [dtaus0.ctl]
-  -b <begleit>  Begleitzettel für die Bank dtaus0.doc]
-  -o <kontroll> Kontrolldatei zum Abheften [dtaus0.sik]
+Due to its limited availability and usefulness most of the
+documentation is held in German.  This program is only useful in
+Germany or for companies that act in Germany.
 
-.SH "CONTROL FILE"
-The control file has a very simple format.  Empty lines and those
-beginning with a hash mark are ignored.  The remainder is splitted
-into three parts, one BEGIN record, several regular records and one
-END record, which is being ignored and created by the program.
-
-For a complete description please refer to
+For a complete description of the control file please refer to
 .I dtaus.txt
-from this distribution.  Here's a short example for a control file:
-
-  BEGIN {
-    Art   LK
-    Name  Martin Schulze
-    Konto 123545
-    BLZ   2004002
-  }
-
-  {
-    Transaktion Einzug
-    Name   Martha Schulze
-    Konto  98832
-    BLZ    2004003
-    Betrag 20.00
-    Zweck  Gebühr Wohnheimnetz
-    Text   Anschluss u. 11+12.97
-  }
+and
+.BR dtaus (5)
+from this distribution.
+.SH OPTIONS
+You have to specify exactly one of
+.BR \-dtaus " or " \-control .
+.TP
+.B \-dtaus
+Liest die Kontrolldatei ein und erzeugt daraus die Bankdatei sowie
+alle anderen benötigten Dateien.
+.TP
+.B \-control
+Liest eine Bankdatei ein und erzeugt daraus die Kontrolldatei,
+dekodiert eine bereits erstellte Bankdatei.
+.TP
+.BI \-d " dtaus"
+Explizite Angabe des Dateinamens für die Bankdatei.  Voreingestellt
+ist
+.BR dtaus0.txt ,
+was von der Bank als einziger Dateiname auf der Diskette erwartet
+wird.  Für Testzwecke oder zur Weiterverarbeitung darf hier die
+spezielle Datei ``-'' angegeben werden, wodurch
+.B dtaus
+angewiesen wird, auf die Standardausgabe zu schreiben.
+.TP
+.BI \-c " control"
+Explizite Angabe des Dateinamens der Steuerdatei.  Voreingestellt ist
+.BR dtaus0.ctl .
+Da dieser Name jedoch nur intern verwendet wird, ist er keinen
+Beschränkungen unterlegen.  In dieser Datei befinden sich die gesamten
+visuell lesbaren Informationen für den Geldverkehr.  Diese Datei muß
+für die Bank in das spezielle DTAUS-Format konvertiert werden.  Das
+geschieht mit dem Schalter
+.BR \-dtaus .
+.TP
+.BI \-b " begleit"
+Explizite Angabe des Dateinamens des Begleitzettels.  Voreingestellt ist
+.BR dtaus0.doc .
+Da dieser Name jedoch nur intern verwendet wird, ist er keinen
+Beschränkungen unterlegen.  Diese Datei muß ausgedruckt und der
+Diskette unterschrieben beigelegt werden.
+.TP
+.BI \-l " \fR[\fIbegleit\fR]\fI"
+LaTeX-Ausgabe des Begleit-Zettels erwünscht.  Diese Datei wird
+normalerweise nicht geschrieben.  Voreingestellt ist
+.B dtaus0.tex
+als Dateiname, es kann jedoch ein anderer angegeben werden.  Für die
+Compilierung wird
+.I dtaus.cls
+benötigt.  Diesem Programm liegt eine einfache Implementierung bei,
+idealerweise wird jedoch eine lokal angepaßte Klasse verwendet, die
+Kopf- und Fußzeilen mit Logos und Adressen realisiert.
+.TP
+.BI \-o " kontroll"
+Explizite Angabe des Dateinamens für die Kontrolldatei.  Voreingestellt ist
+.BR dtaus0.sik .
+Da dieser Name jedoch nur intern verwendet wird, ist er keinen
+Beschränkungen unterlegen.  Es ist ratsam, diese Datei gut
+aufzubewahren oder auszudrucken und abzuheften.  Dieses ist neben der
+Steuer- und Bankdatei die einzige Aufschlüsselung des getätigten
+Geldverkehrs.
+.SH BESCHREIBUNG
+Deutsche Banken bieten für Großkunden oder Kunden mit vielen ähnlichen
+Überweisungen oder Bankeinzügen (auch Lastschriften genannt) die
+Möglichkeit des papierlosen Geldverkehrs über den Beleglosen
+Datenträgeraustausch an.  Hierbei wird nicht mehr für jede Überweisung
+oder jeden Einzug ein eigenes Formular benötigt, sondern
+zusammengehörige Aufträge werden in einer Massensendung verpackt
+gemeinsam verarbeitet.
 
-  ...
+Hier ist jedoch Vorsicht geboten, denn auf dem eigenen Konto erscheint
+lediglich eine einzige Kontobewegung.  Wenn Geld eingezogen wird,
+enthält der Kontoauszug nur die Gesamtsumme, wenn Geld überwiesen
+wird, ist auf dem Kontoauszug nur die Gesamtsumme notiert.  Es ist
+daher immens wichtig, die Ursprungsdaten aufzubewahren bzw. die
+Kontrolldatei auszudrucken und abzuheften.
 
-If you think this description suxx or isn't enough please sit down for
-some hours and write something better.  I'll get included if it's
-appropriate.
+Um an diesem Verfahren teilzunehmen, das den Geldverkehr für
+Organisationen erheblich vereinfachen kann, muß mit der jeweiligen Bank
+eine gesonderte Vereinbarung getroffen werden, in der die speziellen
+Bestimmungen für diesen Datenträgeraustausch akzeptiert werden.
 
+Durch das einfache Format der Steuerdatei läßt sich dieses Verfahren
+leicht mit einer Datenbank oder einem größeren Programm koppeln.  In
+der Tat entstand das Programm nach Aufbau des ersten Wohnheimnetzes in
+Oldenburg (Oldbg.) und der ernüchternden Erkenntnis, daß die vom
+Kassenwart verwendeten Programme für den Datenträgeraustausch weder
+zuverlässig noch nachvollziehbar arbeiteten und somit Ersatz
+geschaffen werden mußte.  Die technische und finanzielle Verwaltung
+des Wohnheimnetzes fand über ein Linux-System mit Datenbankanbindung
+sowie
+.B dtaus
+statt.
+.SH BESONDERHEITEN
+Bei der Verwendung dieses Programms müssen wenigstens die folgenden
+Dinge beachtet werden, es sind Vorgaben von den beteiligten Banken.
+.TP
+1.
+Die Diskette muß mit dem MSDOS-Dateisystem beschrieben sein.
+.TP
+2.
+Auf einer Diskette darf nur eine einzige DTAUS-Datei enthalten sein,
+die den Dateinamen
+.B DTAUS0.TXT
+trägt.
+.TP
+3.
+Der Diskette muß ein Begleitzettel beigelegt werden, der einige
+Angaben erneut enthält sowie persönlich unterschrieben ist.  Dieser
+Begleitzettel wird von
+.B dtaus
+automatisch erzeugt und voreingestellt in der Datei
+.B dtaus0.doc
+gespeichert, die nur noch ausgedruckt und unterschrieben werden muß.
+.TP
+4.
+Um den Beleglosen Datenträgeraustausch nutzen zu können, muß vorher
+eine Zusatzvereinbarung mit der Bank getroffen werden.
+.TP
+5.
+Die Angaben zum Verwendungszweck haben sich ausschließlich auf den
+jeweiligen Zahlungsverkehrsvorgang zu beziehen.
+Verwendungszweckangaben dürfen nicht die Übermittlung einer
+gesonderten Nachricht außerhalb des Zahlungsverkehrs (z.B. Rechnung,
+Lohn- und Gehaltsabrechnung) ersetzen.  Werbetexte dürfen in den
+Verwendungszweckangaben nicht enthalten sein.
+.TP
+6.
+Der Kunde ist verpflichtet, den Inhalt der von ihm gelieferten
+Datenträger mindestens für einen Zeitraum von zehn Kalendertagen ab
+Einlieferung in der Form nachweisbar zu halten, daß dem Institut auf
+Anforderung kurzfristig besonders gekennzeichnete Duplikatsdatenträger
+geliefert werden können.
+.TP
+7.
+Der Rückruf eines Datenträgers ist ausgeschlossen, sobald das
+Kreditinstitut mit dessen Verarbeitung begonnen hat.  Einzelne
+Überweisungen und Lastschriften können nach Verarbeitung eines
+Datenträgers nur außerhalb des Datenträgeraustauschverfahrens
+zurückgerufen werden.
+.TP
+8.
+Das Kreditinstitut führt Konsistenzprüfungen der auf dem Datenträger
+gespeicherten Datei durch.  Schlägt diese fehl, können einzelne
+Datensätze von der Bearbeitung ausgeschlossen oder der gesamte
+Auftrag verworfen werden.
+.TP
+9.
+Ergeben sich bei der Kontrolle der Datenträger durch das
+Kreditinstitut Fehler, so wird es die fehlerhaften Datensätze in ihrem
+vollständigen Inhalt nachweisen und sie dem Kunden unverzüglich
+mitteilen.
+.TP
+10.
+Das Kreditinstitut gibt dem Kunden die von ihm erhaltenen Datenträger
+zurück.  Sie können meistens schon am nächsten Werktag in der Filiale
+abgeholt werden.
+.TP
+11.
+Gutschriften und Belastungen, die auf einem an den Kunden
+ausgelieferten Datenträger enthalten sind, werden als Sammelbuchungen
+auf dem Konto des Kunden gebucht.
+.TP
+12.
+In einer Bankdatei kann ein Ausführungsdatum angegeben werden, wenn
+die Bearbeitung der Diskette zu einem späteren Zeitpunkt als der
+Abgabe der Datei gewünscht wird.  Dieses Datum darf jedoch nicht
+jünger als das Erstellungsdatum (wird automatisch von
+.B dtaus
+eingefügt) sein und höchstens 15 Kalendertage über dem
+Erstellungsdatum liegen.
 .SH "RETURN VALUES"
 On success, zero is returned.  On error, 1  is  returned.
-
 .SH "SEE ALSO"
-DTAUS files use a special but simple and freely documented format.
-It is included in the distribution of dtaus as dtaus.txt.
+.BR dtaus (5).
+
+DTAUS files use a special but simple and publically documented format.
+It is included in the distribution of
+.B dtaus
+as
+.IR dtaus.txt .