                           ARexx-Kommandos

In  diesem  Text  werden  die  von HiSpeed angebotenen ARexx-Kommandos
dargestellt. Normalerweise ist eine gleichzeitige Bedienung ber ARexx
&  Workbench  mglich.  Die  ARexx-Befehle  von HiSpeed fallen in drei
Gruppen:

- Befehle zum Abfragen von Einstellungen (Typ QUERY)
- Kommandos zum Setzen von Einstellungen (Typ SET)
- und schlielich Routinenaufrufe.


A) AREXX

Der  ARexx-Port von HiSpeed kann direkt ber die Shell (z.B. mit einer
Zeile  wie RX  "ADDRESS  HISPEED.1  QUIT" oder aber ber ARexx Script-
Dateien angesprochen werden: RX <File>. Beispiele fr ein Script-File:

  1.      /* alle Rexx-Programme beginnen mit einem Kommentar  */

          address HISPEED.1        /* an HiSpeed wenden        */
          'REQUESTFILE'            /* File auswhlen lassen    */
          'SET QUALITY HISPEED'    /* HiSpeed-Modus einstellen */
          'SET DOUBLE'             /* doppelseitigen Druck ein */
          'SET HEADER ON'          /* Seiten-Header anfordern  */
          'PRINT'                  /* ... und drucken          */

  2.      /* den aktuellen Font abfragen */

          address HISPEED.1        /* an HiSpeed wenden        */
          options results          /* Ergebnis anfordern       */
          'QUERY QUALITY'          /* Font abfragen            */
          say RESULT               /* Ergebnis zeigen          */


B) AREXX-BEFEHLE

Gruppe 1 - Einstellungen setzen (SET)

Mit  den  Befehlen  in  dieser Gruppe knnen die Programmeinstellungen
gendert  werden.  Alle  Kommandos  entsprechen  dabei  dem  folgenden
Schema: SET <Einstellung> <Wert>

  SET LAYOUTX <Spalten>...................... Anzahl Spalten
  SET LAYOUTY <Zeilen>....................... Anzahl Reihen
  SET LEFT <mm>.............................. linker Rand
  SET RIGHT <mm>............................. rechter Rand
  SET TOP <mm>............................... Rand oben
  SET BOTTOM <mm>............................ Rand unten
  SET DX <mm>................................ Raum zwischen Spalten
  SET DY <mm>................................ Raum zwischen Reihen
  SET COPIES <Anzahl>........................ Anzahl Kopien
  SET FEED <0|1|2|3|4|5|6|7>................. Zeilenvorschub (+)
  SET PORT <'PAR:'|'SER:'|FILE>.............. Ausgabeport (s. OUTFILE)
  SET OUTFILE '<Dateiname>'.................. Ausgabedatei
  SET QUALITY <HISPEED|LQ|EDV|BOLD|BOLDEDV>.. Ausgabestil
  SET FILE '<Dateiname>' .................... Datei in Liste aufnehmen
  SET PERFORMESC [ON]|OFF] .................. ESC-Erkennung ein/aus
  SET PERFORMFF [ON|OFF] .................... FF-Erkennung ein/aus
  SET NUMBER [ON|OFF] ....................... Nummerierung ein aus
  SET HEADER [OFF|NOHEADER|ON|INDEX] ........ Headertyp festlegen
  SET SIZE <Fontname> ....................... Font auswhlen (+)
  SET DOUBLE [ON|OFF] ....................... Doppeldruck an/aus
  SET SINGLE [ON|OFF] ....................... Doppeldruck aus/ein
  SET DESCEND [ON|OFF] ...................... ab/aufsteigend drucken
  SET ASCEND [ON|OFF] ....................... auf/absteigend drucken
  SET SEPARATE [ON|OFF] ..................... Trennlinien ein aus
  SET ADJUSTLF [ON|OFF] ..................... LF's anpassen an/aus
  SET KEEPLF [ON|OFF] ....................... LF's anpassen aus/an
  SET REQUESTER [ON|OFF] .................... Requester aus (1)
  SET ASK '<Text>' .......................... YES/NO Requester zeigen
  SET WARN '<Text'> ......................... I SEE Requester anzeigen
  SET BOOK [ON|OFF] ......................... Buch-Modus an/aus
  SET COVER <Coverfile> ..................... Cover drucken
  SET KEYLIST <file> ........................ Stichwortdatei (*)
  SET KEYCODE <Zeichen|OFF> ................. Stichwort-Marker setzen
  SET PAPERX <mm> ........................... Papierbreite festlegen
  SET PAPERY <mm> ........................... Papierhhe festlegen
  SET PERFORATE [ON|OFF] .................... Rand an Abheften anpassen
  SET ORIENTATION <PORTRAIT|LANDSCAPE> ...... Papierausrichtung
  SET MSDOS [ON|OFF] ........................ MS-DOS Modus ein/aus
  SET UNIDIR [ON|OFF] ....................... Unidirektional ein/aus
  SET SCREEN <PubScreenName> ................ Screen auswhlen

