home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga Shareware Floppies / ma20.dms / ma20.adf / ARTM / english.doc / ARTM.doc.pp / ARTM.doc
Text File  |  1994-05-28  |  19KB  |  483 lines
  1.    
  2.                      ARTM   Amiga Real Time Monitor V2.00
  3.                      -------------------------------------
  4.  
  5.           Copyright  ©  1990-93  by  Dietmar Jansen  &  F.J. Mertens
  6.  
  7.  
  8.           ARTM displays and controls activities in your Amiga. It is full
  9.           supported by Intuition and it is very easy to use. It works
  10.           under WB1.3 and WB2.x properly. ARTM need Arp.library 39.+
  11.  
  12.           ARTM is a shareware program. Permission is granted to freely 
  13.           distribute this program without profit. Copy is allowed
  14.           but only completely and unchanged . If you use it often,
  15.           please pay us a donation of 15 US$. In exchange you will get 
  16.           an update without the troublesome requester.
  17.  
  18.           Please send cache and no check. My bank is a shark. When you
  19.           send a 15$ US check:  exchange in the moment 1$ US = 1.70 DM
  20.  
  21.           15$ US = 25.00 DM 
  22.                  - 11.00 DM charge to change an US$ check in German DM
  23.                  ----------
  24.                    14.00 DM
  25.  
  26.  
  27.  
  28.  Installation:
  29.  
  30.       Installation automaticly:
  31.  
  32.       You can install ARTM automaticly with the C= Installer. In archive
  33.           ARTM is an installer script.
  34.  
  35.       Installation by your fingers:
  36.  
  37.       The installation is very easy. ARTM is only one program, so
  38.           you can copy ARTM with the copy command copy ARTM path/ARTM
  39.           in your favorite directory. Copy the .doc files with the copy
  40.           command in your favorite directoy too. The ARTM.guide file
  41.           should you copy to LOCALE:HELP/.
  42.  
  43.          copy ARTM.guid SYS:LOCALE/HELP/ARTM.guide
  44.  
  45.          assign HELP: SYS:LOCAL/HELP
  46.  
  47.      Following files are in archiv ARTM
  48.  
  49.          ARTM
  50.          ARTM.info
  51.          Install_ARTM
  52.          Install_ARTM.info
  53.          german.doc/artm.guide
  54.          german.doc/artm.guide.info
  55.          german.doc/artm.dok
  56.          german.doc/artm.dok.info
  57.          german.doc/artm.history
  58.           german.doc/artm.history.info
  59.          english.doc/artm.guide
  60.          english.doc/artm.guide.info
  61.           english.doc/artm.doc
  62.          english.doc/artm.doc.info
  63.          english.doc/artm.history
  64.          english.doc/artm.history.info
  65.  
  66.  
  67.  
  68.  Programmstart:
  69.  
  70.           ARTM V2.00 required Amigo OS 2.xx and up.
  71.  
  72.           From Shell
  73.           ~~~~~~~~~~
  74.           
  75.           Type  ARTM [opt]
  76.  
  77.           and ARTM will open on the WB Screen
  78.  
  79.           there are many options available:
  80.  
  81.              -q            Will bring up ARTM in its inconified form in
  82.                            the upper right hand corner.
  83.  
  84.              -poutputpath  say where ARTM should be store his output.
  85.                            Possible are all devices prt: ram:file.
  86.  
  87.              -ix/y         Will bring up the ARTM window in its full size,
  88.                            but when iconified the icon will be located at
  89.                            x and y position.
  90.  
  91.              -wx/y         Start ARTM as WB Fenster, x/y is the left upper
  92.                            point from ARTM-Window. Should the difference from
  93.                            x/y to the right screenside lower than 640 Pixel
  94.                            ARTM will start at the left upper corner.
  95.  
  96.              -hx           Start ARTM as WB window, x=window.height. Is the
  97.                            screen shorter than x ARTM-Window.Height = 168.
  98.  
  99.           From Workbench
  100.           ~~~~~~~~~~~~~~
  101.  
  102.           Simply double click the ARTM icon and the ARTM window will
  103.           open on the Workbenchscreen
  104.  
  105.           The options mentioned above can be used as Tooltype.
  106.  
  107.                 START=WINDOW|ICON
  108.                 ICON_POS=x/y
  109.                 OUTPUT_PATH=RAM:ARTM.output
  110.                 WINDOWHEIGHT=280
  111.                 WINDOW_POS=70/16
  112.  
  113.  
  114.  
  115.  Tastaturbelegung:
  116.  
  117.      Keyboardcodes are supported in ARTM:
  118.  
  119.       this version of ARTM support only 3 keycodes. In one of the next
  120.           versiones all functiones should be useable over the keyboard.
  121.  
  122.      Followed keyboardcodes are supported:
  123.  
  124.       ESC      finished ARTM
  125.           HELP     the ARTM.GUIDE pop up and show you the actuel function help
  126.                 (see function The Helpfunction in ARTM)
  127.  
  128.      ARTM requester known followed keyboardcodes:
  129.  
  130.       ESC      cancel the function is like CANCEL
  131.       RETURN   execute the function is like OK
  132.  
  133.  
  134.  
  135.  
  136.  The Helpfunction in ARTM:
  137.  
  138.       an extensive help is available in ARTM. After hitting helpkey,
  139.           ARTM.guide pops up and the last selected function help will be
  140.           show you. The amigaguide.librarie in your Libs: directory is
  141.           required. Allso ARTM.guide must be correct installed.
  142.           (see Installation)
  143.  
  144.  
  145. -----------------------------------------------------------------------------
  146.  
  147.  These functiones are implemented:
  148.  
  149.  
  150.  
  151.  Task       (default at start of ARTM) lists all tasks in your Amiga.
  152.             You select a task with a mouseklick on the requested entry.
  153.             Now you can remove it with REMOVE or change the priority with
  154.             PRIORITY. Function MORE brings a lot of more informationes 
  155.             (look at MORE).
  156.  
  157.               These informationes are displayed:
  158.             Address, Priority, Signals, State, Code; Type, Name.
  159.  
  160.  
  161.  Windows    lists all open screens and windows. Screens are in color 3
  162.             windows are white. Close a window\screen by selecting its
  163.             item and click CLOSE. Fuction MORE brings more informations
  164.             about the selected screen or window (look at more).
  165.             "WARNING" The GURU is waiting for you, if you kill a window
  166.             before its task is dead.
  167.  
  168.               These informations are displayed:
  169.             Address, Position, Size, Flags, IDCMP (only by windows), Title.
  170.  
  171.  
  172.  Libraries  lists all Libraries. By click on any item, you can close the
  173.             library with CLOSE (OpenCount must be NULL) REMOVE removes
  174.             the library. PRIORITY changes the priority.
  175.  
  176.               These informations are displayed:
  177.             Address, Type, Priority, OpenCount, Version (consists of
  178.             version & revision), Negsize, Possize, Name.
  179.  
  180.  
  181.  Devices    lists all devices. With clicking on REMOVE you can remove a
  182.             selected device, if it is closed. Function PRIORITY changes
  183.             the priority.
  184.  
  185.               These informations are displayed:
  186.             Address, Type, Priority, OpenCount, Version (consist of
  187.             version & revision), Negsize, Possize, Name.
  188.  
  189.  
  190.  Resources  lists all resources. Function PRIORITY changes the priority 
  191.         and REMOVE removes a selected resource.
  192.  
  193.               These informations are displayed:
  194.             Address, Type, Priority, OpenCount, Version (consist of
  195.             version & revision), Negsize, Possize, Name.
  196.  
  197.  
  198.  Ports      shows all ports and the name of its task. IDCMP_Ports are
  199.             owned by a window. Ports are removable with REMOVE
  200.  
  201.               These informations are displayed: 
  202.             Address, PortName, Type, SigBit, Flags, TaskName.
  203.  
  204.  
  205.  Residents  lists all residents in your Amiga. Residents which were 
  206.             added by the KickTagPtr (i.e. a virus or RAD:) will be
  207.             diplayed in color 3 and if the residents are in the Res-
  208.             Modules-table too, they will be displayed in black.
  209.  
  210.               These informations are displayed: 
  211.             Address, Type, Priority, Version, Flags, Name.
  212.  
  213.  
  214.  Interrupts shows all interrupts in your Amiga. It's only allowed to
  215.             remove an interrupt controled by a server with REMOVE.
  216.  
  217.               These informations are displayed: 
  218.             Address, Data, Code, Priority, Type, Nr., InterruptName, Name.
  219.               
  220.  
  221.  
  222.  Vectors    show vectors, i.e. Cool-, Cold,- WarmCapture and Kickpointers.
  223.             It's helpful when searching for Viruses, but remember that
  224.             the RAD: device in Kick 1.3 uses the KickTagPtr. Use function
  225.             CLEAR to set any Vector to NULL. If you close KickMemPtr,
  226.             KickTagPtr or KickCheckSum, all of these three would be set
  227.             to NULL.
  228.  
  229.               These informations are displayed: 
  230.             Address, Vector and Content. Should the KickTagPtr point to a
  231.             resident table, you get the Address & Name from this residents.
  232.             Note, that only the first item of the table would be displayed.
  233.             If you want to see the others, select function Residents. The 
  234.             residents of the KickTagPtr-table would be displayed colored.
  235.             (see above).
  236.  
  237.  Memory     show the memory in chip, fast and expansion ram (like avail).
  238.             Function PRIORITY changs the priority. If you select the
  239.             memory (chip or fast) and klick MORE then ARTM will show
  240.             you the memoryfragmention.
  241.  
  242.               These informations are displayed:
  243.             Address, Priority, Attribute, Lower, Upper, Maximum, in Use,
  244.             Free, Largest, Name and in the next colum the totals.
  245.  
  246.  
  247.  Mount      list all mounted Devices in your Amiga.  
  248.  
  249.               These informations are displayed:
  250.             Address, Device, Heads, Sectors, Buffer, Cylinder, Inter-
  251.             leavefaktor, Handlername. By memoryunits ARTM will dispaly
  252.             Size, Full, rw (read/write), Volume (name) too.
  253.  
  254.  
  255.  Assign     show all assigned pathes and programs.
  256.  
  257.               These informations are displayed:
  258.             Address, Directory, Path.
  259.  
  260.  
  261.  Locks      show all Locks (read and write). If your Locks more than 200
  262.             (ARTM has 100 Arrays) you can wiht Forward or Backward view
  263.             the next 100 Locks. Select a Lock and chose Unlock andremove
  264.             a selected item.  
  265.  
  266.               These informations are displayed:
  267.             Address, Access, Path.
  268.  
  269.  
  270.  Fonts      list all loaded fonts, in KickRom too. With REMOVE you can
  271.             remove the selected Font. If you finish the program that
  272.             use the font (Count = NULL), the system should release the
  273.             requested memory.
  274.  
  275.               These informations are displayed:
  276.             Address, Count, YSize, XSize, Style, Flgs, LoChar, HiChar
  277.             und Name.
  278.  
  279.  
  280.  Hardware   list all installed autoconfig-boards (ExpansionBase)
  281.             ARTM will show you which processor and mathcoprocessor is
  282.             in your Amiga. In addition ARTM indicate the new ECS-Chips
  283.         Fat Agnus or Fat Denise (PAL or NTSC) or normal Agnus and
  284.             Denise.
  285.  
  286.               These informations are displayed:
  287.             Address, Boardadr, Boardsize, Slotadr, Slotsize, Driver,
  288.             Product, Type and Manufacturer.
  289.  
  290.  
  291.  Res Cmds   list all Residents from AmigaDos and from ARP1.3 ARES 
  292.             Command. The AmigaDos resident will show all datasegments
  293.             with  Lower Adr, Upper Adr and Size.        
  294.  
  295.               These informations are displayed:
  296.             Sys (AmigaDos or ARP), Name, Usage (only by ARP), Access.
  297.  
  298.  
  299.  Semaphoren   show all Semaphores from AmigaDos. With REMOVE you
  300.             can remove the selected Semaphore but before, the Semaphore will
  301.             automaticly be released. With RELEASE can you release any
  302.             Semaphores.
  303.  
  304.               These informations are displayed:
  305.             Address, Priority, NestCount, WaitQueue, Name, OwnerTask.
  306.  
  307.  
  308.  Monitor    is a little memorymonitor and shows the whole memory.
  309.             The memory will be loaded in the 100 ARTM stringgadgets. 
  310.             With Forward and Backward you can view
  311.             the next or previous 100 records. A click on Address will
  312.             bring up a requester, type an address in it and the Monitor
  313.             list the next 100 records from the address.
  314.  
  315.               These informations are displayed:
  316.             Address, Bytes(Hex), Bytes(ASCII)
  317.  
  318.  
  319.  Last Alert show the last Alertnumber and address.
  320.  
  321. -----------------------------------------------------------------------------
  322.  
  323.  Remove     removes selected tasks, libs, devices, ports, interrupts, semaphpres
  324.             and Fonts. Select (before remove) with a mouseclick on the requested
  325.             entry. But remember libs amd devices must be closed.
  326.  
  327.  Close      closes screens/windows and libraries. Use it as remove.
  328.             
  329.  
  330.  Relase     relase Semaphores from SignalSemaphore.
  331.  
  332.  
  333.  Clear      set the SystemVectors to NULL. Use it as remove or close.
  334.  
  335.  
  336.  Freeze     freeze a runnig Task and removed it form the nodestructur
  337.             The forzen taskstructur is stored. You recognize it 
  338.             function  Task on STATE "Frozen". If you select 
  339.             a forzen task and click Activate the task get a
  340.             new live.
  341.  
  342.  
  343.  Activate   is the counterpart from Freeze. Show above.
  344.  
  345.  
  346.  Priority   changes the priority of a selected task, library, device
  347.             interrupts, memory or resource. Values may range from  -128
  348.             to 127, better use values between -10 and 10.
  349.  
  350.  
  351.  Unlock     remove a Lock (read or write) from the list. Attention
  352.             if the system know the Lock, the amy will go to Indian.  
  353.  
  354.  
  355.  More       show detail informationes. In ARTM version 1.0 these is in-
  356.             plemented for function Task, Windows, Screens, and Memory.
  357.             Example:
  358.             Klick on the requested task and then on MORE. This is the
  359.             result from any task.
  360.  
  361.             Task Structure:                                                   
  362.             IDNestCnt:             0                TDNestCnt:            -1  
  363.             SigAlloc:       c000ffff                SigWait:        c0000000  
  364.             SigRecvd:       00000000                SigExcept:      00000000  
  365.             TrapAlloc:          8000                TrapAble:           0000  
  366.             ExceptData:     00000000                ExceptCode:     00fc2ff0  
  367.             TrapData:       00000000                TrapCode:       00ff47ea  
  368.             SPLower:        00266834                SPUpper:        00267034  
  369.             SPReg:          00266f96                                          
  370.             Switch():       00000000                Launch():       00000000  
  371.             UserData:       00000000                                          
  372.             Process Structure:                                                
  373.             WindowPtr:      00000000                Title:                    
  374.             MsgPort:        00000000                                          
  375.             StackBase:      00266834                StackSize:          2048  
  376.             CurrentDir:     00000000                Path:                     
  377.             CIS:            00000000                COS:            00000000  
  378.             ConsoleTask:    00000000                FileSystemTask: 0020709c
  379.             SegList:        002365e4                SegPointer:     0024940c 
  380.             PktWait:        00000000                CLI:            00091bc3 
  381.             CommandLineInterface Structure:                                  
  382.             CommandDir:     00246874                                         
  383.             StandardInput:  00000000                StandardOutput: 00000000 
  384.             CurrentInput:   00000000                CurrentOutput:  00000000 
  385.             Module:         00000000                                         
  386.             Hunks:                                                           
  387.             Lower     Upper         Size                                     
  388.             ----------------------------                                     
  389.             00249410  00249a6c      1636                                     
  390.             0022ee80  0022ee80         8                                     
  391.             total:                  1644 
  392.  
  393.             For Windows, and  Screens the result is simmilar
  394.             Memory will show the memoryfragmention in address and size.
  395.  
  396.  
  397.  Break      cancel a runnig Task. It will be set Control D/E/F/C
  398.  
  399.  
  400.  Signal     A requester pops up where you can change the SigAlloc. 
  401.             Show function Break
  402.  
  403.  
  404.  Cancel     switch the gadgetrow from action (color 4) back to function
  405.             (color 2).
  406.  
  407.  
  408.  Monitor_Funktionen
  409.  
  410.         Address
  411.  
  412.         Pop up a little Requester. Put here your faworite address. Function
  413.         Monitor search the address and will display it in the first item 
  414.             plus the next 100 rows.
  415.  
  416.         Forward
  417.  
  418.           list the next 100 rows.
  419.  
  420.         Backward
  421.  
  422.         list the previus 100 rows
  423.  
  424.         Search
  425.  
  426.           Pop up a little Requester. Put here the searched ASCII string.
  427.             Function Monitor search the string and when it is found ARTM will
  428.             display it in the first item plus the next 100 rows.
  429.  
  430.  
  431.  zz         Iconify function. If you chose the zz gadget ARTM dis-
  432.             appears and popup as an icon. A doubleklick on this icon and
  433.             ARTM will bring its Window back.
  434.  
  435.  
  436.  i          i is like ABOUT
  437.  
  438.  
  439.  Disksymbol store all items from the current called funktion in a file
  440.             or put it out to PRT: see above option -p.          
  441.  
  442. -----------------------------------------------------------------------------
  443.    
  444.  Note :     If you use the function hardware and have installed
  445.             autoconfig-boards (ExpansionBase). Please send us a mail
  446.             and tell us the output from ARTM (PROD, TYPE and MANUFACTRER)
  447.             and also the name and Type of your expansionbords.
  448.  
  449.  You should ever know what you do! Please send bug reports and a list of
  450.  features you would like to have in the next version to the Authors:
  451.  
  452.  
  453. ---------------------------------------------------------------------------
  454.  
  455.   ********************************************
  456.   *                                          *
  457.   *  A T T E N T I O N                       *
  458.   *  -----------------                       *
  459.   *                                          *
  460.   *  from 93/07/01  there is a new Citycode  *
  461.   *                                          *
  462.   *  72218 Wildberg                          *
  463.   *                                          *
  464.   ********************************************
  465.  
  466.  
  467.       Franz Josef Mertens
  468.       Sonnenrain 17
  469.       7277 Wildberg 1
  470.       Germany
  471.  
  472.       Fido (2:241/7407.9) Mentopolis Wildberg
  473.       UUCP fjm@merlin.tynet.sub.org
  474.  
  475.  Special thanks to all, who helped us with little routines, tips and
  476.  failure tracking and all Betatesters. Special thanks to:
  477.  and all Betatesters.
  478.  
  479.  Matthias Zepf
  480.  Markus Stoll.
  481.  Matthias Scheler
  482.  Kai Bolay
  483.