Power CD-ROM!! 7/POWERCD7.ISO/os2/amos3/amos3.doc

Text File | 1994-11-06 | 17KB | 418 lines

               AA      MM       MM    OOOO      SSSS
              AAAA     MMMM   MMMM   OO  OO    SS  SS
            AA    AA   MM MMMMM MM  OO    OO  SS    SS
            AA    AA   MM  MMM  MM  OO    OO  SS
            AA    AA   MM   M   MM  OO    OO   SSS
            AAAAAAAA   MM   M   MM  OO    OO      SSS
            AA    AA   MM       MM  OO    OO  SS    SS
            AA    AA   MM       MM   OO  OO    SS  SS
            AA    AA   MM       MM    OOOO      SSSS       v3.01


Copenhagen, Denmark, 07. Nov. 1994



 ■ What is AMOS v3
┌─────────────────···
│
│  AMOS v3 is the second generation of programs designed for accessing HPFS
·  drives from native DOS.
·
·  This generation discards the command-line interface known from AMOS v1.x,
   and enters the world of TSR device drivers.

   AMOS v3 is capable of seamlessly mounting HPFS partitions from native
   DOS, making them accessible from within all ordinary DOS and Windows
   programs.  Files with long filenames are visible as well, using a
   truncated version of the name.

   The current version of AMOS v3 is READ ONLY.  That is, this version of
   AMOS v3 cannot write to your HPFS drives from DOS.  I am currently
   developing a read/write version of the program.


 ■ Disclaimer and legal matters
┌──────────────────────────────···
│
│   The AMOS software and documentation is subject to the following licensing
·   terms and conditions.
·
· * AMOS v3 is supplied as is. The author disclaims all warranties,
    expressed or implied, including, without limitation, the warranties
    of merchantability and of fitness for any purpose. The author
    assumes no liability for damages, direct or consequential, which may
    result from the use of the AMOS software.

  * AMOS v3 is distributed as a "shareware program" and is provided at
    no charge to the user for evaluation for a period not extending 30
    days, after which You are required to register. Feel free to share
    it with your friends, but please do not give it away altered or as
    part of another system. The essence of "user-supported" software is
    to provide personal computer users with quality software without
    high prices, and yet to provide incentive for programmers to
    continue to develop new products.

  * The distribution archive is to be considered an evaluation copy only.
    If you continue to use AMOS v3 after a trial period of 30 days, please
    register.

  * The AMOS v3 distribution package, all programs, the documentation
    and support files are copyrighted 1993-94 by Allan Mertner. All
    rights are reserved. You may copy this package for backup purposes.
    You may also copy and share unmodified copies of the whole
    distribution package, providing that the copyright notice is
    reproduced and included on all copies.

  * You may not sell the product for a fee and/or distribute the product
    along with other products without written permission, nor may you
    modify or remove the Copyright Notices from the programs or the
    documentation files. User clubs, if they are NOT commercial, are
    allowed to ask a small amount of money for distribution and storage
    when they want to share this package amongst their members.

  * It is expressively forbidden to modify, adapt, translate, reverse
    engineer, decompile and/or disassemble the software in the AMOS v3
    package. Patching the medium at places that carry the software is
    seen as a program change and is also forbidden.

  * The registered software is licensed to run in conjunction with one
    user and one PC only.

  * Commercial installations are required to pay the commercial registration
    fee for AMOS v3 for every workstation on which it should run.
    Please refer to Register.Doc.


 ■ Benefits of registering AMOS v3
┌─────────────────────────────────···
│
│  The unregistered version of AMOS v3 is identical to the registered version,
·  except for the message displayed in the unregistered version when the
·  program is loaded.
·
   Please remember, that you are allowed to use the unregistered version for
   a trial period of 30 days ONLY.

   By registering, you will keep the Author happy, and more AMOS products
   will see the light of day.  AMOS v3 is NOT crippleware, and releasing it
   this way is an experiment to see, whether you will pay for fully
   functional shareware.  Lots of people complained that they would never
   register CrippleWare, such as AMOS v1.x.


 ■ Getting AMOS v3 up and running