Wie  zu erkennen ist, kann bei allen ber ON/OFF gesteuerten Variablen
das  Schlsselwort  (ON  bzw.  OFF)  entfallen:  SET  SINGLE  hat dann
beispielsweise die gleiche Wirkung wie 'SET SINGLE ON'.


Gruppe 2 - Anweisungen

Mit  den  Befehlen  in  dieser  Gruppe  knnen  Programmfunktionen von
HiSpeed  aufgerufen werden. Argumente werden in keinem Fall werwartet.
Als  Rckgabewerte  sind  10  (Fehler),  5  (Warnung) und 0 (alles OK)
mglich. Mgliche Anweisungen:

  QUIT ...................................... HiSpeed beenden
  SLEEP ..................................... Iconify
  OPENWIN ................................... Hauptfenster ffnen
  SORTNAME .................................. Liste n. Namen sortieren
  SORTSIZE .................................. Files n. Gre sortieren
  NEW ....................................... Job-Liste lschen
  CLR ....................................... dito.
  REQUESTFILE ............................... Filerequester aufrufen
  PRINT ..................................... Files in Liste drucken
  SCAN ...................................... Files in Liste scannen
  VSCAN ..................................... Preview
  RESET ..................................... alle Werte zurcksetzen
  INFO ...................................... SCAN-Ergebnis zeigen
  SAVECONFIG ................................ Einstellungen speichern


Gruppe 3 - Abfragen (QUERY)

In  dieser  Gruppe  finden  sich  Anweisungen, mit denen die aktuellen
HiSpeed-Einstellungen   abgefragt   werden   knnen.   Alle  Kommandos
entsprechen  der  Form QUERY <gesuchte Einstellung> [<Ergnzung>]. Das
Ergebnis  wird  in  der  Variable  RESULT  abgelegt. Es entspricht den
Werten, die bei den analogen SET-Varianten angegeben wurden (s.o.).

  QUERY LAYOUTX ............................. Anzahl Spalten
  QUERY LAYOUTY ............................. Anzahl Zeilen
  QUERY LEFT ................................ linker Rand
  QUERY RIGHT ............................... rechter Rand
  QUERY TOP ................................. Rand oben
  QUERY BOTTOM .............................. Rand unten
  QUERY DX .................................. Raum zwischen Spalten
  QUERY DY .................................. Raum zwischen Reihen
  QUERY COPIES .............................. Anzahl Kopien
  QUERY FEED ................................ Blattvorschub (+)
  QUERY PORT ................................ Ausgabeport
  QUERY OUTFILE ............................. Ausgabedatei
  QUERY QUALITY ............................. Ausgabestil
  QUERY PERFORMESC .......................... ESC-Erkennung
  QUERY PERFORMFF ........................... FF-Erkennung
  QUERY NUMBER .............................. Nummerierung
  QUERY HEADER .............................. Headertyp
  QUERY SIZE ................................ Font (+)
  QUERY DOUBLE .............................. Druck-Betriebsart
  QUERY SINGLE .............................. dito.
  QUERY DESCEND ............................. Druck-Richtung
  QUERY ASCEND .............................. dito.
  QUERY SEPARATE ............................ Trennlinien-Einstellung
  QUERY ADJUSTLF ............................ Adjust-LF-Einstellung
  QUERY KEEPLF .............................. dito.
  QUERY BLOCKX .............................. Buchstaben/Zeile
  QUERY BLOCKY .............................. Zeilen/Block
  QUERY PAGES ............................... bentigte Seiten    (*)
  QUERY SHEETS .............................. bentigte Bltter   (*)
  QUERY DISTORTIONS ......................... Umbrche            (*)
  QUERY BYTES ............................... Textgre in Bytes
  QUERY JOBS ................................ Anzahl Jobs abfragen
  QUERY VERSION ............................. Version abfragen
  QUERY JOBNAME <Slot> ...................... Job-Name abfragen
  QUERY STATE ............................... HiSpeed-Zustand abfragen
  QUERY JOBPAGE <Slot> ...................... Seiten-Nr. abfragen (*)
  QUERY BOOK ................................ Buchmodus abfragen
  QUERY MAXLINE ............................. lngste Zeile       (*)
  QUERY KEYCODE ............................. Stichwort-Code abfragen
  QUERY PERFORATE ........................... Anpassung f. Abheften
  QUERY ORIENTATION ......................... Papierausrichtung
  QUERY MSDOS ............................... MS-DOS Modus abfragen
  QUERY UNIDIR .............................. Unidirektionalmodus

  --------

  (1) das Ein/Ausschalten von Requestern wirkt sich nur auf Operationen
      aus, die ber ARexx ausgelst werden.

  (*) Die mit diesem Zeichen gekennzeichneten Eintrge sind erst nach
      einem Scan-Durchlauf (SCAN oder VSCAN) mit sinnvollen Werten be-
      legt.

  (+) nderung gegenber frheren HiSpeed-Versionen
