ARTM Amiga Real Time Monitor V2.04 ------------------------------------ Copyright © 1990 - 1994 by D. Jansen & F.J. Mertens ARTM ist ein Shareware Programm und darf ohne Profit kopiert werden ( max. Diskettenpreis + Porto ). ARTM darf nur unverändert und komplett weitergegeben werden. Bei regelmäßiger Benutzung bitten wir um einen Shareware-Beitrag von 20,- DM. Dafür er- haltet ihr einen Update - Service ohne die lästigen Requester. Es wird keine Haftung für eventuelle Schäden durch die Benutzung von ARTM übernommen. Wer das Geld lieber sicherheitshalber über- weisen will kann dies an folgende Bankverbindung tun. Bitte dabei immer die volle Adresse angeben sonst kann ich keine Update schicken wohin auch. Kriessparkasse Wildberg BLZ 606 510 70 KontoNr. 219190 Jeder registrierte ARTM - User erhält alle weiteren Updates kostenlos, wenn ich von ihm einen ausreichend frankierten Rück- umschlag und eine formatierte heile Diskette erhalte. Wenn ihr nur schreibt,um Bugs, Anregungen oder Fragen loszuwerden, dann fügt bitte ein ausreichend frankierten Rückumschlag bei. Das viele Porto wird ganz schön teuer. Wenn die Antwort dann mal länger dauert verzweifelt nicht, ich muß nebenbei auch noch arbeiten. ARTM gibt Aufschluß über viele Activities im Amiga, ist voll intuition-gesteuert und sehr leicht zu bedienen. Installation: Installation automatisch: Zur automatischen Installation existiert im Archiv ein Installer script. Hier muß der C= Installer benutzt werden. Installation manuel: Die Installation läuft ganz einfach ab. Da ARTM nur aus einem Programm besteht copieren Sie ARTM einfach mittels copy ARTM zielpath/ in das von Ihnen gewünschte Directory. Oder wählen Sie das ARTM ICON mit der Maus an und schieben es in die gewünschte Schublade auf der Workbench. Die .doc files kopieren Sie auch mit dem copy Befehl in das von Ihnen ausgewählte Directoy. Der ARTM.guide file soll nach LOCALE:HELP/ kopiert werden. copy ARTM.guid SYS:LOCALE/HELP/ARTM.guide assign HELP: SYS:LOCAL/HELP Folgende files sind im Archiv ARTM: ARTM ARTM.info Install_ARTM Install_ARTM.info german.doc/artm.guide german.doc/artm.guide.info german.doc/artm.dok german.doc/artm.dok.info german.doc/artm.history german.doc/artm.history.info english.doc/artm.guide english.doc/artm.guide.info english.doc/artm.doc english.doc/artm.doc.info english.doc/artm.history english.doc/artm.history.info Programmstart: Von der Shell ~~~~~~~~~~~~~ ARTM V2.00 läuft nur noch unter Amigo OS 2.xx und höher. Type ARTM [opt] und ARTM öffnet sein Fenster auf dem WB Screen drei Optionen sind möglich: -q Startet ARTM als Icon am rechten oberen Rand des WB Screens. Ein Doppelclick darauf und ARTM steht voll zur verfügung. -poutputpath teilt ARTM mit wo es sein output hinschreiben soll. Möglich sind z.B. alle devices prt: ram:file. -ix/y Startet ARTM als WB Fenster, wenn Funktion iconify benutzt wird erscheint das Icon an an vorgegebener x/y position. -wx/y Startet ARTM als WB Fenster, x/y ist die linke obere Ecke des ARTM-Window. Sollten von x/y bis zum rechten Rand weniger als 640 Pixel sein wird für x/y = 0/0 gewählt. -hx Startet ARTM als WB Fenster, x=window.height. Ist euer Screen kleiner x wird eine Standarthöhe von 168 Pixeln genommen. Von der Workbench ~~~~~~~~~~~~~~~~~ Ein einfacher Doppelklick auf das ARTM.icon und ARTM öffnet sein Fenster auf dem WB Screen. Die Optionen von oben können auch als ToolType verwendet werden. START=WINDOW|ICON ICON_POS=x/y OUTPUT_PATH=RAM:ARTM.output WINDOWHEIGHT=280 WINDOW_POS=70/16 Tastaturbelegung: Momentan werden nur einige wenige Funktionen durch die Tastatur unterstützt. Dies wird sich aber in der nächsten Version ändern. Dann sollen alle Funktionen über Tastatur bedienbar sein. ARTM kennt folgende Tastaturkommandos: ESC beendet ARTM HELP zeigt zu jeder Funktion die betreffende Node aus diesem Guide (siehe dazu auch Funktion Die Hilfsfunktion in ARTM) ARTM Requestern kennen folgende Tastaturkommandos: ESC bricht die Funktion ab gleich CANCEL RETURN führt die Funktion aus gleich OK Die Hilfsfunktion in ARTM: ARTM bietet eine umfassende Hilfsfunktion. Es kann zu jeder Zeit die Help Taste gedrückt werden. Nun wird sofort das ARTM.guide geöffnet und die ausgewählte Funktion angezeigt. Voraussetzung hierfür ist allerdings das Ihr Amiga über die amigaguide.librarie in Libs: verfügt, und das ARTM.guide korrekt installiert ist. (siehe Installation) ----------------------------------------------------------------------------- Folgende Funktionen sind implementiert: Tasks ist default wenn ARTM gestartet wird und listet alle Task's auf, die sich im Amiga befinden. Durch Mausklick auf eine beliebige Task wird diese selektiert. Anschließend kann mit der Funktion PRIORITY die Priority verändert oder mit REMOVE die Task entfernt werden. MORE bringt zusätzliche Detail informationen. Folgende Informationen werden angezeigt: Address, Priority, Signals, State, Code, Type, Name. Windows listet alle geöffneten Screens und Windows. Auch hier kann durch Mausklick ein Screen oder ein Window selektiert und mit CLOSE aus dem Amy entfernt werden. Mit MORE werden Zu- satzinformationen angezeigt, wie min, max Width und Hight. ACHTUNG Windows sollte man nur schließen wenn auch die zuge- hörige Task tot ist. Sonst ist der GURU gewiß. Das gleiche gilt für Windows mit geshartem IDCMP-Port. Folgende Informationen werden angezeigt: Address, Position, Size, Flags, IDCMP ( nur bei Windows ), Title. Libraries zeigt alle eingebundenen Libraries im Amiga.Wurde eine Library angewählt kann mit der Funktion PRIORITY die Priority und mit CLOSE die Library geschlossen werden (der OpenCount wird auf 0 gesetzt).Libraries die selbst eingebunden wurden, können auch mit REMOVE removed werden wenn der OpenCount = 0 ist. Folgende Informationen werden angezeigt: Address, Type, Priority, OpenCount, Version ( setzt sich zusammen aus Version & Revision), Negsize, Possize, Name. Devices listet alle Devices auf. Mit REMOVE können Devices removed werden, sofern diese closed sind. PRIORITY kann die Priority wie bei Libraries verändern. Folgende Informationen werden angezeigt: Address, Type, Priority, OpenCount, Version ( setzt sich zusammen aus Version & Revision), Negsize, Possize, Name. Resources listet alle Resources. Mit der Funktion PRIORITY kann die Priority geändert werden und mit REMOVE eine vorher selek- tierte Resource entfernt werden. Eine kleine Unstimmigkeit tritt in Zusammenhang mit den ALF 2.0 Resourcen auf. Bei einem Opencount von 21000 und Version von 14021.0 schiebe ich diesen Bug mal der Programmierung von ALF2.0 zu. Folgende Informationen werden angezeigt: Address, Type, Priority, OpenCount, Version (setzt sich zusammen aus Version & Revision), Negsize, Possize, Name. Ports zeigt alle Ports mit den Namen der zugehörigen Tasks. Ports können mit REMOVE removed werden, aber VORSICHT ist von Nöten. Folgende Informationen werden angezeigt: Address, PortName, Type, SigBit, Flags, TaskName. Residents zeigt alle Residents im Amiga. Zusätzlich werden auch die Residents gezeigt, die durch das Verbiegen des Pointers KickTagPtr zusätzlich zur Verfügung stehen. ( z.b. ein Virus oder die RAD:) Dabei werden Residents, die nur in der KickTagPtr-Tabelle stehen color 3 und solche, die nach einem Reboot auch in der ResmodulesTabelle stehen schwarz angezeigt. Folgende Informationen werden angezeigt: Address, Type, Priority, Version, Flags, Name. Interrupts listet alle Interrupts im Amiga auf. Interrupts die durch Interrupt-Server verwaltet werden können mit REMOVE ent- fernt werden. Folgende Informationen werden angezeigt: Address, Data, Code, Priority, Type, Nr., InterruptName, Name. Vectors zeigt die wichtigsten SystemVectoren des Amigas. ColdCapture, CoolCapture, WarmCapture, KickMenPtr, KickTagPtr, KickCheck- Sum Mit dem Gadget CLEAR können ColdCapture, CoolCapture und WarmCapture zu NULL gesetzt werden. Wird KickMemPtr, KickTag- Ptr oder KickCheckSum vorher selektiert, werden alle drei auf einmal auf NULL gesetzt. Der KickTagPtr bietet noch eine Be- sonderheit. Wird in der Residentliste auf die er zeigt ein Eintrag gefunden, wird dessen Node (Address) und Name hinter dem KickTagPtr gezeigt. Sind mehrere Einträge vorhanden, wird momentan nur der erste angezeigt. Will man alle sehen, so ist die Funktion Residents aufzurufen. Die Einträge der KickTagPtr-Tabelle erscheinen farbig (siehe oben). Folgende Informationen werden angezeigt: Address, VectorName und Content, sollte KickTagPtr auf eine eigene Residenttabelle zeigen, wird Address & Name dieser Residents mitangezeigt. Memory zeigt die Speicheraufteilung in chip, fast und expansion Ram an. Mit Funktion PRIORITY kann die Priority geändert werden und MORE zeigt die Größe und Lage der einzelnen Speicherfragmente. Folgende Informationen werden angezeigt: Address, Priority, Attribute, Lower, Upper, Maximum, in Use, Free, Largest, Name und ganz unten die Total Werte Mount listet alle mit mount angemeldeten Devices im Amiga auf. Folgende Informationen werden angezeigt: Address, Device, Heads, Sectors, Buffer, Cylinder, Inter- leavefaktor, Handlername. Bei Speichereinheiten zeigt ARTM zusätzlich Size, Full, rw (read/write), Volume (name) an. Assign zeigt alle assignten Pfade und Programme. Folgende Informationen werden angezeigt: Address, Directory, Path. Locks listet alle Locks (read und write). Wird ein Lock angewählt kann er mit Unlock entfernt werden. Folgende Informationen werden angezeigt: Address, Access, Path. Fonts zeigt alle geladenen Fonts, auch die im KickRom. Mit REMOVE wird der selektierte Font aus der Liste entfernt. Gibt das benutzende Programm den Font frei, (Count auf NULL) wird auch der dafür belegte Speicher freigegeben. Folgende Informationen werden angezeigt: Address, Count, YSize, XSize, Style, Flgs, LoChar, HiChar und Name. Hardware listet alle installierten autoconfig-boards (ExpansionBase) auf. Außerdem wird angegeben welcher Prozessor und Math- prozessor eingebaut sind. Ferner werden auch die CustomChips gelistet und zwar wird unterschieden ob Fat Agnus oder Fat Denise (PAL oder NTSC) oder die normalen Agnus und Denise eingebaut sind. Folgende Informationen werden angezeigt: Address, Boardadr, Boardsize, Slotadr, Slotsize, Driver, Product, Type, Manufacturer und Board. Res Cmds zeigt alle Residenten Befehle im Rom intern und auch die, die mit resident Programm pure resident gemacht werden. Bei den letzteren letzteren werden alle Datensegmente mitangezeigt. Folgende Informationen werden angezeigt: Name, ROM INTERN. Bei selbst resident gemachten Programmen werden Lower, Upper und Size der DatenSegmente mitangezeigt. Semaphoren zeigt alle Semaphoren vom AmigaDos an. Mit REMOVE wird die vorher selektierte Semaphore erst released und dann removed. Mit RELEASE wird die vorher selektierte Semaphore released. Folgende Informationen werden angezeigt: Address, Priority, NestCount, WaitQueue, Name, OwnerTask. Monitor ist ein kleiner Speichermonitor, der es Erlaubt alle Speicher- stellen zu begutachten. Es werden immer 100 Zeilen angezeigt, die gescrollt werden können. Mit Forward und Backward können die nächsten oder voherigen 100 records angezeigt werden. Bei Address erscheint ein kleiner Requester, hier kann eine Adresse angegeben werden. Ab hier zeigt der Monitor dann an. Folgende Informationen werden angezeigt: Address, Bytes(Hex), Bytes(ASCII) Last Alert zeigt die letzte Alertnummer mit Adresse. ----------------------------------------------------------------------------- Folgende Aktionen sind implementiert: Remove entfernt vorher selektierte Tasks, Libs, Devices, Ports, Fonts Resources, Semaphoren und Interrupts aus dem System. Selektiert wird mit einfachem Mausklick auf den entsprechenden Eintrag. Close schließt Screens/Windows und Libraries. Vorgehensweise wie bei Remove. Relase relased Semaphoren aus der SignalSemaphore. Clear setzt die SystemVectoren auf NULL. Vorgehensweise wie bei Remove oder Close. Freeze hält eine laufende Task an, entfernt die Task aus der Node- struktur und speichert die Taskstruktur zwischen. In ARTM ist das in der Tasklist am STATE "Frozen" zu erkennen. Wird ein frozen Task ausgewählt (angeklickt) kann er mit Activate wieder zu Leben erweckt werden. Activate ist die Umkehrfunktion von Freeze. Siehe oben. Priority verändert die Priority der vorher angewählten Task, Library, Device, Ports, Interrupts, Memory oder Resource über einen Requester. Der Wert kann über Tastatur oder die beiden Pfeile verändert werden. Die Priority ist nur im Rahmen von -128 bis 127 veränderbar. Am besten zwischen -10 und 10. Unlock entfernt einen Lock (read oder write) aus der Liste. Hier ist Vorsicht angebracht. Wenn das System den Lock noch kennt, geht die Reise nach Indien. More gibt zusätzliche Informationen. Dies gilt in dieser Version erst nur für Task, Windows, Screens, und Memory. Beispiel eine gewünschte Task wird mittels Mausklick selektiert, danach einmal MORE anwählen. Das Ergebnis sieht dann so aus. Task Structure: IDNestCnt: 0 TDNestCnt: -1 SigAlloc: c000ffff SigWait: c0000000 SigRecvd: 00000000 SigExcept: 00000000 TrapAlloc: 8000 TrapAble: 0000 ExceptData: 00000000 ExceptCode: 00fc2ff0 TrapData: 00000000 TrapCode: 00ff47ea SPLower: 00266834 SPUpper: 00267034 SPReg: 00266f96 Switch(): 00000000 Launch(): 00000000 UserData: 00000000 Process Structure: WindowPtr: 00000000 Title: MsgPort: 00000000 StackBase: 00266834 StackSize: 2048 CurrentDir: 00000000 Path: CIS: 00000000 COS: 00000000 ConsoleTask: 00000000 FileSystemTask: 0020709c SegList: 002365e4 SegPointer: 0024940c PktWait: 00000000 CLI: 00091bc3 CommandLineInterface Structure: CommandDir: 00246874 StandardInput: 00000000 StandardOutput: 00000000 CurrentInput: 00000000 CurrentOutput: 00000000 Module: 00000000 Hunks: Lower Upper Size ---------------------------- 00249410 00249a6c 1636 0022ee80 0022ee80 8 total: 1644 Bei Task, Windows, und  Screens sieht das Ergebnis dann entsprechend aus. Bei  Memory wird die Speicherfragmention aufgelistet in Adresse und Size. Break bricht laufende Task ab. Es werden die Signale Control D/E/F/C gesetzt. Signal kann SigAlloc in der Taskstuktur verändern. Dies tut Break im übrigen auch. Cancel bietet die Möglichkeit die untere Gadgetreihe von Aktion (color 4) in Funktion (color 2) zurück zuschalten, damit wieder alle Funktionen wie z.B Monitor oder Hardware wieder zu- gänglich sind. Monitor_Funktionen Address öffnet einen kleinen Requester. Hier ist die zu suchende Adresse einzugeben. Der Monitor sucht die eingebene Adresse und stellt sie oben links da und anschließend die nächsten 100 Zeilen. Forward Blättert eine Seite vor und zeigt die nächsten 100 Zeilen an. Backward Blättert eine Seite zurück und zeigt die vorherigen 100 Zeilen an. Search öffnet einen kleinen Requester. Hier ist der zu suchende ASCII String einzugeben. Der Monitor sucht den eingebenen String und stellt sie oben links da. Die nächsten 100 Zeilen werden mit aus- gegeben. zz ist eine iconify Funktion. Wird dieses Gadget angewählt verschwindet das Window und wird zum Icon. Ein doppelter Mausklick auf dieses Icon öffnet wieder das ARTM-Window. i i = ABOUT Disksymbol speichert alle items der gerade ausgewählten Funktion in einen file oder gibt die Informationen auf eine Device aus z.B. PRT: siehe hierzu Option -p ----------------------------------------------------------------------------- Note : Eine Bitte vorweg an Alle, die die Funktion Hardware nutzen und Erweiterungskarten installiert haben. Teilt mir doch bitte im einem kurzen Brief, oder an untenstehende Node mit was bei PROD TYPE und MANUFACTRE rauskommt. Dazu dann auch den Name, Typenbezeichnug und Hersteller der Karte. Alle Funktionen sollten nur mit Vorsicht gebraucht werden. Im Übrigen sollte man wissen was man tut. Wünsche für die nächste Version und bug reports (hoffentlich nicht) bitte an die Autoren. Und vergeßt nicht den ausreichend frankierten Rückumschlag. Am einfachsten erreicht ihr mich übers Fidonet. ----------------------------------------------------------------------------- Franz-Josef Mertens Sonnenrain 17 72218 Wildberg Germany Fido (2:246/2013.9) Mentopolis Wildberg UUCP fjm@merlin.tynet.sub.org Vielen Dank an alle, die uns beim Testen und mit Tips oder kleinen Routinen geholfen haben. Insbesondere an: Matthias Zepf, Markus Stoll, Matthias Scheler, Kai Bolay, Marc Heuler, Gregor Hutla und Paul Browne.