home *** CD-ROM | disk | FTP | other *** search
/ back2roots/padua / padua.7z / padua / misc / arpdoc13.lzh / ARES < prev    next >
Encoding:
Text File  |  1989-06-30  |  5.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      ARes(V1.3)              ARP User's Manual              ARes(V1.3)
  5.  
  6.  
  7.  
  8.      NAME
  9.           ARes - Add, view or remove resident programs.
  10.  
  11.      SYNOPSIS
  12.           ARes Filename/..., AS/k REMOVE/s FULL/s FORCE/s NOCHECK/s
  13.  
  14.      DESCRIPTION
  15.           ARes is ARP's alternative to the Commodore Resident.  This
  16.           command should be used instead of Resident when using the
  17.           Arp Shell (ASH) or any other shell which uses the
  18.           arp.library process functions. This resident facility
  19.           supports a "Load on demand" feature, which will only bring
  20.           the program into memory when it is actually accessed.  If it
  21.           is not accessed, it will never be loaded.  Not only does
  22.           this save memory in the case of not using a program, but it
  23.           dramatically speeds up startup scripts which make a lot of
  24.           programs resident.
  25.  
  26.           The ARP Resident allows a program to set its own stack
  27.           size, which prevents crashes and also typically saves
  28.           you memory (all the ARP programs, when run from a shell
  29.           which uses the arp.library process functions, will use
  30.           only a 4000 byte stack).  The ARP resident facility also
  31.           checks to make sure a program is safe to run as resident,
  32.           and will refuse to do so if it is not.  This means you do
  33.           not have to crash your computer to determine which programs
  34.           may be safely run as resident.
  35.  
  36.           ARes by itself displays a list of all currently resident
  37.           programs and statistics on their usage. To add a program to
  38.       the list, simply supply its name.  Like most ARP commands,
  39.       ARes will accept an unlimited number of filenames with each
  40.       invocation.  If you supply a complete pathname, the resident
  41.       facility will use that name to match on AND will also match
  42.       on the filename.  This allows you (for example) to make
  43.       Fault resident as C:Fault, and access it as both Fault and
  44.       C:Fault.  This allows shells to give fast error reporting.
  45.  
  46.      OPTIONS
  47.           AS   Ordinarily, a command is stored on the resident list
  48.                with the same name as you supply on the command line.
  49.                To change this, you use the AS keyword.  For example,
  50.                "ARes DF0:c/DIR as Dir" will use the name "Dir" on the
  51.                list, instead of "DF0:c/Dir".
  52.  
  53.           REMOVE
  54.                Removes a resident program from the list.  If a command
  55.                is stored with its full pathname, you do not need to
  56.                type the whole name, only the filename it is stored
  57.                under to remove it.  For example, to remove a file
  58.                whose resident name is "DF0:c/Dir" you need only type
  59.                "ARes REMOVE Dir".
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/28/89)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      ARes(V1.3)              ARP User's Manual              ARes(V1.3)
  71.  
  72.  
  73.  
  74.           FULL This keyword gives a more informative display than the
  75.                default.
  76.  
  77.           FORCE
  78.                This keyword will force the command or commands into
  79.                memory immediately, overriding the load on demand
  80.                feature.
  81.  
  82.           NOCHECK
  83.                This keyword disables checksum validation on the
  84.                resident program before running it. Every program is
  85.            normally checksumed before each execution and if the
  86.            checksum fails, the resident version of the program is
  87.            not run. There are some applications available that may
  88.            fail a checksum, but can still be run safely from the
  89.            resident list if only one copy of the program is run
  90.            at a time.  The NOCHECK keyword will allow you to run
  91.            these applications and will insure that only one copy
  92.            is run from the resident list. Indiscriminate use of
  93.            this option is likely to cause a system crash by trying
  94.            to run programs that cannot be run from the resident
  95.            list.
  96.  
  97.      Possible Problems
  98.           Not all programs will be happy as resident, it is probably
  99.           fair to say that the large majority of commercial and public
  100.           domain software will not be usable as resident.  All the ARP
  101.           programs, and some commercial software such as TxED+ V2.02
  102.           will work beautifully as Resident.  Hopefully more software
  103.           developers will take advantage of the Resident code features
  104.           of ARP, since it provides a very memory efficient way to run
  105.       multiple copies of programs, as well as faster program loads.
  106.  
  107.           In general, if a program does not work as Resident, the
  108.           resident manager will be able to detect it before running
  109.           your program, and will put up a requester informing you of
  110.           this fact.  You can simply remember not to make that
  111.           particular program resident in the future.  Even if a
  112.           program returns a checksum error, you can remove it using
  113.           the REMOVE switch to recover the memory.
  114.  
  115.      EXAMPLE
  116.           ARes C:Type    ; make type resident
  117.           Run Type DOCUMENTS To PRT:
  118.           Run C:Type DOCUMENTS TO SER:
  119.           DF0:C/Type DOCUMENTS
  120.  
  121.           Note that the last example will not use the resident program
  122.           list, but the disk based version instead.  The first two
  123.           examples will access the resident program.
  124.  
  125.      SEE ALSO
  126.           AshManual Run ARun
  127.  
  128.  
  129.      Page 2                                          (printed 4/28/89)
  130.  
  131.  
  132.  
  133.