home *** CD-ROM | disk | FTP | other *** search
/ Compu-Fix / Compu-Fix.iso / misc / lamb / lambchop.doc < prev    next >
Text File  |  1993-03-01  |  61KB  |  1,439 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                      LambChop (tm) v1.02
  7.          Copyright 1992, LambWare  All Rights Reserved
  8.                         January 1992
  9.                            
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 
  16.                ▒░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░▒██
  17.                ▒░▓▓▓▓▓▓▓▓░░░░░░░░░░░░░░░░░░░░░▒██
  18.                ▒░▓▓▓▓▓▓▓▓░░░░░░░░░░░░░░░░░░░░░▒██
  19.                ▒░▓▓▓▓▓▓▓▓░░░░▒▒▒▒▒░░░░░░▒▒▒▒▒░▒██
  20.                ▒░▓▓▓▓▓▓▓▓░░░░▒▒▒▒▒░░░░░░▒▒▒▒▒░▒██
  21.                ▒░▓▓▓▓▓▓▓▓░░░░▒▒▒▒▒░░░░░░▒▒▒▒▒░▒██
  22.                ▒░▓▓▓▓▓▓▓▓░░░░▒▒▒▒▒░░░░░░▒▒▒▒▒░▒██
  23.                ▒░▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▒░░▒▒░░▒▒▒▒▒░▒██
  24.                ▒░░░░░░░░░░░░░▒▒▒▒▒░▒▒▒▒░▒▒▒▒▒░▒██
  25.                ▒░▒▒▒▒▒▒▒▒▒▒░░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░▒██
  26.                ▒░▒LambWare▒░░░░░░░░░░░░░░░░░░░▒██
  27.                ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██
  28.                  ████████████████████████████████
  29.                                                 (tm)
  30.  
  31.  
  32.  
  33.                        ┌─────────┐
  34.                  ┌─────┴───┐     │               (R)
  35.                ──│         │o    │──────────────────
  36.                  │   ┌─────┴╨──┐ │  Association of
  37.                  │   │         │─┘  Shareware
  38.                  └───│    o    │    Professionals
  39.                ──────│    ║    │────────────────────
  40.                      └────╨────┘    MEMBER
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                             LambWare
  49.                      6955 29th Terrace North
  50.                  St. Petersburg, Florida  33710
  51.  
  52.      Order Info: (813) 525-3162   Secondary: (813) 345-8100
  53.         Compuserve LambWare E-MAIL account #: 70511,3040
  54.  
  55.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved
  56.  
  57.                                 Acknowledgements
  58.  
  59.  
  60.   In memory of:
  61.   Air Force Airman Craig Bentley Uhl, 1971 - 1991.
  62.   Nancie H. Lane, 1935 - 1989.
  63.  
  64.  
  65.   I dedicate this project  to my beautiful wife Melissa and  my two children,
  66.   Christopher Bradley and Ashley Elizabeth.  I love you.
  67.  
  68.  
  69.   A special thank you to:
  70.   My parents and my sister: Roger Sr, Kathie, and Sherrie
  71.   The Endsleys
  72.   Steven Kamradt
  73.   Walter Lane, M.D.
  74.   Michael Meehan
  75.   Papa Duke and Grandma
  76.   William Rollins
  77.  
  78.  
  79.   Beta Testers:
  80.   Scott Dabney, Rob A. Davison, Steven Kamradt, Ray Howell, Stuart Long, Mike
  81.   Rebane, Stephan Roth
  82.  
  83.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved
  84.  
  85.                               Table Of Contents
  86.  
  87.   1. General Information  . . . . . . . . . . . . . . . . . . . . . . . .   1
  88.        What is LambChop?  . . . . . . . . . . . . . . . . . . . . . . . .   1
  89.        Terminology  . . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  90.        LambChop Features  . . . . . . . . . . . . . . . . . . . . . . . .   4
  91.  
  92.   2. Getting Started  . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  93.        Hardware requirements  . . . . . . . . . . . . . . . . . . . . . .   6
  94.        Installation . . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  95.        Setup  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  96.  
  97.   3. LambMenu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  98.        Quick start  . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  99.             Chop mode . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  100.             UnChop mode . . . . . . . . . . . . . . . . . . . . . . . .    10
  101.  
  102.        Configuration files  . . . . . . . . . . . . . . . . . . . . . .    12
  103.  
  104.   4. LambChop . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    13
  105.        Quick start  . . . . . . . . . . . . . . . . . . . . . . . . . .    13
  106.             Chop mode . . . . . . . . . . . . . . . . . . . . . . . . .    13
  107.             UnChop mode . . . . . . . . . . . . . . . . . . . . . . . .    13
  108.  
  109.        LambChop Dos Error Messages  . . . . . . . . . . . . . . . . . .    14
  110.  
  111.        LambChop Directory Structure . . . . . . . . . . . . . . . . . .    14
  112.  
  113.        Chop commands  . . . . . . . . . . . . . . . . . . . . . . . . .    15
  114.             Rules . . . . . . . . . . . . . . . . . . . . . . . . . . .    15
  115.             DOS attributes: /A[h][s]  . . . . . . . . . . . . . . . . .    16
  116.             Adjust segment to exact # of bytes: /B<#> . . . . . . . . .    16
  117.             Compression: /C[a]  . . . . . . . . . . . . . . . . . . . .    17
  118.             Error checking: /E  . . . . . . . . . . . . . . . . . . . .    17
  119.             Fit segment to disk: /F<#>  . . . . . . . . . . . . . . . .    18
  120.             Hack into equal # segments: /H<#> . . . . . . . . . . . . .    18
  121.             Adjust segment to kilobytes: /K<#>  . . . . . . . . . . . .    18
  122.             Move original file into volume: /M  . . . . . . . . . . . .    19
  123.         Chop only New and modified files since last LambChop: /N  .    19
  124.             Overwrite without warning: /O . . . . . . . . . . . . . . .    19
  125.             Store path name with file: /P . . . . . . . . . . . . . . .    20
  126.             Include all subdiRectories: /R  . . . . . . . . . . . . . .    20
  127.             Store path name and include all subdiRectories: /S  . . . .    21
  128.             Disable tone: /T  . . . . . . . . . . . . . . . . . . . . .    21
  129.             Wait (pause) delay: /W  . . . . . . . . . . . . . . . . . .    21
  130.             Exclude file mask: /X<mask> . . . . . . . . . . . . . . . .    21
  131.             Execute DOS command: /Y<"command">  . . . . . . . . . . . .    21
  132.             Alternate work drive: /Z<drive-letter>  . . . . . . . . . .    21
  133.  
  134.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved
  135.  
  136.        UnChop commands /U . . . . . . . . . . . . . . . . . . . . . . .    22
  137.             Rules . . . . . . . . . . . . . . . . . . . . . . . . . . .    22
  138.             Use and create directory if stored: /D  . . . . . . . . . .    22
  139.             Goto file, ignoring previous files: /G<file-name> . . . . .    23
  140.             Locate files in path name: /L<path-name>  . . . . . . . . .    23
  141.             Overwrite: /O[n]  . . . . . . . . . . . . . . . . . . . . .    24
  142.             Disable tone: /T  . . . . . . . . . . . . . . . . . . . . .    24
  143.             View volume: /V[#][d] . . . . . . . . . . . . . . . . . . .    24
  144.             Wait (pause) delay: /W  . . . . . . . . . . . . . . . . . .    26
  145.             Exclude file mask: /X<mask> . . . . . . . . . . . . . . . .    26
  146.             Alternate work drive: /Z<drive-letter>  . . . . . . . . . .    26
  147.  
  148.   5. Configuration File Format  . . . . . . . . . . . . . . . . . . . .    27
  149.  
  150.   6. ShareWare  . . . . . . . . . . . . . . . . . . . . . . . . . . . .    29
  151.        LambWare registration  . . . . . . . . . . . . . . . . . . . . .    29
  152.        Technical support  . . . . . . . . . . . . . . . . . . . . . . .    29
  153.        ASP Ombudsman  . . . . . . . . . . . . . . . . . . . . . . . . .    29
  154.  
  155.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved      1
  156.  
  157.                             1. General Information
  158.  
  159.   What is LambChop?
  160.   Briefly,  LambChop  is a  file  splitter  and  mender with  numerous  fancy
  161.   features.
  162.  
  163.   With  LambChop, you  may  copy files  from  your hard  drive  to a  smaller
  164.   capacity removable disk  drive.  LambChop allows  you to take a  large disk
  165.   file and  spread it  across several floppy  disks.   LambChop also  handles
  166.   multiple DOS files all at the same time.
  167.  
  168.   LambChop, unlike DOS  copy, will never display a "disk  full" message while
  169.   chopping.   LambChop is  so flexible,  you could  effectively back  up your
  170.   entire hard drive!
  171.  
  172.   LambChop  has the  restore (UnChop) utility  built right  in!  There  is no
  173.   reason  to manage  and piece  back the  disk segments  yourself.   LambChop
  174.   creates its own directory of the files you choose to chop up.  It then uses
  175.   this directory  to  obtain the  files you  want to  pull  out and  restore.
  176.   Unlike  DOS backup,  you can  pull  out a  specific file  or  files without
  177.   sequentially restoring the entire volume of files.
  178.  
  179.   The LambChop utility runs from the command line in DOS.   If you have files
  180.   that need to be moved from one system to another, running LambChop from DOS
  181.   can  prove to be time saving.   In daily backups, you frequently select the
  182.   same options from a menu system  over and over again.  LambChop  allows you
  183.   to save your repetitive options to a fully automated configuration file.
  184.  
  185.   LambMenu is a program included with LambChop.  It was designed  to simplify
  186.   the somewhat  confusing DOS  command line options  for LambChop.   LambMenu
  187.   combines LambChops command  line options in a easy  to understand pull down
  188.   window environment.   LambMenu  generates the command  line options  so you
  189.   don't have  to.  Once you have generated  the command line options, you can
  190.   save them in  a configuration file.   The configuration file may  be loaded
  191.   from LambMenu,  from the DOS command  line, or even from a  DOS batch file.
  192.   In addition, you can run LambChop directly from LambMenu.
  193.  
  194.   LambChop has  a unique  niche that no  other package  currently offers.   A
  195.   directory of the  entire volume  is stored  with each disk  segment.   This
  196.   allows you  to  insert any  disk segment  and request  any  file or  files,
  197.   without having to  remember their which disk  the file you want  starts on.
  198.   LambChop will request the appropriate disk segment and directly locate your
  199.   files!
  200.  
  201.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved      2
  202.  
  203.   Terminology
  204.   This  manual is written  for someone with  a beginning  to intermediate DOS
  205.   experience level.   LambWare is assuming you  have a basic understanding of
  206.   DOS directory structures.
  207.  
  208.   There  are several  proprietary terms  used throughout  this manual.   This
  209.   section is given to aid in the understanding of LambChop terminology.
  210.  
  211.   Segment:
  212.       A segment is an equal partition of  a volume.  The disk segment number
  213.       is assigned automatically by LambChop.  The maximum number of segments
  214.       allowed is 999.
  215.  
  216.       Segment: ABCDE 001 .LAM
  217.                ----- --- ----
  218.                  |    |    |----- All segments end with LAM extension.
  219.                  |    |-------- Segment 001-999 assigned by LambChop.
  220.                  |---------- Your 5 character file name.
  221.  
  222.   Volume:
  223.       A  volume is  the  combination of  all disk  segments.   There is  a 5
  224.       character maximum to  the file name that  you can assign to  a volume.
  225.       Do not  include a file extension,  the '.LAM' extension will  be added
  226.       automatically by LambChop. 
  227.  
  228.   Auto fit disk segment:
  229.       By default, LambChop  checks the capacity of the  destination drive to
  230.       set a constant segment size for the entire volume.
  231.  
  232.   Parameter:
  233.       A LambChop or LambMenu command option given on the DOS command line.
  234.  
  235.   LambChop Options:
  236.       To  use any of the enhanced  features of LambChop you  must be able to
  237.       set the  LambChop options.  There are two  ways, from the command line
  238.       or from LambMenu.  If you are using LambMenu, the command line options
  239.       are done automatically.  Otherwise,  any option must be activated from
  240.       the DOS command line.  As with the error checking option,  the command
  241.       option associated  with it is /E.   The /E can be in  any order on the
  242.       command line.   Parameters must be separated by a space on the command
  243.       line.   Either a  / or a  - may be  used in front  of the option  as a
  244.       delimiter.  Parameters are not case sensitive.  See chapter 4 for more
  245.       information on command line options.  
  246.  
  247.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved      3
  248.  
  249.   Config File:
  250.       A configuration file is a text file with the command options  and file
  251.       names saved  in an  ASCII  file format.   Rules  are the  same as  the
  252.       command  line except parameters are separated by a new line instead of
  253.       a space.   Configuration  files are loaded  by placing  a @  symbol in
  254.       front  of the  config file  name.  All  config files  must end  with a
  255.       '.cfg'  extension.   LAMBCHOP.CFG  is loaded  every  time LambChop  or
  256.       LambMenu  is  loaded.     See  chapter  5  for   more  information  on
  257.       configuration files.
  258.  
  259.   File Mask:
  260.       A DOS file mask is a method  of substituting wildcards for actual file
  261.       name alphanumeric characters.  A wildcard is a * or a ?.
  262.  
  263.       Mask Examples:
  264.       *.*       all files
  265.       T?M.BAT   ? is a wildcard, all matching file names
  266.       T*.BAT    files must begin with a T and have a .BAT extension
  267.  
  268.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved      4
  269.  
  270.                               LambChop Features
  271.  
  272.  
  273.   *  Faster than DOS XCOPY. Uses all available conventional memory (640k) for
  274.   maximum efficiency and speed.
  275.  
  276.   * UnChop (restore) utility is built right in to LambChop!!
  277.  
  278.   *  Chop multiple  files,  directories,  and  drives  simultaneously  across
  279.   multiple disk segments.
  280.  
  281.   *  Error  checking (CRC-32  bit) will  notify  you if  the data  stored has
  282.   changed any way.
  283.  
  284.   *  Optional data compression.   Compression reduces the  size of your input
  285.   data files by an average of 45%.  LambChop will identify  and compress text
  286.   files  for  maximum  speed  and  efficiency during  chopping.    Text  file
  287.   identification can be turned off to compress  all files.  LambChop does not
  288.   compress  other  major vendor  compressed  files  in  order to  save  time.
  289.   However, if the file is already compressed, LambChop will include the  file
  290.   in the chopping procedure.  
  291.  
  292.   * When chopping to the output drive, LambChop detects the capacity of first
  293.   destination disk and consumes all  available space.  This proves beneficial
  294.   for not only files  larger than the capacity of the  destination drive, but
  295.   for multiple small files.   For example, assume you have several files in a
  296.   compressed  format spread  across  10  floppy disks  (you  used DOS  copy).
  297.   Assume their is an average of 80% actual usage on each of the 10 disks.  By
  298.   utilizing the 20% unused space on each disk, LambChop would have stored the
  299.   same information on 8 disks, not 10.
  300.  
  301.   * Critical error handler for added program reliability.
  302.  
  303.   * Includes LambMenu program for all users to enjoy features of LambChop via
  304.   a friendly pull down windowed environment.   LambMenu works with or without
  305.   a mouse.
  306.  
  307.   *  Chop more than one file at same time.  On average, most 640k systems can
  308.   chop 4500+ input files  simultaneously.  The only limit is on how much free
  309.   conventional (640k) memory you have available at run time.
  310.  
  311.   * Directory information such as date, time, and attributes  are stored with
  312.   each file.   This  information is restored  to the  original settings  when
  313.   UnChopped.
  314.  
  315.   * Path name information is optionally stored with the file.
  316.  
  317.   * If paths are stored with the file, you may optionally restore the file to
  318.   the original  path.  If the  path does not exist, LambChop  will create one
  319.   for you.
  320.  
  321.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved      5
  322.  
  323.   * No restrictions on restoring to a different hard drive once LambChopped.
  324.  
  325.   * ALL filenames and directory information for the entire LambChop  is saved
  326.   with each disk segment.
  327.  
  328.   *  From any  disk  segment,  you may  view  the  entire LambChop  directory
  329.   information.   Display  in  Ascending  or Descending  order  on file  name,
  330.   segment + file name, or file time.
  331.  
  332.   * Pull out only the files you want directly from their location on the disk
  333.   segment.  Since LambChop  has full volume information in each disk segment,
  334.   there is no need to remember which disk  segment the file or files you want
  335.   start on.  Simply give the file names you are looking for and LambChop will
  336.   prompt you to insert the proper disk segments to restore only those files.
  337.  
  338.   * LambChop can be executed from the DOS command line,  LambMenu,  or from a
  339.   batch file.   Options and files may  be stored in a configuration  file for
  340.   repetitive LambChop operations.
  341.  
  342.   * Works  with DOS 2 through  DOS 5.  Does  not require same version  of DOS
  343.   when restoring like DOS BACKUP does.  Basically, if you can run DOS COPY on
  344.   your system, you can run LambChop!
  345.  
  346.   * Option  to  go to  DOS  while exchanging  diskettes during  chopping  and
  347.   UnChopping.   Memory is swapped to EMS or  disk giving you a full DOS shell
  348.   to  operate with.   Execute DOS commands  and programs (Ie.  format a:) and
  349.   return right where you left off!
  350.  
  351.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved      6
  352.  
  353.                               2. Getting Started
  354.  
  355.  
  356.   Hardware requirements
  357.   Minimum requirements are a 512k IBM PC or 100% compatible with a hard drive
  358.   under MS-DOS 2  through 5.  LambChop  will use as much  conventional memory
  359.   (640k) as you have available for  reading and writing large chunks of  disk
  360.   information more efficiently.  LambChop will operate with a bare minimum of
  361.   128k, but at the expense of speed.
  362.  
  363.   If you have expanded  memory available, LambChop will copy itself into this
  364.   area while swapping to DOS, allowing more room for the DOS shell.  If there
  365.   is  no expanded memory  available, a memory  swap to the work  disk will be
  366.   performed.
  367.  
  368.   LambChop will chop up output disk segments to any size.   The output is not
  369.   restricted to standard floppy disks only.  For example, some users  have 20
  370.   megabyte (Mb) removable fixed disks for output.   LambChop will auto detect
  371.   the capacity of the destination disk  to take advantage of every last  byte
  372.   on the removable disk (20Mb).
  373.  
  374.   A mouse is supported by LambMenu but is not required.
  375.  
  376.  
  377.   Installation
  378.   The LambChop  program is distributed  in a self extracting  compressed disk
  379.   file.   Either create  a new  directory for  LambChop or  find an  existing
  380.   directory which is currently in your autoexec.bat DOS path.
  381.  
  382.   To install LambChop in the appropriate directory, type:
  383.   LAMBCHOP [enter]
  384.  
  385.   An approved alternate file name for COMPUSERVE is: (6 character file limit)
  386.   LAMCHP [enter]
  387.  
  388.   LC.EXE, LM.EXE,LAMBMENU.HLP, LAMBCHOP.CFG, and any supporting custom config
  389.   files  need to  reside in the  same directory.   You might  consider adding
  390.   these files to a directory within  your DOS path.  This will enable  you to
  391.   call LambChop from any directory location within DOS.
  392.  
  393.   To add a new directory to your DOS path: 
  394.   Edit your \autoexec.bat file and add or edit the following line.
  395.  
  396.   PATH=C:\UTILITY
  397.  
  398.   This example  will allow  DOS  to see  the  c:\utility directory  from  any
  399.   directory  you are within  on you system.   Save the  autoexec.bat file and
  400.   reboot your system.  Make certain all of the LambChop files are located  in
  401.   the 'c:\utility'  directory.    The  'c:\utility' directory  is  simply  an
  402.   example and is not a required directory location for LambChop.
  403.  
  404.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved      7
  405.  
  406.   Setup
  407.   LambChop and LambMenu both try to read from the file LAMBCHOP.CFG  at start
  408.   up.  LAMBCHOP.CFG  is simply a  configuration text file.   It contains  the
  409.   LambChop/Menu settings as  given on the command  line.  Since this  file is
  410.   loaded  every time  the program  is  run, you  can fine  tune  the LambWare
  411.   factory defaults  to your individual preference.   For standardization with
  412.   this manual, we  will leave the settings  at their factory default  status.
  413.   See  chapter  5  for  further   instructions  on  configuration  files  and
  414.   customizing LambChop and LambMenu.
  415.  
  416.   If you have placed LambChop in your DOS path, you can start the examples in
  417.   any  DOS directory.   Otherwise,  run the  examples in  the directory  that
  418.   LambChop is stored.   For standardization in the manual, it is assumed that
  419.   LambChop and LambMenu will be within your DOS path.
  420.  
  421.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved      8
  422.  
  423.                                   3. LambMenu
  424.  
  425.   LambMenu was  designed to be easy to  use.  While LambMenu  is running, you
  426.   may press [F1  key] at any point  to receive context sensitive help  on the
  427.   item you  are currently selecting.  After going  through the Quick start in
  428.   the next section, try going through the options and pressing [F1] for help.
  429.   Most all of the menu options are self explanatory.  To see a description of
  430.   each menu option, see chapter 4 on command descriptions.
  431.  
  432.   LambMenu will also accept any  command line parameters with the  same rules
  433.   applying to LambChop.
  434.  
  435.  
  436.   Quick start
  437.   As  you continue,  you'll probably  find  some procedures  you don't  fully
  438.   understand.   In  the Quick  start sections,  the objective  is  to give  a
  439.   workable example on  your machine.  If  you do not understand  exactly what
  440.   each step is for, that's ok!  We  will explain these procedures fully later
  441.   in the manual.
  442.  
  443.  
  444.   Chop mode
  445.   Objective: To  create 10 equally sized disk segments  on your hard drive of
  446.   your current directory.
  447.  
  448.   To start LambMenu:
  449.   Type: LM [and press the enter or return key]
  450.   You should see the opening screen.
  451.  
  452.   (Remember to try using the help feature by pressing the [F1] key)
  453.  
  454.   Bypass the opening LambMenu screen.  You are now at the main menu.
  455.   Press: [enter]
  456.  
  457.   Move to the "Chop" menu.
  458.   Press: [right arrow]
  459.  
  460.   Select the menu option "Volume name".
  461.   Press: [enter]
  462.  
  463.   You are requested to enter the output Volume name LambChop will write to.
  464.   Type: TEST
  465.         [enter]
  466.   You should be returned to the Chop menu.
  467.  
  468.   Select  the "Include  files" option.   The include  files is where  you may
  469.   enter up to 25 file names or masks that you want to include in the Chopping
  470.   procedure.
  471.   Press: [down arrow]
  472.         [enter]
  473.  
  474.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved      9
  475.  
  476.   Edit the highlighted first entry.
  477.   Press: [enter]
  478.   Your cursor should be in the File name field.y
  479.  
  480.   Include all files in the current directory.
  481.   Type:  *.* 
  482.         [enter]
  483.   Notice the file mask was added to the list of include files.
  484.  
  485.   Return to the chop menu.
  486.   Press: [esc]
  487.  
  488.   Select the "Options" sub menu.
  489.   Press: [down arrow]
  490.         [enter]
  491.  
  492.   Select  the "Size  of Segment"  sub menu.   You  may  go there  directly by
  493.   pressing  the  highlighted  letter instead  repeatedly  pressing  the [down
  494.   arrow].
  495.   Press: S
  496.  
  497.   You  will see  a list  of available  segment sizes.   The default  is "Auto
  498.   adjust to  disk size" and  is selected with a  check mark beside  it.  Auto
  499.   adjust reads the free space on the destination disk and sets this  size for
  500.   the output segment.
  501.  
  502.   Since your destination  disk is your hard  drive for this  example, chances
  503.   are your hard drive has more  room on it than is needed for  a disk segment
  504.   change. To force LambChop to create multiple disk segments, select the last
  505.   menu option, "Hack into = segments".
  506.   Press: H
  507.  
  508.   We need to  let LambChop know  that you want to  take all of your  files in
  509.   your current directory, combine, and chop them up into 10 equal segments.
  510.   Type: 10
  511.         [enter]
  512.   Notice the check mark has moved to "Hack into = segments".
  513.  
  514.   Return to the Chop menu.
  515.   Press: [esc]
  516.         [esc]
  517.  
  518.   You are now ready to begin the Chopping procedure.
  519.   Select  the "Begin  Chopping!" option  to  call LambChop  and initiate  the
  520.   procedure.
  521.   Press: C
  522.  
  523.   You have now created 10 equally sized Lamb segments on your drive!  
  524.   You should see a prompt for you to press any key to return to LambMenu.
  525.  
  526.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved     10
  527.  
  528.   UnChop mode
  529.   Objective: To open,  view, and extract all  files to a sub  directory named
  530.   TEMPDIR\
  531.  
  532.   First we begin by opening a LambChop volume.
  533.   Select the UnChop option menu.
  534.   Press: [right arrow] 
  535.  
  536.   Notice that all but the "open Volume" option are deactivated.  In order for
  537.   you to select  one of the deactivated  UnChop menu options, you  must first
  538.   open a LambChop volume.
  539.  
  540.   Select "open Volume".
  541.   Press: [enter]
  542.  
  543.   Display a list of LambChop Segments in your current directory.
  544.   Press: [F3 key]
  545.  
  546.   LambMenu will prompt  you with a drive and directory request to start from.
  547.   Since we want the current path default.
  548.   Press: [enter]
  549.  
  550.   Press your  arrow keys  to select any  one of  the LambChop  segments named
  551.   TEST0??.LAM (where ?? equals a number between 01 - 10).
  552.  
  553.   Copy any LambChop segment to your file name editing line.
  554.   Press: [enter]
  555.  
  556.   Open the segment.
  557.   Press: [enter]
  558.  
  559.   You should see a  box with the LambChop volume  information in it.  Take  a
  560.   moment to review the self explanatory LambChop volume information.
  561.  
  562.   When finished reviewing volume information:
  563.   Press: [enter]
  564.   Notice that the other UnChop menu options are now available for selection.
  565.  
  566.   Select "view LambDirectory" menu option.   View LambDirectory allows you to
  567.   see the files contained in the entire LambChop volume.
  568.   Press: [down arrow]
  569.         [enter]
  570.  
  571.   When finished reviewing the DOS files stored in LambChop format:
  572.   Press: [esc]
  573.  
  574.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved     11
  575.  
  576.   Select  "Extract file  list".  This  list is  similar to the  "Include file
  577.   list", but specifies which files to pull out of the LambChop volume.
  578.   Press: [down arrow]
  579.         [enter]
  580.  
  581.   Edit the highlighted first entry in the table.
  582.   Press: [enter]
  583.   Your cursor should be in the name field.
  584.  
  585.   Move backwards to the directory field.
  586.   Press: [shift and the tab key]
  587.  
  588.   Specify the output directory.   The directory will be created automatically
  589.   for you if it does not already exist.
  590.   Type: TEMPDIR
  591.         [enter]
  592.  
  593.   Specify that you want all files extracted.
  594.   Type: *.*
  595.         [enter]
  596.   Notice that the mask and directory was added to the list of extract files.
  597.  
  598.   Return to the UnChop menu.
  599.   Press: [esc]
  600.  
  601.   There are no UnChop options that need to be set. Select begin UnChopping:
  602.   Press: [down arrow]
  603.         [down arrow]
  604.  
  605.   Activate the begin UnChopping option:
  606.   Press: [enter]
  607.  
  608.   When LambChop finishes UnChopping all the files, return to LambMenu.
  609.   Press: [enter]
  610.  
  611.   To  exit LambMenu and return to DOS, press [ALT  and the X key].  This is a
  612.   hot key to exit LambMenu.  Press: Y to return to DOS.
  613.  
  614.   You may now examine  the directory to see that you in fact have created the
  615.   examples and the TEMPDIR\*.* directory.
  616.  
  617.   Great Job!  That's all there is to it!
  618.  
  619.   This section will clean up the files you created in this example:
  620.   Make sure you are in the same directory you ran the example from.
  621.   Type: DIR TEST*.LAM [enter]
  622.   Type: DEL TEST*.LAM [enter]
  623.   Type: DEL TEMPDIR\*.* [enter]  Respond Yes to "are you sure"
  624.   Type: RD TEMPDIR [enter]
  625.  
  626.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved     12
  627.  
  628.   Configuration files
  629.   Config files are very easy to create with LambMenu.  There is a menu called
  630.   config from the main menu.   The two types of  config files are custom  and
  631.   default.  They  both contain the same  format, but the default  config file
  632.   (LAMBCHOP.CFG)  is  loaded  every  time LambMenu  and  LambChop  is loaded.
  633.   Custom config  files are  only loaded when  you specifically  request them.
  634.   Config  files  are always  stored  and loaded  from the  same  directory as
  635.   LambChop and LambMenu are stored.  See chapter 5 for more on config files.
  636.  
  637.   Load custom  config file: This option will load a previously defined config
  638.   file  into the  current settings  of LambMenu.   Current  settings  will be
  639.   reset.
  640.  
  641.   Save custom  config file:  The  current Chop  and Unchop  menu options  and
  642.   filenames will be saved to a *.cfg text file of your choice.
  643.  
  644.   Save default config  file: LAMBCHOP.CFG will be used as  the default config
  645.   file.  This file is loaded every time the LambChop or LambMenu is run.
  646.  
  647.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved     13
  648.  
  649.                                   4. LambChop
  650.  
  651.   Quick start
  652.   LambChop is the DOS command line engine behind LambMenu.  Both the Chop and
  653.   UnChop utilities  are built into LC.EXE.   LambChop works with command line
  654.   parameters and may seem confusing to the  beginner.  A step by step example
  655.   is  given to  do  the same  exercise  that LambMenu  used  in the  LambMenu
  656.   example.   Remember, if you  don't understand  every step, that's  ok.. the
  657.   objective is to  get the  feel of  the functionality of  LambChop from  the
  658.   command line.
  659.  
  660.  
  661.   Chop mode
  662.   Objective: To  create 10 equally sized disk segments  on your hard drive in
  663.   your current directory from the DOS command line.
  664.  
  665.   To start LambChop, type:
  666.   Type: LC TEMP *.* /h10 [enter]
  667.  
  668.   This tells LambChop to expect a volume name of TEMP, include  all the files
  669.   in the current directory, and hack them into 10 equal disk segments.
  670.  
  671.   UnChop mode
  672.   Objective: To open,  view, and extract all  files to a sub  directory named
  673.   TEMPDIR\
  674.  
  675.   First  to  view the  contents of  any  LambChop disk  segment place  the /v
  676.   parameter anywhere on the command line.
  677.   Type: LC TEMP /v [enter]
  678.  
  679.   This command will open the LambChop volume  TEMP*.LAM and show the contents
  680.   within.
  681.  
  682.   To activate the UnChop mode, simply place the command option /u anywhere on
  683.   the parameter list of options.  
  684.  
  685.   Type: LC /u TEMP TEMPDIR\*.* [enter]
  686.  
  687.   This tells  LambChop to set itself in the UnChop mode, read from the volume
  688.   TEMP*.LAM ,  and write all  the files stored in  the volume to  the TEMPDIR
  689.   directory.   If the  TEMPDIR directory  is not  yet created,  LambChop will
  690.   automatically create the directory while UnChopping.
  691.   Finished!  You are becoming a master!
  692.  
  693.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved     14
  694.  
  695.   This section will clean up the files you created in this example:
  696.   Make sure you are in the same directory you ran the example from.
  697.   Type: DEL TEST*.LAM [enter]
  698.   Type: DEL TEMPDIR\*.* [enter]   Yes to 'are you sure'
  699.   Type: RD TEMPDIR [enter]
  700.  
  701.     
  702.   LambChop DOS Error Messages
  703.   LambChop and LambMenu produce an error message for DOS on exit if an
  704.   error occurred during runtime.  All errors may be detected from within
  705.   a DOS batch file.
  706.  
  707.   DOS error level: 0 - No error
  708.                    1 - Bad file name or file specification
  709.                    2 - Illegal command line parameter(s)
  710.                    3 - Insufficient memory
  711.                    4 - Aborted by user request
  712.                    5 - No files found that match filespec
  713.                    6 - System error
  714.                    7 - Disk full or problem writing to file
  715.                    8 - Program limits (for this version) exceeded
  716.                    9 - Could not open file
  717.                    10- Could not read file
  718.                    11- General error
  719.                    12- Failed Error Check (CRC-32)
  720.  
  721.  
  722.   LambChop Directory Structure
  723.   Beginners may ignore  this paragraph.  The internal  directory structure is
  724.   available  from  LambWare  by  request  only  to  registered  users.    See
  725.   register.txt for LambWare address information.  Please specify that you are
  726.   interested  in  the  directory  structure  in  the  comments  section  when
  727.   registering.
  728.  
  729.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved     15
  730.  
  731.                                 Chop commands
  732.  
  733.   This sections goes into detail for each  command option for Chopping and is
  734.   primarily focused for the DOS command line users.
  735.  
  736.   If you are  primarily a LambMenu user,  all the command options  shown here
  737.   will work with LambMenu from the command line also.
  738.  
  739.  
  740.   Rules
  741.   LambChop has  a  built in  quick  reference guide.    To review  the  quick
  742.   reference from the command line:
  743.   LC [enter]
  744.   or
  745.   LC /? [enter]
  746.  
  747.   When running LambChop, the general syntax is:
  748.   LC   VOLUME-NAME   IN FILES..   OPTIONS..
  749.  
  750.   VOLUME-NAME:  The first file  name LambChop comes  to on the  command line.
  751.   Limit  to 5 characters  or less with no  extension.  A  volume name must be
  752.   supplied.
  753.  
  754.   IN FILES: The second through 26th (25 total) file names on the command line
  755.   are  interpreted as input include files.  If  no file name is given, *.* is
  756.   assumed.  File masks (* and ?) are ok.
  757.  
  758.   OPTIONS:
  759.       * Place anywhere on the command line. 
  760.       * Not case sensitive.
  761.       * Separate with a space.
  762.       * No combining with other options.
  763.       * Precede with / or -
  764.  
  765.   Please note  that the  compression system must  have the  actual compressed
  766.   sizes before chopping up into segments.  In order to do this, LambChop does
  767.   all  compression before actually chopping by  creating the compressed files
  768.   in a temporary directory.  It is a good idea to have at least twice as much
  769.   space  for  LambChop to  work  with.   This  assures ample  work  space for
  770.   temporary file  storage.  When UnChopping, however, files are de-compressed
  771.   as they are extracted from the LambChop volume.
  772.  
  773.   If command is delimitated with a [], the command is optional.
  774.   If  command  is delimited  with a  <>, a  minimum of  one argument  must be
  775.   supplied.
  776.  
  777.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved     16
  778.  
  779.   DOS attributes: /A[h][s]
  780.   Determine whether or not LambChop will include DOS files with the hidden or
  781.   system attribute level.
  782.  
  783.   By  default, hidden  and system  files  are not  included  in the  Chopping
  784.   process.  Hidden  and system files  usually are not  displayed in your  DOS
  785.   directory.  
  786.   If  included,  LambChop  will  restore  the attributes  to  the  file  when
  787.   UnChopping.  
  788.  
  789.   LC A:\TEST *.* /Ah
  790.   Chop all files in the current directory to TEST*.LAM and include DOS hidden
  791.   files.
  792.  
  793.   LC A:\TEST *.* /Ahs
  794.   Chop all files  in the current directory  to TEST*.LAM and include  the DOS
  795.   hidden and system files.
  796.  
  797.  
  798.   Adjust segment to exact # of bytes: /B<#>
  799.   Force LambChop to create each segment with exactly this number of bytes.
  800.  
  801.   Each segment in the entire volume will  match the exact number of bytes you
  802.   specify after the /B command.  
  803.  
  804.   LC A:TEST *.* /B10000
  805.   Chop all files in the current directory  to TEST*.LAM and force 10,000 byte
  806.   segments.
  807.  
  808.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved     17
  809.  
  810.   Compression: /C[a]
  811.   Reduce the  size of the input  files by an average  of 45%.  There  are two
  812.   modes: text and all files.
  813.  
  814.   LambChop  must determine  the  exact  number of  bytes  the total  Chopping
  815.   procedure requires.  LambChop must have the compressed file sizes before it
  816.   starts  writing to  the destination  drive.   Because of  this requirement,
  817.   LambChop will  create a temporary  compressed file on your   current drive.
  818.   You  may  specify an  alternate temporary  work drive with  the /W  command
  819.   (This will be explained later on in the manual).
  820.  
  821.   LambChop  will always  skip files  with  file extensions  of other  popular
  822.   compression file formats.
  823.  
  824.   If the  /C command  is used  by itself,  LambChop will  only compress  text
  825.   files.   LambChop  takes  a  sample  of the  file  for  the  percentage  of
  826.   alphanumeric  characters.    If  the  file  contains  a  majority  of  text
  827.   characters, the file  will be compressed.   Text  files offer the  greatest
  828.   reduction in  file size.   Also,  there  will be  less demand  for a  large
  829.   capacity drive for temporary work space.
  830.  
  831.   If you have  the free disk work  space and want to compress  all files, use
  832.   the /Ca option.  The 'a' lets LambChop know you want to compress all files.
  833.   However, LambChop will not compress other popular compression file  formats
  834.   in this mode.
  835.  
  836.   Note: if the file was skipped for compression, it will still be included in
  837.   the Chopping procedure.
  838.  
  839.   LC A:\TEST *.* /C
  840.   Compress  only  text  files  within  the current  directory  and  store  in
  841.   A:\TEST*.LAM volume.
  842.  
  843.   LC A:\TEST *.* /Ca
  844.   Compress all files  within the current directory and  store in A:\TEST*.LAM
  845.   volume.
  846.  
  847.  
  848.   Error checking: /E  
  849.   Error checking (CRC-32  bit) will notify you if the stored data has changed
  850.   in any way.
  851.  
  852.   LC A:\TEST *.* /E
  853.   Chop all files in current directory to A:\TEST*.LAM using error checking.
  854.  
  855.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved     18
  856.  
  857.   Fit segment to disk: /F<#>
  858.   Force LambChop  to create each disk segment to  a predefined size, given by
  859.   selection <#>. 
  860.  
  861.   The   fit  segment  option   offers  the  lowest   common  denominator  for
  862.   distributing software  to clients and  other users.   Some users  only have
  863.   360k floppy disks.  By  forcing a larger capacity drive (1.2 meg, 1.44 meg)
  864.   to create  360k disk segments  when chopping,  you are  assured of  optimum
  865.   downward compatibility to the 360k floppy disk users.  In addition, several
  866.   360k segments will fit on a single 1.2 meg or 1.44 meg floppy.
  867.  
  868.   Where <#> is defined as:
  869.       <1>  default, autofit the  segment size.  Determine  the free space on
  870.       the destination  drive and set each segment in  the volume to the same
  871.       size.
  872.  
  873.       <2> 1.2  meg floppy.  Segment  size will be set  to fill up a  1.2 meg
  874.       floppy disk even if the destination disk is not a 1.2 meg floppy.
  875.  
  876.       <3> 360k floppy.   Segment size will be  set to fill up  a 360k floppy
  877.       disk even if the destination disk is not a 360k floppy.
  878.  
  879.       <4> 1.44 meg floppy.   Segment size will be set to fill  up a 1.44 meg
  880.       floppy disk even if the destination disk is not a 1.44 meg floppy.
  881.  
  882.       <7> 720k floppy.   Segment size will be  set to fill up a  720k floppy
  883.       disk even if the destination disk is not a 720k floppy.
  884.  
  885.   LC A:\TEST *.* /F3
  886.   (Assume drive A: is a 1.44 meg drive.)
  887.   Chop all files in the  current directory to A:\TEST*.LAM, creating multiple
  888.   360k segments.
  889.  
  890.  
  891.   Hack into equal # segments: /H<#>
  892.   Hack the entire volume into equivalent partition segments.
  893.   The range of hacked segments must be between 1 and 999.
  894.  
  895.   LC TEST *.* /H10
  896.   Chop all files  in current directory to  TEST*.LAM, hacking volume into  10
  897.   equal segments.
  898.  
  899.  
  900.   Adjust segment to kilobytes: /K<#>
  901.   Similar to /B  bytes, but the number you supply here  will be multiplied by
  902.   one  kilobytes (1024 bytes).   Force LambChop  to create  each segment with
  903.   exactly this number of kilo bytes.
  904.  
  905.   Each segment in the entire volume will match the exact number of kilo bytes
  906.   you specify after the /K command.  
  907.  
  908.   LC A:TEST *.* /K100
  909.  
  910.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved     19
  911.  
  912.   Chop all files in the current directory to TEST*.LAM and force 102,400 byte
  913.   segments.
  914.  
  915.  
  916.   Move original file into volume: /M
  917.   After the source  file is successfully copied into the  LambChop volume, it
  918.   is removed from the source drive.
  919.  
  920.   LC A:TEST *.* /M
  921.   Chop  all files  in the  current  directory to A:TEST*.LAM, deleting source
  922.   IMMEDIATELY after copying to the volume.
  923.  
  924.  
  925.  
  926.   Chop only New and modified files since last LambChop: /N
  927.   When LambChop chops up the input files, the DOS ARCHIVE bit is turned off.
  928.   When DOS creates and modifies any file, it switches the ARCHIVE bit back
  929.   on.  LambChop can identify which new files need to be Chopped by examining
  930.   the ARCHIVE bit set by DOS.
  931.  
  932.   LC A:TEST *.* /N
  933.   Chop all files in the current directory to A:TEST, all new and modified
  934.   files will be included.
  935.  
  936.  
  937.  
  938.   Overwrite without warning: /O
  939.   Normally,  LambChop will prompt you  if you want  to Overwrite the existing
  940.   volume.  If you wish to bypass this warning, use /O.
  941.  
  942.   Note  that  LambChop  will  not   update  or  refresh  an  existing  volume
  943.   distributed across single or multiple diskettes.
  944.  
  945.   LC A:\TEST *.* /O
  946.   Chop  all files in the current directory  to A:TEST*.LAM without warning of
  947.   an existing volume of the same name.
  948.  
  949.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved     20
  950.  
  951.   Store path name with file: /P
  952.   LambChop has  the option of storing file path  names.  By default, LambChop
  953.   does not store path names with the file.  LambChop never  stores the source
  954.   drive letter with the file.
  955.  
  956.   It is very important  to note that LambChop only stores  the files RELATIVE
  957.   PATH given  with the input file on the command line.  The path given on the
  958.   command line is considered the root, even if the file actually resides in a
  959.   subdirectory.
  960.  
  961.   Relative Path example:
  962.   Assume your current directory is C:\SUBDIR1\SUBDIR2
  963.  
  964.   LC A:\TEST *.* /P
  965.   Would NOT store any path name with  the file since the relative path is the
  966.   current path.
  967.  
  968.   However, 
  969.   LC A:\TEST C:\SUBDIR1\SUBDIR2\*.* /P
  970.   would  make the root of  the C:\ drive the  relative path, even though your
  971.   current directory is  in the C:\SUBDIR1\SUBDIR2\ directory.   The path name
  972.   stored would be:
  973.   SUBDIR1\SUBDIR2\
  974.  
  975.   Notice that there is no drive letter or preceding \ root slash.  See the /D
  976.   option in UnChop commands for an explanation of how the files  are restored
  977.   to disk.
  978.  
  979.  
  980.   Include all subdiRectories: /R
  981.   Include all files from the relative path downward.
  982.  
  983.   Include  all subdiRectories  will start  at the  current relative  path and
  984.   include all  files in the  subdirectories as well.   If there  are multiple
  985.   input files or  masks, only the files  matching the requested file  name or
  986.   mask will be included.
  987.  
  988.   LC A:\TEMP *.BAT *.EXE /R
  989.   Any file with a .bat  or .exe file extension  in your current directory  or
  990.   within any subdirectories will be included.
  991.  
  992.   LC A:\TEMP C:\*.COM D:\*.COM /R
  993.   Include any file with a .com extension on the entire c: and d: drives.
  994.  
  995.   Note: If the store path name (/P) option is not used, there  will be no way
  996.   to restore these files to their original location.
  997.  
  998.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved     21
  999.  
  1000.   Store path name and include all subdiRectories: /S
  1001.   Both the /P and /R options are  frequently used together.  For this reason,
  1002.   the /S store path  name and include all subdiRectories option  may be used.
  1003.   Effectively, /S is the same as /P /R from the command line.
  1004.  
  1005.  
  1006.   Disable tone: /T
  1007.   By  default, LambChop  will sound  an  audible alarm  when requesting  user
  1008.   input.  When the /T option is used, audible tones are disabled.
  1009.  
  1010.   LC A:\TEST *.* /T
  1011.   No tones sounded at user prompts.
  1012.  
  1013.  
  1014.   Wait (pause) delay: /W
  1015.   Wait will  pause the execution of LambChop  at key points to  give the user
  1016.   time to  review the LambChop  information.   Before the first  segment, and
  1017.   after determining number of disks required are some examples of wait.
  1018.  
  1019.   If  viewing a LambChop  volume, wait will  pause between each  full page of
  1020.   text.
  1021.  
  1022.  
  1023.   Exclude file mask: /X<mask>
  1024.   Any files you do  not want to include in  the chopping procedure.  You  may
  1025.   include wildcards (* or ?), and there is a maximum of 10 masks per chop.
  1026.  
  1027.   LC A:\TEMP *.* /x*.BAT /xTHISFILE.COM
  1028.   Chop all  files in  the current directory  EXCEPT all  files with  the .bat
  1029.   extension and the THISFILE.COM program.
  1030.  
  1031.   Execute DOS command: /Y<"command">
  1032.   This option will execute the command you give between the " " on each disk.
  1033.   LambChop will swap memory to EMS/disk before your command executes, freeing
  1034.   up memory.  Any program or internal DOS command is ok.
  1035.  
  1036.   LC A:\TEMP *.* /y"format A:"
  1037.   format  each disk in the A: drive  before chopping all files in the current
  1038.   directory.
  1039.  
  1040.  
  1041.   Alternate work drive: /Z<drive-letter>
  1042.   Compression  temporary files  and  disk  swap files  need  the fastest  and
  1043.   largest disk resources.   Usually,  this option would  be inserted in  your
  1044.   LAMBCHOP.CFG file with the appropriate drive.
  1045.  
  1046.   LC A:\TEMP *.* /zD
  1047.   All temporary and swap  files will be  created on the  D: drive instead  of
  1048.   your current drive.
  1049.  
  1050.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved     22
  1051.  
  1052.                               UnChop commands /U
  1053.  
  1054.   Rules
  1055.   When running LambChop, the general syntax is:
  1056.   LC  /U   VOLUME-NAME   EXTRACT FILES..   OPTIONS..
  1057.  
  1058.   /U: Place LambChop in the UnChop mode.  All commands will be interpreted as
  1059.   UnChop.  The command option /U should be the first parameter on the command
  1060.   line.
  1061.  
  1062.   VOLUME-NAME: The first  file name  LambChop comes to  on the command  line.
  1063.   Limit  the volume name  to five characters  or less  with no extension.   A
  1064.   volume name must be supplied.
  1065.  
  1066.   EXTRACT FILES: The  2nd through 26th (25  total) file names on  the command
  1067.   line are  interpreted as  "extract files".   Extract files or  extract file
  1068.   masks will be  restored from the volume  to the drive and path  you specify
  1069.   with the extract  file.  If  no file name is  given, *.* is assumed.   File
  1070.   masks (* and ?) are ok.
  1071.  
  1072.   OPTIONS:
  1073.       * Place anywhere on the command line. 
  1074.       * Not case sensitive.
  1075.       * Separate with a space.
  1076.       * No combining with other options.
  1077.       * Precede with / or -
  1078.  
  1079.   If compression is used during chopping, each file that is compressed is de-
  1080.   compressed as it is extracted from the LambChop volume.  
  1081.  
  1082.   If the command is delimited with a [], the command is optional.
  1083.   If the command is  delimited with a <>, a  minimum of one argument must  be
  1084.   supplied.
  1085.  
  1086.  
  1087.   Use and create directory if stored: /D
  1088.   If the files were stored with the  /P (store path name) or /S (include  all
  1089.   subdiRectories  and  store path  name)  option  during  chopping, you  must
  1090.   include  the /D  option  to  restore the  file  to  its original  location.
  1091.   Otherwise,  files will  be restored  to  the relative  path during  UnChop.
  1092.   LambChop  never stores the  source drive letter  with the file.   All files
  1093.   will be restored to  the current drive,  unless another drive is  specified
  1094.   during UnChop.
  1095.  
  1096.   Relative path is the path name given with the extract files on the  command
  1097.   line during  UnChop.  The path given on  the command line is considered the
  1098.   root, even if the file actually resides in a subdirectory.
  1099.  
  1100.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved     23
  1101.  
  1102.   Relative Path example:
  1103.   Assume your current directory is C:\CURDIR\ and the  files were stored with
  1104.   the /P  (store path names) option during  chop.  The path  name stored with
  1105.   the files was SUBDIR1\SUBDIR2\ .
  1106.  
  1107.   Each  file  stored  can  only  be restored  once  in  the  same  UnChopping
  1108.   procedure.  Once  the file has been  restored to its primary  location, all
  1109.   other extract file parameters are ignored.  For example, LC /U  A:\TEST *.*
  1110.   \TEMPDIR\*.*    would  restore nothing to  \TEMPDIR\ because all  the files
  1111.   were restored to the current directory in the first extract parameter.
  1112.  
  1113.   LC /U A:\TEST *.*
  1114.   Without the /D option, the stored path name would  be ignored and all files
  1115.   would be restored to the current C:\CURDIR\ directory.
  1116.  
  1117.   LC /U A:\TEST *.* /D
  1118.   With the /D option, the stored path name is used.  Since the relative  path
  1119.   is  the  current  directory,  C:\CURDIR\   ,  the  files  are  restored  to
  1120.   C:\CURRDIR\SUBDIR1\SUBDIR2\  .  Notice how the stored path SUBDIR1\SUBDIR2\
  1121.   is added to the relative path.
  1122.  
  1123.   LC /U A:\TEST C:\*.* /D
  1124.   With the /D option, the stored path name is used.  The relative path is now
  1125.   the C:\ root.  The files are restored to c:\SUBDIR1\SUBDIR2\ .
  1126.  
  1127.  
  1128.   Goto file, ignoring previous files: /G<file-name>
  1129.   Supported only by LambChop engine.  Use in case UnChop was interrupted
  1130.   before completion.  /G allows you to goto the file you left off on,
  1131.   ignoring previous files in the volume and continuing to the end.  If you
  1132.   are viewing the volume directory with /V while using /G, use the /V4
  1133.   option to view in unsorted order so you may see the exact set of files
  1134.   to be extracted.
  1135.  
  1136.   LC /U A:\TEST C:\*.* /Gautoexec.bat
  1137.   Ignore all files until autoexec.bat is reached, then extract all files on
  1138.   and after autoexec.bat.
  1139.  
  1140.  
  1141.   Locate files in path name: /L<path-name>
  1142.   Extract all files matching  this stored path name.  If  the path name given
  1143.   matches any  portion of the one stored, the  file is queued for extraction.
  1144.   File names and  masks may be  included on  the command line  to filter  the
  1145.   extract list even further.
  1146.  
  1147.   LC /U A:\TEST /lSUB *.BAT
  1148.   Find  any stored  directory  with *SUB*  and extract  only  files with  the
  1149.   extension .BAT .
  1150.  
  1151.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved     24
  1152.  
  1153.   Overwrite: /O[n]
  1154.   Normally, LambChop  will prompt you if  you want to overwrite  the existing
  1155.   file  if found while UnChopping.   If you wish to  bypass this warning, use
  1156.   /O.   /O may be followed by the  'n', new-files-only parameter.  New-files-
  1157.   only will  compare the file time stored in the volume with the file you are
  1158.   overwriting.   If  no  matching  file  is  found,  the  file  is  restored.
  1159.   Otherwise, the date on the file stored in the volume must be newer than the
  1160.   DOS  file date  being  overwritten.   If  it is  newer,  the file  will  be
  1161.   restored.
  1162.  
  1163.   LC /U A:\TEST *.* /O
  1164.   No overwrite warning while UnChopping
  1165.  
  1166.   LC /U A:\TEST *.* /On
  1167.   Only overwrite the new files.
  1168.  
  1169.  
  1170.   Disable tone: /T
  1171.   By  default, LambChop  will sound  an  audible alarm  when requesting  user
  1172.   input.  When the /T option is used, audible tones are disabled.
  1173.  
  1174.   LC /U A:\TEST *.* /T
  1175.   No tones sounded at user prompts.
  1176.  
  1177.  
  1178.   View volume: /V[#][d]
  1179.   Display  a  Directory of  the  entire  LambChop  volume.   If  you  want  a
  1180.   descending order, include a 'd' after the view sorting condition.
  1181.  
  1182.   Where [#] is sorting condition (default is 1):
  1183.  
  1184.   [1] File name only
  1185.   [2] Segment number and file name
  1186.   [3] File time
  1187.   [4] No sorting, same order as the files will be UnChopped in.
  1188.  
  1189.   LC /3d c:\TEST *.* /D
  1190.   Show stored directories, view on file time in descending order (from newest
  1191.   dated files to oldest).
  1192.  
  1193.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved     25
  1194.  
  1195.   View example: 
  1196.   LC /v C:\TEST *.*
  1197.   produces the following output:
  1198.  
  1199.   LambChop (tm) v0.90   Copyright 1992, LambWare  All Rights Reserved
  1200.   Compiled: Dec 15 1991  Registration #: 00000 Unregistered Evaluation Copy! 
  1201.  
  1202.   View mode, files will not be restored to the destination disk!
  1203.  
  1204.   Volume [C:\TEST???.LAM]
  1205.   Created..[12/15/91 11:36:20 (v0.90)]        Total input files....[00017]
  1206.   Segment.................[001 of 001]        Segment-size..[     180,141]
  1207.   CRC 32-bit Error Check....[Enabled!]
  1208.  
  1209.   *** PATH(S) STORED WITH FILENAME ***   Use command /D to restore paths.
  1210.  
  1211.   The  drive letter with  filename is not  stored, may be  changed at command
  1212.   line.
  1213.  
  1214.   Start   File     Compress    File    File   Attr  File 
  1215.   Seg     Size     Size   %    Date    Time    HSR  Name
  1216.   ---------------------------------------------------------------------------
  1217.   001     9119     3845  58  11/11/91  03:00   ...  C:BRIEF.TEM
  1218.   001     5024     1894  63  11/11/91  03:00   ...  C:CMACROS.TEM
  1219.   001    17710     7926  56  11/11/91  03:00   ...  C:DBGBOARD.TD
  1220.   001     7522     2900  62  11/11/91  03:00   ...  C:DEFAULTS.TEM
  1221.   001     3264     1641  50  11/11/91  03:00   ...  C:DOSEDIT.TEM
  1222.   001     9577     3995  59  11/11/91  03:00   ...  C:EPSILON.TEM
  1223.   001    26718    11660  57  11/11/91  03:00   ...  C:H2ASH.TSM
  1224.   001     8781     4063  54  11/11/91  03:00   ...  C:HDWDEBUG.TD
  1225.   001    43386    21988  50  11/11/91  03:00   ...  C:HELPME!.DOC
  1226.   001    11618     5916  50  11/11/91  03:00   ...  C:HELPME!.PRF
  1227.   001    25315    12444  51  11/11/91  03:00   ...  C:HELPME!.TD
  1228.   001    10516     4753  55  11/11/91  03:00   ...  C:HELPME!.TSM
  1229.   001     4954     2554  49  11/11/91  03:00   ...  C:TCREF.TSM
  1230.   001   181453    59679  68  11/11/91  03:00   ...  C:UTIL.DOC
  1231.   001    12821     5792  55  11/11/91  03:00   ...  C:UTILS.PRF
  1232.   001    27891    13218  53  11/11/91  03:00   ...  C:UTILS.TD
  1233.   001    42382    15238  65  11/11/91  03:00   ...  C:WINMEM.DOC
  1234.   ---------------------------------------------------------------------------
  1235.   001   448051   179506  62% w/cluster-waste        00017 file(s) queued
  1236.       --------
  1237.       466,944 = DOS space used out of LambChop including cluster waste!
  1238.  
  1239.   /* end of output */
  1240.  
  1241.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved     26
  1242.  
  1243.  
  1244.   LambChop reflects the actual UnChopping procedure.  This allows you to view
  1245.   the destination of each file before LambChop actually begins UnChopping.
  1246.  
  1247.   Use  the  /W wait  option to  pause between  each full  page of  text while
  1248.   displaying a view command.
  1249.  
  1250.   The first column tells you which segment the file begins on.  LambChop will
  1251.   prompt you for this segment automatically when unchopping.
  1252.  
  1253.   The cluster  waste displayed  at the bottom  of the  view is the  amount of
  1254.   unused space on your  hard drive that each  DOS file takes up.   The larger
  1255.   the number of files you have,  the more cluster waste your DOS  system will
  1256.   require.   When  the files  are stored  in  a LambChop  volume, there  is a
  1257.   significant reduction in cluster waste.
  1258.  
  1259.  
  1260.   Wait (pause) delay: /W
  1261.   Wait will pause the  execution of LambChop at key  points to give the  user
  1262.   time to review the LambChop information. 
  1263.  
  1264.   If viewing a LambChop volume, "wait"  will pause between each full page  of
  1265.   text.
  1266.  
  1267.  
  1268.   Exclude file mask: /X<mask>
  1269.   Any  files you do  not want to  extract in the  UnChop procedure.   You may
  1270.   include wildcards (* or ?).  There is a maximum of 10 masks per UnChop.
  1271.  
  1272.   LC /U A:\TEMP *.* /x*.BAT /xTHISFILE.COM
  1273.   UnChop all files EXCEPT files with the .bat extension and the  THISFILE.COM
  1274.   program.
  1275.  
  1276.  
  1277.   Alternate work drive: /Z<drive-letter>
  1278.   Compression  temporary files  and  disk  swap files  need  the fastest  and
  1279.   largest disk  resources.  Usually,  this option would  be inserted in  your
  1280.   LAMBCHOP.CFG file with the appropriate drive.
  1281.  
  1282.   LC /U A:\TEMP *.* /zD
  1283.   All temporary  and swap files  will be created on  the D: drive  instead of
  1284.   your current drive.
  1285.  
  1286.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved     27
  1287.  
  1288.                           5. Configuration File Format
  1289.  
  1290.   What is a config file?
  1291.   A Configuration file  is a text file with the command line options and file
  1292.   names saved in an ASCII file format.
  1293.  
  1294.  
  1295.   Two types of config files:
  1296.   There are  two types of  config files,  the first is  the default,  and the
  1297.   second is the  custom.  The default  (LAMBCHOP.CFG) must be located  in the
  1298.   same directory  as LambChop and LambMenu.  Options  and files set here will
  1299.   be loaded every time LambChop or LambMenu is run.
  1300.   The second type  is the custom config file.   A custom config  file is only
  1301.   loaded when specified on the command line with a @ preceding the *.CFG file
  1302.   name (Ie. @FILE).
  1303.  
  1304.  
  1305.   If default LAMBCHOP.CFG was deleted:
  1306.   Simply run LM.EXE and select the 'Config - save as default' option from the
  1307.   main menu.
  1308.  
  1309.  
  1310.   Config file format:
  1311.   The rules  for the  config files are  the same  as the command  line except
  1312.   parameters are separated by a new line instead of a space.
  1313.  
  1314.   There  may  be only  one  custom  config file  per  Chopping or  UnChopping
  1315.   process.  You can not call a config file from a config file.
  1316.  
  1317.   When examining  a config file  that LambMenu  has generated  from the  save
  1318.   config file option,  you may  notice a //END  command within.   This is  an
  1319.   internal command  generated by LambMenu.   Beginners may wish  to skip this
  1320.   paragraph and jump to the 'Remarks (comments) section' below.
  1321.  
  1322.   Configuration files are loaded by placing a @ symbol in front of the config
  1323.   file name.  All  config files must end with a '.cfg'  extension, but you do
  1324.   not have  to include the  extension when loading  from the command  line or
  1325.   LambMenu.
  1326.  
  1327.  
  1328.   //END
  1329.   The //END command lets LambMenu know that  the end of the current operating
  1330.   mode (Chop or UnChop) has been reached.  By doing so, File name and command
  1331.   options for the current operating mode (Chop or UnChop) will remain intact,
  1332.   allowing the following files and command  options within the config file to
  1333.   be read into the toggled operating mode.
  1334.  
  1335.   If LambChop reaches an //END command in a config file, it is interpreted as
  1336.   the end of file.  The remainder of the config file will be ignored.
  1337.  
  1338.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved     28
  1339.  
  1340.   Remarks (comments) inside config files:
  1341.   You can remark a line by placing a semicolon in the first column.
  1342.   ; This line would be ignored in a config file.
  1343.  
  1344.  
  1345.   Command options and file name priority:
  1346.   It is important  to understand that there  are three methods of  entering a
  1347.   command into  LambChop and LambMenu.   The three methods  are: loading from
  1348.   the command line, loading from  the default config file (LAMBCHOP.CFG), and
  1349.   loading  from a  custom config file  (@*.CFG).  Remember  that LambChop and
  1350.   LambMenu accepts the first file name as the volume name, and all other file
  1351.   names after the first as the input/output file names. 
  1352.  
  1353.   Think  of the  commands and  filenames  being loaded  as one  long  list of
  1354.   parameters, starting first  with the command line, then  the default config
  1355.   file, and finally the custom config file.
  1356.  
  1357.   LambChop loads commands in the following order of priority:
  1358.     1   All files and options on the command line are loaded first.
  1359.     2   LAMBCHOP.CFG files and options are loaded next.
  1360.     3   @*.CFG files and options loaded last.
  1361.  
  1362.  
  1363.   Example..
  1364.   Write to the A:1201 volume.  Load the config file 'daily.cfg'.
  1365.   LC a:1201 @daily
  1366.  
  1367.   Assume that the default LAMBCHOP.CFG contains:
  1368.   --start file----------------------
  1369.   ; Turn tone off
  1370.   /T
  1371.   --end file------------------------
  1372.  
  1373.   Assume the daily.cfg contains:
  1374.   --start file----------------------
  1375.   ; copy all files
  1376.   *.BAT
  1377.   ; turn on error checking
  1378.   /E
  1379.   --end file------------------------
  1380.  
  1381.   The result will be read in and interpreted as:
  1382.   LC a:1201 /T *.BAT /E
  1383.  
  1384.   Notice how the  commands and files are  spread across the three  methods of
  1385.   entry.   The order in which each file  and command option is loaded is very
  1386.   important.
  1387.  
  1388.         LambChop v1.02  Copyright 1992, LambWare  All Rights Reserved     29
  1389.  
  1390.                                   6. ShareWare
  1391.  
  1392.  
  1393.   LambWare registration
  1394.   Run LM.EXE and select the 'Register' option from  the main menu.  Press the
  1395.   [F10 key] while your  printer is on-line (PRN:).  A  registration form will
  1396.   be sent to your printer.
  1397.  
  1398.   Alternatively, the file REGISTER.TXT contains a registration form which can
  1399.   be viewed or printed as well.
  1400.  
  1401.   To view from DOS to screen:
  1402.   'type register.txt'
  1403.  
  1404.   To print from DOS:
  1405.   'type register.txt > prn:'
  1406.  
  1407.  
  1408.   Technical support
  1409.   LambWare will provide technical support  to registered users only.  Support
  1410.   will  be  available  for  three  months after  the  date  of  registration.
  1411.   LambWare  will answer  questions and  fix serious  bugs during  the minimum
  1412.   three month period.  For problems involving a specific hardware or software
  1413.   environment or feature, LambWare may choose not  to modify the program.  In
  1414.   that case, if  a problem is  reported within three  months after  purchase,
  1415.   then LambWare shall offer to refund the user's purchase price.
  1416.  
  1417.   Technical support via US mail:
  1418.       LambWare
  1419.       6955 29th Terrace North
  1420.       St. Petersburg, FL  33710
  1421.  
  1422.   When contacting LambWare, please include the following information:
  1423.   * Registered serial number.
  1424.   * Technical support error number, line number, and description (if any).
  1425.   * Phone number where we may contact you.
  1426.  
  1427.  
  1428.   ASP Ombudsman
  1429.   This program is produced by a member of the Association of Shareware
  1430.   Professionals (ASP). ASP wants to make sure that the shareware principle
  1431.   works for you. If you are unable to resolve a shareware-related problem
  1432.   with an ASP member by contacting the member directly, ASP may be able to
  1433.   help. The ASP Ombudsman can help you resolve a dispute or problem with an
  1434.   ASP member, but does not provide technical support for members' products.
  1435.   Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442
  1436.   or send a CompuServe message via CompuServe Mail to ASP Ombudsman
  1437.   70007,3536.
  1438.  
  1439.