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