home *** CD-ROM | disk | FTP | other *** search
/ Computer Club Elmshorn Atari PD / CCE_PD.iso / pc / 0600 / CCE_0632.ZIP / CCE_0632 / GOBJ_111.ZIP / GOBJECTS.111 / DOKU / XACCSPY.TXT < prev   
Text File  |  1994-03-25  |  8KB  |  161 lines
  1. "XAcc-Spy" - Der XAcc-Spion (Version 25.03.1994)
  2. ================================================
  3.  
  4. Dieses Programm ist FREEWARE, d.h. es darf und soll weitergegeben und
  5. benutzt werden. Die Weitergabe ist gestattet, sofern die Dateien
  6. XACCSPY.APP, XACCSPY.TXT (diese Datei) und der Ordner SOURCE zusammen
  7. und unverändert weitergegeben werden. Wird das Programm in PD-Serien
  8. aufgenommen, auf CDs gepreßt etc., möge man sich doch bitte um die
  9. aktuellste Version kümmern.
  10.  
  11. Meine Adresse: Thomas Much, Gerwigstraße 46, 76131 Karlsruhe
  12.                Tel. (0721) 62 28 41
  13.                EMail: Thomas_Much@KA2.MAUS.DE
  14.                       UK48@ibm3090.rz.uni-karlsruhe.de
  15.  
  16. XACCSPY.ZIP sollte auf jeden Fall in den Mäusen KA, HAL und HL zu
  17. finden sein (Achtung: Kein Gastdownload von 18-21.45 Uhr).
  18.  
  19.  
  20. Wozu ist XAcc-Spy gut?
  21. ----------------------
  22. XAcc-Spy ist eine Art "XAcc-Debugger", d.h. in einem Fenster werden
  23. alle laufenden Applikationen angezeigt, die das XAcc-(bzw. AV-)Proto-
  24. koll unterstützen. Dazu erhält man alle XAcc-Parameter (s.u.), mit
  25. denen man solche Programme recht gut einschätzen kann. Diese Anleitung
  26. soll allerdings die XAcc-Doku nicht ersetzen, auf sie sei deshalb an
  27. dieser Stelle verwiesen.
  28.  
  29.  
  30. Installation und Anwendung
  31. --------------------------
  32. XAcc-Spy kann sowohl als Programm als auch als Accessory eingesetzt
  33. werden. Beim Einsatz als Programm kann man Accessories auf das XAcc-
  34. Protokoll hin untersuchen, mit dem Accessory kann man entsprechend
  35. ein Hauptprogramm gut untersuchen.
  36. Bei der Verwendung unter MultiTOS sollte der Programmtyp egal sein,
  37. allerdings kann es sein, daß einige Programme noch nicht die "neue"
  38. XAcc-Definition unterstützen, so daß man evtl. ein bißchen herum-
  39. probieren muß (s. "Debugging").
  40. Als Tastatursteuerung kommen derzeit nur <Control>+<Q>, <Control>+
  41. <U>, <Control>+<W> und <Control>+<*> (sowie die gängigen Tasten
  42. <Return>, <Help> etc.) in Frage, ansonten muß die Maus bemüht werden.
  43. In dem Fenster werden alle gefundenen XAcc-Applikationen unterein-
  44. ander angezeigt. Die Zeilen sind folgendermaßen aufgebaut:
  45. Ganz links steht der Name der Applikation. Daneben stehen die AES-
  46. ID und die Nummer des Menüeintrags. Unter einem Nicht-Multitasking-
  47. TOS kennzeichnet apID=0 das Hauptprogramm, das dann auch keinen Menü-
  48. eintrag besitzen sollte (meistens wird dann meID=-1 übergeben).
  49. Dann folgt die Programm-Version, die von der XAcc-Applikation be-
  50. liebig gesetzt und kodiert werden kann. Es folgen noch die unter-
  51. stützten Message-Groups. Jeder Unterstrich kennzeichnet eine Gruppe;
  52. wenn dort die entsprechende Zahl (von rechts nach links) eingetragen
  53. ist, wird diese XAcc-Message-Gruppe verstanden. Links von den Gruppen
  54. wird noch die Art des verstandenen Protokolls angezeigt (a=AV-Proto-
  55. koll, x=XAcc-Protokoll).
  56. Schließlich können noch "Extended Names" vorhanden sein. Mit diesen
  57. kann die Applikation einen maschinenlesbaren Programmtyp (normaler-
  58. weise zwei große Buchstaben) sowie einen entsprechenden "Menschen-
  59. lesbaren" Programmtyp angeben. Außerdem können "Extended Features"
  60. gesetzt werden, die aber normalerweise nur zwischen "gut bekannten"
  61. Programmen versendet und verstanden werden. Ganz zum Schluß folgt
  62. noch der generische Name; dieser kann gesetzt sein, wenn das
  63. Programm nicht überall den gleichen "offiziellen" Namen besitzt,
  64. aber dennoch eindeutig erkannt werden muß.
  65. Alle Buttons im Fenster und in der Toolbar unterstützen die Bubble-
  66. Help (Anklicken des gewünschten Buttons mit der _rechten_ Maus-
  67. taste), so daß sich eine weitere Erklärung hier erübrigt.
  68. Unter MultiTOS bzw. mit dem ICFS-Server wird auch Iconification
  69. unterstützt. In dem Icon-Fenster wird dann nur noch die Anzahl der
  70. gefundenen XAcc-/AV-Applikationen angezeigt.
  71.  
  72.  
  73. "Debugging"
  74. -----------
  75. Singletasking-TOS:
  76. Wird XAcc-Spy als Programm gestartet, sollten sofort alle ge-
  77. fundenen XAcc-Applikationen angezeigt werden; an deren Zahl
  78. darf sich eigentlich nichts mehr ändern.
  79. Beim Einsatz als Accessory ist es normal, daß sich nach jedem
  80. Start oder Verlassen eines Hauptprogramms die Liste ändert,
  81. je nachdem ob das Hauptprogramm XAcc unterstützt oder nicht
  82. (unter dem GEM-Desktop z.B. ist die Liste immer leer). Aller-
  83. dings kann man bei einigen Accessories beobachten, daß diese
  84. _nur_ mit dem Hauptprogramm kommunizieren und nicht (wie es die
  85. XAcc-Definition vorsieht) auch mit den anderen Accessories...
  86. Multitasking-TOS:
  87. Die Liste sollte für das Accessory bzw. für das Programm
  88. gleich aussehen. Unterschiede wird es nur geben, wenn andere
  89. Programme evtl. die XAcc-Multitasking-Definition nicht kennen.
  90. Wird ein neues XAcc-Programm oder -Accessory gestartet (oder
  91. verlassen), reagiert der XAcc-Spy mit einem automatischen Up-
  92. date der Liste!
  93.  
  94. Ein paar Beispiele, welche Programme was anzeigen:
  95. ObjectGEM-Programme geben normalerweise an, daß sie die Message-
  96. Groups 1 und 2 verstehen (meistens wird eine entsprechende An-
  97. frage allerdings per ACC_ACK zurückgewiesen, siehe ObjectGEM-
  98. Doku). Diese Applikationen sollten allgemein _keine_ Probleme
  99. mit XAcc haben. Außerdem verstehen ObjectGEM-Programme sowohl
  100. das XAcc- als auch das AV-Protokoll.
  101. Mit CAT kann man sehr schön die "Extended Names" sehen. So
  102. wird als Applikationstyp "DB" (für Datenbank) bzw. etwas les-
  103. barer "MausTausch-Programm" zurückgegeben. Leider ist die
  104. Abmeldung beim Programmende unter MultiTOS noch nicht ganz
  105. korrekt.
  106. Am besten (der von mir getesteten Programme) wird das XAcc-
  107. Protokoll von Connect beherrscht. Unter MultiTOS sieht es
  108. wirklich toll aus, wenn die XAcc-Liste bei Programmstart und
  109. -ende entsprechend aktualisiert wird :-)
  110.  
  111.  
  112. Was man sonst noch über XAcc-Spy wissen sollte
  113. ----------------------------------------------
  114. Wie man vielleicht am beiliegenden Quelltext erkennt, ist XAcc-Spy
  115. ein ObjectGEM-Programm. Zur Programmierung wurde die neue ObjectGEM-
  116. Version 1.11 verwendet.
  117. Aus dem objektorientierten Ansatz ergibt sich eine für ein "Diagnose"-
  118. Programm unübliche Größe. XAcc-Spy ist allerdings nicht unbedingt zum
  119. dauerhaften Einsatz vorgesehen, sondern eigentlich dazu, um "mal eben"
  120. zu überprüfen, ob ein Programm das XAcc-Protokoll korrekt beherrscht.
  121. Außerdem ist der Quelltext recht übersichtlich und entsprechend ein-
  122. fach zu warten. Und man darf nicht vergessen, daß der Spion FREEWARE
  123. ist, weshalb er von mir auch zum Testen der neuesten ObjectGEM-
  124. Features "mißbraucht" wird...
  125.  
  126. Schließlich muß ich noch darauf hinweisen, daß XAcc-Spy bei mir zwar
  127. wunderbar läuft, daß ich dies aber nicht garantieren kann. Wer XAcc-
  128. Spy einsetzt, tut dies AUF EIGENE GEFAHR. Sollte tatsächlich ein
  129. Fehler auftreten und ich davon erfahren, werde ich diesen nach
  130. Möglichkeit eliminieren.
  131.  
  132. So, nun aber viel Spaß beim "XAcc-debuggen", auf daß möglichst viele
  133. "schwarze Schafe" entlarvt werden, damit sich das XAcc-Protokoll
  134. noch besser durchsetzen kann! ;-)
  135.  
  136.  
  137.  
  138.  
  139. Bekannte Bugs
  140. -------------
  141. - unter Mag!x wird z.Z. noch nicht das XAcc-MT-Protokoll verwendet,
  142.   d.h. der XAcc-Spy wird dort andere Hauptprogramme wahrscheinlich
  143.   _nicht_ erkennen (das wird sich aber bald ändern ;-)
  144. - bei zwei installierten XAcc-Spionen kann es unter "normalem" TOS
  145.   zu Problemen mit der Resource kommen; Bugfixing läuft...
  146.  
  147.  
  148. Release-History
  149. ---------------
  150. 25.03.94
  151. - komplette Überarbeitung der Oberfläche
  152. - das AV-Protokoll wird ausgewertet
  153. - History-Fenster zum Mitprotokollieren der empfangenen Messages
  154. - ein Bug, durch den bei Verwendung von XAcc-Spy als Acc evtl. nicht
  155.   alle anderen XAcc-Accs erkannten wurden, ist beseitigt
  156. 04.02.94
  157. - die drei Bomben unter alten TOS-Versionen (bzw. die Memory Violation
  158.   unter MultiTOS) sollten beseitigt sein (offensichtlich ein PP-Bug...)
  159. 26.01.94
  160. - erste öffentliche Version
  161.