┌────────────────────────────────···
│
│  I recommend that you create a directory on an available FAT drive ( even
·  a floppy disk will do ), and unpack the AMOS v3 distribution archive in
·  this directory.  For simplicity's sake, I will assume that you have placed
·  all AMOS v3 files in C:\AMOS3, and that C: is a FAT drive.

   Go to the C:\AMOS3 directory, and try to start AMOS v3 by typing

   AMOS3 [Enter]

   at the DOS prompt.  Do not try to start AMOS3 from within Windows or
   in an OS/2 Dos-box; this will not work.  If you want access to your
   HPFS drives from within Windows, load AMOS3 before starting Windows.

   AMOS3 then scans all local hard disk drives, and mounts all HPFS partitions
   found.  When the scanning is complete, AMOS v3 writes a message to
   the screen, stating the number and size of partitions found, as well as
   the drive letters assigned to the partitions.

   That is it!  You can now read all of your data and program files the way
   you can from within an OS/2 DOS box.  You can even play DOOM from DOS,
   with DOOM on an HPFS drive!  You cannot save, though :-)

   When you have finished accessing your HPFS drives, you can unload AMOS v3
   from memory by invoking it again; AMOS v3 will then free all resources
   occupied by the program, thus saving you a reboot.


 ■ AMOS v3 and long filenames
┌────────────────────────────···
│
│  HPFS supports long filenames - files with names not conforming to the
·  8.3 naming convention dictated by DOS.
·
·  Using AMOS v3, you can still access and read these files.  When a file
   or directory with a long filename is encountered, AMOS v3 truncates the
   name part of the filename, and generates a random extension based on the
   full HPFS filename.  Examples of the conversion could be:


   HPFS Filename       AMOS v3 truncated 8.3 filename

   Dos Programs        DOS_PROG.0FN
   Information         INFORMAT.XGL
   OS/2 System         OS!2_SYS.ZAE

   The converted long filenames may look a little weird, but retain their
   names even if moved across drives and directories.  There is a slight
   chance that file names may occur more than once in a directory.  If
   this is a problem, try disabling the long filenames using the -i
   switch.

  Filenames with nothing before the first . (As in ".login") are given a
  first name of BLANK, and a longname extension (Making them utterly
  impossible to recognise :)  (".login" could be "BLANK.HYQ").

  Characters being used in the extension includes A-Z, 0-9, $, !, % and #.


 ■ AMOS v3 options
┌─────────────────···
│
│  AMOS v3 supports the following options when invoked from the command line:
·
·  -c<Number>    Defines the size, in kB, of the XMS cache assigned to
·                AMOS v3.  If you do not specify a number, AMOS uses
                 527kB of XMS cache.  If you do specify one, AMOS may modify
                 the number slightly to improve internal cache handling.

                 To make use of the cache, you need to have HIMEM.SYS loaded
                 in your CONFIG.SYS.  If not, AMOS will run without cache.

                 If you do have XMS memory available, but do not want AMOS v3
                 to use it, specify a cache size of 0.


   -f<0,1,2>     Defines the way AMOS v3 reports free space on the partitions
                 mounted.

                 -f0   Disables scanning, and just reports 0 bytes free.

                 -f1   Scans the drives the first time DOS asks for available
                       space on the disk.  This makes the first DIR command
                       take a bit longer than usual.

                 -f2   Scans all drives when AMOS v3 is first loaded.  Makes
                       the startup a bit longer, but avoids slowdowns later.

                 The default is -f1.


   -i            Ignore long filenames, reporting only files with normal
                 style 8.3 names.


   -p<a,b,c...>  Tells AMOS to mount only HPFS partitions a,b,c, etc.  Use
                 this switch, if you do not want AMOS v3 to mount all of
                 your HPFS partitions.

                 If you have 3 partitions, of which partitions 2 and 3 are
                 HPFS, AMOS v3 will normally mount partitions 2 and 3.

                 If AMOS v3 is started with "AMOS3 -p3", only partition 3
                 is mounted; partition 2 is ignored.


   -u            Unloads AMOS v3 from memory, if it was already loaded.  This
                 might fail, if you have loaded other TSR's after loading
                 AMOS, but should generally work.

                 If you invoke AMOS v3 a second time, AMOS v3 will unload
                 itself from memory disregarding any switches you might
                 specify.  Any switches specified in conjunction with -u
                 are ignored.


 ■ AMOS v3 memory requirements
