Converted index() into strchr() which is no Linuxism anymore and also
[infodrom/dtaus] / dtaus.1
1 .\" dtaus - Converter for DTAUS files
2 .\" Copyright (c) 1998,2001  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 1 "17 November 2001" "" ""
19 .SH NAME
20 dtaus \- Converter for DTAUS files
21 .SH SYNOPSIS
22 .B dtaus
23 .RB [ " \-d "
24 .IR dtaus " ]"
25 .RB [ " \-c "
26 .IR control " ]"
27 .RB [ " \-b "
28 .IR begleit " ]"
29 .RB [ " \-o "
30 .IR kontroll " ]"
31 .BR -dtaus " | " -control
32 .SH DESCRIPTION
33 This program can read and write German DTAUS files.  DTAUS is an
34 semi-acronym for 
35 .BR D aten T räger AUS tausch.
36 It is used by German credit institutes in order to manage mass money
37 exchanges between customer accounts and credit institutes.
38
39 Due to its limited availability and usefulness most of the
40 documentation is held in German.  This program is only useful in
41 Germany or for companies that act in Germany.
42
43 For a complete description of the control file please refer to
44 .I dtaus.txt
45 and
46 .BR dtaus (5)
47 from this distribution.
48 .SH OPTIONS
49 You have to specify exactly one of
50 .BR \-dtaus " or " \-control .
51 .TP
52 .B \-dtaus
53 Liest die Kontrolldatei ein und erzeugt daraus die Bankdatei sowie
54 alle anderen benötigten Dateien.
55 .TP
56 .B \-control
57 Liest eine Bankdatei ein und erzeugt daraus die Kontrolldatei,
58 dekodiert eine bereits erstellte Bankdatei.
59 .TP
60 .BI \-d " dtaus"
61 Explizite Angabe des Dateinamens für die Bankdatei.  Voreingestellt
62 ist
63 .BR dtaus0.txt ,
64 was von der Bank als einziger Dateiname auf der Diskette erwartet
65 wird.  Für Testzwecke oder zur Weiterverarbeitung darf hier die
66 spezielle Datei ``-'' angegeben werden, wodurch
67 .B dtaus
68 angewiesen wird, auf die Standardausgabe zu schreiben.
69 .TP
70 .BI \-c " control"
71 Explizite Angabe des Dateinamens der Steuerdatei.  Voreingestellt ist
72 .BR dtaus0.ctl .
73 Da dieser Name jedoch nur intern verwendet wird, ist er keinen
74 Beschränkungen unterlegen.  In dieser Datei befinden sich die gesamten
75 visuell lesbaren Informationen für den Geldverkehr.  Diese Datei muß
76 für die Bank in das spezielle DTAUS-Format konvertiert werden.  Das
77 geschieht mit dem Schalter
78 .BR \-dtaus .
79 .TP
80 .BI \-b " begleit"
81 Explizite Angabe des Dateinamens des Begleitzettels.  Voreingestellt ist
82 .BR dtaus0.doc .
83 Da dieser Name jedoch nur intern verwendet wird, ist er keinen
84 Beschränkungen unterlegen.  Diese Datei muß ausgedruckt und der
85 Diskette unterschrieben beigelegt werden.
86 .TP
87 .BI \-o " kontroll"
88 Explizite Angabe des Dateinamens für die Kontrolldatei.  Voreingestellt ist
89 .BR dtaus0.sik .
90 Da dieser Name jedoch nur intern verwendet wird, ist er keinen
91 Beschränkungen unterlegen.  Es ist ratsam, diese Datei gut
92 aufzubewahren oder auszudrucken und abzuheften.  Dieses ist neben der
93 Steuer- und Bankdatei die einzige Aufschlüsselung des getätigten
94 Geldverkehrs.
95 .SH BESCHREIBUNG
96 Deutsche Banken bieten für Großkunden oder Kunden mit vielen ähnlichen
97 Überweisungen oder Bankeinzügen (auch Lastschriften genannt) die
98 Möglichkeit des papierlosen Geldverkehrs über den Beleglosen
99 Datenträgeraustausch an.  Hierbei wird nicht mehr für jede Überweisung
100 oder jeden Einzug ein eigenes Formular benötigt, sondern
101 zusammengehörige Aufträge werden in einer Massensendung verpackt
102 gemeinsam verarbeitet.
103
104 Hier ist jedoch Vorsicht geboten, denn auf dem eigenen Konto erscheint
105 lediglich eine einzige Kontobewegung.  Wenn Geld eingezogen wird,
106 enthält der Kontoauszug nur die Gesamtsumme, wenn Geld überwiesen
107 wird, ist auf dem Kontoauszug nur die Gesamtsumme notiert.  Es ist
108 daher immens wichtig, die Ursprungsdaten aufzubewahren bzw. die
109 Kontrolldatei auszudrucken und abzuheften.
110
111 Um an diesem Verfahren teilzunehmen, das den Geldverkehr für
112 Organisationen erheblich vereinfachen kann, muß mit der jeweiligen Bank
113 eine gesonderte Vereinbarung getroffen werden, in der die speziellen
114 Bestimmungen für diesen Datenträgeraustausch akzeptiert werden.
115
116 Durch das einfache Format der Steuerdatei läßt sich dieses Verfahren
117 leicht mit einer Datenbank oder einem größeren Programm koppeln.  In
118 der Tat entstand das Programm nach Aufbau des ersten Wohnheimnetzes in
119 Oldenburg (Oldbg.) und der ernüchternden Erkenntnis, daß die vom
120 Kassenwart verwendeten Programme für den Datenträgeraustausch weder
121 zuverlässig noch nachvollziehbar arbeiteten und somit Ersatz
122 geschaffen werden mußte.  Die technische und finanzielle Verwaltung
123 des Wohnheimnetzes fand über ein Linux-System mit Datenbankanbindung
124 sowie
125 .B dtaus
126 statt.
127 .SH BESONDERHEITEN
128 Bei der Verwendung dieses Programms müssen wenigstens die folgenden
129 Dinge beachtet werden, es sind Vorgaben von den beteiligten Banken.
130 .TP
131 1.
132 Die Diskette muß mit dem MSDOS-Dateisystem beschrieben sein.
133 .TP
134 2.
135 Auf einer Diskette darf nur eine einzige DTAUS-Datei enthalten sein,
136 die den Dateinamen
137 .B DTAUS0.TXT
138 trägt.
139 .TP
140 3.
141 Der Diskette muß ein Begleitzettel beigelegt werden, der einige
142 Angaben erneut enthält sowie persönlich unterschrieben ist.  Dieser
143 Begleitzettel wird von
144 .B dtaus
145 automatisch erzeugt und voreingestellt in der Datei
146 .B dtaus0.doc
147 gespeichert, die nur noch ausgedruckt und unterschrieben werden muß.
148 .TP
149 4.
150 Um den Beleglosen Datenträgeraustausch nutzen zu können, muß vorher
151 eine Zusatzvereinbarung mit der Bank getroffen werden.
152 .TP
153 5.
154 Die Angaben zum Verwendungszweck haben sich ausschließlich auf den
155 jeweiligen Zahlungsverkehrsvorgang zu beziehen.
156 Verwendungszweckangaben dürfen nicht die Übermittlung einer
157 gesonderten Nachricht außerhalb des Zahlungsverkehrs (z.B. Rechnung,
158 Lohn- und Gehaltsabrechnung) ersetzen.  Werbetexte dürfen in den
159 Verwendungszweckangaben nicht enthalten sein.
160 .TP
161 6.
162 Der Kunde ist verpflichtet, den Inhalt der von ihm gelieferten
163 Datenträger mindestens für einen Zeitraum von zehn Kalendertagen ab
164 Einlieferung in der Form nachweisbar zu halten, daß dem Institut auf
165 Anforderung kurzfristig besonders gekennzeichnete Duplikatsdatenträger
166 geliefert werden können.
167 .TP
168 7.
169 Der Rückruf eines Datenträgers ist ausgeschlossen, sobald das
170 Kreditinstitut mit dessen Verarbeitung begonnen hat.  Einzelne
171 Überweisungen und Lastschriften können nach Verarbeitung eines
172 Datenträgers nur außerhalb des Datenträgeraustauschverfahrens
173 zurückgerufen werden.
174 .TP
175 8.
176 Das Kreditinstitut führt Konsistenzprüfungen der auf dem Datenträger
177 gespeicherten Datei durch.  Schlägt diese fehl, können einzelne
178 Datensätze von der Bearbeitung ausgeschlossen oder der gesamte
179 Auftrag verworfen werden.
180 .TP
181 9.
182 Ergeben sich bei der Kontrolle der Datenträger durch das
183 Kreditinstitut Fehler, so wird es die fehlerhaften Datensätze in ihrem
184 vollständigen Inhalt nachweisen und sie dem Kunden unverzüglich
185 mitteilen.
186 .TP
187 10.
188 Das Kreditinstitut gibt dem Kunden die von ihm erhaltenen Datenträger
189 zurück.  Sie können meistens schon am nächsten Werktag in der Filiale
190 abgeholt werden.
191 .TP
192 11.
193 Gutschriften und Belastungen, die auf einem an den Kunden
194 ausgelieferten Datenträger enthalten sind, werden als Sammelbuchungen
195 auf dem Konto des Kunden gebucht.
196 .TP
197 12.
198 In einer Bankdatei kann ein Ausführungsdatum angegeben werden, wenn
199 die Bearbeitung der Diskette zu einem späteren Zeitpunkt als der
200 Abgabe der Datei gewünscht wird.  Dieses Datum darf jedoch nicht
201 jünger als das Erstellungsdatum (wird automatisch von
202 .B dtaus
203 eingefügt) sein und höchstens 15 Kalendertage über dem
204 Erstellungsdatum liegen.
205 .SH "RETURN VALUES"
206 On success, zero is returned.  On error, 1  is  returned.
207 .SH "SEE ALSO"
208 .BR dtaus (5).
209
210 DTAUS files use a special but simple and publically documented format.
211 It is included in the distribution of
212 .B dtaus
213 as
214 .IR dtaus.txt .