home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / UTIL_ARC / AM101.ZIP / AM.DOC next >
Text File  |  1994-02-21  |  72KB  |  1,761 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                  ArcMaster 10.1
  12.  
  13.                               Copyright 1987-1994
  14.  
  15.                               All Rights Reserved
  16.  
  17.                           New-Ware Shareware Products
  18.                                8050 Camino Kiosco
  19.                               San Diego, CA 92122
  20.                                  (619) 455-6225
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.   1  Disclaimer
  28.  
  29.  
  30.        New-Ware hereby disclaims all warranties relating to this product,
  31.   whether express or implied, including without limitation any implied
  32.   warranties of merchantability or fitness for a particular purpose. New-Ware
  33.   cannot and will not be liable for any special, incidental, consequential,
  34.   indirect or similar damages due to loss of data or any other reason, even if
  35.   New-Ware or an authorized New-Ware agent has been advised of the possibility
  36.   of such damages.  In no event shall the liability for any damages ever
  37.   exceed the price paid for the license to use software, regardless of the
  38.   form and/or extent of the claim.  The user of this program bears all risk as
  39.   to the quality and performance of the software.
  40.  
  41.  
  42.   2  What is ArcMaster?
  43.  
  44.  
  45.        The name ArcMaster is short for the term Archive Master where the word
  46.   archive means a place where documents and/or records are kept.  In the
  47.   modern world of personal computing, these documents and records are
  48.   maintained in computer files.  These files are frequently compressed and
  49.   grouped together in archive files by special compression systems such as
  50.   ARJ, LHA, UC2, and ZIP.  All of these special programs are operated from the
  51.   DOS command line and require the entry of numerous and varied command line
  52.   switches in order to maximize their utility.
  53.  
  54.        ArcMaster, hereafter known as AM, is an compression system control
  55.   system.  It provides a powerful, easy to use interface that removes the
  56.   burden of remembering all the various command line switches and options that
  57.   may be used with archiving programs.  In addition, AM is a flexible DOS
  58.   shell that provides numerous ways in which the user can maintain and
  59.   manipulate his/her DOS directory and file structures.
  60.  
  61.        AM may be used as a stand-alone program in its useful role as a DOS
  62.   shell, but in order to manipulate compressed archive files the user must
  63.   have present in his/her system at least one of the supported archive
  64.   programs.  A list of supported compression/decompression archive programs
  65.   appears in the next section.
  66.  
  67.  
  68.   3  Archive Systems Needed to Operate AM
  69.  
  70.  
  71.        You will need at least one of the following archive systems in order to
  72.   utilize the full capabilities of AM.
  73.  
  74.             ARJ from Robert K. Jung  -  ARJ230.XXX
  75.  
  76.  
  77.  
  78.                                      - 2 -
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.             Robert Jung
  86.             2606 Village Road West
  87.             Norwood, Massachusetts 02062
  88.  
  89.             LHA from Haruyasu Yoshizaki  -  LHA213.XXX
  90.             This program is free.
  91.  
  92.             UltraCompressor II from AIP-NL  -  UCINS.EXE
  93.             AIP-NL
  94.             P.O. Box 1432
  95.             3430 BK Nieuwegein
  96.             The Netherlands
  97.  
  98.             ZIP from PKWARE  -  PKZ204G.XXX
  99.             PKWARE Inc.
  100.             9025 North Deerwood Drive
  101.             Brown Deer, WI 53223-2437
  102.  
  103.        The file names following the program identifiers reflect the current
  104.   versions.  Please note the .XXX file extension is given because these will
  105.   vary from location to location.  Many are distributed in compressed
  106.   executable (.EXE) format and some are distributed in the PkWare .ZIP format.
  107.   You can find these marvelous programs on just about any computer bulletin
  108.   board system (BBS) or commercial on-line access system such as Compuserve
  109.   Information Service (CIS) or Genie.  All of these programs may be accessed
  110.   from the New-Ware BBS.  Please see the chapter on the New-Ware BBS in this
  111.   document.
  112.  
  113.        AM supports several utilities designed for the specific purpose of
  114.   compressing executable (EXE) files.  These utilities serve to compress an
  115.   EXE file but allow the compressed file to be executed normally from DOS.
  116.   Their trick is that they insert code into the start of the target EXE file
  117.   that decompresses it as it loads into memory for execution.  AM supports the
  118.   following utilities of that type:
  119.  
  120.                  LZEXE from Fabrice Bellard
  121.                  This program is free
  122.  
  123.                  PKLITE from PkWare
  124.                  PKWARE Inc.
  125.                  9025 North Deerwood Drive
  126.                  Brown Deer, WI 53223-2437
  127.  
  128.                  DIET from Teddy Matsumoto
  129.                  This program is free
  130.  
  131.        While not necessary, the user should also have available a file browse
  132.   utility as an alternative to the built in AM browser.  The browser is used
  133.  
  134.  
  135.  
  136.                                      - 3 -
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.   to view/browse the contents of normal files and compressed files that reside
  144.   inside an archive.  AM can be configured to use any file browser that
  145.   accepts a file path name on its command line and the internal browser can
  146.   handle files of any size.
  147.  
  148.        It is important to note the version numbers given above.  AM currently
  149.   supports all version numbers listed above.  Features in earlier versions are
  150.   likely not to be supported and new features in later versions may not be
  151.   supported.
  152.  
  153.        It is mandatory that all supported program files reside in a directory
  154.   that is identified in the "CompDir:" field in the AM configuration dialog.
  155.   If no directory is entered in this field, you will have to ensure that ALL
  156.   supported program files reside on the DOS path.  If you do not understand
  157.   the DOS PATH, please read PATHINFO.TXT.
  158.  
  159.  
  160.   4  About Shareware
  161.  
  162.  
  163.        AM is Shareware.  ARJ, UC2, ZIP, and LIST are also Shareware.
  164.   Shareware is NOT free.  It is computer software offered for sale at a set
  165.   price and the only real difference between Shareware and other commercial
  166.   software products is the method of distribution and the important "try
  167.   before you buy" feature.  With Shareware you are normally licensed by the
  168.   owner/author of the program to operate the Shareware distribution copy on a
  169.   trial basis.  Then if you like it and make regular use of it, you are bound
  170.   to pay for it.
  171.  
  172.        Users are licensed to operate ArcMaster on their personal computers for
  173.   the purpose of test and evaluation on a trial basis for a limited trial
  174.   period.  It is not possible to reasonably define any definitive limits of a
  175.   fair and equitable time period for evaluation, therefore it is left to the
  176.   user's judgment and sense of fair play as to the time required to make a
  177.   decision as to its usefulness.  If the user decides the program is not of
  178.   sufficient merit to warrant purchase through registration with New-Ware, the
  179.   program should be removed from his or her personal computer.  Otherwise, if
  180.   the program is deemed useful and is in regular use on the user's personal
  181.   computer system, registration with New-Ware is required.
  182.  
  183.        Registered users are those users that elect to pay for AM and register
  184.   that payment with New-Ware.  By virtue of registration and payment for the
  185.   program, registered users are granted a license to continue to utilize the
  186.   program on their personal computer for as long as they choose.  This license
  187.   authorizes the user to use the program on any personal computer system he or
  188.   she may own so long as the program is operated on only one computer system
  189.   at a time.
  190.  
  191.  
  192.  
  193.  
  194.                                      - 4 -
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.        Site licenses for use of ArcMaster on multiple computers are available
  202.   upon request at a reduced fee that is based on the number of single machines
  203.   licensed for use.
  204.  
  205.  
  206.   5  How To Register
  207.  
  208.  
  209.        There is no functional difference between the Shareware distribution
  210.   version of AM and the registered version save the absence of the opening and
  211.   closing Shareware screens in the registered version.
  212.  
  213.        The price of AM is $35.00.  You may register AM in one of three ways:
  214.  
  215.             1) By mail with check or money order to:
  216.  
  217.                            New-Ware
  218.                            8050 Camino Kiosco
  219.                            San Diego, CA 92122-1820
  220.  
  221.             2) By telephone with Visa/Mastercard to:
  222.  
  223.                            New-Ware
  224.                            (619) 455-6225
  225.                            Business hours ONLY please!
  226.                            Monday thru Friday
  227.                                 8 a.m. to 5 p.m. Pacific Time
  228.                            Saturday
  229.                                 8 a.m. to 1 p.m. Pacific Time
  230.  
  231.             3) Electronically through the New-Ware BBS:
  232.  
  233.                            New-Ware BBS
  234.                            (619) 455-5226
  235.                            24 Hours per day
  236.                            7 Days per week
  237.  
  238.             4) French users with no Visa/MasterCard may register via
  239.  
  240.                            DP Tool Club
  241.                            B.P. 745
  242.                            99 rue Parmentier
  243.                            59657 Villenueve D'asq
  244.                            FRANCE
  245.                            33-20.05.35.66
  246.  
  247.             5) In Japan please call P. & A. Ltd. at 0425-46-9141 to
  248.                Register.
  249.  
  250.  
  251.  
  252.                                      - 5 -
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.        Special site license rates for licensing multiple copies of ArcMaster
  260.   are available.  Please contact New-Ware for site license per copy schedule
  261.   information.
  262.  
  263.        Foreign (non-US/Canada) orders must include a $2.00 special handling
  264.   fee in addition to the $35.00 registration fee.  Also, no checks on banks
  265.   located outside the United States will be accepted.
  266.  
  267.        California residents MUST include state sales tax with their order.
  268.  
  269.        The Shareware version of ArcMaster and ONLY the Shareware version may
  270.   be freely copied and passed on to other individual users for their
  271.   evaluation.  Disk vendors and/or distributors that desire to distribute
  272.   ArcMaster must adhere to the guidelines presented in VENDOR.DOC.
  273.  
  274.        Press Alt+R to invoke an interactive registration form dialog.  All
  275.   pertinent information may be entered into the dialog and then sent to the
  276.   printed as a registration form.
  277.  
  278.        Upgrades to later versions are available to registered users on the
  279.   New-Ware BBS at no cost.  Access to the BBS is a privilege granted by New-
  280.   Ware that may be revoked at any time for any reason.  Those who request
  281.   upgrades via telephone or mail must remit a $5.00 charge for an upgrade.
  282.  
  283.  
  284.   6  The New-Ware BBS
  285.  
  286.  
  287.        New-Ware Shareware Products BBS
  288.  
  289.        (619) 450-3257 - Node #1 1200/2400/9600/14400  PPI 14000FXMT
  290.              455-5226 - Node #2 1200/2400 (9600 HST)  US Robotics HST
  291.  
  292.        The New-Ware Shareware Products BSS operates 24 hours per day, 7 days
  293.   per week.  Node #1 is dedicated to registered users only.  Nodes #2 is open
  294.   to all callers.  Users registering via the BBS receive access to the latest
  295.   registered version within 1 day after leaving their credit card data.  Users
  296.   who register by mail or phone may also access the registered version by BBS,
  297.   but you MUST log on and leave a comment to the sysop to the effect that you
  298.   are a registered user and desire access.  The author can also be contacted
  299.   on CIS via PPN 71535,665 (please use EMAIL).
  300.  
  301.        The latest versions of all programs that are supported or used by AM
  302.   may be obtained via the BBS.  The BBS also serves as an avenue for product
  303.   support.  You may report problems or ask questions about the operation of AM
  304.   via the message facility of the BBS.
  305.  
  306.  
  307.  
  308.  
  309.  
  310.                                      - 6 -
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.   7  System Requirements
  318.  
  319.  
  320.        AM may be operated on any IBM PC/XT/AT/PS2 or compatible running under
  321.   DOS 3.0 and above and an 80286 or better CPU is required.  The amount of DOS
  322.   memory required to operate AM will vary dynamically and will generally be a
  323.   function of the number of files in each of the main windows.  AM is very
  324.   efficient and should operate with no problems in all but the leanest memory
  325.   environment.
  326.  
  327.        All monitor and graphics cards are supported, including "composite" (2
  328.   color) monitors and backlit laptop screens.  If difficulty with a laptop is
  329.   encountered, start AM with the "/M" parameter.  When executed, AM will
  330.   automatically switch to current screen mode and adjust to the current
  331.   vertical screen height and upon exit to DOS it will restore the original
  332.   video state.  EGA/VGA users may toggle between the normal 25 line and the
  333.   43/50 line mode while running AM and AM may be configured to be forced into
  334.   the 43/50 line mode at run-time.
  335.  
  336.        Mouse support is automatically provided if a mouse driver is present in
  337.   the system.  Any dot matrix or laser printer may be used for printing file
  338.   directory listings.  The printer must be capable of printing IBM line draw
  339.   characters if the directory tree is to be legibly printed.
  340.  
  341.        AM is designed primarily for use with one or more hard drives.
  342.   Starting and operating AM from a 5 1/4" 360K drive is not recommended
  343.   because of the lack of disk space for temporary files, etc.  A multiple 3
  344.   1/2" 720K/1.4M or 5 1/4" 1.2M system will probably be okay, but a hard drive
  345.   is the best way to go.
  346.  
  347.  
  348.   8  Prohibition
  349.  
  350.  
  351.        ArcMaster is released as a single-user product.  It is PROHIBITED for
  352.   ArcMaster to be utilized as a file access program or file retrieval system
  353.   for a CD-ROM disk.  The Shareware version of ArcMaster may be included in a
  354.   CD-ROM Shareware file collection, but it may NOT be used as the means for
  355.   the buyer and user of such a CD-ROM disk to access the files on that disk.
  356.   This means that the distributor of the CD-ROM must NOT provide any
  357.   instructions or directions to the effect that ArcMaster is to be used in
  358.   accessing the files on the disk.
  359.  
  360.  
  361.   9  Version History
  362.  
  363.  
  364.   Version 9.8
  365.  
  366.  
  367.  
  368.                                      - 7 -
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.        - Replaced the internal bare-bones file browser (Ctrl+N) with a
  376.          more sophisticated browser that has many more features.
  377.        - Fixed a problem with correctly recognizing an EXE file compressed
  378.          with PKLITE.
  379.        - Fixed a problem with saving/restoring the two window sort types.
  380.        - Dropped all support for 8088/8086 computers.  AM now requires an
  381.          80286 or better CPU.
  382.  
  383.   Version 9.9
  384.  
  385.        - Excluded 8088/8086 CPUs.
  386.        - Minor bug fixes and enhancements.
  387.  
  388.   Version 10.0
  389.  
  390.        - The F8 command in compression dialogs pulled in the full file
  391.          name with period and extension instead of just the file name.
  392.        - Incorporated ability to retain tags after operations and
  393.          single key toggle of the "Keep Tags" setting.
  394.        - Dropped all support for PAK and incorporated support for the new
  395.          UC2 compression system.
  396.        - Files with SDN extension supported as ARJ compressed files.
  397.        - Added ability to tag multiple directories on the same drive for the
  398.          display of the files in each tagged directory in the current file
  399.          list.  Comparable to a "global file list" capability.
  400.        - Added ability to select from 4 different desktop background
  401.          patterns, one of which gives a solid background.
  402.        - Improved mouse support with a pop-up menu with most used items.
  403.          Activated by the right mouse button.
  404.        - Improved mouse support with mouse "hot" regions on the new display
  405.          bottom line.
  406.        - Fixed problem with reading single ZIP files residing inside of
  407.          single ZIP files that contain a single ZIP file.
  408.        - Added an "[ ] From Top" speed search start option to the directory
  409.          tree.
  410.  
  411.   Version 10.1
  412.  
  413.        - Fixed command label confusion (Alt+O/C) problem in the compressed
  414.          file viewer.
  415.        - Added "Print File" command to the internal viewer menu.
  416.        - Fixed problem with showing compression ratio when viewing UC2 files.
  417.        - Fixed problem with tag ops showing 0 bytes for all tagged files.
  418.        - Fixed problem when using the refreshing command ("*") when operating
  419.          on a floppy disk.
  420.        - Fixed UC2 typos and added "Incremental" and "Subdirs" options to the
  421.          UC2 decompression dialog.
  422.        - Fixed disabling of the mask feature when no matching files present.
  423.  
  424.  
  425.  
  426.                                      - 8 -
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.        - Files were not being removed from the temporary directory after
  434.          conversion to UC2.
  435.        - Fixed a bug that prevented proper manipulation of a file after it
  436.          had been renamed in AM.
  437.  
  438.  
  439.   10  Distribution Files
  440.  
  441.  
  442.        The following files are included in AM distribution package:
  443.  
  444.                  AM.EXE         - Main program
  445.                  AM.OVR         - Overlay file
  446.                  AMHELP.HLP     - Help file
  447.                  AM.DOC         - Operating manual
  448.                  EXECMENU.AM    - Sample program menu
  449.                  AMCOLORS.DOC   - Setting program colors
  450.                  PATHINFO.TXT   - DOS PATH information
  451.                  PROGMENU.DOC   - User defined menu info
  452.                  VENDOR.DOC     - Disk vendor info
  453.                  CDROM.BAN      - CD-ROM use restriction
  454.                  CD-ROM.TXT     - Info on CD-ROM disk
  455.                  WHAT'S.NEW     - Latest product info (if needed)
  456.  
  457.        New-Ware prohibits the modification of any of these files in any way,
  458.   shape, or form except by the individual evaluator or purchaser.
  459.  
  460.  
  461.   11  ArcMaster Program Files
  462.  
  463.  
  464.        It is important that you place the ArcMaster program files listed below
  465.   in the same directory and ensure that directory appears in your DOS path
  466.   string:
  467.  
  468.                            AM.EXE
  469.                            AM.OVR
  470.                            AM.CFG
  471.                            AMHELP.HLP
  472.  
  473.        AM will not run if it cannot locate its overlay file (AM.OVR). If AM
  474.   cannot locate its help file (AMHELP.HLP), there will be no context sensitive
  475.   on-line help available in the program and important configuration
  476.   information will not be available if AM is unable to locate its
  477.   configuration file (AM.CFG).
  478.  
  479.        Other files created by AM include:
  480.  
  481.  
  482.  
  483.  
  484.                                      - 9 -
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.                            AM.HST
  492.                            AMCOL.SET
  493.  
  494.        Text input line history information is maintained in AM.HST and the
  495.   color configuration is maintained in AMCOL.SET.
  496.  
  497.        AM expects to find all the required and optional files in the directory
  498.   from which it resides when it is loaded and executed.  This will be no
  499.   problem if all AM program files are placed in the same directory and that
  500.   directory is on the DOS path so that AM will be run from the same directory
  501.   no matter where you are in your system when you invoke AM.
  502.  
  503.  
  504.   12  Starting ArcMaster
  505.  
  506.  
  507.        AM can be started from the DOS command line by typing AM and pressing
  508.   the Enter key.  Up to three command line parameters are accepted.  There may
  509.   be one or two valid DOS path names and there may be one valid DOS file name.
  510.   For example, to start AM with the directory D:\FOO\BAR active in the AM
  511.   right file window, enter AM D:\FOO\BAR.  To start AM with C:\ARCHIVE in the
  512.   left window and D:\FOO\BAR in the right window, enter AM C:\ARCHIVE
  513.   D:\FOO\BAR.
  514.  
  515.        AM may be run from a DOS batch file or from another DOS shell, but if
  516.   it is run from another shell you may have to adjust the configuration so
  517.   that AM has sufficient memory to operate.
  518.  
  519.        If a file name may be placed on the command line when starting AM, the
  520.   file will be viewed as soon as loads the main file windows.  This means that
  521.   the compressed file viewer will be called if the file is a compressed file,
  522.   otherwise the default browser will be called.
  523.  
  524.        First time users of the Shareware evaluation version of AM will note
  525.   that the first event that occurs after the Shareware delay is complete is
  526.   the appearance of the AM configuration dialog.  It is important that you
  527.   configure at the very least the following two directories:
  528.  
  529.                  Work Dir:
  530.                  Comp Dir:
  531.  
  532.        The work directory is require for the exclusive use of AM.  The
  533.   compression directory is the single directory where all of your archive
  534.   system programs (PKZIP.EXE, PKUNZIP.EXE, LHA.EXE, etc.) reside.
  535.  
  536.        Be sure to save the configuration to disk before proceeding.
  537.  
  538.  
  539.  
  540.  
  541.  
  542.                                      - 10 -
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.   13  The User Interface
  550.  
  551.  
  552.        The AM user interface has been carefully designed to provide a set of
  553.   commands and controls that maximize the program's utility for both straight
  554.   keyboard and mouse users.  The interface employs a "point and shoot" file
  555.   manipulation function via file name lists with scrolling cursor bars.  All
  556.   AM functions are available through a pull-down menu system that may be
  557.   activated with the mouse or by pressing either keyboard backslash (\) key.
  558.   All functions are also accessible via Alt and Ctrl key combinations.  The
  559.   program can be exited to DOS via the menu, by pressing Esc key, by pressing
  560.   Alt+=, or by pressing Alt+X.  Alt+X exits immediately while the Esc key asks
  561.   for confirmation.
  562.  
  563.        Most commands result in the appearance of a window or dialog box.  For
  564.   the purposes of this manual, dialog boxes are windows that contain
  565.   specialized controls such as check buttons and push buttons.  All windows
  566.   can be exited immediately by pressing the Esc key.  The same effect will
  567.   result from clicking on the small square symbol in the upper left corner of
  568.   the window.
  569.  
  570.   13.1  Operating from the Main Display
  571.  
  572.        AM has two main file list windows.  Each window is capable of
  573.   displaying all the files from a specific DOS directory from any drive in
  574.   your system.  Only one window can be active at a time and the active window
  575.   displays a different frame and file selection indicator from that of the
  576.   inactive window.
  577.  
  578.        The user may change the active window by pressing the Tab key, the
  579.   Right/Left Arrow keys, or by clicking in the desired window's area with the
  580.   mouse.  The cursor pad keys (Home, PgDn, Up Arrow, etc.) always move the
  581.   cursor bar in the active window up or down the file list.
  582.  
  583.        The file list in each window consists of a text line that represents
  584.   each file retrieved from the active directory.  This line displays the file
  585.   name, size in bytes, and the date.  The line just above the file list frame
  586.   contains the sequential number and name of the file under the cursor bar as
  587.   well as the file time and the file attribute codes.
  588.  
  589.        AM supports a character-by-character file name speed search.  The
  590.   search string is built by pressing character keys and it appears just above
  591.   the list frame during the search.  As the string is built, AM will search
  592.   the list for the first file name that matches and move the cursor bar to
  593.   that file line if found.  For example, if "Q" is pressed and then "Z" is
  594.   pressed and there is at least one file name on the list that begins with
  595.   "QZ", AM will move the cursor to that file.  Moving the cursor bar with any
  596.  
  597.  
  598.  
  599.  
  600.                                      - 11 -
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.   arrow key will halt the search and the Backspace key may be used to remove
  608.   characters from the search string.
  609.  
  610.        Most AM commands act either directly upon the file under the cursor bar
  611.   when the command is activated or upon a group of files that have been tagged
  612.   (marked) for batch operation.  More about tagging files can be found later
  613.   in this document.  The symbol that indicates that a file is tagged is a
  614.   small right triangle located to the left of the file name.
  615.  
  616.        The top bar of the display is a menu bar that may be accessed by
  617.   clicking on an item with the mouse, pressing Alt+"key" where k is one of the
  618.   menu item shortcut keys (A, F, N, I, P, H & G), or by pressing the "/" or
  619.   "\" key.  All AM functions can be activated through one of the main menu
  620.   items.
  621.  
  622.        A pop-up menu can be activated by pressing the right mouse button with
  623.   the mouse in the active window but NOT in the file list box.  If the mouse
  624.   cursor is in the file list box, the right button serves as a file tagger.
  625.   If the mouse is outside of the file list box, a menu containing the most
  626.   used AM functions pops up.
  627.  
  628.        A two-line status bar occupies the bottom two lines of the display.
  629.   Both lines are divided into sections and each section is responsive to a
  630.   mouse click.
  631.  
  632.        AM supports multiple editing windows and multiple archive file viewer
  633.   windows.  The two main windows and all multiple edit and viewer windows are
  634.   numbered in the upper right hand frame corner.  The left and right main
  635.   windows are numbered #1 and #2, respectively.  Non-mouse users may move from
  636.   window to window by pressing Alt+# where # is the number of the window to
  637.   make active.
  638.  
  639.   13.2  On-line Help
  640.  
  641.        Textual descriptions of all AM functions are available from the main AM
  642.   display and all windows by pressing the F1 key, using the main Help menu, or
  643.   by clicking on the Help identifier in the status bar.  A window will open
  644.   that either presents a list of commands and abbreviated command names or
  645.   context sensitive help.  Selecting an item from the help list will open
  646.   another window that contains a description of the selected command.
  647.  
  648.        Help for a specific item can be located by accessing the main menu,
  649.   placing the cursor bar over the desired item, and pressing the F1 key or
  650.   clicking with the mouse on the status bar help identifier.
  651.  
  652.        The help system is cross-referenced and cross-referenced items appear
  653.   in highlight in the help text window.  Use the Tab key to move through
  654.   available cross-reference items and press the Enter key (or double click the
  655.  
  656.  
  657.  
  658.                                      - 12 -
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.   mouse) on the desired item to change the help window to text on that
  666.   specific item.
  667.  
  668.        Press the F1 key while in the help system to access an alphabetized
  669.   menu of AM functions for which textual help is available.
  670.  
  671.        You may send any help topic that is loaded into the help window to your
  672.   printer by pressing Alt+P.
  673.  
  674.        Press Alt+F1 to return to the last help topic viewed.
  675.  
  676.        AM provides the capability to use the designated file browser to browse
  677.   the associated archive system documentation (DOC) file from the compression
  678.   and decompression dialog boxes via Alt+F1.  The associated DOC file(s) must
  679.   be named as specified below and must reside in the same directory that is
  680.   identified in the "CompDir:" field of the AM configuration dialog.  This is
  681.   the same directory AM expects to find all supported archive system files.
  682.  
  683.                            MANUAL.DOC  -  PKZIP
  684.                            ARJ.DOC     -  ARJ
  685.                            LHA.DOC     -  LHA
  686.  
  687.   With the exception of LHA, these files are distributed as named above.  The
  688.   LHA package usually contains LHAxxx.DOC, where xxx denotes a 3 digit version
  689.   number.  Simply renaming this file to LHA.DOC will suffice.
  690.  
  691.        UC2 is the exception to the above.  In this case, AM will call UC.EXE
  692.   with no parameters which will bring up UC2 in its command mode.  If you
  693.   configured it correctly, you will then have access to its various DOC files.
  694.  
  695.   13.3  Tagging Files
  696.  
  697.        Groups of files appearing in the active file list may be marked for
  698.   certain archiving operations by tagging (marking) them.  To tag a file, move
  699.   the cursor bar to the file and press the space bar or one of the plus (+)
  700.   keys.  A right triangle symbol appears to the left of the file name to
  701.   denote its tagged status.  The tag is a toggle operation and therefore files
  702.   are untagged the same way they are tagged.  All files in an active window
  703.   may be tagged at once by pressing Ctrl+T.  Ctrl+T is a toggle, so if one or
  704.   more files are tagged, all files will be untagged.  If no files are tagged
  705.   then all files will be untagged.  A region on the status line marked "Tags"
  706.   may be clicked on to achieve the same result.
  707.  
  708.        The mouse may also be used for tagging.  Groups of files may be tagged
  709.   by holding down the left mouse button and slowly dragging the mouse cursor
  710.   down the active file list.  Individual files may be tagged by pressing the
  711.   right mouse button when the mouse cursor is inside the file list box.
  712.  
  713.  
  714.  
  715.  
  716.                                      - 13 -
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.        The current tagged file list can be viewed at any time by pressing
  724.   Alt+T.  The copy (Alt+C), move (Alt+C), delete (Del), and change attribute
  725.   (Ctrl+F3) commands will also invoke the tag list dialog if one or more files
  726.   are tagged when the command is issued.
  727.  
  728.        You can use Ctrl+G and then Ctrl+K to mark a block of files.  Ctrl+G
  729.   marks the first file in the block and Ctrl+K marks the last file.  The first
  730.   file must be higher on the list than the last file.
  731.  
  732.        A "Keep Tags" option in the AM configuration dialog controls whether
  733.   tags are retained or cleared after each batch operation.  Obviously, if the
  734.   tagged files were removed during the operation the tags cannot be retained
  735.   even though the "Keep Tags" option is ON.
  736.  
  737.   13.4  Dialog Boxes
  738.  
  739.        Dialog boxes are used extensively throughout AM to provide the user
  740.   with a means to set specific commands and options prior to performing a
  741.   particular operation.  Dialogs usually include boxed clusters of controls
  742.   called radio buttons and check boxes.  The user may move from cluster to
  743.   cluster with the Tab/Shift-Tab command, Alt+Shortcut, or mouse.  The
  744.   shortcut character is the highlighted character in the title string of the
  745.   cluster box.
  746.  
  747.        Dialog boxes also contain push-button controls that are labeled
  748.   according the command function they represent.  A push button may be
  749.   "pushed" by clicking with the mouse, pressing Alt+Shortcut key, or by moving
  750.   to the control and pressing the Enter key.
  751.  
  752.        Many dialogs contain editable text fields and some dialogs have input
  753.   fields that are updated dynamically as the user selects specific options or
  754.   switches.  Pressing the Enter key while in an editing field is the same as
  755.   pushing the Okay button for that dialog.  The oKay button always signals to
  756.   AM to proceed with the operation and the Quit button always exits the dialog
  757.   with no further action.
  758.  
  759.        Some dialogs contain list boxes which contain a list of file names.  A
  760.   prime example is the compressed file contents viewer dialog.  If a dialog
  761.   box contains an input field for the entry of a file name or other text, the
  762.   box should be exited for continuation of the operation by pressing the Enter
  763.   key while the cursor is in the text field.  If the text field is empty when
  764.   the Enter key is pressed, the operation will be aborted.  Pressing Esc
  765.   anytime while in a dialog box will close the box and abort the operation.
  766.   Almost all dialog boxes have a push-button, which is a small box with an
  767.   "oKay" inside.  Mouse users may move the mouse to the "oKay" and press the
  768.   left mouse button to signify proceeding with the indicated operation.
  769.  
  770.  
  771.  
  772.  
  773.  
  774.                                      - 14 -
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.   13.5  The Mouse Interface
  782.  
  783.        Mouse users will find the AM mouse interface quite easy and intuitive
  784.   to use.  Like most mouse interfaces, the mouse cursor may be moved to a
  785.   control location on the main display or within a dialog box and the left
  786.   mouse button clicked to activate that command or control.  For example,
  787.   moving the mouse cursor to the pull-down menu line at the top of the main
  788.   display and pressing the left mouse button will activate the menu system.
  789.        Each window and dialog box has a small square symbol between brackets
  790.   in the upper left corner of the frame.  Clicking on this symbol will close
  791.   the window just as if the Esc key were pressed.  Clicking on the "Quit"
  792.   button in any dialog will also close the window with no action.
  793.  
  794.        The mouse can be used with scroll bars that appear down the right edge
  795.   of any window that contains a file list.  You may "drag" the scroll marker
  796.   down the bar by moving the cursor to the marker, holding down the left
  797.   button, and moving the mouse up or down.  Alternatively, you may place the
  798.   cursor at a specific location on the vertical bar and click the mouse.  This
  799.   will move the file list cursor bar to the relative location of the scroll
  800.   bar marker.  Clicking on either arrow at the top and bottom of the scroll
  801.   bar scrolls the file list up and down, respectively.
  802.  
  803.        LIST users please note that AM does not pass the mouse command line
  804.   switch ("/M") to LIST.  If you desire to have the mouse active when entering
  805.   LIST from AM, you must use the LIST clone feature to create a version of
  806.   list that will use the mouse.  Please see LIST.DOC for further information.
  807.   This accommodates those users who wish to use a file browser other than
  808.   LIST.
  809.  
  810.        AM saves and restores the mouse state when shelling out to call an
  811.   external program.  This prevents AM from altering the target program's mouse
  812.   defaults.  AM also saves the mouse state at program run time and restores it
  813.   upon program exit.
  814.  
  815.   13.6  Positioning Windows/Dialogs
  816.  
  817.        The editor and compressed file viewer windows may be moved around the
  818.   screen with the mouse or the keyboard.  Press the Ctrl+F5 key, move the
  819.   window to the desired location with the arrow keys, and then press the Enter
  820.   key to exit the move mode.  Or you may position the mouse on the top window
  821.   frame, hold down the left button, and drag the window to a new location.
  822.  
  823.        Edit windows may be re-sized.  Click on the lower right corner of the
  824.   edit window and drag the mouse until the desired window width and height are
  825.   reached.  Or press the F5 key and control the width and height with the
  826.   left/right or up/down arrow keys, respectively.
  827.  
  828.  
  829.  
  830.  
  831.  
  832.                                      - 15 -
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.   14  Keyboard Commands
  840.  
  841.  
  842.        In addition to comprehensive mouse support, AM employs the use of Ctrl,
  843.   Alt, and function key inputs.
  844.  
  845.   14.1  Function Keys
  846.  
  847.        Each of the ten keyboard function keys are assigned a command and
  848.   pressing one of these keys bypasses the menu system and immediately executes
  849.   the assigned command.  Function key command assignments are:
  850.  
  851.                  F1  -  Help
  852.                  F2  -  Change active archive system
  853.                  F3  -  Change system drive
  854.                  F4  -  Zoom active window
  855.                  F5  -  Open directory tree display
  856.                  F6  -  Rename file
  857.                  F7  -  Change file mask
  858.                  F8  -  Change file sort
  859.                  F9  -  Compress file(s)
  860.                  F10 -  Decompress file(s)
  861.  
  862.        The following function keys may be used as key "macros" while operating
  863.   in any of the compression dialogs:
  864.  
  865.                  F8  - Insert file name under active cursor bar
  866.                  F9  - Insert current date string (mm-dd-yy)
  867.                  F10 - Insert current directory name
  868.  
  869.   14.2  Alt+Key Commands
  870.  
  871.        Seven Alt+key commands are dedicated to activating one of the pull-down
  872.   menus.  The are:
  873.  
  874.                  Alt+A  -  Archive commands
  875.                  Alt+F  -  File commands
  876.                  Alt+N  -  Navigation commands
  877.                  Alt+I  -  Miscellaneous commands
  878.                  Alt+P  -  Executable program menu
  879.                  Alt+G  -  Tag operations menu
  880.                  Alt+H  -  Help menu
  881.  
  882.        The following Alt+key commands are assigned to the indicated AM
  883.   functions:
  884.  
  885.                  Alt+C  -  Copy file(s)
  886.                  Alt+D  -  Tag By Date
  887.  
  888.  
  889.  
  890.                                      - 16 -
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.                  Alt+E  -  Edit file
  898.                  Alt+J  -  Compress directory
  899.                  Alt+K  -  Calculator
  900.                  Alt+L  -  Calendar
  901.                  Alt+M  -  Move file(s)
  902.                  Alt+Q  -  Toggle video mode
  903.                  Alt+R  -  Register ArcMaster
  904.                  Alt+S  -  Search for file
  905.                  Alt+T  -  Show tagged files
  906.                  Alt+V  -  Call virus scanner
  907.                  Alt+W  -  Make both windows same
  908.                  Alt+X  -  Exit immediately to DOS
  909.                  Alt+Z  -  Check for duplicate files
  910.                  Alt+F1 -  Load AM.DOC into the viewer
  911.                  Alt+F4 -  Call 4DOS DESCRIPT.ION Editor
  912.                  Alt+F3 -  Check disk functions
  913.                  Alt+F10-  Convert compressed file(s)
  914.                  Alt+=  -  Exit to active directory
  915.  
  916.   14.3  Ctrl+Key Commands
  917.  
  918.        The following Ctrl+key commands are assigned to the indicated AM
  919.   functions:
  920.  
  921.                  Ctrl+A  -  Auto-update function
  922.                  Ctrl+B  -  Reset file archive bits
  923.                  Ctrl+C  -  Configure ArcMaster
  924.                  Ctrl+D  -  Update To Latest
  925.                  Ctrl+E  -  Edit new file
  926.                  Ctrl+F  -  Call FormatMaster (FM.EXE)
  927.                  Ctrl+G  -  Start tag block
  928.                  Ctrl+I  -  Edit with internal editor
  929.                  Ctrl+K  -  Tag from tag block start
  930.                  Ctrl+L  -  Pack EXE file function
  931.                  Ctrl+N  -  Browse with internal browser
  932.                  Ctrl+P  -  Print file/directory listing
  933.                  Ctrl+Q  -  Quick directory tree
  934.                  Ctrl+S  -  Single Archive function
  935.                  Ctrl+T  -  Tag/Untag all files
  936.                  Ctrl+V  -  VirusSCAN DOS files
  937.                  Ctrl+W  -  Swap main file windows
  938.                  Ctrl+X  -  Program Exec Menu
  939.                  Ctrl+Z  -  Call PKZIPFIX
  940.                  Ctrl+F1 -  Help for command keys
  941.                  Ctrl+F2 -  Print text file
  942.                  Ctrl+F3 -  Change file attribute
  943.                  Ctrl+F4 -  Call 4DOS DESCRIBE
  944.                  Ctrl+F5 -  Move window/dialog
  945.  
  946.  
  947.  
  948.                                      - 17 -
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.                  Ctrl+F6 -  Set tagged files date/time stamp
  956.                  Ctrl+F7 -  Set mask like extension
  957.                  Ctrl+F8 -  Tag all like extension
  958.                  Ctrl+F9 -  Multi-update function
  959.                  Ctrl+Enter  -  Execute EXE file
  960.                  Ctrl+PgUp - Go to parent directory
  961.  
  962.   14.4  Other Commands
  963.  
  964.        The PgUp, PgDn, Up/Down Arrow, Home, and End keys are all operative for
  965.   moving through any of the file list displays.  Other miscellaneous commands
  966.   are:
  967.  
  968.             Asterisk    -  Reset the file mask to *.* and refresh
  969.             Slash       -  Access menu system
  970.             Ins Key     -  Set Archive "Hot Name"
  971.             Del Key     -  Delete single or tagged files
  972.             Space Bar   -  Tag/Untag file
  973.  
  974.        The archive "Hot Name" command will set the hot name to the file name
  975.   under the cursor bar.  Any time thereafter that you elect to compress files,
  976.   AM will insert that name automatically into the archive name field in the
  977.   appropriate dialog box.  The Ins Key is a toggle so if the hot name is not
  978.   set when pressed, it will be set and if it is set, it will be cleared.  Note
  979.   that the hot name status is always indicated in the bottom display line.
  980.  
  981.  
  982.   15  Configuring ArcMaster
  983.  
  984.  
  985.        AM provides the capability to configure various options and to save
  986.   those options to a disk file if desired.  Selection of the Configure AM item
  987.   on the mIsc pull-down menu (Alt+I) or pressing Ctrl+C opens a dialog box in
  988.   which the configuration may be set.  Keep in mind that the current sort
  989.   order, active archive system, active convert option, and all archive system
  990.   command options will also be saved in their current states.
  991.  
  992.        If you exit the configuration dialog via the "oKay" button, the changes
  993.   you made will be in effect immediately but will not be saved to disk.  You
  994.   must use the "Save" button (Alt+S) to save the configuration to the file
  995.   named AM.CFG.
  996.  
  997.        You may use the "Reset" button to negate any changes you have made and
  998.   restore all settings to the state they were in upon entry to the dialog.
  999.  
  1000.        The "Load" button can be used to load a configuration that you have
  1001.   stored in a directory other than the AM host directory.
  1002.  
  1003.  
  1004.  
  1005.  
  1006.                                      - 18 -
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.        Help can be attained for any specific configuration item/field by
  1014.   pressing the F1 key.  The help text that appears will be specific to the
  1015.   focused item/field when the F1 key is pressed.
  1016.  
  1017.   15.1  Options
  1018.  
  1019.        There is a check box cluster which can be used to toggle various AM
  1020.   options as listed below:
  1021.  
  1022.        Options
  1023.        [X] Show hidden files         - Display hidden/sys/r-only files
  1024.        [ ] Force 43/50 line mode     - Force 43/50 line EGA/VGA mode
  1025.        [X] Beeps on                  - Turn sound on/off
  1026.        [ ] Use password              - Use password for compression ops
  1027.        [X] Prompt for overwrite      - Confirm before overwrite during copy
  1028.        [X] Pause after ops           - After comp/decomp/etc.
  1029.        [X] Sort directory tree       - Sort the directory tree
  1030.        [X] Sort archive by extn      - Sort by extension in archive viewer
  1031.        [X] Pause after prog exec     - Pause after executing program
  1032.        [ ] Erase after conversion    - Erase target files after conversion
  1033.        [ ] Menu acts on 1st click    - First mouse click activates menu item
  1034.        [ ] Keep Tags                 - Permit tagging from multiple dirs
  1035.        [ ] Use 24 hour time          - Display time in 24 hour "hh:mm" format
  1036.        [X] Use shadowed windows      - All windows/boxes are shadowed
  1037.  
  1038.        Most of these options are self-explanatory.  The "Mouse 1st Click"
  1039.   option affects how the left mouse button works in the AM menu system.  If
  1040.   turned OFF (unchecked is the default), then AM will move the cursor bar to
  1041.   an item on the first click and then will select the item on the second
  1042.   click.  This provides a bit of protection against selecting the wrong item.
  1043.   If "Mouse 1st Click" is ON then AM will immediately select the menu item
  1044.   under the mouse cursor when the left button is clicked.
  1045.  
  1046.        "When Sort Arc by Ext" is checked, AM will sort the contents of a
  1047.   compressed file by file name and extension so that files with common
  1048.   extensions are grouped together.
  1049.  
  1050.        If the "Pause After Exec" option is selected then AM will pause
  1051.   immediately after the target program is exited so you can see any program
  1052.   results on the screen.
  1053.  
  1054.   15.2  Anti-virus Scanner
  1055.  
  1056.        Either the McAfee VIRUScan or Norton Anti-virus program may be
  1057.   selected.  Be sure that the correct file name and path for the selected
  1058.   scanner is placed into the "Vscan:" field.
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.                                      - 19 -
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.   15.3  Start-up Directories
  1072.  
  1073.        A directory path name may be entered for each of the two file windows
  1074.   for AM to use upon start-up.  Each time AM is started, these directory paths
  1075.   will be used unless overridden by a command line entry.  Do not enter a file
  1076.   mask here.  AM will save the file mask active for each window when the
  1077.   configuration is saved and will used the saved file masks automatically at
  1078.   start-up.  You may also enter the name of a compressed file on the command
  1079.   line to direct AM to go immediately into the compressed file viewer using
  1080.   the file name as the target.
  1081.  
  1082.   15.4  The ArcMaster Work Directory
  1083.  
  1084.        This is an extremely important configuration item.  AM requires
  1085.   exclusive use of a hard drive directory for use during archive file
  1086.   conversions and other file operations.  AM will also use this directory as a
  1087.   temporary directory for archiving programs use.
  1088.  
  1089.        PKZIP fans should note that there are two instances where PKZIP may
  1090.   need to create a temporary file on a hard drive while manipulating a ZIP
  1091.   file on a floppy drive.  The first is when PKZIP is building a large file on
  1092.   a floppy disk and the second case is when PKZIP is modifying an existing ZIP
  1093.   file on a floppy disk.  The first case must be handled by placing the
  1094.   following line in your AUTOEXEC.BAT file:  SET PKTMP=X:\TEMPPATH, where
  1095.   X:\TEMPPATH is the full path name of the temporary directory you wish PKZIP
  1096.   to use.  PKZIP does NOT use the "-b" switch in this case.  The second case
  1097.   is handled by designating X:\TEMPPATH as the AM temporary directory as
  1098.   described above.  It is recommended, but not required that the same
  1099.   directory be used for both cases.
  1100.  
  1101.   15.5  The Log Directory
  1102.  
  1103.        AM provides a graphical directory tree for navigation and directory
  1104.   manipulation.  If no Log directory is specified, AM will always scan the
  1105.   current drive whenever the tree needs to be displayed.  This can be a
  1106.   lengthy process, especially on slow hard drives with lots of directories.
  1107.   AM uses a directory log file strategy to avoid this problem.  What this
  1108.   means is that if a valid Log directory is specified, the first time the tree
  1109.   is scanned on a given drive AM will store the tree information in a file and
  1110.   place it in the specified log directory.  Then all following calls to access
  1111.   the tree result in AM reading that file instead of re-scanning the drive,
  1112.   which is very fast.  The file names that AM will place in the Log directory
  1113.   are NEW-WARE.X, where X is the drive designator.
  1114.  
  1115.        One important item must be kept in mind when using this strategy.  AM
  1116.   will have no knowledge of any directories that are created, renamed, or
  1117.   removed outside of AM.  You can accomplish each of these operations while in
  1118.   the tree.  If you add a new directory and then bring up AM and call up the
  1119.  
  1120.  
  1121.  
  1122.                                      - 20 -
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.   tree, the new directory will not appear on the tree.  In this case you will
  1130.   need to manually re-scan the disk by invoking the AM directory dialog with
  1131.   F3 or F5 and pressing the "Scan Drv" button.
  1132.  
  1133.        Just remember that if you have not entered a valid DOS drive:\directory
  1134.   path in the log directory field of the configuration dialog, AM will scan
  1135.   the disk to collect the directory names each time the tree is opened.
  1136.  
  1137.        This version of AM includes an alternative to the main AM directory
  1138.   tree.  Use Ctrl+Q to activate the Quick Tree function.  This function
  1139.   displays an abbreviated directory tree that does not use the log file
  1140.   strategy described above.
  1141.  
  1142.        AM provides special support for CD-ROM drives.  When a CD-ROM drive is
  1143.   accessed the first time, AM will scan the drive to build the directory tree.
  1144.   This data will then be stored in a file with a name built from the first 8
  1145.   characters of the CD-ROM disk volume label and an extension of "CDR".  If no
  1146.   volume label exists, AM will name the file "CD-ROM" plus the drive letter.
  1147.   For example, if you access a CD-ROM drive with a disk whose volume label is
  1148.   "ATLAS", the log file name will be "ATLAS.CDR" and if you access a CD-ROM
  1149.   drive that is drive "M" in your system that has a disk that does not have a
  1150.   volume label, the log file name will be "CD-ROM.M".
  1151.  
  1152.   15.6  The Compression Program Directory
  1153.  
  1154.        This directory (CompDir:) is where AM will expect to find ALL of the
  1155.   supported archive system programs:
  1156.  
  1157.                            ARJ.EXE
  1158.                            ARCE.COM
  1159.                            LHA.EXE
  1160.                            UC.EXE
  1161.                            PKZIP.EXE
  1162.                            PKZIPFIX.EXE
  1163.                            PKUNZIP.EXE
  1164.                            ZIP2EXE.EXE
  1165.  
  1166.        If no valid directory is entered here, AM will expect the programs
  1167.   above to reside in a directory identified in the DOS path.  In addition, AM
  1168.   expects to find the archive system program documentation files in this
  1169.   directory.  The configuration field name is "CompDir:"  AM will also look
  1170.   for the respective archive system .DOC files in this directory.
  1171.  
  1172.   15.7  Password Operations
  1173.  
  1174.        ARJ and ZIP each have a provision for password protecting compressed
  1175.   files.  To enable password use, first invoke the AM configuration dialog
  1176.   (Ctrl+C) and then check the box that is labeled "Use Password".  If this box
  1177.  
  1178.  
  1179.  
  1180.                                      - 21 -
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.   is checked, a password entry field will appear in the compression dialog
  1188.   when compressing files.  If this field is left blank, AM will not pass the
  1189.   password switch to the active archive system program.  If it is not blank,
  1190.   whatever appears in this field will be passed as the password.
  1191.  
  1192.        You may save your password to the AM.CFG file by invoking any archive
  1193.   system compression dialog, entering a password in the password field and
  1194.   then saving the configuration.  If you have AM configured to use a password
  1195.   and have a password saved in the .CFG file, you can still compress a batch
  1196.   of files not using the password by simply clearing the password field and
  1197.   leaving it that way throughout the session.
  1198.  
  1199.   15.8  Editor, Browser, and Scan Names
  1200.  
  1201.        Each of these fields identify to AM the executable file names to call
  1202.   when editing, browsing, or scanning.  Be sure to enter the file name as a
  1203.   minimum.  The full path is optional, but if no path is included with the
  1204.   file name, AM will expect DOS to find the program on the DOS path.  Here is
  1205.   are some examples of how the browser might be identified:
  1206.  
  1207.        C:\UTIL\LIST.COM
  1208.        LIST
  1209.        LIST.COM
  1210.        E:\MYUTIL\VIEWER\LIST.COM
  1211.  
  1212.        AM also supports the Norton Anti-Virus (NAV) program.  To use NAV,
  1213.   insure that the selected scanner program and the "Vscan:" field match.
  1214.  
  1215.   15.9  Setting Editor Memory
  1216.  
  1217.        The "Edit Mem:" field controls the amount of memory AM will allocate to
  1218.   the internal text editing system at start-up.  This value must fall between
  1219.   1024 and 163,840 bytes.  The maximum size text file that may be edited is
  1220.   64,535 bytes.
  1221.  
  1222.        AM will allocate the amount of memory designated in the "Edit Mem:"
  1223.   field at program start-up.  This pool of memory is used by each editor that
  1224.   is activated and by the clipboard, which is used for cut and paste
  1225.   operations.  Suppose you have configured AM for 16,384 bytes.  Then you load
  1226.   an 8,433 byte file into one editor and a 5,361 byte file into another
  1227.   editor.  That leaves 3073 bytes for cutting and pasting blocks from one
  1228.   editor to another.  If insufficient memory exists to support loading a text
  1229.   file into an editor, AM will inform you and abort the operation.
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.                                      - 22 -
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.   16  Viewing Archive File Contents
  1246.  
  1247.  
  1248.        The contents of any of the supported archive file types, including
  1249.   self-extracting EXE files (SXF), may be viewed by moving the active window
  1250.   cursor bar to the file and pressing the Enter Key.  A window will open that
  1251.   displays a sorted list of the files contained in the target file.  This
  1252.   window operates very much like the active window in that you move through
  1253.   the file list with keypad cursor keys or with the mouse and scroll bar
  1254.   except that it is a dialog and has push button controls.
  1255.  
  1256.        The number that appears in the upper right hand area of the dialog
  1257.   frame represents a rough estimate of the size of a resultant compressed file
  1258.   and is based upon the number of bytes tagged at that time.
  1259.  
  1260.        Files may be tagged for decompression operations in the same manner
  1261.   that files are tagged on the main file list.  Pressing the "UnXXX" button,
  1262.   where XXX is ZIP, ARJ, etc., proceeds with decompression.
  1263.  
  1264.        A special symbol is used to mark the end of a line that represents a
  1265.   file that PKZIP has marked as a text file.
  1266.  
  1267.        File lines that represent compressed files with the file attribute set
  1268.   to other than normal will be in a different color.
  1269.  
  1270.   16.1  Multiple Compressed File Viewers
  1271.  
  1272.        Two compressed file viewing dialog windows may be active at one time
  1273.   and it is possible to copy files from one compressed file to another.  The
  1274.   following sequence demonstrates how to accomplish this:
  1275.  
  1276.        1. In either main file window, move the cursor bar to a compressed
  1277.           file and press Enter to activate a viewer.
  1278.        2. Click on either main window with the mouse or press Alt+1 or Alt+2
  1279.           to go back to a main file window.
  1280.        3. Move the cursor bar to a different compressed file and press the
  1281.           Enter key to activate a second viewer.
  1282.        4. Tag files in one of the viewers and press the Copy button.  The
  1283.           tagged files will be copied to the inactive viewer.
  1284.  
  1285.   You can move from viewer to viewer with the mouse or the Alt+Number key
  1286.   where Number is the viewer number.
  1287.  
  1288.   16.2  Browsing a Compressed File
  1289.  
  1290.        Compressed files may be viewed with the designated file browser by
  1291.   moving the cursor bar to the desired file and pressing Enter.  If no browser
  1292.   is specified, the internal AM browser will be used. The file will be
  1293.  
  1294.  
  1295.  
  1296.                                      - 23 -
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.   decompressed by AM to the work directory and browsed.  When browsing is
  1304.   complete, AM deletes the file.  A compressed file inside another compressed
  1305.   file will may also be viewed.
  1306.  
  1307.   16.3  Editing A Compressed File
  1308.  
  1309.        A compressed text file may be edited with the user-defined external
  1310.   editor or with the internal AM editor.  In both cases the file is extracted
  1311.   to the AM work directory and edited.  After the edited file is saved, it
  1312.   replaces the original inside the compressed file before being deleted.  The
  1313.   dialog Edit button calls the external editor.  To use the AM editor, press
  1314.   Ctrl+I with the cursor bar over the target file.
  1315.  
  1316.   16.4  Creating/Editing a ZIP File Comment
  1317.  
  1318.        The PKWare ZIP system allows the addition of a comment to each ZIP
  1319.   file.  AM provides a means to create and/or edit this comment with the Cmnt
  1320.   button.  Press this button to bring up the comment editor.  If a comment
  1321.   exists, it will be loaded into the editor.  If not, you may create a new
  1322.   comment and save it from the editor.
  1323.  
  1324.  
  1325.   17  ARJ Considerations
  1326.  
  1327.  
  1328.        ARJ was the first file compression system to offer a backup mode that
  1329.   permits spanning of a diskette by a compressed file and New-Ware feels that
  1330.   the ARJ backup system is superior to that of the PKWare System.  You can use
  1331.   AM to view the contents of an ARJ backup volume and you can even extract
  1332.   individual files quickly and easily.  Just be aware that the first and last
  1333.   files in an ARJ backup volume may be split across two diskettes and that you
  1334.   should NOT attempt to view or edit these files.  You can use the AM file
  1335.   list sort toggle to list the contents as they are stored in the ARJ file to
  1336.   determine which are the first and last files in the volume.
  1337.  
  1338.        One other note regarding the ARJ backup system.  You can create backup
  1339.   volumes on a hard disk and then check the overall integrity of each volume
  1340.   before transferring them to diskettes.  You can do this by using the ARJ
  1341.   volume size parameter ("Vol Size:" in AM) and the multi-volume ("-v")
  1342.   switch.  Consult ARJ.DOC for details.
  1343.  
  1344.        Note that neither ARJ nor UC2 place inane restrictions on the size of
  1345.   the list file they process.
  1346.  
  1347.   17.1  PKZIP List File Problems
  1348.  
  1349.        New-Ware uses the PKZIP list file capability to pass file name lists
  1350.   for compression.  This avoids the severe DOS command line length restriction
  1351.  
  1352.  
  1353.  
  1354.                                      - 24 -
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.   but involves some PKZIP restrictions.  The list file that AM passes to PKZIP
  1362.   contains the full DOS path name of each tagged file.  Obviously, the longer
  1363.   the path name, the longer each list file line will be and the larger the
  1364.   list file will be.
  1365.  
  1366.        Experimentation has shown that PKZIP will refuse to accept any list
  1367.   file of this type that is larger than 3700 bytes.  If the list file is
  1368.   greater than 3700 bytes, PKZIP prints a "Insufficient memory" message and
  1369.   quits.  This will happen regardless of the actual amount of EMS/XMS memory
  1370.   actually available!  PKZIP just blindly quits!
  1371.  
  1372.        To circumvent this inane restriction, AM monitors the size of the list
  1373.   file as it is being built and when the 3700 byte limit is reached, AM calls
  1374.   PKZIP to process the file.  Then AM continues with a new list file until the
  1375.   tagged file queue is exhausted or limit is reached again.  This works
  1376.   wonderfully well in all but one important situation.  It will NOT work with
  1377.   the PKZIP backup mode!  This is because PKZIP will just start fresh when
  1378.   called on successive occasions.  It is strongly recommended that you use the
  1379.   AM compress directory function (Alt+J) in conjunction with the backup mode
  1380.   instead of tagging a large number of files for backup.
  1381.  
  1382.   17.2  PKZIP Backup Files
  1383.  
  1384.        Another PKZIP situation to be aware of is that ZIP files that have been
  1385.   created on multiple diskettes by using the PKZIP backup mode cannot all be
  1386.   read by the AM compressed file viewer.  PKZIP stores the beginning of its
  1387.   central directory for the entire backup set on the one of the last
  1388.   diskettes.  Other disks contain ZIP files that have no central directory and
  1389.   AM will not read these ZIP files.  In fact, PKZIP will not give you a
  1390.   listing of such a file and instead will print an error message telling you
  1391.   to use PKZIPFIX on the file!
  1392.  
  1393.        When AM reads the ZIP file from a diskette that contains the central
  1394.   directory record for the backup set, the disk number of the diskette that
  1395.   contains the ZIP file that actually includes the compressed file data is
  1396.   listed to the right of the file data line in the viewer.  If the files are
  1397.   not grouped by disk number, use the toggle sort (F3) function to list the
  1398.   files in unsorted order.
  1399.  
  1400.        And one last note.  If you should happen to lose or damage the one of
  1401.   the diskettes that contains the central directory in a ZIP backup set, you
  1402.   can use PKZIP fix to restore the central directory of any ZIP file residing
  1403.   on any single diskette in the set, but the integrity of the entire set is
  1404.   lost.
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.                                      - 25 -
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.   18  The AM Internal File Browser
  1420.  
  1421.  
  1422.        The AM internal file browser will be used whenever the "Browser:" field
  1423.   in the configuration dialog is left empty.  This browser is not limited by
  1424.   file size but it is limited to 32,767 lines of text.  A text file with an
  1425.   average line length of 45 characters and 32,767 lines would be 1.4MB bytes.
  1426.   It is strongly recommended that you give the internal browser a try and to
  1427.   use it if it suits you because it is so much faster to call the internal
  1428.   browser than to shell out to LIST.COM or some other external browser.
  1429.  
  1430.        The browser has a number of useful functions, including fast text
  1431.   search, text block marking, block write to a file, block print, line number
  1432.   display, jump to a line number, and more.  Consult the on-line help when in
  1433.   the browser for details on available commands.
  1434.  
  1435.  
  1436.   19  The AM Internal Editor
  1437.  
  1438.  
  1439.        AM has a simple yet powerful internal editing system that not only
  1440.   supports text file editing but supports cut and paste operations between two
  1441.   text files as well.  The AM internal editor is called when Ctrl+I is pressed
  1442.   or when Alt+E is pressed and there is no external editor defined.
  1443.  
  1444.        The amount of memory available for the internal editing buffers is
  1445.   dependent upon the "Edit Mem:" field in the AM configuration dialog.
  1446.  
  1447.        Editor commands are based upon the well-known WordStar command set.
  1448.   Consult the on-line help system for editing command key assignments.  Note
  1449.   that the bottom status line contains main editing commands whenever an
  1450.   editor is active.
  1451.  
  1452.        Here is an example of how to use multiple editor windows:
  1453.  
  1454.        1. Move the active file list cursor bar to a text file and press
  1455.           Ctrl+I.  An edit window loaded with the file contents will appear.
  1456.        2. Activate one of the two main file list windows by pressing Ctrl+1
  1457.           or Ctrl+2 or by clicking with the mouse.
  1458.        3. Move the cursor bar to a different text file and press Ctrl+I.
  1459.        4. Two edit windows are not active.  You can select either window by
  1460.           clicking with the mouse or using the Alt key plus the window
  1461.           number.
  1462.        5. Cut & paste and clipboard commands are visible on the bottom status
  1463.           line and explained in the on-line help file.
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.                                      - 26 -
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.   20  AM Use of the Overlay File
  1478.  
  1479.  
  1480.        The AM overlay file, AM.OVR, is used to store program functions that
  1481.   are not normally needed until invoked by the user.  This permits AM to
  1482.   contain many, many more functions that would ordinarily be tolerated in the
  1483.   available DOS memory.
  1484.  
  1485.        In the absence of extended (XMS) or expanded (EMS) memory, AM will read
  1486.   the code it needs from the disk file (AM.OVR) as required.  This operation
  1487.   is more noticeable on systems with slower disk drives.  If there is
  1488.   sufficient (approximately 200K) XMS or EMS memory available, AM will load
  1489.   the entire overlay file into memory at runtime and this results in all AM
  1490.   functions being available directly from memory, a much faster operation that
  1491.   disk access.
  1492.  
  1493.        If sufficient XMS memory exists, AM will use that first.  If not, and
  1494.   sufficient EMS memory exists, AM will use that.  Finally, AM will resort to
  1495.   the direct on-demand use of the disk file.
  1496.  
  1497.        To learn how AM is actually employing overlay memory, access the Memory
  1498.   Usage dialog from the Help menu.
  1499.  
  1500.  
  1501.   21  AM Use of Extended/Expanded Memory
  1502.  
  1503.  
  1504.        When AM "shells out" to DOS to perform some function like calling PKZIP
  1505.   to ZIP a group of files, AM will check available memory and will swap the
  1506.   entire DOS memory space out to EMS/XMS memory or a disk file.  If you have
  1507.   an EMS memory manager loaded and sufficient memory can be allocated, AM will
  1508.   swap to expanded memory.  If you have no EMS but do have an extended (XMS)
  1509.   memory driver loaded, AM will use XMS memory if sufficient memory is
  1510.   available.  If no EMS or XMS memory is available, AM will swap out to a disk
  1511.   file.  Obviously, the swap to EMS/XMS is so fast as to be transparent
  1512.   whereas the swap to disk will cause a noticeable delay.
  1513.  
  1514.  
  1515.   22  Running AM with NDOS or 4DOS
  1516.  
  1517.  
  1518.        AM has been tested while running under the Norton Utilities NDOS from
  1519.   Symantec Corp.  NDOS is quite similar to 4DOS and in fact both programs are
  1520.   the work of Tom Rawson.  When AM shells out out to view the contents of a
  1521.   compressed file, the command passed to DOS is a call for LIST, which is
  1522.   intended to call Vern Buerg's LIST.COM.  LIST, however, is an internal
  1523.   command of NDOS and 4DOS.  The internal LIST command will work fine with AM
  1524.  
  1525.  
  1526.  
  1527.  
  1528.                                      - 27 -
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.   version 6.5 and later, but if you desire to use the more powerful LIST.COM
  1536.   there are three ways to do so.
  1537.  
  1538.        The first way is to disable the internal LIST command by issuing the
  1539.   command SETDOS /I-LIST from the AUTOEXEC.BAT (or NSTART.BAT) file.  The
  1540.   second way is to issue the command ALIAS LIST C:\UTIL\LIST.COM.  This also
  1541.   disables the internal LIST command, but you can use the alias command to use
  1542.   the internal LIST function under a different name, as in the command ALIAS
  1543.   SHOW *LIST.  The third way is to rename LIST.COM and to configure AM to call
  1544.   the renamed version of LIST.
  1545.  
  1546.        AM also provides extensive support for the 4DOS/NDOS DESCRIPT.ION
  1547.   files.  Ctrl+F4 invokes the 4DOS/NDOS DESCRIBE command with the name of the
  1548.   file under the active cursor bar.  The Alt+F4 command calls the editor
  1549.   defined in the AM configuration "4Dos Ed:" field.  You may place a command
  1550.   line parameter list following the file name entry, if so desired.  If no
  1551.   program is designated in the "4Dos Ed:" field, AM will use the internal
  1552.   editor.  AM will update DESCRIPT.ION files in the source and destination
  1553.   directories during any rename, copy, move, delete, and archive convert
  1554.   operations.  This includes using the move option with any of supported file
  1555.   compressors.
  1556.  
  1557.        4DOS is Copyright by JP Software.  NDOS is a version of 4DOS licensed
  1558.   to the Symantic Corp.
  1559.  
  1560.  
  1561.   23  Search Menu (Alt+S)
  1562.  
  1563.  
  1564.        AM provides a fast search for DOS or compressed files on the drive in
  1565.   the active window.  If searching for a DOS file and the target file name is
  1566.   found (wild cards are okay), AM will issue a notification prompt.  You have
  1567.   the choice of halting the search, continuing the search, or viewing the file
  1568.   list of the directory in which the file was found.  If you elect to view, AM
  1569.   will change to that directory and position the cursor bar over the target
  1570.   file name.
  1571.  
  1572.        Searching for a file inside an archive file operates in the same way
  1573.   except that AM will go through each directory on the current drive and open
  1574.   each archive file found and search it for the target file.  If found and you
  1575.   elect to view, AM will open the archive directory view window and position
  1576.   the cursor bar over the target file name.  You may elect to extract, erase,
  1577.   etc. tagged files in this case but please note that when the operation is
  1578.   complete that the active directory will have changed to the directory in
  1579.   which the target archive file was found.
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.                                      - 28 -
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.   24  Program Menu (Ctrl+X)
  1594.  
  1595.  
  1596.        This command invokes the special AM user created program menu.  Please
  1597.   read the information in the file named PROGMENU.DOC.
  1598.  
  1599.  
  1600.   25  Registering AM (Alt+R)
  1601.  
  1602.  
  1603.        The command will open a window that will prompt you for the vital
  1604.   information needed to print the registration form.  You can close the window
  1605.   with no action at any time by pressing the Esc Key.  When all the
  1606.   information has been entered, you will have the opportunity to print the
  1607.   form on your printer.
  1608.  
  1609.        Note that the registration feature is included in the registered
  1610.   version of AM so that registered users may order more than one copy of AM
  1611.   for legitimate use.
  1612.  
  1613.  
  1614.   Copyright 1987,1994, all rights reserved.
  1615.   New-Ware
  1616.   8020 Camino Kiosco
  1617.   San Diego, CA 92122
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.                                      - 29 -
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.                                  Contents
  1658.  
  1659.  
  1660.           1  Disclaimer  . . . . . . . . . . . . . . . . . . . . . . .  2
  1661.           2  What is ArcMaster?  . . . . . . . . . . . . . . . . . . .  2
  1662.           3  Archive Systems Needed to Operate AM  . . . . . . . . . .  2
  1663.           4  About Shareware . . . . . . . . . . . . . . . . . . . . .  4
  1664.           5  How To Register . . . . . . . . . . . . . . . . . . . . .  5
  1665.           6  The New-Ware BBS  . . . . . . . . . . . . . . . . . . . .  6
  1666.           7  System Requirements . . . . . . . . . . . . . . . . . . .  7
  1667.           8  Prohibition . . . . . . . . . . . . . . . . . . . . . . .  7
  1668.           9  Version History . . . . . . . . . . . . . . . . . . . . .  7
  1669.           10  Distribution Files . . . . . . . . . . . . . . . . . . .  9
  1670.           11  ArcMaster Program Files  . . . . . . . . . . . . . . . .  9
  1671.           12  Starting ArcMaster . . . . . . . . . . . . . . . . . . . 10
  1672.           13  The User Interface . . . . . . . . . . . . . . . . . . . 11
  1673.              13.1  Operating from the Main Display . . . . . . . . . . 11
  1674.              13.2  On-line Help  . . . . . . . . . . . . . . . . . . . 12
  1675.              13.3  Tagging Files . . . . . . . . . . . . . . . . . . . 13
  1676.              13.4  Dialog Boxes  . . . . . . . . . . . . . . . . . . . 14
  1677.              13.5  The Mouse Interface . . . . . . . . . . . . . . . . 15
  1678.              13.6  Positioning Windows/Dialogs . . . . . . . . . . . . 15
  1679.           14  Keyboard Commands  . . . . . . . . . . . . . . . . . . . 16
  1680.              14.1  Function Keys . . . . . . . . . . . . . . . . . . . 16
  1681.              14.2  Alt+Key Commands  . . . . . . . . . . . . . . . . . 16
  1682.              14.3  Ctrl+Key Commands . . . . . . . . . . . . . . . . . 17
  1683.              14.4  Other Commands  . . . . . . . . . . . . . . . . . . 18
  1684.           15  Configuring ArcMaster  . . . . . . . . . . . . . . . . . 18
  1685.              15.1  Options . . . . . . . . . . . . . . . . . . . . . . 19
  1686.              15.2  Anti-virus Scanner  . . . . . . . . . . . . . . . . 19
  1687.              15.3  Start-up Directories  . . . . . . . . . . . . . . . 20
  1688.              15.4  The ArcMaster Work Directory  . . . . . . . . . . . 20
  1689.              15.5  The Log Directory . . . . . . . . . . . . . . . . . 20
  1690.              15.6  The Compression Program Directory . . . . . . . . . 21
  1691.              15.7  Password Operations . . . . . . . . . . . . . . . . 21
  1692.              15.8  Editor, Browser, and Scan Names . . . . . . . . . . 22
  1693.              15.9  Setting Editor Memory . . . . . . . . . . . . . . . 22
  1694.           16  Viewing Archive File Contents  . . . . . . . . . . . . . 23
  1695.              16.1  Multiple Compressed File Viewers  . . . . . . . . . 23
  1696.              16.2  Browsing a Compressed File  . . . . . . . . . . . . 23
  1697.              16.3  Editing A Compressed File . . . . . . . . . . . . . 24
  1698.              16.4  Creating/Editing a ZIP File Comment . . . . . . . . 24
  1699.  
  1700.  
  1701.  
  1702.                                        i
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.           17  ARJ Considerations . . . . . . . . . . . . . . . . . . . 24
  1710.              17.1  PKZIP List File Problems  . . . . . . . . . . . . . 24
  1711.              17.2  PKZIP Backup Files  . . . . . . . . . . . . . . . . 25
  1712.           18  The AM Internal File Browser . . . . . . . . . . . . . . 26
  1713.           19  The AM Internal Editor . . . . . . . . . . . . . . . . . 26
  1714.           20  AM Use of the Overlay File . . . . . . . . . . . . . . . 27
  1715.           21  AM Use of Extended/Expanded Memory . . . . . . . . . . . 27
  1716.           22  Running AM with NDOS or 4DOS . . . . . . . . . . . . . . 27
  1717.           23  Search Menu (Alt+S)  . . . . . . . . . . . . . . . . . . 28
  1718.           24  Program Menu (Ctrl+X)  . . . . . . . . . . . . . . . . . 29
  1719.           25  Registering AM (Alt+R) . . . . . . . . . . . . . . . . . 29
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.                                        ii
  1761.