\documentstyle[german]{report} %\input{amiga} \setlength{\textwidth}{16.5cm} \setlength{\oddsidemargin}{0.0cm} \setlength{\evensidemargin}{0.0cm} \setlength{\topmargin}{0.0cm} \setlength{\footskip}{1.0cm} \setlength{\textheight}{23.0cm} \pagestyle{headings} \sloppy \def\ta{{\large{\sf TheAnswerIII}}} \def\ZER{{\bf ZERBERUS(R)}} \def\znetz{{\it Z--Netz}} \def\zcall{{\it Z--Netz V3.8}} \def\zconnect{{\it ZConnect V3.1}} %\def\Amiga{{\normalsize\sl{ }}{\large\sl A}{\normalsize\sl MIGA}} \def\Amiga{{\sc Amiga}} \def\maps {{\sc Maps}} \begin{document} %---------------------------------------------------------------------------- \begin{titlepage} \vspace*{4cm} \begin{center} {\huge\bf TheAnswer III}\\ {\huge Das Amiga\footnotemark \addtocounter{footnote}{-1} Point--Programm f"ur Z--Netz\footnotemark \addtocounter{footnote}{-1} und ZConnect\footnotemark{} kompatible Datennetze\\ \vspace*{2cm} \footnotetext{Copyrights im Anhang der Hauptdokumentation zu TheAnswerIII} %\addtocounter{footnote}{-1} } {\LARGE Deutsche Dokumentation zu\\ {\Huge\bf TAConvert}\footnote{THE ANSWER ist CardWare und Copyright 1990-1993 bei Toni G"unzel-Peltner}\\ Konvertierprogramm von TheAnswerII nach TheAnswerIII.\\ Version 1.10 vom 20.12.1993\bigskip } {\Large Autor:\\ Toni G"unzel--Peltner\\ Paul-Preuss-Str. 5\\ D--80995 M"unchen\\ \medskip EMail:\\ WEGAR@AMC.ZER\\ WEGAR@AMC.zer.sub.org\\ } \bigskip{\LARGE\bf Nur keine Panik, es sind alles nur Nullen und Einser.} \end{center} \end{titlepage} \tableofcontents %---------------------------------------------------------------------------- \chapter[Einleitung und Allgemeines]{Einleitung und Allgemeines} \section[Das Programm]{Das Programm} \begin{itemize} \item \ta{} ist ein Point--Programm f"ur das \znetz{}. \ta{} ist eine vollst"andig neues Programm, da"s mit seinen Vorg"angern nur noch die Aufgabenstellung gemeinsam hat. \ta{} unterst"utzt die Datenaustauschformate \zcall{} und \zconnect{}. \item Diese Dokumentation behandelt die Funktionsweise von TAConvert, da"s ben"otigt wird, um die alten TheAnswerII-Daten in das Format von \ta{} zu konvertieren. TAConvert kann die Daten von TheAnswerII V2.00, V2.01 und V2.03 in das Format von \ta{} V3.00 konvertieren. \item Was \ta{} ist, wie es arbeitet usw. wird ausf"uhrlich in der Dokumentation zum Hauptprogramm \ta{} erkl"art. \item Man sollte die {\bf Stack--Size} auf mindestens 20000 Byte setzen. \item Dieses Programm ist nur vollst"andig, wenn folgende Files im TAConvert-Paket enthalten sind: \begin{itemize} \item TAConvert-LiesMich.txt \item TAConvert \item TAConvert.info \item TAConvert.dok \item TAConvertHelp \end{itemize} \end{itemize} \section[Das Funktionsprinzip]{Das Funktionsprinzip} TAConvert konvertiert die Konfiguration und die Bretter von TheAnswerII nach \ta{}. Da {\bf alle} Daten kopiert und gespeichert werden, wird auf dem Speichermedium (Disk/Festplatte) f"ur die Konvertierung mindestens so viel Platz ben"otigt, wie gerade f"ur die Daten von TheAnswerII ben"otigt werden. Nach einer erfolgreichen Konvertierung k"onnen die TheAnswerII-Daten gel"oscht werden. \noindent In dieser Dokumentation wird {\bf nicht} auf das Datenforamt eingegangen. Informationen dazu finden sich in der Dokumentation zum Konfigurationsprogramm TAConfig und in der Dokumentation zu Hauptprogramm, \ta{}. \section[Das Copyright]{Das Copyright} \noindent Dieses Programm ist {\bf Cardware}. Es kann von jedermann genutzt werden, solange das Paket vollst"andig bleibt die Nutzung nicht in komerziellen, gewerblichen oder milit"arischen Rahmen geschieht. Das Copyright und Urherberrecht bleibt jedoch allein dem Autor vorbehalten. Diesbez"uglich gelten die einschl"agigen deutschen Gesetze und Rechtsvorschriften.\\ \noindent Alle anderen Copyrights finden sich in der Dokumentation zu \ta{} und gelten uneingeschr"ankt auch f"ur TAConvert.\\ \noindent Der Autor "ubernimmt keinerlei Garantien, da"s TAConvert 100\% funktioniert. Dies gilt f"ur alle Konfigurationen bez"uglich Hard-- oder Software. F"ur Fehler und Sch"aden, die durch TAConvert verursacht wird wird keine Haftung "ubernommen.\\ \noindent Fremde Copyrights, die \ta{} oder diesen Text betreffen, befinden sich im Anhang der Dokumentation des Hauptprogrammes.\\ \section{Die Installation} TAConvert kann grunds"atzlich gestartet und bedient werden, ohne vorher irgendwelche Installationen vornehmen zu m"ussen. Allein die Hilfstexte, die in der Datei ''TAConvertHelp'' zu finden sind, m"ussen an eine Stelle kopiert werden, an der sie TAConvert findet. (Siehe Allgemeines zur Men"uf"uhrung im n"achsten Abschnitt). \noindent Es ist jedoch auch m"oglich, und macht TAConvert komfortabler, wenn mit dem Programm TAConfig {\bf zuerst} eine Konfiguration erstellt und gespeichert wird und diese dann nach dem Start von TAConvert eingeladen wird. \noindent Dies entbindet den Benutzer jedoch nicht davon, nach der Beendigung von TAConvert TAConfig nocheinmal zu starten und alle Konfigurationsdateinen nochmal zu speichern. Das liegt daran, da"s absichtlich alle Konfigurationsdateien, die TAConvert erzeugt mit einem Flag gespeichert werden, da"s verhindet, da"s derart konvertierte Dateien direkt von \ta{} gestartet werden k"onnen. In den allermeisten F"allen mu"s die neue Konfiguration noch an \ta{} angepa"st werden, da die erforderlichen Daten unter TheAnswerII nicht vorhanden sind. \section{Allgemeines zur Menf"uhrung von TAConvert} \subsection{Spezielle Tasten und Gadgets} TAConvert unterst"utzt, im Gegensatz zu \ta{}, selbst keine Tastatur, bis auf folgende Ausnahmen: \begin{itemize} \item Die Pull-Down-Men"us k"onnen mit der im Men"u angegebenen Taste angew"ahlt werden. \item Mit der Tabulator-Taste kann zwischen Stringgadgets hin- und hergesprungen werden. (TAB: vorw"arts, Shift-TAB: r"uckw"arts). \end{itemize} \subsection{Das Hilfssystem} Auf jeder Seite befindet sich ein Gadget, um die Online-Hilfe zu aktivieren. In einem Auswahlfenster k"onnen, nach Aktivierung der Hilfe, Hilfstexte zu bestimmten Stichworten gelesen werden. Voraussetzung daf"ur ist, da"s TAConvert die Datei mit den Hilfstexten findet. TAConvert sucht seine Hilfstextdatei, die ''TAConvertHelp'' heissen mu"s, in folgenden Verzeichnissen: \begin{itemize} \item Im Verzeichnis ''S:'' \item Im Verzeichnis ''ENV:Answer/'' \item In dem Verzeichnis, da"s das aktuelle Verzeichnis war, als TAConvert gestartet wurde. \end{itemize} \subsection[Die Requester]{Die Requester} TAConvert benutzt nur noch Requester des \Amiga{}-Dos. Dabei werden f"ur Fragen Standard--Requester erzeugt und f"ur die Auswahl von Dateien die File--Requester der ASL.library, die ab Kickstart 2.00 zum Standard-Umfang des \Amiga{}-Dos geh"ort. Richtig gut und schnell arbeitet die ASL.library allerdings erst ab der Workbench 2.1.\\ \noindent Das \Amiga{}-Dos unterst"utzt die Tastatur bei einen Requester nur sehr sp"arlich. Intuition-Requester k"onnen standardm"a"sig mit der linken \Amiga{}-Taste und gleichzeitigem dr"ucken von ''v'' mit ''JA'' bzw. von ''b'' mit ''NEIN'' beantwortet werden. Bietet der Requester nur eine Antwort, so ist es egal welche der beiden Tasten gedr"uckt wird. Sind mehr als zwei Antworten m"oglich, bleibt dem Benutzer nur der Griff zur Maus, falls er nicht die linkeste Alternative (v) bzw. die rechteste Alternative (b) w"unscht. \noindent Die ASL-FileRequester haben den gr"o"sten Teil ihrer Befehle in den Gadgets gleichzeitig als Pull-Down-Men"u-Alternativen zur Verf"ugung, die Men"us k"onnen ihrerseits auch mit der Tastatur gesteuert werden.\\ \centerline{{\bf Warum Intuition ?}} \noindent Es ist auch mir bekannt, da"s es einige gute Zusatzbibliotheken gibt, um die eher mageren Requester des \Amiga{}'s aufzupeppen. Gleichzeitig stellte sich aber heraus, da"s jeder eine andere dieser Zusatz--Bibliotheken bevorzugt. Aus diesem Grund wurde keine externe Bibliothek mehr f"ur die Requester benutzt. Diese Entscheidung wurde vor allem dadruch unterst"utzt, da"s die guten Alternativen zu den \Amiga{}-Requestern wie ''ReqTools'' oder ''ARQ'' M"oglichkeiten besitzen, diese \Amiga{}-Requester mit einem System-Patch durch die eigenen zu ersetzen. So kann sich jeder Benutzer seinen eigenen Wunschrequester zusammenstellen, die auch mit der Tastatur oftmals leichter angesprochen werden k"onnen. \subsection{Programmstart per Argument} TAConvert kann sowohl von der Workbench als auch vom Shell aus gestartet werden. TAConvert aktzeptiert dabei {\bf keine} Argumente. Es sind auch keine n"otig. %---------------------------------------------------------------------------- \chapter{Die Konvertierung} \section {Die Hauptseite} Nach dem Programmstart wird man zuerst per Requester gefragt, ob man eine bereits vordefinierte \ta{}-Konfiguration als Grundlage der Konvertierung benutzen will oder nicht. Wird der Requester mit ''JA'' beantwortet, kann per File-Requester eine \ta{}(keine TheAnswerII)-Konfiguration vorgeladen werden. \noindent {\bf WICHTIG:} Wenn mehr als eine TheAnswerII-Konfiguration konvertiert werden soll, so mu"s f"ur die zweite Konfiguration vorher eine \ta{}-Vorgabe mit anderen Filenamen geschaffen werden, da sonst die neue Zweit-Konfiguration die Erst-Konfiguration "uberschreibt. \noindent Dann befindet man sich auf der Hauptseite. Nachfolgend werden die Funktionen beschrieben, die man vom Hauptmen"u aus aufrufen kann. \subsection[Die Gadgets]{Die Gadgets} \indent \begin{tabular}{|lp{10cm}|} \hline Gadget & Erkl"arung\\ \hline Konfiguration konvertieren & Die Daten einer TheAnswerII-Kon\-fi\-gurations\-datei werden konvertiert und in einem \ta{}-Konfigurationsverbund gespeichert.\\ Bretter/Nachrichten konvertieren & Nur aktivierbar, wenn eine The\-AnswerII-Kon\-fi\-gu\-ration mit\-konver\-tiert wird. Alle Bretter und Nachrichten der mitkonvertierten Konfiguration werden im \ta{}-Format gespeichert. Die neuen Daten sollte in einem neuen Verzeichnis gespeichert werden.\\ Unterschriften konvertieren & Nur aktivierbar, wenn eine The\-AnswerII-Kon\-fi\-gu\-ration mit\-konver\-tiert wird. Die Unterschriftendateinen werden konvertiert, und die bislang in der TA2-Konfiguration als Einzeiler gespeicherten Headerzeilen, werden in TA3-Files konvertiert.\\ Adressdatei konvertieren & Eine TheAnswerII-Adressdatei wird ins TheAnswerIII-Format konvertiert. Mit einem Aufruf k"onnen meherere Adressdateien nacheinander konvertiert werden.\\ TheAnswerII-Daten l"oschen & F"uhrt in ein Men"u, von dem aus die meisten TheAnswerII-Daten gel"oscht werden. Dies sollte erst nach einer auf Erfolg gepr"uften Konvertierung erfolgen.\\ Weiter & Die ausgew"ahlten Aktionen werden nacheinander ausgef"uhrt.\\ Hilfe & Das bereits erkl"arte Hilfssystem wird aufgerufen.\\ Ende & TAConvert wird beendet.\\ \hline \end{tabular} \subsection[Die Pull-Down-Men"us]{Die Pull-Down-Men"us} Die Tastaturalternativen f"ur Men"us sind eine Kombination: Rechte \Amiga{}-Taste und die angegebene Taste. {\bf Alle} Seiten haben die gleiche Pull-Down-Men"us. Daher sei mit einem Hinweis auf diese Tabelle dem Thema Pull-Down-Men"us gen"uge getan. \begin{center} \begin{tabular}{|lll|} \hline Men"upunkt & Taste & Erkl"arung\\ \hline {\bf Projekt} & & \\ Info & I & Copyright-Requester\\ Ende & Q & Beendet das Programm.\\ \hline \end{tabular} \end{center} %---------------------------------------------------------------------------- \section{Konfiguration konvertieren} Es wird eine TheAnswerII-Datei eingeladen und konvertiert. Daten, die danach noch ge"andert werden m"ussen, k"onnen im anschlie"senden Men"u editiert werden. Danach wird die neue Konfiguration gespeichert. Falls Bretter/Nachrichten mitkonvertiert werden sollen, geschieht dies zuerst. Die Schritte im einzelnen: \begin{enumerate} \item Das Ausgabefenster wird vergr"o"sert und ein File-Requester wird ge"offnet, um eine TheAnswerII-Konfiguration ausw"ahlen zu k"onnen. \item Die geladene TheAnswerII-Konfiguration wird intern konvertiert. Das Ende wird mit einem Info-Requester mitgeteilt, der noch erkl"art, welche Daten sp"ater von Hand nacheditiert werden m"ussen. \item Es "offent sich ein Men"u in dem die wichtigsten Daten so ver"andert werden k"onnen, da"s sich sp"ater zu konvertierende TheAnswerII-Daten und \ta{}-Daten nicht in die Quere kommen: \begin{tabular}{|lp{12cm}|} \hline Gadget & Erkl"arung\\ \hline Netcallverzeichnis & Hier wird ein vollst"andiger Amiga-Dos-Pfad eingetragen, in dem das Verzeichnis definiert wird, "uber das in Zukunft der Upload/Download beim Netcall laufen soll. F"ur \ta{} sollte ein neues Verzeichnis gew"ahlt werden, da"s sich vom TheAnswerII-Hauptverzeichnis und vom \ta{}-Brett-Verzeichnis unterscheidet. Dieser Pfad kann bei ausreichend viel Speicher auch ein Verzeichnis auf einer RAM-Disk sein.\\ Brettverzeichnis & Hier wird ein vollst"andiger Amiga-Dos-Pfad eingetragen, in dem das Verzeichnis definiert wird, in dem \ta{} in Zukunft alle Bretter und Nachrichten speichern soll. F"ur \ta{} sollte ein neues Verzeichnis gew"ahlt werden, da"s sich vom TheAnswerII-Hauptverzeichnis und vom \ta{}-Netcall-Verzeichnis unterscheidet.\\ Log-Verzeichnis & Hier wird der Pfad f"ur die \ta{}-Logfiles eingetragen. Das \ta{}-interne Format unterscheidet sich von TheAnswerII. Die JRComm- und NComm-kompatiblen Dateien bleiben erhalten. Da das \ta{}-Format einen anderen Filenamen w"ahlt, kommen sich die Log-Files nicht in die Quere.\\ Adressen & Adressdateinen k"onnen nun in einem seperat definierten Verzeichnis liegen. Sie haben ein anderes Format und andere Filenamen. (Sie besitzen nun die Endung ''.ADR'' statt ''.DAT'').\\ Header/Signums & Nicht nur die Unterschriften, auch Daten wie der Weiterleitungskopf oder der Quotekopf werden unter \ta{} in Ascii-Files gespeicehrt, um frei editeirt werden zu k"onnen. Sie m"ussen in einem extra Unterverzeichnis liegen.\\ REQ-Gadget & Neben jedem dieser Eingabefelder findet sich ein REQ-Gadget, um den gew"unschten Pfad auch per File-Requester einstellen zu k"onnen.\\ \hline \end{tabular} \newpage \begin{tabular}{|lp{12cm}|} \hline Gadget & Erkl"arung\\ \hline Modem-Anwahl & Der Anwahlstring f"urs Modem mu"s ge"andert werden. Da unter \ta{} drei Telefonnumern pro Mailbox gespeichert werden k"onnen, mu"s im Anwahlstring die Telefonnumer der Mailbox entfernt werden und druch \%n ersetzt werden.\\ Telefonnummer & Hier wird die bisher im Anwahlstring gespeicherte Telefonnummer angegeben. Weitere Nummern k"onnen mit TAConfig in der Netcall-Konfiguration eingetragen werden.\\ Upload/Download & Hier m"ussen die Daten zum Packen und Entpacken der Upload/Download-Datei eingetragen werden. Die TA2-Daten k"onnen nicht konvertiert werden. Dabei ist zu beachten, da"s eventuelle Batch-Programme jetzt getrennt vom Packeraufruf angegeben werden k"onnen. N"aherer Infos zu den Feldern und Schaltern finden sich in der Dokumentation zu TAConfig, Kapitel ''Netcall-Seite''.\\ Hilfe & Das bereits erkl"arte Hilfssystem wird aufgerufen.\\ Weiter & TAConvert arbeitet mit den so ge"anderten Daten weiter.\\ Abbruch & Die Aktion kann durch Bet"atigung des Close-Gadgets des Windows abgebrochen werden.\\ \hline \end{tabular} \item Wurde ''WEITER'' gew"ahlt wird entweder die Konfiguration gespeichert und ins Hauptmen"u zur"uckgekehrt oder es wird mit dem n"achsten, vom Hauptmen"u aus gew"ahlten, Schritt weitergemacht. \end{enumerate} \section{Bretter und Nachrichten} Diese Funktion kann nur aufgerufen werden, wenn vorher eine TheAnswerII-Konfiguration im gleichen Arbeitsgang konvertiert wurde. \noindent TAConvert konvertiert alle Bretter und Nachrichten automatisch in der Reihenfolge der TA2-Brettliste. Dabei werden alle eingestellten Daten "ubernommen, die in den TA2-Brettern gespeichert sind. Vor der Konvertierung wird ein Brett-Editor-Men"u aufgerufen, in dem alle Parameter eingestellt werden k"onnen, die beim \ta{}-Brett m"oglich sind. Dies beduetet aber nicht, da"s die konvertierten Bretter mit diesen Daten gef"ullt werden. Es werden nur Daten aus der editierten Vorgabe benutzt, die unter TheAnswerII noch unbekannt waren. Die Einstellungen dieser Vorgabe werden in der neuen Konfiguration als Brettvorgabe f"ur die Zukunft gespeichert. Die Schritte im einzelnen: \begin{enumerate} \item Der Bretteditor wird ge"offnet. Er entspricht im Wesentlichen dem Bretteditor f"ur das Programm TAConfig. Diesem Men"u ist daher in der TAConfig-Dokumentation ein vollst"andiges und sehr ausf"uhrliches Kapitel gewidmet: ''Die Brettvorgabe'' \item Nachdem alle Einstellungen im Bretteditor gemacht wurden, beginnt TAConvert alle Bretter und Nachrichten zu konvertieren und in den neuen Verzeichnissen zu speichern. Da alle Nachrichten in ein neues Format konvertiert werden und neuen Index-Dateien generiert werden m"ussen, kann das bei vielen langen Brettern etwas dauern. Die Konvertierung kann jederzeit, durch Dr"ucken des Close-Gadgets des Windows, abgebrochen werden. \noindent {\bf WICHTIG:} TAConvert kann eine TA2-Brettstruktur nur auf einmal konvertieren. Wird die Konvertierung abgebrochen, oder aufgrund eines Fehlers vorzeitig beendet, so mu"s die Brettliste {\bf vollst"andig} neu konvertiert werden. \item Nach Beendigung der Konvertierung folgen zwei Hinweis-Requester. Anschlie"send wird die neue Konfiguration gespeichert oder mit dem n"achsten Punkt weitergemacht. \end{enumerate} \section{Unterschriften} Diese Funktion kann nur aufgerufen werden, wenn vorher eine TheAnswerII-Konfiguration im gleichen Arbeitsgang konvertiert wurde. \noindent TAConvert kopiert die beiden Unterschriftenfiles und das Cookie-File unter neuem Namen ins neuen Unterschriftenverzeichnis. \noindent Die Zeilendefinitionen f"ur Quote-K"opfe und Lese-Header aus der TheAnswerII-Konfiguration werden in die neuen Header-Files, die daf"ur unter \ta{} benutzt werden konvertiert und kopiert. \noindent Anschlie"send wird die neue Konfiguration gespeichert oder mit dem n"achsten Punkt weitergemacht.\\ \noindent {\bf Hinweis:} \ta{} unterst"utzt bedeutend mehr M"oglichkeiten und Variationen bei Headern als das TheAnswerII tat. Diese neuen M"oglichkeiten k"onnen bei einer Konvertierung nicht ber"ucksichtig werden. Mit dem Programm TAConfig werden Muster-Header in Deutsch und Englisch mitgeliefert, die man als Alternative in Betracht ziehen sollte. \section{Adressen} Eine TheAnswerII-Adressdatei wird per File-Requester eingeladen und, ebenfalls per File-Requester, im TheAnswerIII-Format gespeichert. Wurde vorher eine TheAnswerII-Konfiguration im gleichen Arbeitsgang konvertiert, sind die Zielpfade bereits richtig eingestellt, andernfalls m"ussen die alten Dateien gefunden werden und die neuen Dateien im Adressen-Verzeichnis der zuk"unftigen \ta{}-Konfiguration gespeichert werden. Es ist zu beachten, da"s \ta{}-Adressdateien mit dem K"urzel ''.ADR'' enden sollten. \noindent Nach jeder Konvertierung wird man gefragt, ob eine weitere Adressdatei konvertiert werden soll. Zumindest sollten jedoch die Datei ''ADRESS.DAT'' nach ''ADRESS.ADR'' und die Datei ''FILTER.DAT'' nach ''FILTER.ADR'' konvertiert werden. \section{TheAnswerII-Daten l"oschen} In einem Men"u kann ausgew"ahlt werden, welche Dateien von TheAnswerII gel"oscht werden. Dabei werden immer die Daten einer zugeh"origen Konfiguration gel"oscht. Daher k"onnen die unteren Gadgets nur aktiviert werden, wenn eine TheAnswerII-Konfig-Datei gel"oscht wird. \noindent Nach Aktivierung von ''L"OSCHEN'' werden die aufgelisteten Daten von der Disk/Festplatte entfernt. ''HILFE'' aktiviert die bekannte Online-Hilfe und ''ABBRECHEN'' kehrt zu Hauptmen"u zur"uck. \end{document}