home *** CD-ROM | disk | FTP | other *** search
/ ST-Computer Leser 2002 January / STC_CD_01_2002.iso / APP / ZCONT25A / DEUTSCH / ZCONTROL.TXT < prev    next >
Text File  |  1995-12-27  |  30KB  |  922 lines
  1.                            Die Anleitung zu
  2.  
  3.                                zControl
  4.  
  5.                                  0.23
  6.                           27. Dezember 1995
  7.  
  8.                                  von
  9.  
  10.                            Ralf Zimmermann
  11.                             Am Ruhwehr 35
  12.                           D-65207 Wiesbaden
  13.  
  14.                            dl1fdt@amsat.org
  15.  
  16.  
  17.  
  18. Inhaltsverzeichnis
  19. ==================
  20.  
  21.  1 Diese Version
  22.    1.1 English Version
  23.  
  24.  2 Orlando/Florida
  25.  
  26.  3 Copyright
  27.    3.1 Shareware
  28.    3.2 UK Register
  29.        3.2.1 Free Update Service
  30.    3.3 Preisliste
  31.  
  32.  4 Entstehungsgeschichte
  33.  
  34.  5 Installation
  35.  
  36.  6 Bedienung des Programms
  37.    6.1 Hauptdialog
  38.    6.2 Popup-Dialog 'Optionen'
  39.    6.3 Voreinstellung
  40.    6.4 Modul-Auswahl
  41.    6.5 Selektieren eines Moduls
  42.    6.6 Starten eines Moduls
  43.    6.7 Tastaturbedienung
  44.    6.8 Parameter-Übergabe an zControl
  45.        6.8.1 Anwendung anmelden
  46.        6.8.2 AV-Protokoll
  47.        6.8.3 Drag&Drop
  48.    6.9 Iconifizierung
  49.  
  50.  7 Die INF-Datei
  51.    7.1 Debug-Funktion
  52.    7.2 Wo wird die INF-Datei gesucht?
  53.  
  54.  8 Undokumentierte Funktionen
  55.    8.1 KONFIG.CPX
  56.    8.2 LINK_CPX.CPX
  57.    8.3 DFREE.CPX
  58.  
  59. Anhang
  60. ======
  61.  
  62.  A Das Format der INF-Datei
  63.  
  64.  B Das Format der Datei FILESORT.SYS
  65.  
  66.  C Bezugsquellen
  67.  
  68.  D Danksagungen
  69.  
  70.  E Probleme
  71.  
  72.  F History
  73.  
  74.  
  75.  
  76. 1 Diese Version
  77. ===============
  78.  
  79. Das Programm ist noch nicht ganz fertig! Ich würde es als eine *gut
  80. getestete* Beta-Version bezeichnen.
  81.  
  82. Ich habe aber im Moment nicht sehr viel Zeit und kann nicht absehen,
  83. wann all das eingebaut ist was ich gerne noch machen würde. In der
  84. letzten Zeit haben sich die Anfragen nach diesem Programm gehäuft.
  85. Ich habe mich deshalb entschlossen, erstmal diese Version an die
  86. Öffentlichkeit zu bringen - denn das Programm funktioniert eigentlich
  87. ohne grö₧ere Probleme. Sobald ich wieder etwas mehr Zeit habe kommt
  88. eine neue Version!
  89.  
  90. 'Ohne grö₧ere Probleme' hei₧t in diesem Fall folgendes: In dieser
  91. Version läuft zControl als ACCessorie nur unter Multitasking-
  92. Systemen. Sobald man versucht das Programm z.B. unter TOS 3.06 als
  93. ACC zu starten bekommt man beim booten einen kräftigen Absturz.
  94.  
  95. Bisher wei₧ ich leider nicht woran es liegt und kann deshalb nichts
  96. daran ändern. Ich selbst benutze MagiC!3 bzw. MagicMac. Hoffen wir
  97. also auf einen Geistesblitz und auf die Zukunft. Dann wird zControl
  98. auch für die (immer noch vorhandenen) Benutzer von Single-Tasking-
  99. Systemen auf dem Atari verwendbar sein.
  100.  
  101. Als ACC unter Single-TOS wird beim booten eine Warnmeldung
  102. ausgegeben. Dabei werden keine CPX-Module geladen. Man kann die
  103. Module nachträglich laden lassen. Falls es dabei zu einem Absturz
  104. kommt würde ich mich über einen Bugreport freuen, dabei bitte die
  105. verwendete Konfiguration beschreiben:
  106.  
  107. Rechner, Speicher, Betriebssystem, HD-Treiber, AUTO-Ordner-
  108. Programme...
  109.  
  110. Ab Version 0.22 gibt es eine Option namens SINGLELOAD, sie ermöglicht
  111. das normale Arbeiten von zControl unter Single-TOS - die Module
  112. werden geladen. Diese Option dient zum Testen. Mehr zur Anwendung
  113. dieser Option findet man im Kapitel "Das Format der INF-Datei".
  114.  
  115. *Wer diese Option unter Single-TOS austestet, soll mir doch bitte über
  116. email berichten, wie sich zControl verhält.* Ich habe hier in Florida
  117. leider keinen Rechner mit Single-TOS und bin daher von solchen
  118. Rückmeldungen abhängig.
  119.  
  120. Bekannter Fehler: Wenn man noch CPX-Fenster offen hat, während man
  121. die Module neu lädt, so bekommt man einen Absturz des Programmes.
  122. Dies wird aus Zeitgründen erst in der nächsten Version behoben.
  123.  
  124.  
  125. 1.1 English Version
  126. -------------------
  127.  
  128. Version 0.20 of zControl had an english manual, the version 0.21 now
  129. can run in english (and german of course).
  130.  
  131. In the future, maybe, there will be other languages supported.
  132.  
  133. Please note: There is an english version of this manual.
  134.  
  135.  
  136.  
  137. 2 Orlando/Florida
  138. =================
  139.  
  140. Von End Juli 95 bis Mitte März 96 bin ich in Orlando/Florida. Ich
  141. mache hier meine Diplomarbeit. Obwohl Orlando ein sehr netter
  142. Aufenthaltsort ist, hat es einen entscheidenden Nachteil. Ich habe
  143. keinen Zugriff auf meiner Atari-Rechner zuhause. Dies bedeutet
  144. eingeschränkte Testmöglichkeiten für dieses Programm.
  145.  
  146.  
  147.  
  148. 3 Copyright
  149. ===========
  150.  
  151. zControl ist ein Shareware-Programm von
  152.  
  153.    Ralf Zimmermann
  154.    Am  Ruhwehr  35
  155.    65207 Wiesbaden
  156.      Deutschland
  157.  
  158.    MausNet     :  Ralf Zimmermann @ OF2
  159.    internet    :  dl1fdt@amsat.org
  160.    PacketRadio :  DL1FDT@DB0GV
  161.  
  162.    Bankverbindung:
  163.    Naspa Wiesbaden
  164.    BLZ  510 500 15
  165.    Kto 1010 299 72
  166.  
  167. Der schnellste Weg, den Autor zu erreichen, ist sicherlich die email!
  168.  
  169.  
  170. 3.1 Shareware
  171. -------------
  172.  
  173. Dieses Programm wird als Shareware vertrieben. Das hei₧t, Sie können
  174. das Programm beliebig und in vollem Umfang testen. Unter Testen
  175. verstehe ich einen Zeitraum von ca. 3 Wochen. Danach sollte klar
  176. sein, ob Sie das Programm weiter benutzen wollen oder nicht.
  177.  
  178. Welche Einschränkung hat das Programm in der Öffentlichen Version?
  179.  
  180. *- Keine -*
  181.  
  182. Denn es gibt keine andere Version von zControl! Die Funktionen des
  183. Programms werden in der öffentlichen Version also *nicht*
  184. eingeschränkt! Somit handelt es sich bei zControl um einen *echten*
  185. Vertreter der Gattung Shareware.
  186.  
  187. Mit der Registrierung bezahlen Sie ein Programm, welches Sie schon
  188. besitzen und ausgiebig testen konnten. Viel fairer kann man Software
  189. wohl kaum anbieten. Ich hoffe das zahlt sich (trotzdem) aus.
  190.  
  191. Wenn Ihnen das Programm gefällt und es weiter benutzen wollen, so
  192. müssen Sie sich bei dem Autor registrieren lassen. Die erfolgt
  193. einfach durch Zahlung des Shareware-Beitrags von DM 10, als
  194. Überweisung, Bargeld oder Verrechnungsscheck.
  195.  
  196. Bitte beachten Sie folgendes: Wenn Sie ein Shareware-Programm
  197. benutzen ohne sich registrieren zu lassen, dann benutzen Sie eine
  198. Raubkopie!
  199.  
  200. Standard-Disclaimer:
  201.  
  202.     Das Programm wurde mit Sorgfalt erstellt. Der Autor übernimmt
  203.     allerdings keinerlei Verantwortung für irgendwelche Schäden, die
  204.     im Zusammenhang mit der Benutzung, Nicht-Benutzung oder
  205.     Verschmutzung von zControl entstehen.
  206.  
  207.  
  208. 3.2 UK Register
  209. ---------------
  210.  
  211. UK users may register for zControl via CyberSTrider, the shareware
  212. support scheme run by Denesh Bhabuta. The UK shareware fee for
  213. zControl currently stands at 6 Pounds Sterling, which entitles you to
  214.  
  215.    ∙ A printed labelled Master Disk with the latest version of
  216.      zControl, plus a selection of other shareware supported by
  217.      Denesh.
  218.  
  219.    ∙ Free e-mail, post and telephone support
  220.  
  221.    ∙ Free update service (as long as the registration fee does not go
  222.      up, or it becomes commercial)
  223.  
  224. If you use zControl, then you must register. Make cheques, postal
  225. orders, international money orders, and eurocheques payable to DENESH
  226. BHABUTA, for the sum of 6 Pounds Sterling (overseas users please add
  227. 1 pound), and send with your details to:
  228.  
  229. CyberSTrider
  230. 203 Parr Lane
  231. Unsworth
  232. Bury
  233. Lancashire
  234. BL9 8JW
  235. England
  236.  
  237. E-mail: dbhabuta@cix.compulink.co.uk
  238.         danny@micros.hensa.ac.uk
  239.  
  240.  
  241. 3.2.1 Free Update Service
  242.  
  243. Registered users may benefit from the free update service by sending
  244. an unlabelled blank floppy disk and stamped self addressed envelope
  245. to Denesh at the above address.
  246.  
  247.  
  248. 3.3 Preisliste
  249. --------------
  250.  
  251. Gegenwärtig kostet die Registrierung von zControl auf einen einzelnen
  252. Benutzer:
  253.  
  254.     DM 10,-
  255.  
  256.  
  257.  
  258. 4 Entstehungsgeschichte
  259. =======================
  260.  
  261. Von Atari wird seit TOS 2.00 das Accessory XCONTROL.ACC mitgeliefert.
  262. Es dient als Umgebung für die CPX-Module. Das sind Module, mit denen
  263. man den Rechner bzw. die Software konfigurieren kann. Es gibt z.B.
  264. Module zur Konfiguration der seriellen Schnittstellen, der Tastatur
  265. und des Druckers. Mancher Software liegt auch ein CPX-Modul bei. Die
  266. Module erkennt man an der Datei-Endung '.CPX'.
  267.  
  268. Die Module sind ohne ein modulares Kontrollfeld (zControl oder
  269. XControl) nicht lauffähig!
  270.  
  271. Nachdem sich mittlerweile gezeigt hat, da₧ XControl wohl ein paar
  272. Bugs hat, entstand die Idee eine Alternative zu schaffen.
  273.  
  274. *Diese Alternative soll nun zControl bieten.*
  275.  
  276. Es lädt die gleichen CPX-Module wie XControl und verhält sich
  277. weitgehend kompatibel, soweit es die Dokumentation zu den CPX-Modulen
  278. verlangt.
  279.  
  280. Die Vorteile gegenüber XControl liegen auf der Hand:
  281.  
  282.    ∙ zControl wird weiterentwickelt, d.h. eventuelle auftretende
  283.      Probleme werden behoben.
  284.  
  285.    ∙ zControl unterstützt moderne Protokolle:
  286.  
  287.       - Drag&Drop
  288.  
  289.       - Iconifizierung
  290.  
  291.       - AV-Protokoll
  292.  
  293.      Das bedeutet, da₧ sich das Programm perfekt in moderne
  294.      Benutzeroberflächen integriert.
  295.  
  296.    ∙ zControl ermöglicht das gleichzeitige arbeiten mit mehreren
  297.      Modulen! Jedes CPX-Modul läuft dabei in einem eigenen Fenster.
  298.  
  299.    ∙ zControl kann weitgehend per Tastatur bedient werden.
  300.  
  301.    ∙ zControl enthält weitere nützliche Features, die mancher
  302.      vielleicht schon vermi₧t hat.
  303.  
  304.  
  305.  
  306. 5 Installation
  307. ==============
  308.  
  309. Kopieren Sie die Datei ZCONTROL.ACC auf die oberste Ebene Ihres
  310. Bootlaufwerkes. Erzeugen Sie sich auf Ihrem Laufwerk einen Ordner mit
  311. dem Namen CPX und kopieren Sie Ihre CPX-Module dort hinein. Natürlich
  312. darf der Ordner auch anders hei₧en. Dann booten Sie den Rechner neu.
  313.  
  314. Nun rufen Sie das Programm über den Eintrag in der Menuzeile auf.
  315. Klicken Sie auf den Knopf 'Optionen' im Hauptdialog. In dem
  316. erscheinenden Popup-Dialog wählen Sie den Eintrag
  317. 'Voreinstellung...'. Dort klicken Sie auf den Eintrag der unter 'CPX
  318. Verzeichnispfad' steht. In dem erscheinenden Dateiauswahldialog geben
  319. Sie an, aus welchem Ordner die CPX-Module geladen werden sollen. Die
  320. Bestätigung erfolgt mit dem 'OK'-Knopf. Üblicherweise sollte dies
  321. z.B. ein Ordner mit folgendem Pfad sein:
  322.  
  323. C:\CPX\
  324.  
  325. Klicken Sie auf den Knopf 'Sichern' und bestätigen Sie die
  326. Sicherheitsabfrage. Danach sollte zControl bei jedem Start die CPX-
  327. Module im richtigen Ordner suchen.
  328.  
  329. Unter Multitasking-Systemen kann zControl natürlich auch als
  330. Applikation gestartet werden. Man ändert dazu den Programmnamen von
  331. .ACC auf .APP oder .PRG und schon kann man zControl als normales
  332. Programm laufen lassen.
  333.  
  334.  
  335.  
  336. 6 Bedienung des Programms
  337. =========================
  338.  
  339. Im folgenden wird kurz auf die Bedienung des Programmes eingegangen.
  340.  
  341.  
  342. 6.1 Hauptdialog
  343. ---------------
  344.  
  345. Nach dem Starten des Programmes öffnet sich der Hauptdialog. Dort
  346. wird angezeigt, welche CPX-Module geladen wurden und somit verfügbar
  347. sind. Wurden mehr Module gefunden, als in den Dialog passen (was die
  348. Regel ist), so kann man mittels dem rechts angeordneten vertikalen
  349. Schieber die anderen Einträge erreichen.
  350.  
  351. ACHTUNG:
  352. In der Beta-Version wird der Fenstertitel als Laufschrift
  353. dargestellt. Dies soll einen daran erinnern, da₧ es sich eben um eine
  354. Vorab-Version handelt!
  355.  
  356.  
  357. 6.2 Popup-Dialog 'Optionen'
  358. ---------------------------
  359.  
  360.    ∙ Info...
  361.      Unter diesem Punkt erhalten Sie einen kurzen Copyright-Hinweis
  362.      zu dem Programm, unter anderem steht hier auch die
  363.      Versionsnummer des Programmes.
  364.  
  365.    ∙ Voreinstellung...
  366.      Mit diesem Punkt kommen Sie zu einem Dialog, der Ihnen die
  367.      Konfiguration des Programmes ermöglicht.
  368.  
  369.    ∙ Öffne CPX...
  370.      Falls ein Modul selektiert ist, können Sie es hier starten,
  371.      genau so als ob Sie einen Doppelklick auf den Modul-Eintrag
  372.      gemacht hätten.
  373.  
  374.    ∙ CPX Info...
  375.      Falls ein Modul selektiert ist, erhalten Sie hier ein paar
  376.      interne Informationen über das Modul.
  377.  
  378.    ∙ Entferne CPX...
  379.      Das selektierte Modul wird aus dem Speicher entfernt.
  380.  
  381.  
  382. 6.3 Voreinstellung
  383. ------------------
  384.  
  385. In diesem Dialog kann man
  386.  
  387.    ∙ CPX-Module neu laden.
  388.  
  389.    ∙ in den Dialog zur Modul-Auswahl wechseln.
  390.  
  391.    ∙ die Anzahl der angezeigten CPX-Einträge im Hauptdialog
  392.      bestimmen.
  393.  
  394.    ∙ die von zControl benutzte Sprache einstellen. Bisher wird
  395.      Deutsch und Englisch unterstützt.
  396.  
  397.    ∙ das Verzeichnis, in dem die CPX-Module gesucht werden,
  398.      einstellen.
  399.  
  400.  
  401. 6.4 Modul-Auswahl
  402. -----------------
  403.  
  404. In diesem Dialog kann man auswählen, welche CPX-Module beim nächsten
  405. Laden berücksichtigt werden sollen. Aktive Module werden in der Liste
  406. mit einem Haken vor dem Eintrag dargestellt.
  407.  
  408. Durch einen Mausklick auf einen Eintrag kann man den Status des
  409. Moduls verändern.
  410.  
  411. Hinweis: Das (de)aktivieren wird auf dem Laufwerk durch verändern der
  412. Datei-Endung erreicht. Aktive Module haben die Endung '.CPX' und
  413. deaktivierte Module die Endung '.CPZ'.
  414.  
  415.  
  416. 6.5 Selektieren eines Moduls
  417. ----------------------------
  418.  
  419. Ein Modul wird durch einen einfachen Klick mit der linken Maustaste
  420. auf den Eintrag selektiert. Die Selektion ist durch die invertierte
  421. Darstellung erkennbar. Wenn man ein Modul selektiert hat, kann man
  422. mit dem Popup-Dialog 'Optionen' weitere Informationen zu dem Modul
  423. erhalten.
  424.  
  425.  
  426. 6.6 Starten eines Moduls
  427. ------------------------
  428.  
  429. Ein Modul wird durch
  430.  
  431.    ∙ einen Doppelklick mit der Maus auf den CPX-Eintrag
  432.  
  433.    ∙ drücken der Return-Taste bei selektiertem Eintrag
  434.      (siehe Tastaturbedienung)
  435.  
  436.    ∙ eine VA_START-Meldung
  437.  
  438.    ∙ eine Drag&Drop-Meldung
  439.  
  440. gestartet.
  441.  
  442. Es wird für jedes laufende CPX-Modul ein eigenes Fenster geöffnet.
  443. Man kann in zControl gleichzeitig mehrere CPX-Module offen haben! Zur
  444. Zeit werden maximal 4 CPX-Fenster unterstützt, diese Zahl ist
  445. willkürlich gewählt und kann in Zukunft erweitert werden.
  446.  
  447.  
  448. 6.7 Tastaturbedienung
  449. ---------------------
  450.  
  451. zControl läst sich im Hauptdialog weitgehend per Tastatur bedienen:
  452.  
  453.    Cursor-Hoch      - Bewegt den Selektierbalken um eine Position nach
  454.                       oben.
  455.                     - Falls noch keine Selektion existiert, wird der
  456.                       unterste Eintrag im Fenster selektiert.
  457.    Cursor-Runter    - Bewegt den Selektierbalken um eine Position nach
  458.                       unten.
  459.                     - Falls noch keine Selektion existiert, wird der
  460.                       oberste Eintrag im Fenster selektiert.
  461.    Shift-Cursor     - Bewegt den Selektierbalken Seitenweise.
  462.    Return
  463.    Enter            - Falls eine Selektion existiert, so wird das
  464.                       entsprechende CPX-Modul aufgerufen.
  465.                     - Existiert keine Selektion, so wird das
  466.                       Fenster geschlossen.
  467.    Esc              - Hebt eine eventuell existierende Selektion auf.
  468.    Control-U
  469.    Control-Q        - Das Fenster wird geschlossen.
  470.    Control-Alternate-Leertaste
  471.                     - Das Fenster wird iconifiziert
  472.                       (siehe Iconifizierung)
  473.  
  474.  
  475. 6.8 Parameter-Übergabe an zControl
  476. ----------------------------------
  477.  
  478. Beim Start als Programm kann man zControl Parameter übergeben. Bisher
  479. wird die Kommandozeile lediglich nach dem Namen eines CPX-Moduls
  480. abgesucht. Falls das entsprechende Modul beim Start von zControl
  481. geladen wurde, wird es aktiviert.
  482.  
  483. zControl akzeptiert auch deaktivierte Module, mit der Datei-Endung
  484. CPZ.
  485.  
  486.  
  487. 6.8.1 Anwendung anmelden
  488.  
  489. Es empfiehlt sich, zControl als Anwendung für die Datei-Endung
  490. '*.CPX' anzumelden. Im Atari-Desktop funktioniert dies, indem man das
  491. Programm selektiert und im Menu die Funktion 'Anwendung anmelden'
  492. auswählt. Dort trägt man die Endung 'CPX' für das Programm ein.
  493. Danach mu₧ diese Einstellung noch gesichert werden, mittels 'Arbeit
  494. sichern'.
  495.  
  496. Wenn man dann ein Doppelklick auf eine CPX-Datei macht, so wird
  497. zControl gestartet und die gewählte CPX-Datei aktiviert. Damit hat
  498. man die Möglichkeit, CPX-Module als Icon auf den Desktop zu legen und
  499. per Doppelklick direkt aufzurufen.
  500.  
  501. Unter dem Desktop-Ersatz 'Gemini' kann man unter 'Anwendungen...' die
  502. Option 'Versteht VA_START-Meldung' aktivieren. Falls zControl schon
  503. gestartet ist, übergibt Gemini den Modulnamen per VA_START-Message
  504. als Parameter.
  505.  
  506. Tip:
  507. Man kann sich eine leere Datei mit der Endung .CPX erstellen, die man
  508. lediglich zum aktivieren von zControl verwendet. Bei mir heist die
  509. datei z.B. _CALL.CPX und hat 0Bytes Grö₧e. Diese Datei habe ich als
  510. Icon auf dem Desktop liegen, ein Doppelklick darauf aktiviert das als
  511. Accessorie installierte zControl.
  512.  
  513.  
  514. 6.8.2 AV-Protokoll
  515.  
  516. zControl versteht die Meldung VA_START des AV-Protokolls. Als
  517. Parameter kann der Name eines CPX-Moduls übergeben werden. Falls das
  518. Modul schon geladen ist, wird es aktiviert. Andernfalls wird
  519. versucht, das Modul neu zu laden.
  520.  
  521. zControl versteht auch die Meldung VA_DRAGACCWIND. Man kann z.B. aus
  522. Gemini heraus eine CPX-Datei auf das zControl-Fenster ziehen und
  523. fallenlassen. Das funktioniert dann genauso wie bei Drag&Drop.
  524.  
  525.  
  526. 6.8.3 Drag&Drop
  527.  
  528. zControl versteht das Drag&Drop-Protokoll. Hat man ein
  529. Betriebssystem, welches Drag&Drop und unterstützt, so kann man
  530. einfach eine CPX-Datei vom Desktop auf das zControl-Fenster ziehen
  531. und dort fallenlassen.
  532.  
  533. Daraufhin lädt zControl das Modul und aktiviert es.
  534.  
  535. Folgende TOS-kompatible Betriebssysteme beherschen zur Zeit meines
  536. Wissens das Drag&Drop-Protokoll:
  537.  
  538.    ∙ MultiTOS mit einem AES >= 4.1
  539.  
  540.    ∙ MagiC! 3.0
  541.  
  542.    ∙ MagiCMac (auf dem Apple Macintosh)
  543.  
  544.  
  545. 6.9 Iconifizierung
  546. ------------------
  547.  
  548. Unter Iconifizierung versteht man die Verkleinerung eines normalen
  549. GEM-Fensters auf minimale Grö₧e. Das Fenster ist dann sehr klein und
  550. zeigt nur noch ein Symbol an, nicht mehr den echten Inhalt. Besonders
  551. bei vielen offenen Fenstern ist es sehr angenehm, die geöffneten
  552. Fenster eines Programms vorübergehend 'aus dem Weg zu schaffen'.
  553.  
  554. zControl beherscht zwei verschiedene Arten des Iconify:
  555.  
  556.    ∙ MultiTOS-Iconify
  557.  
  558.      Unter MultiTOS wird rechts oben im Fenstertitel eine Iconify-
  559.      Knopf angezeigt. Klickt man darauf, so wird das Fenster zu einem
  560.      Icon verkleinert.
  561.  
  562.    ∙ ICFS-Iconify
  563.  
  564.      Falls kein Betriebssystem mit Iconify-Möglichkeiten gefunden
  565.      wird, aber der Iconify-Server (ICFS) vorhanden ist, so wird das
  566.      Iconify per ICFS unterstützt. Wenn man den Schlie₧-Knopf des
  567.      Fensters betätigt und gleichzeitig eine der Tasten
  568.  
  569.       - Control
  570.  
  571.       - Shift
  572.  
  573.       - Alternate
  574.  
  575.      gedrückt hält, so wird das Fenster zu einem Icon verkleinert.
  576.  
  577. Das Iconifizieren kann man auch per Tastatur mittels Control-
  578. Alternate-Leertaste erreichen. Also einfach die Control- und die
  579. Alternate-Taste gedrückt halten und dann die Leertaste betätigen.
  580.  
  581.  
  582.  
  583. 7 Die INF-Datei
  584. ===============
  585.  
  586. zControl speichert seine Parameter in der Datei ZCONTROL.INF, welche
  587. beim Programmstart gesucht wird. Zur Zeit werden folgende Parameter
  588. gespeichert:
  589.  
  590.    ∙ Der Pfad aus dem die CPX-Module nachgeladen werden.
  591.  
  592.    ∙ Die Einstellung, wieviele CPX-Modul-Einträge im Hauptdialog
  593.      dargestellt werden.
  594.  
  595.    ∙ Die Position des zControl-Fensters.
  596.  
  597.    ∙ Die Positionen der CPX-Fenster.
  598.  
  599. Sämtliche Parameter werden gespeichert, wenn man im Dialog
  600. 'Optionen/Voreinstellung...' den Knopf 'Sichern' wählt.
  601.  
  602.  
  603. 7.1 Debug-Funktion
  604. ------------------
  605.  
  606. Manchmal kommt es vor, da₧ ein CPX-Modul Probleme bereitet. Damit man
  607. bei einer gro₧en Zahl von Modulen herausfinden kann, welches Modul
  608. das ist, kann man eine einfache Debug-Funktion aktivieren.
  609.  
  610. Wenn man eine Zeile
  611.  
  612.    DEBUG = STDOUT
  613.  
  614. von Hand in die INF-Datei einfügt, dann wird beim Starten jedes
  615. Moduls eine kurze Text-Ausgabe erzeugt. Damit kann man z.B. beim
  616. booten herausfinden, wo das Problem liegt.
  617.  
  618.  
  619. 7.2 Wo wird die INF-Datei gesucht?
  620. ----------------------------------
  621.  
  622. zControl sucht seine INF-Datei mit den Voreinstellungen der
  623. Reihenfolge nach mit folgenden Methoden:
  624.  
  625.   1. Im AES-Environment, per shel_envrn(), wird nach der Variablen
  626.      HOME gesucht.
  627.  
  628.   2. Das beim Programmstart übergebene Environment wird nach der
  629.      Variablen HOME abgesucht.
  630.  
  631.   3. Mittels shel_read() wird versucht den Startpfad zu ermitteln.
  632.  
  633.   4. In argv[0] wird nach dem Startpfad gesucht.
  634.  
  635.   5. Auf dem Wurzelverzeichnis des Bootlaufwerks, welches mittels
  636.      _bootdev ermittelt wird. Üblicherweise also C:\.
  637.  
  638. Sobald eine der Methoden einen Pfad liefert, so wird er zum Laden und
  639. Speichern der INF-Datei verwendet.
  640.  
  641. Es wird empfohlen, die HOME-Variable zu benutzen. In Zukunft werden
  642. hoffentlich immer mehr Programme dieses Verfahren benutzen.
  643.  
  644. Unter dem Betriebssystem MagiC (oder Mag!X) kann man die HOME-
  645. Variable erzeugen indem man z.B. folgende Zeile in die Datei MAGX.INF
  646. schreibt:
  647.  
  648. Die Zeile sollte auf jeden Fall vor der Zeile mit dem #_CTR stehen.
  649.  
  650. Unter MultiTOS kann man die HOME-Variable erzeugen, indem man in der
  651. Datei GEM.CNF folgende Zeile einträgt:
  652.  
  653. setenv HOME=c:\gemini2\user
  654.  
  655.  
  656.  
  657. 8 Undokumentierte Funktionen
  658. ============================
  659.  
  660. In XControl gibt es wenigstens zwei nicht-dokumentierte Funktionen,
  661. die von manchen Modulen benutzt werden. Das sind nur sehr wenige
  662. Module, aber es gibt sie.
  663.  
  664. Zur Zeit werden nur alle dokumentierten Funktionenunterstützt. Falls
  665. man Module hat, die Probleme machen, so sollte man Vorsicht walten
  666. lassen.
  667.  
  668. Es folgt eine Auflistung der mir bekannten Module, die
  669. undokumentierte Funktionen von XControl verwenden.
  670.  
  671.  
  672. 8.1 KONFIG.CPX
  673. --------------
  674.  
  675. Es gibt ein CPX-Modul von Atari, welches leider eine Besonderheit
  676. darstellt. Es nennt sich KONFIG.CPX und dient zur Konfiguration der
  677. CPX-Header. Man kann dort z.B. die Farben des Icons und der Texte
  678. einstellen.
  679.  
  680. Leider verwendet dieses Modul nicht-dokumentierte Funktionen von
  681. XControl. Das führt zum sofortigen Absturz des Rechners.
  682.  
  683. Deshalb wird dieses Modul zur Zeit von zControl abgelehnt. Bei dem
  684. Versuch das Modul zu starten erscheint eine Fehlermeldung.
  685.  
  686.  
  687. 8.2 LINK_CPX.CPX
  688. ----------------
  689.  
  690. Das Modul von Richard Kurz verwendet ebenfalls nicht-dokumentierte
  691. Funktionen von XControl. Immerhin verhält es sich etwas kooperativer
  692. als KONFIG.CPX und stürzt nicht sofort ab...
  693.  
  694. Trotzdem ist das Modul mit Vorsicht zu geniessen, diese Funktionen
  695. werden zur Zeit einfach nicht unterstützt!
  696.  
  697.  
  698. 8.3 DFREE.CPX
  699. -------------
  700.  
  701. Dieses Modul von Andreas Mandel benutzt auch eine nicht-dokumentierte
  702. Funktion (reserve2()), ich wei₧ aber nicht weshalb.
  703.  
  704.  
  705.  
  706.  
  707. A Das Format der INF-Datei
  708. ==========================
  709.  
  710. zControl verwendet in seiner Parameter-Datei folgende Schlüsselworte:
  711.  
  712.    ∙ CPX_PATH
  713.      Mit diesem Parameter wird festgelegt, in welchem Pfad die CPX-
  714.      Module gesucht werden.
  715.  
  716.    ∙ ANZ_DISP_ENTRY
  717.      Mit diesem Eintrag wird festgelegt, wieviele CPX-Modul-Einträge
  718.      im Hauptdialog dargestellt werden. Man kann zur Zeit zwischen
  719.      vier und 12 Einträgen anzeigen.
  720.  
  721.    ∙ COUNTRY
  722.      Hier wird die Länderkennung für die verwendete Sprache von
  723.      zControl gespeichert.
  724.  
  725.    ∙ WIND_MAIN
  726.      Unter diesem Eintrag wird die Position des zControl-Fensters
  727.      gespeichert. Das Fenster wird nach dem Programmstart an dieser
  728.      Position geöffnet.
  729.  
  730.    ∙ WIND_CPX?
  731.      Hinter diesem Eintrag wird die Position eines Fensters für ein
  732.      CPX-Modul gespeichert. Anstelle des Fragezeichens steht in der
  733.      INF-Datei die Nummer des Fensters, z.B. 'WIND_CPX2' für das
  734.      zweite CPX-Fenster.
  735.  
  736.    ∙ DEBUG
  737.      Siehe Debug-Funktion.
  738.  
  739.    ∙ SINGLELOAD
  740.      Falls die Zeile
  741.  
  742.  
  743.          SINGLELOAD = TRUE
  744.  
  745.      in der INF-Datei auftaucht, dann werden auch als ACC unter
  746.      Single-TOS die CPXe geladen. Dies ist dafür gedacht, da₧ man
  747.      ausprobieren kann, ob zControl auf dem entsprechenden Rechner
  748.      läuft oder nicht.
  749.      Diese Option ist nur für diejenigen, die zControl als ACC unter
  750.      Single-TOS laufen lassen!
  751.  
  752.  
  753.  
  754. B Das Format der Datei FILESORT.SYS
  755. ===================================
  756.  
  757. Unter TOS werden die CPX-Dateien in einer festgelegten Reihenfolge
  758. geladen. Normalerweise ist dies die Reihenfolge in der die Dateien in
  759. den entsprechenden Ordner kopiert wurden. Wenn man die Reihenfolge
  760. der CPX-Module ändern möchte, so mu₧ man dies recht aufwendig durch
  761. hin- und herkopieren realisieren.
  762.  
  763. Die Reihenfolge in der die Module geladen werden ist die gleiche
  764. Reihenfolge in der sie dann im Kontrollfeld angezeigt werden.
  765.  
  766. Unter MagiCMac auf dem Mac gibt es nun diese natürliche Reihenfolge
  767. nicht mehr. Die Dateien werden in alphabetischer Folge geladen. Das
  768. ist zwar schön, aber nicht praktisch.
  769.  
  770. Für diese beiden Fälle habe ich eine neue Möglichkeit geschaffen.
  771. Wenn zControl in dem CPX-Ordner eine Datei mit dem Namen FILESORT.SYS
  772. findet, so wird diese ausgewertet. In dieser Datei befindet sich in
  773. jeder Zeile der Name eines CPX-Moduls, ohne Pfad. Beim Laden der
  774. Module wird nun als allererstes versucht die angegebenen Module der
  775. Reihe nach zu laden. Wenn ein Modul nicht gefunden wird, so gibt es
  776. hier keine Fehlermeldung. Nach dem abarbeiten der Datei FILESORT.SYS
  777. werden die restlichen CPX-Module geladen.
  778.  
  779. Somit kann man zumindestens die Reihenfolge der ersten Module
  780. bestimmen. Ich gebe zu, dieses Verfahren ist nicht unbedingt einfach,
  781. denn man mu₧ diese Datei für sich selbst konfigurieren. Aber dieses
  782. Verfahren ist sehr flexibel. Die Idee ist allerdings, dieses Vorgehen
  783. in der Zukunft komfortabler zu gestalten, indem zControl selbst diese
  784. Datei erstellen wird.
  785.  
  786. Zur Zeit kann man die Datei mit einem ASCII-Editor von Hand erstellen
  787. oder ändern.
  788.  
  789.  
  790.  
  791. C Bezugsquellen
  792. ===============
  793.  
  794. Bereits registrierte Benutzer erhalten die jeweils neueste Version
  795. des Programms beim Autor gegen Einsendung einer formatierten Diskette
  796. sowie eines frankierten und adressierten Rückumschlags. Für noch-
  797. nichtregistrierte Benutzer kommt der SharewareBetrag von 10DM hinzu.
  798.  
  799. Besitzer eines Modems finden die aktuelle Version von zControl in der
  800. Maus Offenbach 2:
  801.  
  802.    ∙ Maus OF2: 06103-921170
  803.  
  804. Der Archivname lautet jeweils ZCONTROL.LZH.
  805.  
  806. Auf jeweils neue Versionen wird in der MausNet-Gruppe "ATARI.NEWS"
  807. hingewiesen.
  808.  
  809.  
  810.  
  811. D Danksagungen
  812. ==============
  813.  
  814. Ich möchte mich bei ein paar Leuten bedanken, ohne ihre Mithilfe wäre
  815. zControl niemals so ein schönes Programm geworden. Ich habe zwar die
  816. ganze 'Dreckarbeit' gemacht, aber einige Ideen und Informationen
  817. kamen von au₧en.
  818.  
  819. Vielen Dank an...
  820.  
  821.    ∙ *Dirk Haun @ WI2*
  822.      für Informationen und sein aufmerksames Testen.
  823.      ("Na wer sagt's denn, es hat sich ja doch einer gefunden, der
  824.      einen XControl-Clone schreibt")
  825.  
  826.    ∙ *Julian Reschke @ WI2*
  827.      für seine Informationen bezüglich Drag&Drop und diesem ganzen
  828.      modernen Kram...
  829.  
  830.    ∙ *Martin Osieka @ OF2*
  831.      für seine Hilfe bei allerlei Problemen. Besonderer Dank gebührt
  832.      ihm für die Idee, wie man mehrere CPX-Module gleichzeitig
  833.      verwaltet! So ein echter Informatiker kann hin und wieder sehr
  834.      hilfreich sein - ich kann das nur empfehlen!
  835.      ("Bitte nicht jeden Tag eine neue Release")
  836.  
  837.    ∙ *Rainer Wiesenfeller @ RS*
  838.      für das versprochene Bier, falls ich das irgendwann bekomme.
  839.      ("... finde ich es gut, da₧ sich mal jemand die Mühe gibt,
  840.      dieses Programm neu zu programmieren und zu pflegen.")
  841.  
  842.    ∙ *Reiner Rosin @ WI2*
  843.      der mir seinen Gruppenprogrammteil zur Verfügung gestellt hat.
  844.      Zwar nicht freiwillig, aber immerhin...
  845.  
  846.    ∙ *Rene Bartholomay @ OL*
  847.      der die Chance genutzt hat, der erste zahlende Benutzer von
  848.      zControl zu werden. ;-)
  849.      ("Endlich mal jemand, der auch an die Gro₧bildschirmbenutzer
  850.      denkt!")
  851.  
  852.  
  853.  
  854. E Probleme
  855. ==========
  856.  
  857. *Zu wenig Speicher unter MagiC*
  858.  
  859. Manchmal kann es vorkommen, da₧ zControl sich beschwert, da₧ nicht
  860. genügend Speicher vorhanden ist um alle Module zu laden. Und das,
  861. obwohl man jede Menge Speicher hat. Dies kommt dadurch zustande, da₧
  862. sich ein Programm beim booten den gesamten Speicher reserviert und
  863. erst später wieder freigibt.
  864.  
  865. Unter MagiC kann man dies verhindern, indem man aus der Datei
  866. MAGX.INF die Zeile mit dem Eintrag #_TSL entfernt. Das präemptive
  867. Multitasking wird dann erst von dem MagiC-CPX-Modul eingeschaltet.
  868.  
  869.  
  870.  
  871. F History
  872. =========
  873.  
  874.    ∙ *Version 0.23*
  875.  
  876.       - Die Funktion cpx_getcookie() sollte jetzt endgültig
  877.         funktionieren. Ich hatte die korrigierte Routine nicht neu
  878.         compiliert.
  879.  
  880.    ∙ *Version 0.22*
  881.      Dies war eigentlich nur eine Beta-Version zum testen.
  882.  
  883.       - Man kann zControl jetzt auch deaktivierte Module (mit der
  884.         Endung CPZ) übergeben. Sie werden dann gestartet. Die
  885.         Dateiendung wird nicht verändert.
  886.  
  887.       - Es kam wie es kommen muste: Nur mal eben schnell eine
  888.         Kleinigkeit geändert und schon Unheil angerichtet. Die
  889.         Version 0.21 lief nicht ordentlich. Ich habe da etwas mit der
  890.         Fensterverwaltung komplett durcheinandergebracht.
  891.  
  892.       - Das beta-Zeichen in dem Menu-Eintrag als ACC entfernt. Unter
  893.         englischem TOS gab es Darstellungsprobleme.
  894.  
  895.       - Wenn nach dem starten von zControl ein Modul gelöscht oder
  896.         umbenannt wurde, so stürzte das Programm beim Aufruf des
  897.         entsprechenden Moduls ab. Jetzt gibt es eine Fehlermeldung
  898.         und das Modul wird aus der Liste entfernt.
  899.  
  900.    ∙ *Version 0.21*
  901.  
  902.       - zControl kann jetzt in der Sprache umgeschaltet werden.
  903.         Bisher wird Englisch und Deutsch unterstützt.
  904.  
  905.       - Iconifizierte Module bekommen keinen Mausclick und
  906.         Tastendruck mehr.
  907.  
  908.       - CPX-Module bekommen jetzt auch folgende Meldungen:
  909.         AP_DRAGDROP und VA_START
  910.  
  911.       - Die Funktion cpx_getcookie() hatte einen Fehler.
  912.  
  913.       - Die Zeitanzeige hatte ein paar Unschönheiten.
  914.  
  915.    ∙ *Version 0.20*
  916.  
  917.       - Die erste öffentliche Version von zControl.
  918.  
  919.  
  920.  
  921.  
  922.