##### ##### # ##### ##### # # # # #### #### # # # # # # # ## # # # # # # # # # ### # ### # # # # # # #### # # # # # # # ## # # # # # # # ##### ##### ##### ##### # # # # # #### # # # Telefonnummern- und Adressenverzeichnis Copyrights by Andreas Mandel @ OG Version 2.10 01.03.1994 >>>> F A I R W A R E <<<< Programmiert mit PURE C (Dokumentation und ChefBetaTester: Alexander Gth @ Wš) EINLEITUNG / FUNKTIONSPRINZIP ---------------------------------------------------------------------------- TELEINX.CPX, ist ein CPX-Modul, welches mit dem modularen Kontrollfeld von ATARI (XCONTROL), benutzt werden kann. Mit TELEINX.CPX kann man Telefon- nummern und Adressen auf einfache Art zum Abruf bereit stellen. Die Telefonnummern k”nnen dazu in einer einfachen ASCII Datei gespeichert oder z.B. aus einer bestehenden Datenbank exportiert werden. Und das beste, TELEINX erlaubt es Telefonnummer ber das Modem zu w„hlen, also kein auswendiglernen mehr oder Notizbuch suchen ! LAUFFŽHIGKEIT ---------------------------------------------------------------------------- TELEINX.CPX sollte dank des modularen Kontrollfeldes von ATARI auf allen Rechnern/TOS-Version (>=1.04) und in allen Aufl”sungen (ST-LOW bis TT-HIGH) sowie Grafikkarten laufen. TELEINX.CPX ben”tigt im aktiven Betriebszustand, d.h. wenn es vom Kontroll- feld aufgerufen wird oder auch resident geladen wird, ca. 12 KB Speicher und je nach Einstellung des File-Puffers ca. 1-999 KB zus„tzlichen Datenpuffer. Im passiven Betriebszustand, d.h. nicht resident im Kontrollfeld und nicht gestartete CPX-Application, ben”tigt TELEINX.CPX nur 512 Bytes (!!!), d.h. nur der CPX-Header ist geladen :-). LIEFERUMFANG ---------------------------------------------------------------------------- Das Softwarepaket besteht aus folgenden Dateien: TELEINX .CPX : CPX-Modul TELEINX .TXT : Diese Anleitung TELEBSP .TXT : Eine Beispielnummern Datei TELEINX .UPL : Uploadtext fr Mailboxen Eine Weitergabe des unvollst„ndigen Softwarepaketes ist untersagt !!! COPYRIGHT ---------------------------------------------------------------------------- TELEINX.CPX ist FAIRWARE, d.h. o Sie drfen TELEINX.CPX beliebig weitergeben, jedoch muž stets der Inhalt des Ordners TELEINX KOMPLETT und UNVERŽNDERT kopiert werden. Krzungen und Žnderungen verletzen die Copyright-Bestimmungen! o Wenn Sie SPOOL regelm„žig benutzen, so sollen Sie einen Fairware-Betrag entrichten und werden im Gegenzug registrierter Anwender. Weiterhin erhalten Sie dann gegen Einsendung einer formatierten Diskette mit frankiertem Rckumschlag die neuesten Version sowie weiteren Tools. Eine Verbreitung ber Mailboxen ist gestattet. Der Vertrieb in Verbindung mit kommerzieller Software oder ber PD/Shareware-Anbieter ist nur nach vorheriger Absprache erlaubt. (Verst”že werden geahndet !!!) Fehlerberichte, Fragen und Unterstzungen sind mir immer willkommen. Postanschrift: Andreas Mandel Postfach 26 77799 Ortenberg E-Mail : Andreas_Mandel@og.maus.de am@zrz.fh-furtwangen.d400.de MausNet: Andreas Mandel @ OG Bankverbindung: Volksbank Offenburg Kto.Nr. 6478 4307 BLZ 664 900 00 UPDATE / UPGRADE ---------------------------------------------------------------------------- Die neueste Version von TELEINX, gibt es immer a) in der Maus OG (0781-38807) im ”ffentlichem Programmteil unter dem Namen "TELE*.*" b) gegen Einsendung einer Diskette zusammen mit einem ausreichend frankierten und an Sie adressierten Rckumschlag HAFTUNGSAUSSCHLUž ---------------------------------------------------------------------------- Natrlich kann die Funktionsf„higkeit des CPX-Moduls nicht garantiert werden und der Autor haftet auch nicht fr irgendwelche Sch„den, die sich aus der Benutzung des Programmes oder der Dokumentation ergeben k”nnen. INSTALLATION ---------------------------------------------------------------------------- - Kopieren Sie TELEINX.CPX in den CPX-Ordner von XCONTROL (ATARI) - Aktivieren Sie das XCONTROL.ACC, d.h. Endung = .ACC - Booten Sie den Rechner neu oder laden Sie im XCONTROLL.ACC unter dem Menpunkt "Voreinstellungen" die CPX-Module neu ein. - Rufen Sie TELEINX.CPX auf (Doppelklick auf "Telefonbuch" ) - Klicken Sie auf das PupUp-Men "Optionen" und w„hlen Sie den Menpunkt "Datenbank Setup..." aus. - Klicken Sie auf die Pfadzeile. Es ”ffnet sich nun eine Fileselectorbox, in welcher Sie den Pfad zu der Telefonnummerndatei (z.B. TELEBSP.TXT) festlegen/einstellen k”nnen. - Klicken Sie "Sichern" um den Pfad+Datei im CPX-Modul zu sichern. - Klicken Sie "OK" und Sie kommen wieder ins Hauptmen - ... und jetzt kann's los gehen :-) START / BEDIENUNG ---------------------------------------------------------------------------- Nach ”ffenen des modularen Kontrollfeldes von ATARI, kommen Sie mit Doppelklick auf den Eintrag "Telefonbuch" in das Hauptanzeigefeld von TELEINX.CPX. Wie Sie erkennen k”nnen, benutzt TELEINX.CPX eine Menleiste, welche wie bei vielen anderen GEM-Programmen zu bedienen ist. Unterhalb der Menleiste, k”nnen Sie die Namen und Telefonnummern der aktuellen Telefonnummerndatei betrachten (Hauptanzeigefeld). Tastatur-Shortcuts ------------------ Seit Version 2.10 untersttzt TELEINX Let'em Fly, womit alle Menleisten Dialoge und Datens„tze ber Tastatur-Shortcuts bedient werden k”nnen. Einfach die Alternate-Taste in Verbindung mit dem unterstrichenen Buchstaben drcken, also z.B. ALT-I fr Men-Index. Beginnen wir mit der Menleiste: CPX === Info ---- Nach bet„tigen dieses Meneintrages, kommen Sie in einen Dialog, in welchem sich die Copyrighthinweise, sowie die aktuellen Versionsdaten zum CPX-Modul befinden. Quit ( OK ) ----------- šber diesen Meneintrag kann das CPX-Modul verlassen werden. Dieser Button hat den selben Effekt wie der Button OK, unterhalb des Hauptanzeigefeldes. Optionen ======== Datenbank Setup --------------- o File Puffer in KiloByte (KB) Hier haben Sie die M”glichkeit einzustellen, wieviel Speicher TELEINX fr die zu ladende Adressendatei bereitstellen soll. Ist die Adressendatei gr”žer als der unter File Puffer eingestellte Wert, l„d Teleinx immer den ben”tigten Teil nach. Dies fhrt natrlich zu h„ufigen Lesezugriffen und verlangsamt Scroll- und Suchaktionen. o Schrift Hier k”nnen Sie den Schrifttyp (Grož, klein) w„hlen, mit welchem im Hauptanzeigefeld die Datens„tze angezeigt werden sollen. o Telefonverzeichnis Datei Durch Klick auf die Pfadzeile bekommen Sie die Fileselectorbox, mit welcher Sie den Pfad sowie die aktuelle Telefonnummerndatei ausw„hlen, einstellen k”nnen. o Sichern Durch Anwahl von "Sichern" werden die vorgenommen Einstellungen dauerhaft in TELEINX.CPX gespeichert. o OK - best„tigen der letzten Žnderungen/Eingaben o Abbruch - verwerfen der letzten Žnderungen/Eingaben Modem Setup ----------- o Modem Hier werden die an das Modem zu sendende Steuercodes eingestellt, welche das Modem dazu veranlassen die angezeigte/ausgew„hlte Telefonnummer zu w„hlen. Parameter: # = Telefonnummer | = CR (Return) ~ = Pause von 0.5 sek. beim senden der Steuerzeichen [ = DTR on (DATA Terminal Ready) ] = DTR off Natrlich k”nnen auch Modemeigene Parameter verwendet werden, sowie CTRL-M als CR Ersatz geht auch ! Init - Anwahlparameter zum Modem hier hat sich folgender Anwahlstring als gnstig erwiesen: ATZ|~~~ATL2DT#| ATZ = Modem Reset ATL2 = Modem Lautsprecher auf Lautst„rke 2 DT = Dial Tone (bei Bedarf auf Pulswahl umstellen = DP) Exit - Auflegeparameter zum Modem hier hat sich folgender Auflegstring als gnstig erwiesen ATH|~ ATH = Off Hook (= Modem legt auf) falls das Modem es verkraftet geht auch "ATZ|~" Repeat - Wahlwiederholung zum Modem Falls das Telefon des gewnschten Partners besetzt ist, erkennt das Modem ein BUSY (= Besetztzeichen). TELEINX bietet nun die M”glichkeit an das Modem einen Repeatstring zu senden, welches auch die meisten Modems verstehen (Hayes-Standart) und zu einer Wahlwiederholung fhrt: A>~ = Letzter Befehl ("ATDT#|") einmal wiederholen, die zuletzt gew„hlt Nummer bis zu neun Mal erneut anw„hlen (die Anzahl der Versuche ist vom Modem/Staat abh„ngig) Alternativen: A/~ = Letzter Befehl einmal wiederholen ATDL~ = Dial Last = einmalige Wahlwiederholung ATDT#~ = siehe "ATDL" o Schnittstelle Diese PopUpMen dient zur Einstellung/Ver„nderung des Ausgabekanals/ Schnittstelle an welche TELEINX.CPX die Modemparameter/Steuercodes senden soll. Es gibt 10 verschiedene Schnittstellenm”glichkeiten: - PRN (Paralelle, meist Drucker !) - AUX (Serielle, aktueller Ausgabekannal, welcher ber das SERIELL.CPX-Modul eingeschaltet/deffiniert ist.) - CON (Bildschirm (mit VT52), direkt !) - MIDI (MIDI) - IKBD (Input Keyboard) - RAWCON (Bildschirm (ohne VT52), direkt) - Modem 1 (only Atari STE/TT) - Modem 2 (only Atari STE/TT) - Seriell 1 (only Atari STE/TT) - Seriell 2 (only Atari STE/TT) Online-Screen -------------- Der Button vor dem PopUpMen Schnittstelle, dient zum ein und aus- schalten der ONLINE-Screen Anzeige (W„hldialog). On (schwarz) = w„hrend der Anwahl werden die aktuellen Meldungen zum und vom Modem angezeigt (AT-Kommandos) Off (weiž) = Anzeige deaktiviert (bei St”rung mit Terminalprogramm) o Sichern Durch Anwahl von "Sichern" werden die vorgenommen Einstellungen dauerhaft in TELEINX.CPX gespeichert. o OK - best„tigen der letzten Žnderungen/Eingaben o Abbruch - verwerfen der letzten Žnderungen/Eingaben Index ===== Durch Anwahl dieses Menpunktes ”ffnet sich ein PopUpMen (Buchstaben A-Z, ? und ! ). Um Adressen abzurufen, w„hlen Sie einfach den den Anfangs- buchstaben des gesuchten Namens. Die gew„hlten Adressen mit dem ent- sprechenden Anfangsbuchstaben werden darauf sofort im Hauptanzeigefeld angezeigt. Ist kein passender Eintrag vorhanden wird an den Anfang der Adresskartei im Hauptanzeigefeld gesprungen. Aufbau: A-Z: Eintr„ge mit Anfangsbuchstaben von A-Z ?: Eintr„ge mit anderen Anfangsbuchstaben (Sonderzeichen, Umlaute) !: Eintr„ge mit dem Anfangsbuchstaben "!" (Dieser Eintrag ist gedacht fr Notrufnummern wie die Feuerwehr, Polizei, Notruf, Žrzte, uva.) Autolocater (Tastaturbedienung) ----------- Als Alternative zum Direktsprung ber Index, wurde ein Tastatur Auto- locater eingebaut. Man kann ber die Eingabe des Anfangsbuchstaben des gesuchten Datensatzes, direkt zum ersten gefunden Datensatz springen. Hierbei ver„ndert sich die Titelzeile des CPX-Moduls von 'Teleinx' auf z.B. 'Teleinx "M"', bei Eingabe des Zeichens 'M'. Ein weiterer Buchstabe wird akzeptiert, wenn einen dazu passender Datensatz vorhanden ist, also z.B. 'Teleinx "MA"' fr 'Mandel'. L”schen kann man den Autolocaterspeicher mit BACKSPACE oder ber Direkt- sprung durch das Index-Men. Hauptanzeigefeld ---------------- Sofort nach dem ”ffnen des CPX-Modules k”nnen Sie das Hauptanzeigefeld in Form einer Listenausgabe der Adressen erkennen. Hier k”nnen Sie die Adressen im folgendem Format betrachten: 1. Zeile: Namen des 1. Adresseneintrages (linksbndig) 2. Zeile: dazugeh”rige Telefonnumer (rechtsbndig) 3. Zeile: Namen des 2. Adresseneintrages (linksbndig) 4. Zeile: dazugeh”rige Telefonnumer (rechtsbndig) .... usw. Sind mehr als 4/8 (Schrift: Grož/klein) Eintr„ge vorhanden, so k”nnen Sie mit dem Slider auf der rechten Seite durch die Eintr„ge bl„ttern. Durch selektieren eines Eintrages (Name oder Telefonnummer) in der Listenanzeige, ”ffnet sich eine PopUpMen, mit welchem Sie folgende Auswahlm”glichkeiten besitzen: Anzeigen -> Maskenanzeige (detailierte Anzeige des Datensatzes) W„hlen -> Anw„hlen des selektierten Gespr„chpartners (Modem) Befinden Sie sich in der Maskenanzeige und selektieren Sie hier den Datensatz, ”ffnet sich folgendes PopUpMen: Liste -> zurck zur Listenanzeige W„hlen -> Anw„hlen des selektierten Gespr„chspartners (Modem) W„hlvorgang ----------- Haben Sie eine Datensatz selektiert und im PopUpMen "W„hlen" ausgew„hlt kommen Sie in den W„hldialog. Oben k”nnen Sie nochmal den gew„hlten Datensatz mit Name und Telefon- nummer des gewnschten Gepr„chspartners erkennen. Unten sehen Sie den ONLINE-Screen, in welchem alle Modem-Kommandos und Antworten angezeigt/beobachtet werden k”nnen, falls der Schalter unter Modem Setup auf ON steht. TELEINX.CPX beginnt sofort mit dem W„hlvorgang (Senden von Modem INIT) o Auflegen (Senden von Modem EXIT) Kommt eine Verbindung zustande, nehmen Sie den Telefonh”rer ab und bet„tigen Sie 'Auflegen' = RETURN o Repeat (Senden von Modem REPEAT) Ist die Telefonnummer des gewnschten Gespr„chspartners belegt (BUSY), k”nnen Sie durch bet„tigen von REPEAT eine Wahlwiederholung ausl”sen. Kommt nach mehrmaliger Anwahl eine Verbindung zustande, nehmen Sie den Telefonh”rer ab und bet„tigen Sie 'Auflegen' = RETURN o Abbruch - verlassen des W„hlvorganges ohne weiter Aktivit„ten DAS FORMAT DER TELEFONNUMMERN DATEI ---------------------------------------------------------------------------- Die Telefonnummern Datei ist denkbar einfach aufgebaut, ein erstellen per Editor oder als Export aus einem Datenbank-Programm sollte keine Probleme bereiten. Datensatzaufbau: 1. Datenfeld: Namen (Name, Vorname) 2. Datenfeld: Telefonnummer 3-8. Datenfeld: Frei deffinierbar Trenner: Datenfelder = "|" Datens„tze = CR LF (Return + LineFeed) Grenzen: o Datenfeld max. 28 Zeichen (Grožer Zeichensatz) max. 36 Zeichen (Kleiner Zeichensatz) sind mehr angegeben werde diese ignoriert/nicht angezeigt o pro Datensatz max. 8 Datenfelder sind mehr angegeben werden dies ignoriert/nicht angezeigt Zu beachten ist, beim Export von Adressen aus Datenbanken (Ph”nix, Datamat, Adimens, Twist, uva.), das TELEINX.CPX beim einlesen der Daten alle Zeichen bernimmt, also auch st”rende Leerzeichen. Diese mssen Sie entweder selbst entfernen oder entfernen lassen. Dies ist deswegen so, damit n”tige Formatierungen von Eintr„gen m”glich sind. Desweiteren sollten die Adressen von A nach Z sortiert sein, damit TELEINX bei seinen Suchaktionen immer alle Datens„tze findet ! Wrde n„mlich "Mandel" vor "Albert" stehen, f„nde TELEINX nie "Albert". Beispiel: Mandel, Andreas|9876-56789|Postfach 26|77799 Ortenberg|Maus OG Gth, Alexander|1234-56789|Himmelsleiter 7411|2001 Odysee|Fax 334499 BEKANNTE BESCHRŽNKUNGEN / BUGs ---------------------------------------------------------------------------- o Keine Fehlerkorrekturen Das Programm schickt keine Fehlermeldungen. Falls also irgendwas nicht so funktioniert oder l„uft wie es sollte, berprfen Sie zuerst die eingestellten Parameter (Pfad der Telefondatei) sowie den Datenaufbau der Telefondatei. o TELEINX.CPX funktioniert nur dann, wenn das Telefon entweder hinter oder parallel zum Modem h„ngt. o In TELEINX ist keine automatische Sortierung der Adressdaten eingebaut ! Entweder macht das schon die Datenbank, aus welcher die Daten kommen, oder Sie benutzen ein geeignetes Programm dazu. TIPs und KNIFFE ---------------------------------------------------------------------------- o Wunderbar l„žt ich auch TELEINX.CPX als Hintergrunddialer fr Mailboxen verwenden. Einfach z.B. MAUS.DAT laden (MausNet-Mailboxen) und die ge- wnschte Maus anw„hlen lassen. Ist diese besetzt, einfach REDIAL starten. Im Vordergrund kann man bequem in seiner Textverarbeitung oder sonst. Application weiterarbeiten. Kommt eine Verbindung zustande (man h”rt das :-) ), ist angesagt, ent- weder die Application schnell zu verlassen (Sichern der Daten nicht ver- gessen !!!) und in das Terminalprogramm (CoNnect, Rufus) zu gehen, oder auch ein Terminalprogramm als Accessory (Harlekin) aufzurufen. Unter MultiTOS oder MAGIC! ist das natrlich viel sch”ner, da muž man nur die laufende Application wechseln :-). HISTORY ---------------------------------------------------------------------------- ?????.92 V2.00 pro Datensatz sind jetzt 8 Felder m”glich. 10.02.93 V2.01 Bug, der uU die RSC-Texte von Teleinx ,,krzte'' gefixt. 20.04.93 V2.05 Kleine Bugfixes, Umgestellt auf "Men-CPX", Modem-Dialer. 01.06.94 V2.10 - Autolocater eingebaut - ONLINE-Screen eingebaut (Modem Aktionen) - Nun wird die gesammte Adressdatei geladen und man kann von A-Z scrollen ... Direktsprung mit Autolocater oder Men-Index. - Let'em Fly untersttzung (Mens und Dialoge sind nun ber Shortcuts erreichbar) - DTR on/off Einstellm”glichkeiten bei Modem-Kommandos grožen Dank an Wolfgang Wander. 24.06.94 V2.11 Der Speicher fr die Telefonnummern wurde nicht freigegeben TNX an Frank Rger