home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / DISK / MULTVOL1.ZIP / VOLUME.DOC next >
Encoding:
Text File  |  1992-01-14  |  6.3 KB  |  190 lines
  1.  
  2.  
  3. ********************************************************************************
  4. 16:14:48  01/14/92                                                     Page 1   
  5.                      T O O L Z   D O C U M E N T A T I O N                      
  6.                                   V O L U M E                                   
  7. ********************************************************************************
  8.  
  9.  
  10. o MODULE NAME
  11.  
  12.    VOLUME
  13.  
  14. o LIBRARY NAME
  15.  
  16.    TOOLZ
  17.  
  18. o TYPE
  19.  
  20.    PROGRAM
  21.  
  22. o QUICK DESCRIPTION
  23.  
  24.    Store/retrieve a large file on several volumes
  25.  
  26. o ARGUMENT DESCRIPTION
  27.  
  28.    volume /i <volume name> ["/p=<command>[,del]"]
  29.    volume /o <volume name> <input file> ["/p=<command>[,del]"]
  30.  
  31. o NARRATIVE DESCRIPTION
  32.  
  33.    The VOLUME utility writes a file to an output device, and breaks the
  34.    file into multiple volumes if the file size exceeds the capacity of
  35.    the output device.  VOLUME also reads an volume from a device, and
  36.    the volume may be contained on multiple removable media.  The volume
  37.    name must be specified without an extension as VOLUME will append an
  38.    extension to indicate the volume number.
  39.  
  40.    VOLUME does not archive or compress files, but it will call your
  41.    favorite archiver or compress program for you.
  42.  
  43.    Output mode:
  44.  
  45.       If any files are contained on the removable media, they will not
  46.       be affected in any way.  VOLUME uses the DOS file system on the
  47.       media instead of raw data transfer, allowing the storage of
  48.       other files on the media.
  49.  
  50.       The first volume will contain the files, <name>.0 and <name>.1,
  51.       where <name> is the name you have chosen for the volume.  The
  52.       next volume will contain <name>.2, and so forth.  The last
  53.       volume will contain <name>.n and <name>, where n is the last
  54.       volume number and <name> is an empty file signifying that this
  55.       volume contains the last piece of the file.
  56.  
  57.       If a preprocessor command option (/p) is specified, then the
  58.       specified "command" will be executed (usually an archiver) before the
  59.  
  60.  
  61. ********************************************************************************
  62.               T O O L Z   M o d u l e   D o c u m e n t a t i o n               
  63. ********************************************************************************
  64.  
  65.  
  66. ********************************************************************************
  67. 16:14:48  01/14/92                                                     Page 2   
  68.                      T O O L Z   D O C U M E N T A T I O N                      
  69.                                   V O L U M E                                   
  70. ********************************************************************************
  71.  
  72.  
  73.       volume creation is commenced.  If the ",del" option is added to the
  74.       postprocessor option, the input file will be deleted upon
  75.       successful completion of "command."  The /p option argument should be
  76.       quoted to preserve any spaces embedded in "command."
  77.  
  78.    Input mode:
  79.  
  80.       The volumes need to be read in the order they were created.
  81.  
  82.    If a postprocessor command option (/p) is specified, then the
  83.    specified "command" will be executed (usually a de-arhiver) after the
  84.    volumes are read.  If the ",del" option is added to the postprocessor
  85.    option, the input file (as restored to the current directory) will be
  86.    deleted upon successful completion of "command."  The /p option
  87.    argument should be quoted to preserve any spaces embedded in
  88.    "command."
  89.  
  90.  
  91. o RETURNS
  92.  
  93.    EXITWARN if volume is prematurely aborted, EXITNORMAL otherwise.
  94.  
  95. o APPLICATIONS
  96.  
  97.    UTILITY
  98.  
  99. o PLATFORMS
  100.  
  101.    MSDOS
  102.  
  103. o REVISIONS
  104.  
  105.    1/14/92
  106.    Add postprocess and preprocess options.
  107.  
  108. o FIXES
  109.  
  110.    5/23/91
  111.    Improve documentation
  112.    9/12/91
  113.    Restoration (/i) was previously attempted with original full path
  114.    of file.  Path is now removed.
  115.  
  116. o SOURCE LANGUAGE
  117.  
  118.    C
  119.  
  120. o EXAMPLE(S)
  121.  
  122.  
  123.  
  124. ********************************************************************************
  125.               T O O L Z   M o d u l e   D o c u m e n t a t i o n               
  126. ********************************************************************************
  127.  
  128.  
  129. ********************************************************************************
  130. 16:14:48  01/14/92                                                     Page 3   
  131.                      T O O L Z   D O C U M E N T A T I O N                      
  132.                                   V O L U M E                                   
  133. ********************************************************************************
  134.  
  135.  
  136.    volume /o a:filearc files.zip
  137.    volume /i a:filearc
  138.    volume /o b:fred bruce.zip "/p=pkzip bruce.zip c:\source\*.c,del"
  139.    volume /i b:fred "/p=pkunzip bruce.zip,del"
  140.  
  141. o NOTICE
  142.  
  143.    Copyright 1991 Software Toolz, Inc. - Atlanta, Georgia
  144.  
  145.    All rights reserved worldwide.  This program may not be reproduced,
  146.    transmitted, transcribed, stored in a retrieval system or translated in
  147.    any human or computer language, in any form without the express written
  148.    permission of Software Toolz, Inc.
  149.  
  150.    Software Toolz also publishes FILEZ, an excellent binary file editor.
  151.    It is available for $19.95 plus shipping and handling, and this
  152.    includes a printed user manual.  Call or write Software Toolz for a
  153.    FILEZ brochure.  A un-licensed shareware version of FILEZ is also
  154.    available for download from numerous sources.
  155.  
  156.    You are invited to evaluate DOCZ(tm), the code documentation
  157.    automation facility for MSDOS and UNIX.  DOCZ works with all computer
  158.    languages, and it builds reference manuals and on-line documentation
  159.    for software modules with documentation imbedded in the source code.
  160.    Call or write Software Toolz for the FREE MSDOS demo version and
  161.    DOCZ brochure.
  162.  
  163.    Software Toolz, Inc.
  164.    8030 Pooles Mill Dr.
  165.    Ball Ground, GA 30107-9610
  166.    Voice-mail:  (800) 869-3878
  167.    (404) 889-8264
  168.    Area Code 404 will be changed to 706 on 3 May 1992
  169.    Internet:  software%toolz.uucp@mathcs.emory.edu
  170.  
  171. o INTRODUCTION DATE
  172.  
  173.    05/14/91
  174.  
  175. o LAST FILE UPDATE
  176.  
  177.    01/14/92 16:05:16 -- volume.c
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187. ********************************************************************************
  188.               T O O L Z   M o d u l e   D o c u m e n t a t i o n               
  189. ********************************************************************************
  190.