┌──────────────────────────────···
│
│  AMOS v3 occupies 40720 bytes of precious DOS memory, in addition to the
·  XMS cache memory being used.
·
·  AMOS v3 can of course be loaded high, using LOADHI from QEMM or some other
   utility coming with DOS.  Please consult your DOS manual on this.

   Since 40kB is quite a lot of memory, AMOS v3 can be unloaded when you
   have finished using it.  Simply invoke AMOS v3 a second time, and it
   will remove itself from memory.


 ■ AMOS v3 speed
┌───────────────···
│
│  Comparing the performance of AMOS to that of HPFS drives under OS/2 can
·  never be a fair test.  AMOS is restricted by DOS, 16 bit, and available
·  memory.
·
   Still, my benchmarks show that AMOS is almost as fast as OS/2 when
   doing common things (DIR /S, VirScan, XCOPY, etc).  See the next
   section for the actual figures.


 ■ AMOS v3 benchmark
┌───────────────────···
│
│  AMOS v3 is not the only program available for mounting HPFS drives.  To
·  my knowledge, two other programs exist: HPFSDOS and IHPFS.  I have tested
·  and benchmarked both products - the results follow:
·
   HPFSDOS works fine; I have not been able to find any errors in it.  It
   occupies 55112 bytes of DOS memory.

   IHPFS works fine with most applications.  However, it crashes when I
   try to run my NC clone HC, and it does not report the .. and .
   directories when writing DIR.  IHPFS occupies 8208 bytes of memory
   per partition mounted.  XMS cache can be used, but is default disabled.

   AMOS v3 works fine (I hope :), and occupies 40720 bytes of memory.  XMS
   cache can be used (And will be, default).

   The following benchmarks were performed on my OS/2 HPFS boot-drive,
   containing lots of directories.  The drive is 72MB large, with about
   60MB of files on it.  AMOS v3 was started with the -i switch, since
   neither HPFSDOS nor IHPFS supports long filenames.

   The tests:
     A: SCAN F: /NOMEM.  The scanner used was McAfee SCAN v2.1.1.
     B: SCAN F: /NOMEM /AF Test.  Same scanner as (A), and saving the
        results in a file.
     C: NCD /R using Norton Change Directory v8.0.
     D: PKZIP -r -p F:\*.*.  Used PKZIP v2.04g.

   HPFSDOS was v0.99 beta-3, AMOS was v3.01, and IHPFS was v1.13.

   Time to complete / min │     A      B      C      D
   ───────────────────────┼─────────────────────────────
   AMOS v3, 512k cache    │   0:21   1:33   0:03   5:06
   IHPFS, 512k cache      │   0:17   2:11   0:04   6:30
                          │
   AMOS v3, no cache      │   0:38   2:00   0:09   7:19
   HPFSDOS, no cache      │   2:15   4:59   0:11   7:02
   IHPFS, no cache        │   2:22   5:51   0:14   8:22
                          │
   OS/2 DosBox            │   0:21   1:08   0:03   5:05

   As can be seen from the table, AMOS v3 offers the fastest overall
   performance using the default cache size, though IHPFS using its
   own cache is fast as well.  Without cache, none of the other programs
   come nowhere near the performance AMOS offers.

   The main drawback of AMOS is its memory requirement of 40k, easily beaten
   by IHPFS' 8k per partition.  If you only have a few HPFS partitions, and
   you are not having problems with IHPFS crashes, IHPFS might be the
   program for you.  In all other cases, however, AMOS looks as the best
   shot.


 ■ Troubleshooting AMOS v3
