home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 28 / amigaformatcd28.iso / +system+ / tools / expert / artm / english.doc / artm.doc next >
Text File  |  1997-02-27  |  19KB  |  426 lines
  1.  
  2.                       ARTM   Amiga Real Time Monitor V2.04
  3.                       -------------------------------------
  4.  
  5.            Copyright  ©  1990-94  by  Dietmar Jansen  &  F.J. Mertens
  6.  
  7.      ARTM displays and  controls  activities  in  your  Amiga.   It is fully
  8.      supported by Intuition and it  is  very  easy  to  use.  It works under
  9.      WB1.3 and WB2.x properly.  ARTM needs Arp.library 39.+
  10.  
  11.      ARTM is a shareware program.  Permission  is granted freely to distrib-
  12.      ute this program without profit.   Copying  is  allowed but only if the
  13.      ARTM package is complete and unchanged .  If you use ARTM often, please
  14.      pay us a donation of  US$15.   In  exchange  you will receive an update
  15.      without the irritating requester.
  16.  
  17.      Please send cash, not cheques.  My  bank  is  a shark.  When you send a
  18.      US$15 cheque:  exchange at the moment US$1 = DM1.70
  19.  
  20.                 US$15 = 25.00 DM
  21.                       - 11.00 DM charge to change a US$ check to German DM
  22.                       ----------
  23.                         14.00 DM
  24.  
  25.      Installation:
  26.      -------------
  27.      Automatic Installation
  28.      You can install ARTM automatically with the Commodore Installer.  There
  29.      is an installation script in the archive.
  30.  
  31.      Manual Installation
  32.      Installation is very easy.  ARTM is a self-contained program so you can
  33.      copy ARTM with the copy command:
  34.  
  35.         copy ARTM <path>/ARTM
  36.  
  37.      into the directory of your choice.   Copy  the .doc files with the copy
  38.      command in the same  way.   The  ARTM.guide  file  should  be copied to
  39.      LOCALE:HELP/.
  40.  
  41.         copy ARTM.guide SYS:LOCALE/HELP/ARTM.guide
  42.         assign HELP: SYS:LOCAL/HELP
  43.  
  44.      The ARTM archive contains the following files:
  45.      ----------------------------------------------
  46.           ARTM
  47.           ARTM.info
  48.           Install_ARTM
  49.           Install_ARTM.info
  50.           german.doc/artm.guide
  51.           german.doc/artm.guide.info
  52.           german.doc/artm.dok
  53.           german.doc/artm.dok.info
  54.           german.doc/artm.history
  55.           german.doc/artm.history.info
  56.           english.doc/artm.guide
  57.           english.doc/artm.guide.info
  58.           english.doc/artm.doc
  59.           english.doc/artm.doc.info
  60.           english.doc/artm.history
  61.           english.doc/artm.history.info
  62.  
  63.      Starting the program:
  64.      ---------------------
  65.      ARTM V2.00 requires Amiga Workbench 2.x and above.
  66.  
  67.      From Shell
  68.      ~~~~~~~~~~
  69.  
  70.      Type  ARTM [opt]          and ARTM will open on the WB Screen
  71.  
  72.      there are many options available:
  73.  
  74.      -q            Will bring up ARTM  in  its  iconified  form in the upper
  75.                    right hand corner.
  76.  
  77.      -poutputpath  tells ARTM where it should  store its output.  Any device
  78.                    can be specified, e.g. prt:, ram:file, etc.
  79.  
  80.      -ix/y         Will bring up the ARTM window  in its full size, but when
  81.                    iconified the icon will be located at x and y position.
  82.  
  83.      -wx/y         Start ARTM as Workbench  window,  x/y  is  the upper left
  84.                    corner of the ARTM-Window.  If the difference from x/y to
  85.                    the right screenside is lower  than  640 pixels then ARTM
  86.                    will start at the upper left corner.
  87.  
  88.      -hx           Start ARTM as Wb window,  x=window.height.  If the screen
  89.                    is shorter than x then ARTM-Window.Height = 168.
  90.      From Workbench
  91.      ~~~~~~~~~~~~~~
  92.      Simply double click the ARTM icon and  the ARTM window will open on the
  93.      Workbench screen.
  94.  
  95.      The options mentioned above can be used as Tooltypes.
  96.                    START=WINDOW|ICON
  97.                    ICON_POS=x/y
  98.                    OUTPUT_PATH=RAM:ARTM.output
  99.                    WINDOWHEIGHT=280
  100.                    WINDOW_POS=70/16
  101.  
  102.      Using the keyboard:
  103.      -------------------
  104.      Keyboard codes are  supported  in  ARTM.   this  version  of  ARTM only
  105.      supports 3  keycodes.   In  future  versions  all  functions  should be
  106.      accessible via the keyboard.
  107.  
  108.      The following keyboard codes are supported:
  109.  
  110.      ESC           quit ARTM
  111.  
  112.      HELP          the ARTM.GUIDE  will  pop  up  and  show  you  the actual
  113.                    function help (see The Help function)
  114.  
  115.      The ARTM requester knows the following keyboard codes:
  116.  
  117.      ESC           cancel function just like the CANCEL button.
  118.  
  119.      RETURN        execute function just like the OK button
  120.  
  121.  
  122.      The ARTM Help function:
  123.                    extensive help is available  in  ARTM.  After hitting the
  124.                    help key,  ARTM.guide  pops  up  and  help  for  the last
  125.                    selected function will be  displayed.   You must have the
  126.                    amigaguide.library  in  your  Libs:  directory  for  this
  127.                    function to work.   Also,  ARTM.guide  must  be correctly
  128.                    installed (see Installation)
  129.      -----------------------------------------------------------------------
  130.  
  131.      The following functions are available from ARTM:
  132.  
  133.      Task          (default setting) lists  all  tasks  in  your Amiga.  You
  134.                    select a task with a mouse  click on the requested entry.
  135.                    Now you can remove it with  REMOVE or change the priority
  136.                    with PRIORITY.   The  MORE  function  brings  up  further
  137.                    information (see MORE).
  138.  
  139.                    This information is displayed:
  140.                    Address, Priority, Signals, State, Code; Type, Name.
  141.  
  142.      Windows       lists all  open  screens  and  windows.   Screens  are in
  143.                    colour 3, windows are  white.   Close  a window/screen by
  144.                    selecting its item and click on CLOSE.  The MORE function
  145.                    brings up more information  about  the selected screen or
  146.                    window (see more).
  147.  
  148.                    WARNING:  The GURU  is  waiting  for  you  if  you kill a
  149.                    window before its task is finished.
  150.  
  151.                    This information is displayed:
  152.                    Address, Position, Size, Flags,  IDCMP (only by windows),
  153.                    Title.
  154.  
  155.      Libraries     lists all Libraries.  By  clicking  on  any item, you can
  156.                    close the library with  CLOSE  (OpenCount  must be NULL);
  157.                    REMOVE  removes  the   library.    PRIORITY  changes  the
  158.                    priority.
  159.  
  160.                    This information is displayed:
  161.                    Address, Type, Priority, OpenCount,  Version (consists of
  162.                    version & revision), Negsize, Possize, Name.
  163.  
  164.      Devices       lists all devices.  By clicking  on REMOVE you can remove
  165.                    a selected device,  provided  it  has  been  closed.  The
  166.                    PRIORITY function changes the priority.
  167.  
  168.                    This information is displayed:
  169.                    Address, Type, Priority,  OpenCount,  Version (consist of
  170.                    version & revision), Negsize, Possize, Name.
  171.  
  172.      Resources     lists all resources.  The  PRIORITY  function changes the
  173.                    priority and REMOVE removes a selected resource.
  174.  
  175.                    This information is displayed:
  176.                    Address, Type, Priority, OpenCount,  Version (consists of
  177.                    version & revision), Negsize, Possize, Name.
  178.  
  179.      Ports         shows all ports and the name of their tasks.  IDCMP_Ports
  180.                    are owned by a window.  Ports are removable with REMOVE.
  181.  
  182.                    This information is displayed:
  183.                    Address, PortName, Type, SigBit, Flags, TaskName.
  184.  
  185.      Residents     lists all residents in  your  Amiga.  Residents that were
  186.                    added by the KickTagPtr (e.g.  a  virus  or RAD:) will be
  187.                    displayed in colour 3  and  if  the  residents are in the
  188.                    Res-Modules-table too, they will be displayed in black.
  189.  
  190.                    This information is displayed:
  191.                    Address, Type, Priority, Version, Flags, Name.
  192.  
  193.      Interrupts    shows all interrupts in your  Amiga.  You can only remove
  194.                    an interrupt controlled by a server with REMOVE.
  195.  
  196.                    This information is displayed:
  197.                    Address, Data, Code, Priority,  Type, Nr., InterruptName,
  198.                    Name.
  199.  
  200.      Vectors       show  vectors,  e.g.    Cool-,   Cold,-  WarmCapture  and
  201.                    Kickpointers.
  202.                    This is helpful when searching  for viruses, but remember
  203.                    that the RAD: device  in  Kick  1.3  uses the KickTagPtr.
  204.                    Use the CLEAR function to set any Vector to NULL.  If you
  205.                    close KickMemPtr,  KickTagPtr  or  KickCheckSum,  all  of
  206.                    these three would be set to NULL.
  207.  
  208.                    This information is displayed:
  209.                    Address, Vector and Content.  Should the KickTagPtr point
  210.                    to a resident table, you get  the  Address & Name of this
  211.                    table, but note that  only  the  first  item of the table
  212.                    would be displayed.   If  you  want  to  see  the others,
  213.                    select  function  Residents.    The   residents   of  the
  214.                    KickTagPtr-table would be displayed coloured (see above).
  215.  
  216.      Memory        show the memory in chip, fast and expansion ram (like the
  217.                    AmigaDOS avail command).   The  PRIORITY function changes
  218.                    the priority.  If you  select  the  memory (chip or fast)
  219.                    and click  MORE  then  ARTM  will  show  you  the  memory
  220.                    fragmentation.
  221.  
  222.                    This information is displayed:
  223.                    Address, Priority, Attribute,  Lower,  Upper, Maximum, in
  224.                    Use, Free, Largest,  Name  and  in  the  next  column the
  225.                    totals.
  226.  
  227.      Mount         lists all mounted Devices in your Amiga.
  228.  
  229.                    This information is displayed:
  230.                    Address,  Device,  Heads,   Sectors,   Buffer,  Cylinder,
  231.                    Interleave factor, Handler name.  With storage units ARTM
  232.                    will also display  Size,  Full,  rw  (read/write status),
  233.                    Volume (name).
  234.  
  235.      Assign        shows all assigned paths and programs.
  236.  
  237.                    This information is displayed:
  238.                    Address, Directory, Path.
  239.  
  240.      Locks         shows all Locks (read and write).   If you have more than
  241.                    200 Locks (ARTM has 100 Arrays)  you  can see the next or
  242.                    previous 100 Locks with the Forward or Backward function.
  243.                    Select a Lock and  choose  Unlock  to remove the selected
  244.                    item.
  245.  
  246.                    This information is displayed:
  247.                    Address, Access, Path.
  248.  
  249.      Fonts         lists all loaded fonts, in  KickRom too.  With REMOVE you
  250.                    can remove the selected  Font.   If  you quit the program
  251.                    that used the  font  (Count  =  NULL),  the system should
  252.                    release the requested memory.
  253.  
  254.                    This information is displayed:
  255.                    Address, Count, YSize, XSize, Style, Flgs, LoChar, HiChar
  256.                    and Name.
  257.  
  258.      Hardware      lists all  installed  autoconfig-boards  (ExpansionBase).
  259.                    ARTM will show you which  processor and maths coprocessor
  260.                    are in your Amiga.   In  addition  ARTM indicates the new
  261.                    ECS-Chips Fat Agnus or Fat Denise (PAL or NTSC) or normal
  262.                    Agnus and Denise.
  263.  
  264.                    This information is displayed:
  265.                    Address, Boardadr, Boardsize,  Slotadr, Slotsize, Driver,
  266.                    Product, Type and Manufacturer.
  267.  
  268.      Res Cmds      lists all commands made residents  with both AmigaDos and
  269.                    the ARP1.3 ARES  command.   The  AmigaDos  residents will
  270.                    show all datasegments  with   Lower  Adr,  Upper  Adr and
  271.                    Size.
  272.  
  273.                    This information is displayed:
  274.                    Sys (AmigaDos  or  ARP),  Name,  Usage  (only  with ARP),
  275.                    Access.
  276.  
  277.      Semaphores    show all Semaphores from  AmigaDos.   With REMOVE you can
  278.                    remove the  selected  Semaphore  but  the  Semaphore will
  279.                    automatically be released  first.   With  RELEASE you can
  280.                    release any Semaphores.
  281.  
  282.                    This information is displayed:
  283.                    Address, Priority, NestCount, WaitQueue, Name, OwnerTask.
  284.  
  285.      Monitor       is a little memory  monitor  and  shows the whole memory.
  286.                    The memory will be loaded  into  the 100 ARTM stringgadg-
  287.                    ets.  You can view the next  or previous 100 records with
  288.                    Forward and Backward.  A click on Address will bring up a
  289.                    requester, type an address  in  it  and the Monitor lists
  290.                    the next 100 records from that address.
  291.  
  292.                    This information is displayed:
  293.                    Address, Bytes(Hex), Bytes(ASCII)
  294.  
  295.      Last Alert    shows the last Alertnumber and address.
  296.      -----------------------------------------------------------------------
  297.  
  298.      Remove        removes selected tasks, libs, devices, ports, interrupts,
  299.                    semaphores, and Fonts.  Select  the  entry  to be removed
  300.                    with a mouseclick.  But remember libs and devices must be
  301.                    closed.
  302.  
  303.      Close         closes screens/windows and libraries.  Use it as remove.
  304.  
  305.      Releases      release Semaphores from SignalSemaphore.
  306.  
  307.      Clear         sets the SystemVectors  to  NULL.   Use  it  as remove or
  308.                    close.
  309.  
  310.      Freeze        freezes a running  Task  and  removes  it  form  the node
  311.                    structure.  The frozen task structure is stored.  It will
  312.                    be labelled as "Frozen" under the SATE column on the Task
  313.                    display.  If  you  select  a  frozen  task  and  click on
  314.                    Activate then the task will start running again.
  315.  
  316.      Activate      is the opposite of Freeze (see above).
  317.  
  318.      Priority      changes the priority of a  selected task, library, device
  319.                    interrupts, memory or  resource.   Values  may range from
  320.                    -128 to 127, though it's better to use values between -10
  321.                    and 10.
  322.  
  323.      Unlock        removes a Lock (read or write) from the list.  ATTENTION:
  324.                    if the system is using the  Lock then your Amiga will get
  325.                    a visit from the Indian.
  326.  
  327.      More          shows detailed information.  In ARTM version 1.0 this was
  328.                    implemented for the  Task,  Windows,  Screens, and Memory
  329.                    functions.
  330.  
  331.                    Example:
  332.                    Click on the required task and then on MORE.  This is the
  333.                    result for any task.
  334.  
  335.                    Task Structure:
  336.                    IDNestCnt:            0         TDNestCnt:             -1
  337.                    SigAlloc:      c000ffff         SigWait:         c0000000
  338.                    SigRecvd:      00000000         SigExcept:       00000000
  339.                    TrapAlloc:         8000         TrapAble:            0000
  340.                    ExceptData:    00000000         ExceptCode:      00fc2ff0
  341.                    TrapData:      00000000         TrapCode:        00ff47ea
  342.                    SPLower:       00266834         SPUpper:         00267034
  343.                    SPReg:         00266f96
  344.                    Switch():      00000000         Launch():        00000000
  345.                    UserData:      00000000
  346.                    Process Structure:
  347.                    WindowPtr:     00000000         Title:
  348.                    MsgPort:       00000000
  349.                    StackBase:     00266834         StackSize:           2048
  350.                    CurrentDir:    00000000         Path:
  351.                    CIS:           00000000         COS:             00000000
  352.                    ConsoleTask:   00000000         FileSystemTask:  0020709c
  353.                    SegList:       002365e4         SegPointer:      0024940c
  354.                    PktWait:       00000000         CLI:             00091bc3
  355.                    CommandLineInterface Structure:
  356.                    CommandDir:    00246874
  357.                    StandardInput: 00000000         StandardOutput:  00000000
  358.                    CurrentInput:  00000000         CurrentOutput:   00000000
  359.                    Module:        00000000
  360.                    Hunks:
  361.                    Lower           Upper          Size
  362.                    -----------------------------------
  363.                    00249410      00249a6c       1636
  364.                    0022ee80      0022ee80          8
  365.                    total:                        1644
  366.  
  367.                    For Windows, and Screens  the  result is similar.  Memory
  368.                    will show the memory fragmentation in address and size.
  369.  
  370.      Break         cancels a running Task.  The  selected  task will be sent
  371.                    Ctrl-D/E/F/C
  372.  
  373.      Signal        A requester pops up  where  you  can  change the SigAlloc
  374.                    (see Break)
  375.  
  376.      Cancel        switches the gadgetrow  from  action  (colour  4) back to
  377.                    function (colour 2).
  378.  
  379.      Monitor Functions
  380.      -----------------
  381.      Address       Pops up a little Requester.  Enter  an address and it and
  382.                    the next 99 addresses will be displayed.
  383.  
  384.      Forward       lists the next 100 rows.
  385.  
  386.      Backward      lists the previous 100 rows.
  387.  
  388.      Search        Pops up a little  Requester.   Enter  an ASCII string and
  389.                    ARTM will search memory for it.
  390.  
  391.      Title Bar Gadgets
  392.      -----------------
  393.      zz            Iconify function.   If  you  chose  the  zz  gadget  ARTM
  394.                    disappears and puts an icon  on  the Workbench.  A double
  395.                    click on this icon will bring ARTM's main window back.
  396.  
  397.      i             i is like ABOUT
  398.  
  399.      Disk symbol   stores all items from the currently displayed function to
  400.                    a file or prints it out to PRT: (see -p option above)
  401.      -----------------------------------------------------------------------
  402.  
  403.      Note :        If you use  the  hardware  function  and  have autoconfig
  404.                    boards (ExpansionBase)  installed  that  aren't  properly
  405.                    recognised by ARTM then please  write  to  us and tell us
  406.                    the output from ARTM  (PROD,  TYPE  and MANUFACTURER) and
  407.                    also the name and Type of your expansion boards.
  408.  
  409.      You should always be careful  of  what  you're  doing!  Please send bug
  410.      reports and a list of  features  you  would  like  to  have in the next
  411.      version to the Authors:
  412.  
  413.            Franz Josef Mertens
  414.            Sonnenrain 17
  415.            72218 Wildberg 1
  416.            Germany
  417.  
  418.            Fido (2:246/2013.9) Mentopolis Wildberg
  419.            UUCP fjm@merlin.tynet.sub.org
  420.  
  421.      Special thanks to everyone who helped us with little routines, tips and
  422.      error tracking and all Beta testers.  Special thanks to:
  423.  
  424.      Matthias Zepf, Markus Stoll, Matthias Scheler, Kai Bolay, Marc Heuler,
  425.      Gregor Hutla and Paul Browne.
  426.