home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / BATCH / DPV12.ZIP / DPV12.DOC < prev    next >
Encoding:
Text File  |  1990-12-08  |  5.2 KB  |  263 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                    User's Manual for DPV - Drive Path Volume
  20.  
  21.                                 DPV version 1.2
  22.                                December 8, 1990
  23.  
  24.                        Copyright 1990, Sydney M. Willett
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                     - 1 -
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.                                TABLE OF CONTENTS
  85.  
  86.  
  87.  
  88.     TABLE OF CONTENTS ...................................... 2
  89.  
  90. 1.  DESCRIPTION ............................................ 3
  91.  
  92. 2.  DISTRIBUTION POLICY .................................... 3
  93.  
  94. 3.  OPERATION .............................................. 3
  95.  
  96.     a.  GENERAL ............................................ 3
  97.  
  98.     b.  COMMAND LINE PARAMETERS ............................ 3
  99.  
  100.     c.  EXAMPLES ........................................... 4
  101.  
  102. 4.  ERRORLEVEL CODE MEANINGS ............................... 4
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                     - 2 -
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138. 1.  DESCRIPTION.
  139.  
  140.     a.  DPV (an acronym for Drive Path Volume) checks if a drive exists, if a
  141. diskette is inserted in a floppy drive, if a path exists, or if a volume label
  142. matches.  DPV returns errorlevels describing the success or failure of the
  143. requested operation.  These errorlevels can be used in batch files to automate
  144. directory searches, checks for unformatted diskettes, proper diskettes
  145. inserted in drives, etc.
  146.  
  147.     b.  DPV has been successfully tested with several computers using
  148. different versions of MS-DOS.  I only used MS-DOS interrupts which are
  149. compatible with MS-DOS versions 2.X and later.
  150.  
  151.  
  152. 2.  DISTRIBUTION POLICY.
  153.  
  154.     a.  DPV is hereby freely given to the Public Domain.  No fee is to be
  155. charged for its use.
  156.  
  157.     b.  DPV is released "as is" with no implied warranty or guarantees.  The
  158. author assumes no responsibility for any claims of damage incurred with the
  159. use of this program.
  160.  
  161.     c.  DPV is to be distributed with the following files:
  162.  
  163.         DPV.C           C source code
  164.         DPV.EXE         Executable program
  165.         DPV12.DOC       This manual
  166.         TEST.BAT        A simple batch file to display DPV errorlevel returns
  167.  
  168.  
  169. 3.  OPERATION.
  170.  
  171.     a.  GENERAL.
  172.  
  173.         (1)  DPV.EXE must be either in the current directory or in the DOS
  174. path.
  175.  
  176.          (2)  DPV is essentially useless when executed from the DOS prompt. 
  177. You won't see any visible results.  DPV returns errorlevel codes which are
  178. used in a batch file.
  179.  
  180.         (3)  If a drive check fails, then any path or volume label checks will
  181. not be performed.
  182.  
  183.     b.  COMMAND LINE PARAMETERS.
  184.  
  185.         (1)  DPV is executed with the following command line parameters:
  186.  
  187.              DPV [drive:][path] [/Vvolume]
  188.  
  189.              drive:    logical drive letter
  190.              path:     path (preceding \ searches from root
  191.              /Vvolume  volume label for search
  192.  
  193.  
  194.  
  195.  
  196.                                     - 3 -
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.         (2)  drive:    The logical drive letter (A, B, C, D, etc.)  DPV will
  205. detect floppy drives, hard disks, and ramdisks.  (Should detect network
  206. drives, but I didn't have access to a networked machine to verify.)  Absence
  207. of a drive letter instructs DPV to use the current drive.
  208.  
  209.         (3)  path:     A path preceded by a '\' is a full path name.  A path
  210. not preceded by a '\' is appended to the current directory.  The full path
  211. name is limited to 80 characters.
  212.  
  213.         (4) /Vvolume:  /V tells DPV all of the following characters and spaces
  214. is a volume label.  For this reason, the /V switch and the volume name must be
  215. the final command line argument.  The volume label can be eleven characters
  216. long (including spaces.)  Any characters more than eleven are ignored.
  217.  
  218.         (5)  At least one parameter must be given.  If no parameter is given,
  219. or an invalid parameter is given, a help screen will be displayed and
  220. errorlevel 7 returned.
  221.  
  222.     c.  EXAMPLES.
  223.  
  224.         DPV a:                      Checks drive A:
  225.  
  226.         DPV work                    Checks current directory for a sub-
  227.                                     directory named \WORK
  228.  
  229.         DPV \ws\work                Checks current drive for directory named
  230.                                     \WS\WORK
  231.  
  232.         DPV a:\ws\work              Checks drive A: for directory named
  233.                                     \WS\WORK
  234.  
  235.         DPV a: /vwork disk          Checks drive A: for volume label WORK DISK
  236.  
  237.         DPV a:\ws\work /vwork disk  Checks drive A: for directory named
  238.                                     \WS\WORK and volume label WORK DISK
  239.  
  240.  
  241. 4.  ERRORLEVEL CODE MEANINGS.
  242.  
  243.     Code     Meaning
  244.     ----     -------
  245.       0      disk in drive okay, 
  246.              and/or subdirectory exists, 
  247.              and/or volume label matches
  248.       1      volume label doesn't match
  249.       2      invalid path
  250.       3      both volume label doesn't match and invalid path
  251.       4      invalid drive letter
  252.       5      no diskette in drive
  253.       6      unformatted diskette in drive
  254.       7      invalid or no parameter(s)
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                                     - 4 -
  263.