┌─────────────────────────···
│
│  * For optimum performance, make sure that the line
·      DEVICE=HIMEM.SYS
·    is present in our CONFIG.SYS.  If not, AMOS v3 cannot use its internal
·    XMS cache, and will run very slowly.

   * Make sure that the LASTDRIVE variable in CONFIG.SYS is suitably large.
     Setting it at too low a value may mean that some of your HPFS drives
     are not mounted by AMOS v3.  If in doubt, insert the following line
     in your CONFIG.SYS:
     LASTDRIVE=Z

   * AMOS v3 does not run in DOS versions befor DOS 4.01.  If you are still
     running DOS v2.x or 3.x, please upgrade before running AMOS.
     AMOS v3 works the best using DOS 5.x and 6.x.
     AMOS v3 does not work in an OS/2 or Windows NT DOS-box either.

   * Some conditions may cause AMOS v3 to run out of memory.  Lots of HPFS
     partitions may cause this, as may very fragmented files.  Subdirectories
     with thousands of files should not be a problem, however.
     If you do experience memory problems, try to run AMOS using the -p
     switch, to make AMOS v3 load fewer partitions.
     If the memory problem persists, you may have one or more very fragmented
     files.  In this release, there is no other work-around than to defragment
     the file by booting OS/2 and copying the file somewhere else, then
     copy it back onto itself.

   * Very long paths may cause problems.  DOS only allows the full name of
     file and directory to be a maximum of 80 characters long, whereas
     HPFS allows a maximum length of 254 characters.
     If a subdirectory is encountered, that may cause problems, AMOS v3
     reports it as being a 0-byte file instead of a directory to avoid
     problems.
     This may cause a DIR /S command to yield different results under OS/2
     and DOS.
     The problem is prevalent if you run OS/2 Warp v3, using the "Archive
     Desktop" option, since this causes very long paths to be created.

   * Large hard disks with more than 1024 cylinders cannot be read using
     any standard method from DOS.  Partitions on your hard disk which
     crosses this boundary can NOT be read using AMOS v3.


 ■ The future of the AMOS product line
┌─────────────────────────────────────···
│
│  It is my intention to expand the AMOS product line to the following:
·
·
·   AMOS read/write TSR
    AMOS FAT to HPFS converter
    AMOS HPFS to FAT converter
    AMOS HPFS disk optimizer
    AMOS HPFS format utility
    AMOS HPFS CHKDSK utility

  When these tools are in place, even users without OS/2 can use and
  access HPFS drives, and gain access the a file system that is not as
  outdated as "good lod FAT".

  The current version of AMOS v3 is written in Borland Pascal 7.  Future
  development will probably see the AMOS products written mostly in
  assembler, for speed and memory efficiency.


 ■ AMOS registration and support information
┌───────────────────────────────────────────···
│
│  The Author of AMOS v3 is
·
·  Allan Mertner
·  Enghavevej 20A, 2tv
   DK-1674 Copenhagen V
   Denmark
   Europe

   I can be contacted through the following networks and node numbers:
     FidoNet    : 2:235/104
                  2:235/105
                  2:235/106
                  2:235/107

     OS2Net     : 81:445/14

     CompuServe : 100327,2035
                  AMOS v1.x registration ID : 1808
                  AMOS v3   registration ID : As of yet unknown

   Rainbow BBS:
   BBS Line 1 : [phone] (ZyXEL 19k2 / v32bis, soon v34 )
   BBS Line 2 : [phone] (v32bis)
   BBS Line 3 : [phone] (HST 16k8 / v22bis)
   BBS Line 4 : [phone] (ZyXEL 19k2 / v32bis, soon v34 )


   If you live in USA or Australia, please refer to US.REG and OZ.REG,
   respectively.

   All others should use either DENMARK.REG or WORLD.REG, and send it
   to one of the above listed addresses.


 ■ Acknowledgements
┌──────────────────···
│
│  AMOS v3 has been a long time underway, and has only been possible through
·  tremendous support from my wife, my brother, and my enduring friends who
·  have been testing the product even since buggy beta 1.
·

   Thanks to you all!