home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / comms / comprgs / t22bd1.lha / termRexx.dok < prev    next >
Text File  |  1992-05-08  |  32KB  |  634 lines
  1. ================================== term ===================================
  2. ===========================================================================
  3.               Ein  Gift-Ware  Telekommunikationsprogramm von
  4.          Olaf Barthel, ⌐ Copyright 1990-92 by Olaf Barthel & MXM,
  5.                          alle Rechte vorbehalten.
  6.  
  7.    Es   wird   keinerlei   GewΣhrleistungspflicht   fⁿr   die  vollstΣndige
  8. FunktionsfΣhigkeit  des  (der)  in diesem Dokument beschriebenen Programmes
  9. (Programme) ⁿbernommen.  Sie nutzen diese Software auf eigenes Risiko.
  10.  
  11.  
  12. ============================= term und ARexx ==============================
  13. ===========================================================================
  14. In   dieser   Datei  sollen  die  von  `term'  unterstⁿtzten  ARexx-Befehle
  15. beschrieben  werden.   Dies ist keine Einfⁿhrung in die Sprache selbst, die
  16. von  Mike  F.   Cowlishaw auf dem IBM VM/SP« entwickelt (eine Bewertung des
  17. VMS/CMS«  will ich mir hier sparen) und von William S.  Hawes auf dem Amiga
  18. implementiert wurde.
  19.    ARexx  (oder  auch  Amiga  Rexx)  ist ein kommerzielles Produkt, das dem
  20. AmigaDOS 2.0 Enhancer Package beiliegt. Wer nach einer guten Einfⁿhrung und
  21. Beschreibung   der   Sprache   sucht,   dem  empfehle  ich  das  Buch  `Die
  22. Programmiersprache  REXX'  von  M.   F.  Cowlishaw, erschienen 1988 im Carl
  23. Hanser Verlag Mⁿnchen/Wien, ISBN 3-446-15195-8.
  24.  
  25.    `term'  richtet einen Rexx-Host unter dem Namen "TERM" ein (anzusprechen
  26. mittels `address term').  Startet man mehrere `term'-Programme, so wird der
  27. Name  des  Hosts  der  Nummer des Programmes angepa▀t (das erste gestartete
  28. Programm meldet den Host unter dem Namen `TERM' an, das zweite bedient sich
  29. `TERM.1',  das  dritte  nimmt `TERM.2', etc.).  Der Name wird auch im Titel
  30. des Hauptbildschirmes des jeweiligen Programmes angezeigt.
  31.    Insgesamt  werden genau 44 Befehle unterstⁿtzt, die sich in zwei Klassen
  32. einteilen lassen:
  33.  
  34. - Asynchrone  Befehle,  die  `augenblicklich'  ausgefⁿhrt  werden  und  ein
  35.   ARexx-Programm nicht zum Warten zwingen.
  36.  
  37. - Synchrone  Befehle,  die  das Hauptprogramm `term' selbst ausfⁿhrt.  Dies
  38.   kann  es  notwendig machen, da▀ das ARexx-Programm wartet, bis der Befehl
  39.   ausgefⁿhrt wurde.
  40.  
  41.  
  42. ========================= Die Asynchronen Befehle =========================
  43. ===========================================================================
  44. CLEARDISPLAY........... L÷scht den Inhalt des `Logbuches'.
  45.  
  46. CLOSEDISPLAY........... Schlie▀t   den  Bildschirm  des  `Logbuches',  lΣ▀t
  47.                         dessen Inhalt aber unverΣndert.
  48.  
  49. DEFAULT2FRONT.......... Schiebt  den  Standardbildschirm (`Default Screen')
  50.                         nach    vorne.     Dies   ist   ⁿblicherweise   der
  51.                         Workbench-Bildschirm.
  52.  
  53. REXX2FRONT............. Schiebt  den  Bildschirm  nach  vorne,  auf dem das
  54.                         Ausgabefenster des ARexx-Interfaces liegt.
  55.  
  56. DISPLAY2FRONT.......... Schiebt den Bildschirm des `Logbuches' nach vorne.
  57.  
  58. TERM2FRONT............. Schiebt  den  Hauptbildschirm des `term' Programmes
  59.                         nach vorne.
  60.  
  61. WB2FRONT............... Schiebt  ausdrⁿcklich den Workbench-Bildschirm nach
  62.                         vorne.
  63.  
  64. CLEARDOWNLOADLIST...... Die  Liste  aller  bisher  empfangenen Dateien wird
  65.                         gel÷scht.
  66.  
  67. QUERY.................. Mit   diesem   Befehl   lassen   sich  verschiedene
  68.                         Systemparameter abfragen.  Aufgrund der KomplexitΣt
  69.                         dieses  Befehles  soll  er  nachfolgend beschrieben
  70.                         werden.
  71.  
  72. QUIETEXIT.............. Wird   dieser   Befehl   aufgerufen,  so  wird  das
  73.                         Ausgabefenster   des   Programmes  nach  Beendigung
  74.                         sofort geschlossen.  ▄blicherweise bleibt es bis zu
  75.                         einer BestΣtigung durch den Anwender ge÷ffnet.
  76.  
  77.  
  78. =========================== Der `QUERY' Befehl ============================
  79. ===========================================================================
  80. Die  folgenden Parameter lassen sich ⁿber den `QUERY' Befehl abfragen (z.B.
  81. ⁿber `query baudrate'):
  82.  
  83. ADOWNLOADPATH.......... Der   Name  des  Verzeichnisses  in  dem  die  beim
  84.                         Empfangen   von  ASCII-Daten  entstehenden  Dateien
  85.                         abgelegt werden.
  86.  
  87. AUPLOADPATH............ Der  Name  des Verzeichnisses, das beim Verschicken
  88.                         von ASCII-Dateien durchsucht wird.
  89.  
  90. AUDBELL................ ON   wenn   ein   akustisches   Signal   bei  jedem
  91.                         `Bell'-Zeichen ausgegeben wird, sonst OFF.
  92.  
  93. AUTOCAPTURE............ ON    falls   beim   erfolgreichen   Aufbau   einer
  94.                         Telefonverbindung  eine  Mittschnitt-Datei angelegt
  95.                         wird, sonst OFF.
  96.  
  97. BAUDRATE............... Die     aktuell     eingestellte    ▄bertragungsge-
  98.                         schwindigkeit in Bits/Sekunde.
  99.  
  100. BEEPSOUND.............. Der  Name  der  IFF-Sound-Datei,  die  anstelle des
  101.                         normalen  Piepsens  beim Eingang eines BEL-Signales
  102.                         gespielt wird.
  103.  
  104. BITSPERCHAR............ Die Anzahl der ⁿbertragenen Bits pro Zeichen.
  105.  
  106. BLINKING............... ON   falls   die   Blinkfunktionen   des  Terminals
  107.                         eingeschaltet sind, sonst OFF.
  108.  
  109. BREAKLENGTH............ Die    Dauer    eines   Unterbrechungssignales   in
  110.                         Mikrosekunden   (1   Million   Mikrosekunden   =  1
  111.                         Sekunde).
  112.  
  113. BDOWNLOADPATH.......... Der   Name  des  Verzeichnisses  in  dem  die  beim
  114.                         Empfangen   von  BinΣr-Daten  entstehenden  Dateien
  115.                         abgelegt werden.
  116.  
  117. BUPLOADPATH............ Der  Name  des Verzeichnisses, das beim Verschicken
  118.                         von BinΣr-Dateien durchsucht wird.
  119.  
  120. BUSY................... Die  Zeichenkette,  an  Hand derer die WΣhlfunktion
  121.                         erkannt, da▀ eine Telefonleitung besetzt ist.
  122.  
  123. CAPTUREFILTER.......... ON  wenn  Steuersequenzen  aus der Mittschnittdatei
  124.                         ausgefiltert werden sollen, sonst OFF.
  125.  
  126. CAPTUREPATH............ Das  Verzeichnis,  in  dem die Mittschnitt-Dateien,
  127.                         die bei aktivierter `Connect Auto-Capture'-Funktion
  128.                         entstehen, abgelegt werden.
  129.  
  130. CAPTURESTATE........... Gibt den aktuellen Mitschnitt-Modus aus:  `PRINTER'
  131.                         wenn  auf den Drucker mitprotokolliert wird, `FILE'
  132.                         wenn  in eine Datei mitgeschnitten wird.  Es k÷nnen
  133.                         auch  beide  W÷rter  zurⁿckgeliefert  werden,  oder
  134.                         `OFF' falls der Mitschnitt nicht aktiviert wurde.
  135.  
  136. CHARACTERWRAP.......... ON falls am rechten Bilschirmrand ein Zeilenumbruch
  137.                         durchgefⁿhrt wird, sonst OFF.
  138.  
  139. COLOUR................. Dieser   Befehl  liest  die  aktuell  eingestellten
  140.                         Farbinformationen  des `term' Hauptbildschirmes aus
  141.                         (`query  colour  12')  und  liefert  den jeweiligen
  142.                         Farbwert als Hexadezimalzahl zurⁿck (`FFF').
  143.  
  144. COLOURMODE............. Der  aktuell  eingestellte Farbmodus (AMIGA, EIGHT,
  145.                         SIXTEEN, MONO).
  146.  
  147. COLUMNS................ Die Anzahl Zeichen pro Zeile.
  148.  
  149. CONNECT................ Die  Zeichenkette,  an  Hand derer die WΣhlfunktion
  150.                         erkannt, da▀ ein Telefonverbindung aufgebaut werden
  151.                         konnte.
  152.  
  153. CONNECTAUTOBAUD........ ON  wenn  beim  Aufbau  einer Telefonverbindung die
  154.                         ▄bertragungsgeschwindigkeit     automatisch     neu
  155.                         ermittelt wird, sonst OFF.
  156.  
  157. CURSOR................. Liefert  die  aktuelle  Position  der  Schreibmarke
  158.                         zurⁿck.    X-   und   Y-Position   sind  durch  ein
  159.                         Leerzeichen getrennt (`12 23').
  160.  
  161. CURSORMODE............. Arbeitsmodus   der  Cursortasten  (`STANDARD'  oder
  162.                         `APPLICATION').
  163.  
  164. CURSORWRAP............. ON  falls  der  Cursor  in  seinen Bewegungen nicht
  165.                         eingeschrΣnkt ist, sonst OFF.
  166.  
  167. DEFAULTSTORE........... Der   Name   des   Verzeichnisses,   in   dem  alle
  168.                         Konfigurationsdateien   des   Programmes   abgelegt
  169.                         werden.
  170.  
  171. DIALPREFIX............. Die   Befehlssequenz,   die   jeder   zu  wΣhlenden
  172.                         Telefonnummer vorangestellt wird.
  173.  
  174. DIALRETRIES............ Die   maximale  Anzahl  von  DurchlΣufen,  die  die
  175.                         WΣhlfunktion  unternimmt,  um eine Telefonverbidung
  176.                         aufzubauen.
  177.  
  178. DIALTIMEOUT............ Die Zeit in Sekunden, die die WΣhlfunktion nach der
  179.                         Anwahl  einer  Telefonnummer  bis zum erfolgreichen
  180.                         Aufbau einer Verbindung wartet.
  181.  
  182. DISPLAYMODE............ Der   Anzeigemodus   des  `term'  Hauptbildschirmes
  183.                         (HIRES,   HIRESLACE,   SUPERHIRES,  SUPERHIRESLACE,
  184.                         PRODUCT,   PRODUCTLACE,   PALHIRES,   PALHIRESLACE,
  185.                         PALSUPERHIRES,     PALSUPERHIRESLACE,    NTSCHIRES,
  186.                         NTSCHIRESLACE,  NTSCSUPERHIRES, NTSCSUPERHIRESLACE,
  187.                         A2024TENHZ, A2024FIFTEENHZ).
  188.  
  189. DOWNLOADS.............. Die   Anzahl  der  Dateien,  die  bisher  empfangen
  190.                         wurden.
  191.  
  192. DSBACKSPACE............ ON  wenn  das  `Backspace'-Zeichen auch das Zeichen
  193.                         links der Schreibmarke l÷scht, sonst OFF.
  194.  
  195. DUPLEX................. Datenⁿbertragungsart (FULL, HALF).
  196.  
  197. EDITOR................. Name  des  Text-Editors, der von der Funktion `Edit
  198.                         File' aufgerufen wird.
  199.  
  200. EIGHTYCOLUMNS.......... ON  falls  der  Bildschirm  auf  80  ╫  24  Zeichen
  201.                         beschrΣnkt wurde, sonst OFF.
  202.  
  203. EMULATION.............. Die   gerade   aktive   Terminalemulation  (ANSIVT,
  204.                         ATOMIC,TTY).
  205.  
  206. ERROR.................. Die  Zeichenkette,  die  das  Modem  beim Auftreten
  207.                         eines Fehlers sendet.
  208.  
  209. FONT................... Der eingestellte Zeichensatz (TOPAZ, IBM).
  210.  
  211. FONTSCALE.............. Gr÷▀e   des   Zeichensatzes  (`NORMAL',  `HIGHTOP',
  212.                         `HIGHBOTTOM', `WIDE', `HALF').
  213.  
  214. HANDSHAKING............ Der    eingestellte   Handshaking-Modus   (XONXOFF,
  215.                         RTSCTS, NONE).
  216.  
  217. HIGHSPEED.............. ON   falls   der   `Hochgeschwindigkeitsmodus'  des
  218.                         seriellen Treibers aktiviert wurde, sonst OFF.
  219.  
  220. INSERTMODE............. ON  falls  das  Terminal  im Einfⁿgemodus arbeitet,
  221.                         sonst OFF (▄berschreibemodus).
  222.  
  223. LINE................... ON falls eine Telefonverbindung besteht, sonst OFF.
  224.  
  225. LINES.................. Die   Anzahl   Zeilen,   die   auf  dem  Bildschirm
  226.                         darstellbar sind.
  227.  
  228. LOGACTIONS............. ON  falls  alle  Aktionen  des  Programmes in einer
  229.                         Datei mitprotokolliert werden, sonst OFF.
  230.  
  231. LOGFILE................ Der  Name  der  Datei,  in der bei aktivierter `Log
  232.                         Actions'-Funktion alle Aktionen gespeichert werden.
  233.  
  234. MACRO.................. Von    diesem   Befehl   werden   als   zusΣtzliche
  235.                         Aufrufparameter  Qualifier (None, Shift, Alternate,
  236.                         Control)   und   die   Funktionstastennummer  (0-9)
  237.                         erwartet  (`query  macro none 0').  Es wird die mit
  238.                         der    entsprechenden   Funktionstaste   verknⁿpfte
  239.                         Befehlssequenz zurⁿckgeliefert.
  240.  
  241. MACROFILE.............. Der      Name     der     aktuell     eingestellten
  242.                         Funktionstastendefinitionsdatei.
  243.  
  244. MODEMEXIT.............. Die   Befehlssequenz,   die   beim   Verlassen  des
  245.                         Programmes an das Modem geschickt wird.
  246.  
  247. MODEMHANGUP............ Die   Befehlssequenz,   die   zum  Abbrechen  einer
  248.                         Verbindung an das Modem geschickt wird.
  249.  
  250. MODEMINIT.............. Die  Befehlssequenz,  die  beim  Programmstart  zur
  251.                         Initialisierung des Modems verschickt wird.
  252.  
  253. NOCARRIER.............. Die  Zeichenfolge, die das Modem beim Abbruch einer
  254.                         Telefonverbindung verschickt.
  255.  
  256. NEWLINEMODE............ ON falls das Terminal im `New Line'-Modus arbeitet,
  257.                         sonst OFF.
  258.  
  259. NUMERICMODE............ Der  Arbeitsmodus  des  Zehnerblockes  (`STANDARD',
  260.                         `APPLICATIONS').
  261.  
  262. OKAY................... Die  Zeichenkette,  die  das  Modem zur BestΣtigung
  263.                         eines Befehles abschickt.
  264.  
  265. PARITY................. Der aktuell eingestellte ParitΣtsmodus (NONE, EVEN,
  266.                         ODD, MARK, SPACE).
  267.  
  268. PROTOCOL............... Das    aktuell    eingestellte    Transferprotokoll
  269.                         (xprzmodem.library, xprxmodem.library, etc.).
  270.  
  271. PROTOCOLOPTIONS........ Die  verwendeten  Optionen des gerade eingestellten
  272.                         Transferprotokolles.   Die  Bedeutung  der Optionen
  273.                         ist der Dokumentation des jeweiligen Protokolles zu
  274.                         entnehmen.
  275.  
  276. PUBLICSCREEN........... ON  wenn  der `term' Hauptbildschirm als ÷ffentlich
  277.                         zugΣnglicher Bereich ge÷ffnet wurde, sonst OFF.
  278.  
  279. REDIALDELAY............ Die  Zeit  in Minuten, die die WΣhlfunktion vor dem
  280.                         nΣchsten Durchlauf der WΣhlliste wartet.
  281.  
  282. REQUESTERS............. ON   wenn   Sicherheitsabfragen   angezeigt  werden
  283.                         sollen, sonst OFF.
  284.  
  285. RING................... Die Zeichenfolge, die das Modem beim Erkennen eines
  286.                         Anrufes sendet, der von einem anderen Modem stammt.
  287.  
  288. SCREENADDRESS.......... Liefert  die  Adresse  des `term'-Hauptbildschirmes
  289.                         als Dezimalzahl zurⁿck.
  290.  
  291. SENDCR................. Der   Modus,   in   dem   ein   `Carriage   Return'
  292.                         (Zeilenrⁿcklauf)   versandt   wird  (IGNORE,  ASCR,
  293.                         ASCRLF).
  294.  
  295. SENDLF................. Der  Modus, in dem ein `Line Feed' (Zeilenvorschub)
  296.                         versandt wird (IGNORE, ASLF, ASLFCR).
  297.  
  298. SERIAL................. ON  wenn  der  serielle  Treiber noch zur Verfⁿgung
  299.                         steht, wenn er bereits freigegeben wurde OFF.
  300.  
  301. SERIALDEVICE........... Der Name des eingestellten seriellen Treibers.
  302.  
  303. SHANGHAI............... ON  wenn  Fenster  der  Workbench  auf  dem  `term'
  304.                         Hauptbildschirm ge÷ffnet werden sollen, sonst OFF.
  305.  
  306. SMOOTHSCROLL........... ON    falls   der   Bildschirm   viertelzeilenweise
  307.                         gescrollt wird, sonst OFF.
  308.  
  309. SPEECHFILE............. Der Name der aktuellen Sprach-Konfigurationsdatei.
  310.  
  311. SPEECH................. ON  falls der Sprachsynthesizer in `term' aktiviert
  312.                         wurde, sonst OFF.
  313.  
  314. SPEECHRATE............. Die  Sprechgeschwindigkeit,  des Sprachsynthesizers
  315.                         in Worten pro Minute.
  316.  
  317. SPEECHPITCH............ Die Stimmververzerrung des Sprachsynthesizers.
  318.  
  319. SPEECHFREQUENCY........ Die Stimmh÷he des Sprachsynthesizers in Hertz.
  320.  
  321. SPEECHVOLUME........... Die SprechlautstΣrke des Sprachsynthesizers.
  322.  
  323. SPEECHSEX.............. Das  Geschlecht  der  Stimme des Sprachsynthesizers
  324.                         (MALE = mΣnnlich, FEMALE = weiblich).
  325.  
  326. STARTUP................ Die   Befehlssequenz  die  beim  Start  des  `term'
  327.                         Programmes  ausgefⁿhrt  wird  (oder  was die letzte
  328.                         Telefonverbindung in diesem Feld gelassen hat).
  329.  
  330. STATUS................. Der  ⁿbergeordnete  Zustand  des  `term' Programmes
  331.                         (READY,   HOLDING,   DIALING,   UPLOAD,   DOWNLOAD,
  332.                         BREAKING, HANGUP).
  333.  
  334. STOPBITS............... Die  Anzahl  der  bei  der  ▄bertragung verwendeten
  335.                         Stopbits.
  336.  
  337. TIMEOUT................ Die LΣnge in Mikrosekunden, die beim `INPUT' Befehl
  338.                         vor dem Abbruch gewartet wird.
  339.  
  340. TDOWNLOADPATH.......... Der   Name  des  Verzeichnisses  in  dem  die  beim
  341.                         Empfangen   von   Text-Daten  entstehenden  Dateien
  342.                         abgelegt werden.
  343.  
  344. TUPLOADPATH............ Der  Name  des Verzeichnisses, das beim Verschicken
  345.                         von Text-Dateien durchsucht wird.
  346.  
  347. UNITNUMBER............. Die  Nummer  des  seriellen Treibers der eigestellt
  348.                         wurde.
  349.  
  350. VISBELL................ ON    wenn   ein   optisches   Signal   bei   jedem
  351.                         `Bell'-Zeichen ausgegeben wird, sonst OFF.
  352.  
  353. VOICE.................. Die Zeichenfolge, die das Modem ⁿbertrΣgt, wenn ein
  354.                         Anruf  erkannt  wird,  der  nicht von einem anderen
  355.                         Modem stammt.
  356.  
  357.  
  358. ========================= Die Synchronen Befehle ==========================
  359. ===========================================================================
  360. BDOWNLOAD.............. Fⁿhrt   einen  Datentransfer  zum  `term'  Programm
  361.                         durch.    Ein  Dateiname  wird  erwartet,  mu▀  bei
  362.                         Protokollen wie ZModem aber nicht vorhanden sein.
  363.  
  364. BEEP................... LΣ▀t  den  Bildschirm  blitzen/piepen, etc.  in der
  365.                         Manier des `Bell'-Zeichens.
  366.  
  367. BREAK.................. Schickt    ein    Unterbrechungssignal   ⁿber   die
  368.                         Telefonleitung.
  369.  
  370. BUFFER................. Befa▀t   sich   mit  dem  Inhalt  des  `Logbuches'.
  371.                         Mittels  `buffer  new  file'  wird  der  Inhalt des
  372.                         `Logbuches'   mit   dem  Inhalt  der  Datei  `file'
  373.                         ⁿberschrieben,  `set  buffer  append file' fⁿgt den
  374.                         Inhalt  der  Datei  an das bestehende `Logbuch' an.
  375.                         Wird  `buffer  display'  aufgerufen,  so  wird  der
  376.                         Bildschirm des `Logbuches' ge÷ffnet.
  377.  
  378. BUPLOAD................ Schickt eine Datei an den EmpfΣnger auf der anderen
  379.                         Seite  der  Telefonleitung.  Hier mu▀ ein Dateiname
  380.                         angegeben    werden,    oder    das    eingestellte
  381.                         Transferprotokoll  wird  sich  beklagen.   Nur  ein
  382.                         Dateiname  wird  akzeptiert,  wer  mehrere  Dateien
  383.                         wⁿnscht, sollte sich mit Wildcardmustern befassen.
  384.  
  385. CAPTURE................ ─ndert  den  Zustand des Mitschnittes auf Diskette.
  386.                         Mitels   `capture   close'  wird  das  Mitschneiden
  387.                         abgebrochen,  `capture  new file' ⁿberschreibt eine
  388.                         Zieldatei  mit  dem  Mittschnitt,  `capture  append
  389.                         file' fⁿgt den Mitschnitt an eine Datei an.
  390.  
  391. CLEARSCREEN............ L÷scht schlicht und einfach den Bildschirm.
  392.  
  393. COMMAND................ Schickt  eine  Befehlssequenz  in der Art und Weise
  394.                         des   `term'   Hauptprogrammes  ⁿber  die  serielle
  395.                         Leitung.
  396.  
  397. CONFIG................. Speichert  die  aktuelle  Konfiguration ab (`config
  398.                         save  file')  oder  lΣdt und setzt sie neu (`config
  399.                         load file').
  400.  
  401. DELAY.................. Wartet  eine  anzugebende Zeitperiode.  Dieser Wert
  402.                         sollte   nicht   zu  gro▀  bemessen  sein,  da  die
  403.                         Wartezeit  nicht  abgekⁿrzt  werden  kann.  Es kann
  404.                         jeweils    in   Mikrosekunden-,   Sekunden-,   oder
  405.                         Minutenintervallen gewartet werden:
  406.  
  407.                            delay 10 mic -> Wartet zehn Mikrosekunden.
  408.                            delay 10 sec -> Wartet zehn Sekunden.
  409.                            delay 10 min -> Wartet zehn Minuten.
  410.  
  411. DIAL................... WΣhlt  eine  Telefonnummer, wer Spa▀ daran hat, der
  412.                         kann  auch den Namen eines Eintrages im Telefonbuch
  413.                         angeben.   Wird  der  Eintrag gefunden, so wird die
  414.                         damit verknⁿpfte Telefonnummer verwendet.  Ein Wort
  415.                         der Warnung:  der WΣhlbefehl wird abgeschickt, eine
  416.                         Verarbeitung  des Ergebnisses mu▀ anders gehandhabt
  417.                         werden.
  418.  
  419. FILEREQUEST............ Zeigt ein Datei-Auswahlfeld an, der ⁿbergebene Text
  420.                         wird   im   Titelbalken   des  jeweiligen  Fensters
  421.                         angezeigt.   Diese  Funktion  liefert den Namen von
  422.                         Datei  und  Verzeichnis  zurⁿck,  die  der Benutzer
  423.                         ausgewΣhlt hat.
  424.  
  425. FIRSTDOWNLOAD.......... Die Namen aller empfangenen Dateien werden in einer
  426.                         Liste gespeichert, die sich vom ARexx-Interface aus
  427.                         auslesen  lΣ▀t.   Dieser  Befehl liefert den ersten
  428.                         Namen in dieser Liste zurⁿck.
  429.  
  430. GETCLIP................ Entnimmt  den  Inhalt  des `Clipboards' und liefert
  431.                         ihn als Zeichenkette zurⁿck.
  432.  
  433. GETSTRING.............. Fordert  eine  Zeichenkette vom Anwender des `term'
  434.                         Programmes an.
  435.  
  436. HANGUP................. Bricht  die Telefonverbindung, die gerade aktiv ist
  437.                         (sofern  ⁿberhaupt  vorhanden)  kurz und schmerzlos
  438.                         ab, indem das Modem zum Auflegen gebracht wird.
  439.  
  440. INPUT.................. Liest  eine  anzugebende Anzahl von Zeichen von der
  441.                         seriellen  Leitung.   Wurde  ein  `TIMEOUT' mit dem
  442.                         entsprechenden  Kommando  gesetzt,  wird  nach  dem
  443.                         Eintreffen  von  genⁿgend  Zeichen  oder  nach  dem
  444.                         Verstreichen der Wartezeit zurⁿckgekehrt.
  445.  
  446. LASTDOWNLOAD........... Die Namen aller empfangenen Dateien werden in einer
  447.                         Liste gespeichert, die sich vom ARexx-Interface aus
  448.                         auslesen  lΣ▀t.   Dieser Befehl liefert den letzten
  449.                         Namen in dieser Liste zurⁿck.
  450.  
  451. MACROS................. Speichert  die  aktuelle Funktionstastenbelegung ab
  452.                         (`macros  save  file')  oder lΣdt und setzt sie neu
  453.                         (`macros load file').
  454.  
  455. MESSAGE................ Gibt  einen  Text  auf dem Bildschirm aus (der Text
  456.                         wird nicht ⁿber die serielle Leitung verschickt).
  457.  
  458. NEXTDOWNLOAD........... Die Namen aller empfangenen Dateien werden in einer
  459.                         Liste gespeichert, die sich vom ARexx-Interface aus
  460.                         auslesen  lΣ▀t.  Dieser Befehl liefert den nΣchsten
  461.                         Namen   in  dieser  Liste  zurⁿck,  es  mu▀  vorher
  462.                         entweder    `firstdownload'   oder   `lastdownload'
  463.                         aufgerufen  worden  sein, um einen Ausgangspunkt in
  464.                         der Liste bestimmen zu k÷nnen.
  465.  
  466. PHONE.................. Speichert  das aktuelle Telefonbuch ab (`phone save
  467.                         file')  oder  lΣdt  und  setzt  es neu (`phone load
  468.                         file').
  469.  
  470. PRINTER................ Schaltet  die Protokollierung der eingehenden Daten
  471.                         auf  dem Druck ab (`printer off') oder zu (`printer
  472.                         on').
  473.  
  474. PUTCLIP................ Legt eine Zeichenkette im `Clipboard' ab.
  475.  
  476. RESETSTYLES............ Fⁿhrt die Terminalemulation wieder auf den Pfad der
  477.                         Tugend   zurⁿck   (alle   Zeichenattribute   werden
  478.                         zurⁿckgesetzt).
  479.  
  480. SAVEILBM............... Speichert   den   Inhalt   des   Bildschirmes   als
  481.                         IFF-ILBM-Datei  unter einem anzugebenden Dateinamen
  482.                         ab.
  483.  
  484. SET.................... Setzt    Systemparameter    neu,    eine   genauere
  485.                         Beschreibung folgt diesem Text.
  486.  
  487. SIMPLEREQUEST.......... Stellt  einen Text in einem Hinweisfeld (wie `term'
  488.                         es  z.B.  beim Verlassen des Programmes zeigt) dar.
  489.                         Der  Bildschirm  von `term' wird automatisch in den
  490.                         Vordergrund gebracht.
  491.  
  492. SPEAK.................. Spricht  -  sofern  m÷glich  -  einen Text ⁿber den
  493.                         Sprachsynthesizer des Amiga aus.
  494.  
  495. SPEECH................. Speichert    die    aktuellen   Einstellungen   des
  496.                         Sprachsynthesizers  ab  (`speech  save  file') oder
  497.                         lΣdt und setzt sie neu (`speech load file').
  498.  
  499. TDOWNLOAD.............. Fordert eine Datei (α la BDOWNLOAD) von der anderen
  500.                         Seite   der  Leitung  an,  versucht  dies  aber  im
  501.                         Textmodus.
  502.  
  503. TUPLOAD................ Schickt  eine Datei (α la BUPLOAD) zum anderen Ende
  504.                         der  Leitung,  unternimmt  diesen  wackeren Versuch
  505.                         allerdings im Textmodus.
  506.  
  507. TONEDIAL............... Spielt eine Telefonnummer in Ton-Codierung ⁿber die
  508.                         Audio  Hardware  des Amiga ab.  Die T÷ne k÷nnen zur
  509.                         Anwahl   einer   Telefonnummer   verwendet  werden,
  510.                         vorausgesetzt  das  jeweilige  Telefon  ist an eine
  511.                         digitale   Vermittlungsstelle  der   Telekom  ange-
  512.                         schlossen   und   die  Sprechmuschel  wird  an  den
  513.                         Ausgabelautsprecher gehalten.
  514.  
  515. TWOGADREQUEST.......... Stellt  einen Text in einem Hinweisfeld (wie `term'
  516.                         es  z.B.  beim Verlassen des Programmes zeigt) dar.
  517.                         Der  Bildschirm  von `term' wird automatisch in den
  518.                         Vordergrund gebracht.  Unter dem Hinweisfeld werden
  519.                         zwei   Kn÷pfe   `Yes'  und  `No'  angezeigt,  diese
  520.                         Funktion   liefert   anschlie▀end  zurⁿck,  welchen
  521.                         dieser beiden Kn÷pfe der Benutzer angeklickt hat.
  522.  
  523. WAITSTRING............. Wartet  darauf, da▀ eine bestimmte Zeichenkette vom
  524.                         das  Modem  ⁿbertragen  wird.   Es k÷nnen praktisch
  525.                         unbegrenzt  viele  Zeichenketten  ⁿbergeben werden,
  526.                         auf   die  gewartet  werden  soll.   Ist  eine  der
  527.                         Zeichenketten eingegangen, so wird sie als Ergebnis
  528.                         zurⁿckgeliefert.   Gro▀- und Kleinschreibung werden
  529.                         beim  ▄berprⁿfen  ignoriert.   Auch  hier  ist  der
  530.                         globale  Timeout  aktiv  (lΣ▀t  sich z.B.  mit `set
  531.                         timeout  10  sec' setzen), verstreicht entsprechend
  532.                         viel Zeit, so kehrt die Routine automatisch zurⁿck.
  533.                         Ich  empfehle  _jedermann_ einen Timeout zu setzen,
  534.                         da  sonst anderenfalls die M÷glichkeit besteht, da▀
  535.                         die Routine _niemals_ zurⁿckkehrt.
  536.  
  537.                                Beispielaufruf: waitstring "logon: "
  538.  
  539. WRITE.................. Schickt  eine  Zeichenkette ⁿber die Leitung, zeigt
  540.                         dies  aber  nicht  notwendigerweise  auf dem `term'
  541.                         Hauptbildschirm an.
  542.  
  543.  
  544. ============================ Der `SET'-Befehl =============================
  545. ===========================================================================
  546. GrundsΣtzlich  stellt  der  `SET'-Befehl die Umkehrung des `QUERY'-Befehles
  547. dar.   Zu  jedem  Parameter  existiert  ein  analoger Befehl, der dieselben
  548. Eingaben  verarbeitet,  wie  sie  der  `QUERY' Befehl zurⁿckliefert (`query
  549. baudrate'  liefert  z.B.   2400, also lΣ▀t sich mit `set baudrate 2400' die
  550. Baudrate entsprechend setzen).
  551.    Da  den  Autor  dieser  Zeilen momentan Rⁿckschmerzen planen und er sich
  552. nach   einem   Non-Stop-Tour-De-Force-Programmierungsmarathon  nicht  allzu
  553. phantastisch  fⁿhlt,  sei  ihm (also mir) erlaubt, an dieser Stelle nur die
  554. Unterschiede zwischen den Befehlen anzugeben:
  555.  
  556. BELL................... Setzt  die Parameter des Bildschirmblitzes neu (die
  557.                         Reaktion  auf das `Bell'-Zeichen).  Hier werden die
  558.                         Aufrufparameter `AUDIBLE' und `VISIBLE' erkannt.
  559.  
  560. COLOUR................. Setzt eine der Bildschirmfarben neu.  Hier wird die
  561.                         Nummer  der  Farbe erwartet (0-15) und der Wert der
  562.                         Farbe als Hexadezimalzahl.
  563.  
  564. MACRO.................. Setzt  eine  der ⁿber Funktionstasten aufzurufenden
  565.                         Befehlssequenzen  neu.   Hier  wird  der  Name  des
  566.                         Qualifiers  (None,  Shift,  Alternate, Control) die
  567.                         Nummer  der  Funktionstaste  (0-9)  und die Sequenz
  568.                         erwartet.
  569.                         
  570.                            Beispiel: set macro none 0 hello!
  571.  
  572. SCREEN................. Dies  ist  eine  Kombination  der durch die Befehle
  573.                         `QUERY    PUBLICSCREEN'    und   `QUERY   SHANGHAI'
  574.                         abzufragenden  Optionen.   Als Parameter k÷nnen der
  575.                         Funktion SHANGHAI und PUBLIC ⁿbergeben werden.
  576.  
  577. TIMEOUT................ Setzt  den globalen Timeout, d.h.  die Zeitperiode,
  578.                         die   alle   Lesefunktionen   warten,   bevor   sie
  579.                         automatisch  abgebrochen  werden.   Diese Zeit kann
  580.                         wie  beim  DELAY-Befehl  in Mikrosekunden, Sekunden
  581.                         und Minuten angegeben werden.
  582.  
  583.                                 Beispielaufruf: set timeout 10 sec
  584.  
  585.  
  586.    Hinweis:   zu  den Befehlen `query line', `query lines' `query columns',
  587. `query  status',  `query  cursor',  `query downloads' und `query beepsound'
  588. gibt  es  jeweils kein Gegenstⁿck.  Der Zustand der Telefonverbindung sowie
  589. auch  die  physikalische  Bildschirmgr÷▀e kann nicht erzwungen werden.  Zur
  590. Positionierung  der  Schreibmarke  sollte  besser  eine  Steuersequenz  zum
  591. Terminal  geschickt  werden,  als  an  den  internen  Programmvariablen  zu
  592. manipulieren.
  593.  
  594.  
  595. ================================ Probleme =================================
  596. ===========================================================================
  597. Bei  der  Arbeit  mit  dem ARexx-Interface k÷nnen Probleme auftreten, deren
  598. KlΣrungen  sich  sich  dem  `normalen' Anwender entziehen.  Ich m÷chte hier
  599. eine Handvoll potentieller Fragen beanworten:
  600.  
  601. Frage:   Was sind synchrone und was sind asynchrone Befehle und warum mu▀te
  602.          der Befehlssatz in diese zwei Gruppen getrennt werden?
  603.  
  604. Antwort: Synchrone   Befehle   und   asynchrone  Befehle  werden  von  zwei
  605.          verschiedenen  Instanzen  des  `term'-Programmsystems  ausgefⁿhrt.
  606.          Asynchrone  Befehle werden direkt vom selben Prozess abgearbeitet,
  607.          der  die  ARexx-Nachrichten  empfΣngt.  Synchrone Befehle hingegen
  608.          werden   an   das   `term'-Hauptprogramm  weitergeleitet,  da  die
  609.          entsprechenden Befehle Resourcen ben÷tigen oder verΣndern, auf die
  610.          nur das Hauptprogramm Zugriff hat.
  611.  
  612.  
  613. Frage:   Mein  ARexx-Programm  scheint pl÷tzlich nicht mehr weiterzulaufen,
  614.          nachdem es eine  der  `term'-Funktionen  angewΣhlt  hat.  Was  ist
  615.          passiert?
  616.  
  617. Antwort: Wahrscheinlich  wurde  ein  synchroner Befehl des ARexx-Interfaces
  618.          aufgerufen  und  das  `term'-Hauptprogramm  ist nicht in der Lage,
  619.          diesen  sofort  zu bearbeiten (ein Datei-Auswahlfeld ist offen, es
  620.          wird  ein  Dateitransfer  ⁿber den seriellen Treiber durchgefⁿhrt,
  621.          die Funktion `Iconify' wurde aufgerufen).
  622.  
  623.  
  624. Frage:   Warum   kann   man   das   Hauptprogramm  `term'  nicht  ⁿber  das
  625.          ARexx-Interface  beenden  oder  ⁿber  die  `Iconify'-Funktion  `in
  626.          Schlaf versetzen'?
  627.  
  628. Antwort: Beide   Funktionen  haben  zur  Folge,  da▀  die  Abarbeitung  der
  629.          eingehenden  ARexx-Befehle  abgebrochen,  bzw.  unterbrochen wird.
  630.          Nachfolgende  Befehle  wⁿrden  nicht  mehr  abgearbeitet  und  das
  631.          ARexx-Programm   nicht   mehr   weiterlaufen:    es   wⁿrde  keine
  632.          Unterbrechung  des ARexx-Programmes erfolgen, es wⁿrde schlichtweg
  633.          stehenbleiben und sich nicht mehr verlassen lassen.
  634.