home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 469.lha / ARTM_v1.2 / artm.english.doc.pp / artm.english.doc
Text File  |  1991-02-09  |  15KB  |  341 lines
  1.    
  2.                      ARTM   Amiga Real Time Monitor V1.0
  3.                     -------------------------------------
  4.  
  5.           Copyright  ©  1990 by  Dietmar Jansen  &  F.J. Mertens
  6.  
  7.           ARTM is a shareware program. Permition is guaranted to freely 
  8.           distribute this program (without profit). Copy is allowed
  9.           but only complete and unchanged . If you often use it,
  10.           please pay us a donation of 20 US$. Therefore you will get 
  11.           from us one update service and the sourcecode for Aztec 3.6.
  12.           The next update cost 10,- DM or 8$ US. 
  13.  
  14.           ARTM displays and controls activities in your Amiga. It will
  15.           be full supported by Intuition and is very easy to use.
  16.  
  17. ---------------------------------------------------------------------------
  18.  Changes in V1.0
  19.  
  20.  To keep the program short we created a PAL and a NTSC version.
  21.  
  22.  New functiones:  Memory, Mount, Assign, Fonts, Hardware , Iconify
  23.  More brings a lot of more informationes e.g. Task.
  24.  Start as Icon (iconify) with Runback ARTM -q
  25. -----------------------------------------------------------------------------
  26.  Changes in V1.1
  27.  
  28.  New functiones: Locks, Res Cmds, Monitor, Last Alert, Break, Signal
  29.  und Freeze. Function More brings now more informationes. 
  30.  The last gadgetrow is now dublicated. It switch automaticly between
  31.  function and action. Is function e.g. Libraries selected ARTM will
  32.  show all Libraries. When you select a Librarie with a mouseclick the
  33.  last gadgetrow will switch to actions. Now chose any action.
  34.  
  35.  Bug fixed: thanks to Pius Nippgen
  36.  
  37.  If you select a Task, with WindowPtr is -1 (no Requester) and than click
  38.  on MORE you will get a Guru 00000003. 
  39. -----------------------------------------------------------------------------
  40.  Changes in V1.2
  41.  
  42.  function Hardware brings now the Bordtype form C= Boards. E.g. A2090.
  43.  fixed littel Bugs.
  44.  
  45. ------------------------------------------------------------------------------
  46.  
  47.  Programmstart:
  48.  
  49.         Starting ARTM from the Workbench with doubleklick on its Icon or
  50.         from CLI. If you use the option -q
  51.  
  52.         runback ARTM -q
  53.  
  54.         ARTM start as BackroundTask. On the WbScreen pop up the ARTM-Icon
  55.         (iconify), with doubleklick on this Icon ARTM will open his Window.
  56.  
  57.         ARTM has any problems with the workbench. The functions Locks 
  58.         sometimes will get a problem if your amy has more than 200 Locks.
  59.         Start ARTM from CLI.
  60.  
  61. -----------------------------------------------------------------------------
  62.  
  63.  These functiones are implemented:
  64.  
  65.  
  66.  
  67.  Task       (is default if you call ARTM) lists all tasks in your Amiga.
  68.             You select a task with a mouseklick on the requested entry.
  69.             Now you can remove it with REMOVE or change the priority with
  70.             PRIORITY. Function MORE brings a lot of more informationes 
  71.             (look at MORE).
  72.  
  73.               These informationes are displayed:
  74.             Address, Priority, Signals, State, Code; Type, Name.
  75.  
  76.  
  77.  Windows    lists all open screens and windows. Screens are in orange
  78.             windows are white. Close a window\screen by selecting its
  79.             item and click CLOSE. Fuction MORE brings more informations
  80.             about the selected screen or window (look at more).
  81.             "WARNING" The GURU is waiting for you, if you kill a window
  82.             before its task is dead.
  83.  
  84.               These informationes are displayed:
  85.             Address, Position, Size, Flags, IDCMP (only by windows), Title.
  86.  
  87.  
  88.  Libraries  lists all Libraries. By click on any item, you can close the
  89.             librarie with CLOSE (OpenCount must be NULL) REMOVE removes
  90.             the librarie. PRIORITY changed the priority.
  91.  
  92.               These informationes are displayed:
  93.             Address, Type, Priority, OpenCount, Version (consists of
  94.             version & revision), Negsize, Poszize, Name.
  95.  
  96.  
  97.  Devices    lists all devices. With clicking on REMOVE you can remove a
  98.             selected device, if it is closed. Function PRIORITY changes
  99.             the priority.
  100.  
  101.               These informationes are displayed:
  102.             Address, Type, Priority, OpenCount, Version (consist of
  103.             version & revision), Negsize, Poszize, Name.
  104.  
  105.  
  106.  Resources  lists all resources. Function PRIORITY changes the priority 
  107.         and REMOVE removes a selected resource.
  108.  
  109.               These informationes are displayed:
  110.             Address, Type, Priority, OpenCount, Version (consist of
  111.             version & revision), Negsize, Poszize, Name.
  112.  
  113.  
  114.  Ports      shows all ports and the name of its task. IDCMP_Ports are
  115.             owned by a window. Ports are removable with REMOVE
  116.  
  117.               These informationes are displayed: 
  118.             Address, PortName, Type, SigBit, Flags, TaskName.
  119.  
  120.  
  121.  Residents  lists all residents in your Amiga. Residents which were 
  122.             added by the KickTagPtr (i.e. a virus or RAD:) will be
  123.             diplayed in orange and if the residents are in the Res-
  124.             Modules-table too will be displayed in black.
  125.  
  126.               These informationes are displayed: 
  127.             Address, Type, Priority, Version, Flags, Name.
  128.  
  129.  
  130.  Interrupts shows all interrupts in your Amiga. It's only allowed to
  131.             remove an interrupt controled by a server with REMOVE.
  132.  
  133.               These informationes are displayed: 
  134.             Address, Data, Code, Priority, Type, Nr., InterruptName, Name.
  135.               
  136.  
  137.  
  138.  Vectors    show vectors, i.e. Cool-, Cold,- WarmCapture and Kickpointers.
  139.             It's helpful when searching for Viruses, but remember that
  140.             the RAD: device in Kick 1.3 uses the KickTagPtr. Use function
  141.             CLEAR to set any Vector to NULL. If you close KickMemPtr,
  142.             KickTagPtr or KickCheckSum, all of these three would be set
  143.             to NULL.
  144.  
  145.               These informationes are displayed: 
  146.             Address, Vector and Content, should the KickTagPtr point to a
  147.             residenttable, you get the Address & Name from this residents.
  148.             Note, that only the first item of the table would be displayed.
  149.             If you want see the others select function Residents. The 
  150.             residents of the KickTagPtr-table would be displayed colored.
  151.             (see above).
  152.  
  153.  Memory     show the memory like avail in chip, fast and expansion ram.
  154.             Function PRIORITY changed the priority. Select the requested
  155.             memory chip, fast or expansion and klick MORE then ARTM will
  156.             show you the memoryfragmention.
  157.  
  158.               These informationes are displayed:
  159.             Address, Priority, Attribute, Lower, Upper, Maximum, in Use,
  160.             Free, Largest, Name and in the next colum the totals.
  161.  
  162.  
  163.  Mount      list all mounted Devices in your Amiga.  
  164.  
  165.               These informationes are displayed:
  166.             Address, Device, Heads, Sectors, Buffer, Cylinder, Inter-
  167.             leavefaktor, Handlername. By memoryunits ARTM will dispaly
  168.             Size, Full, rw (read/write), Volume (name) too.
  169.  
  170.  
  171.  Assign     show all assigned pathes and programs.
  172.  
  173.               These informationes are displayed:
  174.             Address, Directory, Path.
  175.  
  176.  
  177.  Locks      show all Locks (read and write). If your Locks more than 200
  178.             (ARTM has 100 Arrays) you can wiht Forward or Backward view
  179.             the next 100 Locks. Selct a Lock and chose Unlock andremove
  180.             a selected item.  
  181.  
  182.               These informationes are displayed:
  183.             Address, Access, Path.
  184.  
  185.  
  186.  Fonts      list all loaded fonts, in KickRom too. With REMOVE you can
  187.             remove the selected Font. If you finish the program that
  188.             use the font (Count = NULL), the system should release the
  189.             requested memory.
  190.  
  191.               These informationes are displayed:
  192.             Address, Count, YSize, XSize, Style, Flgs, LoChar, HiChar
  193.             und Name.
  194.  
  195.  
  196.  Hardware   list all installed autoconfig-boards (ExpansionBase)
  197.             ARTM will show you which processor and mathcoprocessor is
  198.             in your Amiga. In addition ARTM indicate the new ECS-Chips
  199.         Fat Agnus or Fat Denise (PAL or NTSC) or normal Agnus and
  200.             Denise.
  201.  
  202.               These informationes are displayed:
  203.             Address, Boardadr, Boardsize, Slotadr, Slotsize, Driver,
  204.             Product, Type and Manufacturer.
  205.  
  206.  
  207.  Res Cmds   list all Residents from AmigaDos and from ARP1.3 ARES 
  208.             Command. The AmigaDos resident will show all datasegments
  209.             with  Lower Adr, Upper Adr and Size.        
  210.  
  211.               These informationes are displayed:
  212.             Sys (AmigaDos or ARP), Name, Usage (only by ARP), Access.
  213.  
  214.  
  215.  Monitor    is a little memorymonitor and shows the whole memory.
  216.             The memory will be loaded in the 100 ARTM stringgadgets. 
  217.             With Forward and Backward you can view
  218.             the next or previous 100 records. A click on Address will
  219.             bring a requester, type a address in it and the Monitor list
  220.             from address the next 100 records.
  221.  
  222.               These informationes are displayed:
  223.             Address, Bytes(Hex), Bytes(ASCII)
  224.  
  225.  
  226.  Last Alert show the last Alertnumber and address.
  227.  
  228. -----------------------------------------------------------------------------
  229.  
  230.  Remove     removes selected tasks, libs, devices, ports, interrupts and
  231.             Fonts. Select (before remove) with a mouseclick on the requested
  232.             entry. But remember libs amd devices must be closed.
  233.  
  234.  Close      closes screens/windows and libraries. Use it as remove.
  235.             
  236.  
  237.  Clear      set the SystemVectors to NULL. Use it as remove or close.
  238.  
  239.  
  240.  Freeze     freeze a runnig Task and removed it form the nodestructur
  241.             The forzen taskstructur is stored. You recognize it 
  242.             function  Task on STATE "Frozen". If you select 
  243.             a forzen task and click Activate the task get a
  244.             new live.
  245.  
  246.  
  247.  Activate   is the counterpart from Freeze. Show above.
  248.  
  249.  
  250.  Priority   changes the priority of a selected task, library, device
  251.             interrupts, memory or resource. Values may range from  -128
  252.             to 127, better use values between -10 and 10.
  253.  
  254.  
  255.  Unlock     remove a Lock (read or write) from the list. Attention
  256.             if the system know the Lock, the amy will go to Indian.  
  257.  
  258.  
  259.  More       show detail informationes. In ARTM version 1.0 is these in-
  260.             plemented for function Task, Windows, Screens, and Memory.
  261.             A sample:
  262.             Klick on the requested task and then on MORE. This is the
  263.             result from any task.
  264.  
  265.             Task Structure:                                                   
  266.             IDNestCnt:             0                TDNestCnt:            -1  
  267.             SigAlloc:       c000ffff                SigWait:        c0000000  
  268.             SigRecvd:       00000000                SigExcept:      00000000  
  269.             TrapAlloc:          8000                TrapAble:           0000  
  270.             ExceptData:     00000000                ExceptCode:     00fc2ff0  
  271.             TrapData:       00000000                TrapCode:       00ff47ea  
  272.             SPLower:        00266834                SPUpper:        00267034  
  273.             SPReg:          00266f96                                          
  274.             Switch():       00000000                Launch():       00000000  
  275.             UserData:       00000000                                          
  276.             Process Structure:                                                
  277.             WindowPtr:      00000000                Title:                    
  278.             MsgPort:        00000000                                          
  279.             StackBase:      00266834                StackSize:          2048  
  280.             CurrentDir:     00000000                Path:                     
  281.             CIS:            00000000                COS:            00000000  
  282.             ConsoleTask:    00000000                FileSystemTask: 0020709c
  283.             SegList:        002365e4                SegPointer:     0024940c 
  284.             PktWait:        00000000                CLI:            00091bc3 
  285.             CommandLineInterface Structure:                                  
  286.             CommandDir:     00246874                                         
  287.             StandardInput:  00000000                StandardOutput: 00000000 
  288.             CurrentInput:   00000000                CurrentOutput:  00000000 
  289.             Module:         00000000                                         
  290.             Hunks:                                                           
  291.             Lower     Upper         Size                                     
  292.             ----------------------------                                     
  293.             00249410  00249a6c      1636                                     
  294.             0022ee80  0022ee80         8                                     
  295.             total:                  1644 
  296.  
  297.             By Task, Windows, and  Screens is the result equivalent
  298.             Memory will show the memoryfragmention in address and size.
  299.  
  300.  
  301.  Break      cancel a runnig Task. It wiil be set Control D/E/F/C
  302.  
  303.  
  304.  Signal     A requester pops up where you can change the SigAlloc. 
  305.             Show function Break
  306.  
  307.  
  308.  Cancel     switch the gadgetrow from action (orange) back to function
  309.             (white).
  310.  
  311.  
  312.  zz         is a iconify function. If you chose the zz gadget ARTM dis-
  313.             appears and popup as an icon. A doubleklick on this icon and
  314.             ARTM will bring his Window back.
  315.  
  316.  
  317.  i          i is like ABOUT
  318.  
  319.  
  320.  +          + shows the HELP-Page
  321.  
  322. -----------------------------------------------------------------------------
  323.    
  324.  Note :     If you use the function hardware and have installed
  325.             autoconfig-boards (ExpansionBase). Please send us a mail
  326.             and tell us the output from ARTM (PROD, TYPE and MANUFACTRER)
  327.             additional the name and Type from your expansionbords.
  328.  
  329.  You should ever know what you do! Please send bug reports and a list of
  330.  features you would like to have in the next version to the Authors:
  331.  
  332.       Franz Josef Mertens  &  Dietmar Jansen
  333.       Sonnenrain 17
  334.       7277 Wildberg 1
  335.       West-Germany
  336.       Fido-Address: ZENICA (2:507/630)
  337.  
  338.  
  339.  Special thanks to all, who helped us with little routines, tips and
  340.  failure tracking. Special thanks to Matthias Zepf and Markus Stoll.
  341.