
      ##### #####  #     ##### ##### #   # #   #     ####  ####  #   #
        #   #      #     #       #   ##  #  # #     #      #   #  # #
        #   ###    #     ###     #   # # #   #      #      ####    #
        #   #      #     #       #   #  ##  # #     #      #      # #
        #   #####  ##### ##### ##### #   # #   #  #  ####  #     #   #



                  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 knnen 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 whlen,
  also kein auswendiglernen mehr oder Notizbuch suchen !


  LAUFFHIGKEIT
  ----------------------------------------------------------------------------

  TELEINX.CPX sollte dank des modularen Kontrollfeldes von ATARI auf allen
  Rechnern/TOS-Version (>=1.04) und in allen Auflsungen (ST-LOW bis TT-HIGH)
  sowie Grafikkarten laufen.

  TELEINX.CPX bentigt 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 zustzlichen Datenpuffer.

  Im passiven Betriebszustand, d.h. nicht resident im Kontrollfeld und nicht
  gestartete CPX-Application, bentigt 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 unvollstndigen 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 UNVERNDERT kopiert werden. 
    Krzungen und nderungen verletzen die Copyright-Bestimmungen!

  o Wenn Sie SPOOL regelmig 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. (Verste 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 Funktionsfhigkeit des CPX-Moduls nicht garantiert
  werden und der Autor haftet auch nicht fr irgendwelche Schden, die sich
  aus der Benutzung des Programmes oder der Dokumentation ergeben knnen.


  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 whlen 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 knnen. 
  - 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 knnen, benutzt TELEINX.CPX eine Menleiste, welche wie 
  bei vielen anderen GEM-Programmen zu bedienen ist. 

  Unterhalb der Menleiste, knnen 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 Datenstze ber Tastatur-Shortcuts bedient werden knnen. 
  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 bettigen 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 Mglichkeit einzustellen, wieviel Speicher TELEINX
    fr die zu ladende Adressendatei bereitstellen soll.
    Ist die Adressendatei grer als der unter File Puffer eingestellte 
    Wert, ld Teleinx immer den bentigten Teil nach. Dies fhrt natrlich
    zu hufigen Lesezugriffen und verlangsamt Scroll- und Suchaktionen.
  
  o Schrift
  
    Hier knnen Sie den Schrifttyp (Gro, klein) whlen, mit welchem im
    Hauptanzeigefeld die Datenstze angezeigt werden sollen.
  
  o Telefonverzeichnis Datei

    Durch Klick auf die Pfadzeile bekommen Sie die Fileselectorbox, mit 
    welcher Sie den Pfad sowie die aktuelle Telefonnummerndatei auswhlen,
    einstellen knnen.
    
  o Sichern
    
    Durch Anwahl von "Sichern" werden die vorgenommen Einstellungen dauerhaft
    in TELEINX.CPX gespeichert.
    
  o OK        -  besttigen 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/ausgewhlte Telefonnummer zu 
    whlen.
    
    Parameter:
      # = Telefonnummer
      | = CR (Return)
      ~ = Pause von 0.5 sek. beim senden der Steuerzeichen
      [ = DTR on  (DATA Terminal Ready)
      ] = DTR off
  
          Natrlich knnen 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 Lautstrke 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 
           Mglichkeit 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
                 gewhlt Nummer bis zu neun Mal erneut anwhlen (die 
                 Anzahl der Versuche ist vom Modem/Staat abhngig)
          
           Alternativen:
          
           A/~ = Letzter Befehl einmal wiederholen
          
           ATDL~ = Dial Last = einmalige Wahlwiederholung
          
           ATDT#~ =  siehe "ATDL"
          
          
  o Schnittstelle
    
    Diese PopUpMen dient zur Einstellung/Vernderung des Ausgabekanals/
    Schnittstelle an welche TELEINX.CPX die Modemparameter/Steuercodes 
    senden soll.

    Es gibt 10 verschiedene Schnittstellenmglichkeiten:

    - 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 (Whldialog). 
    
    On (schwarz) = whrend der Anwahl werden die aktuellen Meldungen
                   zum und vom Modem angezeigt (AT-Kommandos)
    Off (wei)   = Anzeige deaktiviert (bei Strung mit Terminalprogramm)

  o Sichern
    
    Durch Anwahl von "Sichern" werden die vorgenommen Einstellungen dauerhaft
    in TELEINX.CPX gespeichert.
  
  o OK        -  besttigen 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, whlen Sie einfach den den Anfangs-
  buchstaben des gesuchten Namens. Die gewhlten 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: Eintrge mit Anfangsbuchstaben von A-Z
    ?: Eintrge mit anderen Anfangsbuchstaben (Sonderzeichen, Umlaute)
    !: Eintrge 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 verndert 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'. 

  Lschen kann man den Autolocaterspeicher mit BACKSPACE oder ber Direkt-
  sprung durch das Index-Men.   
  
  
  Hauptanzeigefeld
  ----------------
  Sofort nach dem ffnen des CPX-Modules knnen Sie das Hauptanzeigefeld in
  Form einer Listenausgabe der Adressen erkennen.
  
  Hier knnen Sie die Adressen im folgendem Format betrachten:
  
    1. Zeile: Namen des 1. Adresseneintrages   (linksbndig)
    2. Zeile:      dazugehrige Telefonnumer   (rechtsbndig)
    3. Zeile: Namen des 2. Adresseneintrages   (linksbndig)
    4. Zeile:      dazugehrige Telefonnumer   (rechtsbndig)
     .... usw.
  
  Sind mehr als 4/8 (Schrift: Gro/klein) Eintrge vorhanden, so knnen Sie
  mit dem Slider auf der rechten Seite durch die Eintrge blttern.
  
  Durch selektieren eines Eintrages (Name oder Telefonnummer) in der 
  Listenanzeige, ffnet sich eine PopUpMen, mit welchem Sie folgende
  Auswahlmglichkeiten besitzen:
  
    Anzeigen -> Maskenanzeige    (detailierte Anzeige des Datensatzes)
    Whlen   -> Anwhlen des selektierten Gesprchpartners     (Modem)
  
  Befinden Sie sich in der Maskenanzeige und selektieren Sie hier den 
  Datensatz, ffnet sich folgendes PopUpMen:
  
    Liste    -> zurck zur Listenanzeige
    Whlen   -> Anwhlen des selektierten Gesprchspartners    (Modem)
  
  
  Whlvorgang
  -----------
  Haben Sie eine Datensatz selektiert und im PopUpMen "Whlen" ausgewhlt
  kommen Sie in den Whldialog.
  
  Oben knnen Sie nochmal den gewhlten Datensatz mit Name und Telefon-
  nummer des gewnschten Geprchspartners erkennen.
  
  Unten sehen Sie den ONLINE-Screen, in welchem alle Modem-Kommandos und
  Antworten angezeigt/beobachtet werden knnen, falls der Schalter unter
  Modem Setup auf ON steht.  
  
  TELEINX.CPX beginnt sofort mit dem Whlvorgang (Senden von Modem INIT)
  
  o Auflegen  (Senden von Modem EXIT)
  
    Kommt eine Verbindung zustande, nehmen Sie den Telefonhrer ab und
    bettigen Sie 'Auflegen' = RETURN
  
  o Repeat    (Senden von Modem REPEAT)
  
    Ist die Telefonnummer des gewnschten Gesprchspartners belegt (BUSY),
    knnen Sie durch bettigen von REPEAT eine Wahlwiederholung auslsen.
    Kommt nach mehrmaliger Anwahl eine Verbindung zustande, nehmen Sie den
    Telefonhrer ab und bettigen Sie 'Auflegen' = RETURN
    
  o Abbruch   -   verlassen des Whlvorganges ohne weiter Aktivitten
  

  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 = "|"
    Datenstze  = CR LF (Return + LineFeed)
    
  Grenzen:
  
    o  Datenfeld max. 28 Zeichen (Groer 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 (Phnix, Datamat,
  Adimens, Twist, uva.), das TELEINX.CPX beim einlesen der Daten alle Zeichen
  bernimmt, also auch strende Leerzeichen. Diese mssen Sie entweder selbst
  entfernen oder entfernen lassen. Dies ist deswegen so, damit ntige
  Formatierungen von Eintrgen mglich sind. 
  
  Desweiteren sollten die Adressen von A nach Z sortiert sein, damit TELEINX
  bei seinen Suchaktionen immer alle Datenstze findet ! Wrde nmlich
  "Mandel" vor "Albert" stehen, fnde 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 BESCHRNKUNGEN / BUGs
  ----------------------------------------------------------------------------

  o Keine Fehlerkorrekturen
  
    Das Programm schickt keine Fehlermeldungen. Falls also irgendwas nicht
    so funktioniert oder luft 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 hngt.
    
  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 lt ich auch TELEINX.CPX als Hintergrunddialer fr Mailboxen
    verwenden. Einfach z.B. MAUS.DAT laden (MausNet-Mailboxen) und die ge-
    wnschte Maus anwhlen lassen. Ist diese besetzt, einfach REDIAL starten.
    Im Vordergrund kann man bequem in seiner Textverarbeitung oder sonst.
    Application weiterarbeiten.
    Kommt eine Verbindung zustande (man hrt 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 schner, da mu man 
    nur die laufende Application wechseln :-).


  HISTORY
  ----------------------------------------------------------------------------

?????.92  V2.00   pro Datensatz sind jetzt 8 Felder mglich.
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 Einstellmglichkeiten bei Modem-Kommandos
                    groen Dank an Wolfgang Wander.
24.06.94  V2.11   Der Speicher fr die Telefonnummern wurde nicht 
                   freigegeben TNX an Frank Rger                    
