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