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



                  Telefonnummern- und Adressenverzeichnis


                             Copyrights by

                          Andreas Mandel @ OG

                             Version 2.05

                              20.04.1993


                       >>>>  F R E E 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 der max. Eintrge ca. 1-20 KB zustzlichen Daten-
  speicher.

  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 FREEWARE, 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!

  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
                    7601 Ortenberg
                    D-W 7601 Ortenberg  (ab 1.7.93,  77799 Ortenberg)

         E-Mail :   Andreas_Mandel@og.maus.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). 
 
  Beginnen wir mit der Menleiste:

  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.
  
  
  Datenbank Setup
  ---------------

  o Max. Eintrge/Buchstabe

    Hier haben Sie die Mglichkeit einzustellen, wieviel Eintrge pro Buch-
    stabe (A-Z,?,!) das CPX-Modul aus der geladen Adressendatei im Haupt- 
    anzeigefeld anzeigen soll.
    Befinden sich im Hauptanzeigefeld unter einem Index-Buchstaben mehr Daten-
    stze, als unter "Max. Eintrge/Buchstabe" eingestellten Wert, wird der 
    letzte Datensatz mit "**" markiert, welches einem signalisiert, das unter 
    diesem Buchstaben noch mehr Datensatze vorhanden sind. 
    Man kann nun den Wert von Max. Eintrge/Buchstabe erhhen.

    Kann das CPX-Modul nicht gengend Speicher fr die geforderte Anzahl von
    Eintrgen bekommen (wenn z.B. ein anderes Programm einfach allen Speicher
    fr sich reserviert hat) so erscheint eine Alert-Box. Eine Anzeige der
    Datenstze ist dann nicht mglich.
  
  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
  
          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 = Dail 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)

  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, klicken Sie einfach den den Anfangs-
  buchstaben des gesuchten Namens. Die gewhlten Adressen mit dem ent-
  sprechenden Anfangsbuchstaben werden darauf sofort im Hauptanzeigefeld 
  angezeigt. Sind keine passenden Eintrge vorhanden bleibt das 
  Hauptanzeigefeld leer.
  
  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.)
  

  Hauptanzeigefeld
  ----------------
  Sofort nach dem ffnen des CPX-Modules knnen Sie das Hauptanzeigefeld in
  Form einer Listenausgabe je Anfangsbuchstabe 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.
  
  Mittig knnen Sie nochmal den gewhlten Datensatz mit Name und Telefon-
  nummer des gewnschten Geprchspartners erkennen.
  
  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. 
  
  Beispiel:
  
  Mandel, Andreas|0781-38807|Postfach 26|7601 Ortenberg|<77799> Ortenberg
  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. 


  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 REDAIL 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 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.
