.\" dtaus - Converter for DTAUS files
-.\" Copyright (c) 1998 Martin Schulze <joey@infodrom.north.de>
+.\" 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
.\" 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
.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.
+It is used by German credit institutes in order to manage mass money
+exchanges between customer 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
-
- -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 \-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 .
projects / infodrom / dtaus / blobdiff