home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / util2 / sd60.lzh / VSN.DOC < prev   
Text File  |  1989-01-06  |  4KB  |  87 lines
  1. ------------------------------------------------------------------------
  2.  
  3.         VSN: Volume Serial Number Utility V1.0
  4.  
  5.          Copyright (C) 1989 By John F. Stetson
  6.  
  7.               All Rights Reserved
  8.  
  9. ------------------------------------------------------------------------
  10.  
  11. VSN.COM is utility program which is  used  to  manage  DOS  Disk  Volume
  12. Serial Numbers.  It operates on IBM-PC compatible computer systems using
  13. the IBM PC-DOS or Microsoft  MS-DOS  Operating    System    Version  2.0  or
  14. higher.
  15.  
  16. Disk Volume Serial Numbers were introduced with DOS 4.0.  When a disk is
  17. formatted by FORMAT or copied with  DISKCOPY,  an  8  digit  hexadecimal
  18. Volume Serial Number is automatically placed in the Boot Sector  of  the
  19. disk.  Subsequent execution of the  DOS  CHKDSK, DIR, LABEL, TREE or VOL
  20. command will cause the Volume Serial Number to    be  displayed.    However,
  21. no mechanism is provided for the user to create a specified VSN,  change
  22. an existing VSN, or to delete  an  existing  VSN.  The    VSN.COM  utility
  23. provides these functions.
  24.  
  25. Perhaps even more useful is its ability to perform these  functions  for
  26. disks formatted under ANY version of DOS from 2.0 through  4.0,  and  it
  27. can be executed under ANY version of DOS  from    2.0  through  4.0.  This
  28. greatly enhances the possible benefits of using Volume Serial Numbers.
  29.  
  30. The main reason for using Volume Serial Numbers is to establish a unique
  31. means of identifying a disk.  Disks may have identical Volume Labels  or
  32. even identical Directories, but may still contain different data.  Since
  33. DOS 4.0 forces the user to accept the VSN it selects for a disk, and the
  34. method used is based on the current  time,  each  VSN  will  be  unique.
  35. However, this means that the assigned VSN's follow  no  logical  pattern
  36. and are difficult to relate to one another.  The VSN utility retains the
  37. benefits of the concept, but allows the user to  establish  a  numbering
  38. scheme which can be used to form a disk cataloging sequence which  makes
  39. sense, and is compatible with the format used by DOS 4.0.
  40.  
  41. The DOS command line syntax is as follows:
  42.  
  43. VSN [drive:] [xxxx-xxxx] [/d]
  44.  
  45. where all parameters are optional.  If no parameters are specified, help
  46. information is displayed.  If a drive letter is specified,  the  current
  47. Volume Serial Number is displayed, or the user    is  informed  that  none
  48. exists.  If an 8 hexadecimal digit value is specified, the VSN    for  the
  49. specified drive is changed to  the  specified  value.  If  no  drive  is
  50. specified, the current drive is used.  VSN's are  always  specified  and
  51. displayed as 4 hex digits (0-9 or A-F), followed by a dash (-), followed
  52. by 4 hex digits.  The /d switch causes the current VSN for the specified
  53. drive to be deleted.
  54.  
  55. Error Messages
  56.  
  57. Unable to Read Disk Boot Sector - an error occurred when trying to  read
  58. the boot sector for the specified drive.
  59.  
  60. Unable to Locate System Boot Code - there was no jump instruction at the
  61. start of the boot sector for the specified drive.
  62.  
  63. Insufficient Room for Volume Serial Number - the  data    area  after  the
  64. jump instruction in the boot sector was too small to contain the VSN.
  65.  
  66. Unable to Write Disk Boot Sector - an  error  occurred    when  trying  to
  67. write the boot sector for the specified drive.
  68.  
  69. Status Messages
  70.  
  71. Drive D: Has No Disk Volume Serial Number
  72. Drive D: Old Disk Volume Serial Number is: XXXX-XXXX
  73. Drive D: New Disk Volume Serial Number is: XXXX-XXXX
  74. Drive D: Volume Serial Number Deleted
  75.  
  76. Examples of Use
  77.  
  78. VSN C: - display the VSN (if any) for drive C:
  79.  
  80. VSN C: 0001-0002 - create or change the VSN for drive C:
  81.  
  82. VSN A: 1989-0001 - create or change the VSN for drive A:
  83.  
  84. VSN C: /D - delete the VSN for drive C:
  85.  
  86. ------------------------------------------------------------------------
  87.