home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR4 / DMS10.ZIP / DMS10.DOC < prev    next >
Text File  |  1993-12-27  |  22KB  |  640 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                     ▒▒▒▒▒▄  ▒▒▒▄▄▒▒▒▄ ▒▒▒▒▒▒▄
  9.                     ▒▒█▀▒▒█ ▒▒█▒▒█▒▒█ ▒▒█▀▀▀▀
  10.                     ▒▒█ ▒▒█ ▒▒█ ▀▀▒▒█ ▒▒▒▒▒▒▄
  11.                     ▒▒█ ▒▒█ ▒▒█   ▒▒█  ▀▀▀▒▒█
  12.                     ▒▒▒▒▒█▀ ▒▒█   ▒▒█ ▒▒▒▒▒▒█
  13.                      ▀▀▀▀▀   ▀▀    ▀▀  ▀▀▀▀▀▀
  14.  
  15.  
  16.  
  17.                           Disk Management System
  18.                                 Version 1.0
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.                                  Jay Brown
  41.                                 BC Systems
  42.                                 7801 Dublin
  43.                             Wichita, KS  67206
  44.                                     USA
  45.  
  46.                               CIS: 73171,2442
  47.  
  48.  
  49.  
  50.  
  51.  
  52.                         Copyright 1993 by Jay Brown
  53.                        All rights reserved worldwide
  54.                                  Contents
  55.  
  56. Chapter 1 - General Information .............................. 1
  57.      Product Overview ........................................ 1
  58.      Shareware Marketing Concept ............................. 1
  59.      Software Use Agreement  ................................. 2
  60.      Registration Information ................................ 3
  61.      Distribution Files  ..................................... 3
  62.      Installation Procedure .................................. 4
  63.  
  64. Chapter 2 - Volume Operations ................................ 5
  65.      Cataloging a Disk Volume ................................ 5
  66.      Scratching a Volume ..................................... 5
  67.      Listing Volumes and Free Space .......................... 6
  68.  
  69. Chapter 3 - Groups ........................................... 7
  70.      Adding or Modifying a Group ............................. 7
  71.      Listing Groups .......................................... 7
  72.  
  73. Chapter 4 - File Operations .................................. 8
  74.      Adding or Moving a File ................................. 8
  75.      Deleting a File ......................................... 8
  76.      Updating the File Description ........................... 9
  77.      Updating the Group Assignment ........................... 9
  78.      Exporting the Catalog ................................... 9
  79.  
  80. Chapter 5 - Reporting ........................................ 10
  81.      Report by File Name ..................................... 10
  82.      Report by Group ......................................... 10
  83.      Report by Description  .................................. 11
  84.      Report by Volume ........................................ 11
  85.      Report Unassigned Group ................................. 11
  86.  
  87. Chapter 6 - DMSIMP Utility ................................... 12
  88.  
  89. Chapter 7 - XDESC Utility .................................... 13
  90.  
  91.                                  Chapter 1
  92.                             General Information
  93.  
  94.  
  95. Product Overview 
  96.  
  97. DMS can help you organize your files and diskettes.  The following
  98. features set DMS apart from other disk cataloging software:  
  99.  
  100.    - Ease of use
  101.    - Command line interface
  102.    - Uses 4DOS descriptions if available
  103.    - Optionally assigns categories to files
  104.    - Generates reports based on filename, description, category or
  105.      volume
  106.    - Ability to move/copy files to free space on cataloged volumes
  107.    - A low registration cost of $15 US
  108.  
  109. A typical user will catalog a set of floppy diskettes, or volumes,
  110. by typing 
  111.  
  112.                DMS -c
  113.  
  114. at the DOS prompt.  Each volume must first be labeled with the DOS
  115. label command, and inserted into the disk drive.  To quickly find
  116. a file contained by one of these volumes, the user will type 
  117.  
  118.                DMS filename
  119.  
  120. The filename may contain DOS wildcards.  DMS will then report all
  121. matching files and their volume label.  To add a file to one of the
  122. cataloged volumes, simply type 
  123.  
  124.                DMS -a filename
  125.  
  126. DMS will select the first volume with sufficient space to hold the
  127. file or files and prompt for insertion of the disk.  To generate a
  128. full catalog report by filename and send the report to the printer,
  129. the user will type 
  130.  
  131.                DMS -r >prn
  132.  
  133. A summary of command options is presented if you type 
  134.  
  135.                DMS
  136.  
  137. without any arguments.  That's all there is to it, Have Fun!!  
  138.  
  139.  
  140. Shareware Marketing Concept
  141.  
  142. Shareware distribution gives users a chance to try software before
  143. buying it.  If you try a Shareware program and continue using it,
  144. you are expected to register.  Individual programs differ on
  145. details -- some request registration while others require it, some
  146. specify a maximum trial period.  With registration, you get
  147. anything from the simple right to continue using the software to an
  148. updated program with printed manual.
  149.  
  150. Copyright laws apply to both Shareware and commercial software, and
  151. the copyright holder retains all rights, with a few specific
  152. exceptions as stated below.  Shareware authors are accomplished
  153. programmers, just like commercial authors, and the programs are of
  154. comparable quality.  (In both cases, there are good programs and
  155. bad ones!) The main difference is in the method of distribution. 
  156. The author specifically grants the right to copy and distribute the
  157. software, either to all and sundry or to a specific group.  For
  158. example, some authors require written permission before a
  159. commercial disk vendor may copy their Shareware.
  160.  
  161. Shareware is a distribution method, not a type of software.  You
  162. should find software that suits your needs and pocketbook, whether
  163. it's commercial or Shareware.  The Shareware system makes fitting
  164. your needs easier, because you can try before you buy.  And because
  165. the overhead is low, prices are low also.  Shareware has the
  166. ultimate money-back guarantee -- if you don't use the product, you
  167. don't pay for it.
  168.  
  169.  
  170. Software Use Agreement
  171.  
  172. Users of DMS must accept this disclaimer of warranty:  "DMS is
  173. supplied as is.  The author disclaims all warranties, expressed or
  174. implied, including, without limitation, the warranties of
  175. merchantability and of fitness for any purpose.  The author assumes
  176. no liability for damages, direct or consequential, which may result
  177. from the use of DMS."
  178.  
  179. DMS is a "shareware program" and is provided at no charge to the
  180. user for evaluation.  Feel free to share it with your friends, but
  181. please do not give it away altered or as part of another system. 
  182. The essence of "user-supported" software is to provide personal
  183. computer users with quality software without high prices, and yet
  184. to provide incentive for programmers to continue to develop new
  185. products.  If you find this program useful and find that you are
  186. using DMS and continue to use DMS after a reasonable trial period
  187. of 30 days, you must make a registration payment of $15 to Jay
  188. Brown.  The $15 registration fee will license one copy for use on
  189. any one computer at any one time.  You must treat this software
  190. just like a book.  An example is that this software may be used by
  191. any number of people and may be freely moved from one computer
  192. location to another, so long as there is no possibility of it being
  193. used at one location while it's being used at another.  Just as a
  194. book cannot be read by two different persons at the same time.
  195.  
  196. Anyone distributing DMS for any kind of remuneration must first
  197. contact Jay Brown at the address above for authorization.  This
  198. authorization will be automatically granted to distributors
  199. recognized by the (ASP) as adhering to its guidelines for shareware
  200. distributors, and such distributors may begin offering DMS
  201. immediately (However Jay Brown must still be advised so that the
  202. distributor can be kept up-to-date with the latest version of
  203. DMS.).
  204.  
  205. You are encouraged to pass a copy of DMS along to your friends for
  206. evaluation.  Please encourage them to register their copy if they
  207. find that they can use it.  
  208.  
  209.  
  210. Registration Information
  211.  
  212. Simply print and fill out the order form supplied as file
  213. "ORDFORM.TXT".  Send it and a $15 check or money order, drawn for
  214. US funds, and made payable to Jay Brown.
  215.  
  216. You will receive free technical support by US Mail or E-Mail,
  217. Notice of future revisions, a printed copy of this documentation,
  218. and a license number.  This activation number, in conjunction with
  219. your registration name, can be used to disable the shareware
  220. notices.  Your number will be valid for all future releases of DMS. 
  221. To enter your license number, once received, simply type the
  222. command:
  223.  
  224.                DMS -L
  225.  
  226. You will be prompted for your name and activation number.  You must
  227. enter your name exactly as it appears on the license confirmation
  228. letter.
  229.  
  230. You may NOT distribute a licensed copy of DMS.  Your name is
  231. displayed when the "DMS" command is issued without arguments.
  232.  
  233.  
  234. Distribution Files
  235.  
  236. dms.exe        Disk Management System executable
  237. dmsimp.exe     Database import utility
  238. dms.dbd        Database dictionary
  239. file_id.diz    Software description
  240. desc.sdi       Software description
  241. xdesc.exe      4DOS automatic description utility
  242. dms10.doc      Documentation text file
  243. descript.ion   4DOS file descriptions
  244. ordform.txt    DMS order form
  245.  
  246.  
  247. Installation Procedure
  248.  
  249. Installation of DMS is much like any other software package.  Refer
  250. to your DOS manual if you have any questions about modifying your
  251. PATH, setting environment variables or creating directories.
  252.  
  253.   1. Create a directory of your choice.
  254.  
  255.   2. Copy the executables and database dictionary to the directory
  256.      you have just created.  
  257.  
  258.   3. Add the directory to your PATH.  This is necessary if you wish
  259.      to run DMS outside of it's directory.  The PATH is used by DOS
  260.      to find the executable and by DMS to find it's database.
  261.  
  262.   4. If your floppy drive is not drive A, then set the DMSDRIVE
  263.      environment variable.  This can be done in your AUTOEXEC.BAT
  264.      file similar to how the PATH is set (e.g. SET DMSDRIVE=B).
  265.  
  266.  
  267.                                  Chapter 2
  268.                              Volume Operations
  269.  
  270.  
  271. Cataloging a Disk Volume
  272.  
  273. A new diskette can be added to the catalog with the command
  274.  
  275.                DMS -C
  276.  
  277. The diskette must first be placed in the DMSDRIVE.  The default
  278. drive is "A".  However, to utilize another drive, simply set the
  279. DMSDRIVE environment variable.  For example, if you are using drive
  280. "B" for your catalog activities, issue the following DOS command: 
  281. "SET DMSDRIVE=B".  This command may be added to your AUTOEXEC.BAT
  282. file.
  283.  
  284. The diskette you are cataloging must also have a DOS label.  This
  285. label must uniquely identify the diskette among your other
  286. cataloged disks.  For example, to label your disk as "SHARE0001",
  287. simply issue the DOS command "label a:", assuming your DMSDRIVE is
  288. "A", and respond with "SHARE0001" when asked for the label.  You
  289. may use up to eleven characters.
  290.  
  291. If the files on the diskette have 4DOS descriptions, these
  292. descriptions will be stored in the catalog.  Refer to the 4DOS
  293. "describe" command or the XDESC utility in Chapter 7.
  294.  
  295. Each file on the diskette may also be associated with a group or
  296. category of files.  The group numbers must have already been setup,
  297. refer to Chapter 3 for a discussion on using groups.  The 4DOS
  298. description may optionally specify the file's associated group. 
  299. This is done by placing the group number followed by a slash as the
  300. first part of the file's description.  For example,
  301.  
  302.           PANELC24.ZIP  2/Panels for C user interface
  303.  
  304.  
  305. indicates the file "PANELC24.ZIP" should belong to group number 2,
  306. and it's description should be "Panels for C user interface.
  307.  
  308.  
  309. Scratching a Volume
  310.  
  311. To remove a volume or diskette from the catalog, simply issue the
  312. command
  313.  
  314.                DMS -S SHARE0001
  315.  
  316. This command will remove the volume SHARE0001 from the catalog
  317. along with all the file entries contained by the volume.  This
  318. command will not alter the actual contents of the diskette.  It
  319. will only uncatalog the diskette.
  320.  
  321.  
  322. Listing Volumes and Free Space
  323.  
  324. The command 
  325.  
  326.                DMS -V
  327.  
  328. will list to stdout all the volumes that have been previously
  329. cataloged.  This command will also display the free space (in
  330. bytes) on each volume.  This information can be easily printed with
  331.  
  332.                DMS -V >PRN
  333.  
  334. or redirected to a text file, refer to your DOS manual.
  335.                                  Chapter 3
  336.                                   Groups
  337.  
  338. Groups allow you to categorize your files without regard to the
  339. volumes they are contained.  A group consists of a number and a
  340. name and associated catalog files.  You may have up to 999 groups.
  341.  
  342. Adding or Modifying a Group
  343.  
  344. The command 
  345.  
  346.                DMS -G3
  347.  
  348. will allow you to add group number three, if it does not already
  349. exist.  Otherwise, it will allow you to modify the group name.
  350.  
  351.  
  352. Listing Groups
  353.  
  354. The command
  355.  
  356.                DMS -G  or DMS -GN
  357.  
  358. will list all the defined groups by group number.  Output from this
  359. command might look like this:
  360.  
  361.     1  Archivers
  362.     2  BBS Software
  363.     3  Business
  364.     4  DOS Shells/Menus
  365.     5  Educational
  366.     6  Utilities
  367.     7  Ham Radio
  368.     8  Household
  369.     9  OS/2
  370.    10  Programming
  371.    11  Windows
  372.    12  Database
  373.    13  Clip Art
  374.    14  Security
  375.    15  Telecommunications
  376.    16  Graphics
  377.    17  Misc.
  378.    18  Fonts and Managers
  379.  
  380.  
  381. Also, the command
  382.  
  383.                DMS -GD
  384.  
  385. will list all the defined groups by group name, or description.                                  Chapter 4
  386.                               File Operations
  387.  
  388. Adding or Moving a File
  389.  
  390. A file may be copied or moved onto the catalog disk set.  These
  391. operations will physically copy/move the specified file to a
  392. cataloged diskette with enough space to hold the file.  The move
  393. operation will delete the specified file after successfully copying
  394. it to a cataloged disk.  Upon successful copy/move the catalog
  395. database is updated to reflect the new file name, description,
  396. group, etc.  The volume free space is also updated.
  397.  
  398. For example, 
  399.  
  400.                DMS -A PANELC24.ZIP
  401.  
  402. will search for a cataloged volume with enough space to hold the
  403. file, prompt you to insert the volume, and perform the copy.  The
  404. 4DOS description is used to update the catalog information about
  405. this new file, if available.
  406.  
  407.                DMS -M ABC110.ZIP
  408.  
  409. will perform the same steps as the previous example, in addition to
  410. removing the file after the copy is performed.
  411.  
  412.                DMS -A3 AB*.ZIP PANELC*.*
  413.  
  414. This example illustrates the use of wildcards.  Also, the newly
  415. cataloged files will be associated with group number 3.  The group
  416. association may also be specified within the 4DOS description as
  417. follows:
  418.  
  419.      DESCRIBE PANELC24.ZIP "4/Panels for C user interface"
  420.  
  421. This would indicate PANELC24.ZIP belongs to group number 4 while
  422. all other files matching the wildcards belong to group 3.
  423.  
  424. Deleting a File
  425.  
  426. A file may be physically removed from its associated volume by
  427. issuing the "-d" option.  Wildcards are also permitted.  The
  428. catalog database is updated to reflect the deleted files.  For
  429. example,
  430.  
  431.                DMS -D ABC110.ZIP
  432.  
  433. will search the catalog database for the file, remove the database
  434. entry, prompt for insertion of the appropriate volume and delete
  435. the file from the inserted diskette, if actually present.
  436.  
  437.  
  438. Updating the File Description
  439.  
  440. File descriptions may be updated within the catalog database.  This
  441. option does not alter the 4DOS description.
  442.  
  443. For example,
  444.  
  445.                DMS -P"Accounting file" AB*.*
  446.  
  447. will update all cataloged files beginning with "AB" to have the
  448. description of "Accounting file".
  449.  
  450.  
  451. Updating the File Group Assignment
  452.  
  453. Files may be assigned or reassigned to groups within the catalog
  454. database.
  455.  
  456. For example, 
  457.  
  458.                DMS -5 AB*.*
  459.  
  460. will update all cataloged files beginning with "AB" to be
  461. associated with group number 5, regardless of their previous
  462. association.
  463.  
  464.  
  465. Exporting the Catalog
  466.  
  467. A command option is available allowing exportation of all file
  468. information in String Delimited Format (SDF).  This is useful if
  469. you wish to import the disk catalog into a spreadsheet, or other
  470. software product.
  471.  
  472.                DMS -E >FILES.SDF
  473.  
  474. This will essentially dump the catalog database to the file
  475. "FILES.SDF".  The fields on each line are as follows:  file name,
  476. size, date, time, attributes, description, volume label, volume
  477. free space, group number, and group name.
  478.                                  Chapter 5
  479.                                  Reporting
  480.  
  481.  
  482. Report by File Name
  483.  
  484. The command 
  485.  
  486.                DMS -R or DMS -RF
  487.  
  488. may be issued to list all files in the catalog, sorted by filename. 
  489. The following is an example of how this report might look:
  490.  
  491. 200ICONS.ZIP    41160  01/16/92  ---  Icons for Windows
  492. 2DOV10.ZIP     812625  04/26/93   11  To-do task manager
  493. 4DMENU11.ZIP     9472  10/28/92  ---  
  494. 4DOS401D.ZIP   258944  10/27/92  ---  
  495. 4DOS401P.ZIP   289920  10/27/92  ---  
  496. 4EDIT105.ZIP    33280  10/28/92  ---  
  497. 4MICA25A.ZIP    12288  03/22/93  ---  
  498. 4OS210.ZIP     255232  10/28/92  ---  
  499. 4PROMPT.ZIP      6784  10/27/92  ---  
  500. 4WIN110.ZIP     39789  07/04/91   11  4-DOS like shell for Windows
  501.  
  502. Also listed are the file size, file date, group number (if
  503. assigned) and file description.
  504.  
  505.  
  506. Report by Group
  507.  
  508. The command 
  509.  
  510.                DMS -RG
  511.  
  512. may be used to list all files in the catalog which are associated
  513. with a group.  The following is an example of how this report might
  514. look:
  515.  
  516. Archivers
  517. ---------------------------------------
  518. AM97.ZIP       219108  10/23/93  ArcMaster V9.5
  519. SHEZ94.ZIP     252170  10/14/93  SHEZ V9.4 Compression Shell
  520.  
  521. BBS Software
  522. ---------------------------------------
  523. BIN2ASC1.ZIP    16647  11/02/93  Convert binary to text
  524. CQWK110A.ZIP   391223  11/02/93  Windows offline mail reader #1
  525. CQWK110B.ZIP   404221  11/02/93  Windows offline mail reader #2
  526. SLMR21A.ZIP    160065  11/10/93  Silly Little Mail Reader
  527.  
  528.  
  529. Report by Description
  530.  
  531. The command
  532.  
  533.                DMS -RP
  534.  
  535. may be used to report all files sorted by description prose.  An
  536. example might look like this:
  537.  
  538. 4-DOS like shell for Windows              4WIN110.ZIP     39789  07/04/91
  539. 4DOS aware zip and unzip utility          ZIP4.ZIP        51238  11/22/93
  540. 4DOS front-end for ROBOCOMM               AUTOROB2.ZIP     7484  11/03/93
  541. Address manager for windows               ADR11B.ZIP     222411  03/05/93
  542. Antique font for Windows                  ANTIQUE.ZIP     37724  01/14/91
  543. Archive shell                             SHEZ90A.ZIP    234112  06/08/93
  544. ArcMaster V9.5                            AM97.ZIP       219108  10/23/93
  545.  
  546.  
  547. Report by Volume
  548.  
  549. The command 
  550.  
  551.                DMS -RV
  552.  
  553. will report all files in the catalog sorted by volume label.  An
  554. example follows:
  555.  
  556. SHARE0001
  557. -----------
  558. AC44A0.ZIP      61195  10/20/91  Painless accounting for Windows #1 of 2
  559. DIARY.ZIP       37632  04/14/90  
  560. SLM.ZIP         35461  04/05/92  Shopping list manager
  561.  
  562. SHARE0002
  563. -----------
  564. DRAGVIEW.ZIP   259705  08/05/93  Drag and View for Windows
  565. TDRAWFNT.ZIP    17048  11/09/93  Fonts for THEDRAW
  566. WPGR.ZIP       928256  06/29/93  WPG clip art
  567.  
  568.  
  569. Report Unassigned Group
  570.  
  571. The command
  572.  
  573.                DMS -RU
  574.  
  575. will list for you all the catalog files not assigned to a group. 
  576. An example follows:
  577.  
  578. 200ICONS.ZIP    41160  01/16/92  Icons for Windows
  579. AGWP-P.ZIP      34807  03/21/93  Wet Paint font for Windows
  580. ANSIDR30.ZIP    22272  07/11/90  
  581. ANTIQUE.ZIP     37724  01/14/91  Antique font for Windows
  582. BDSK22.ZIP      57922  01/16/92  
  583. BEAV120.ZIP     70016  11/02/92  Binary editor and viewer
  584. BTOOL1.ZIP     132352  11/04/92  C library for BTrieve access
  585.                                  Chapter 6
  586.                               DMSIMP Utility
  587.  
  588. The DMSIMP utility is basically the opposite of the export command
  589. option.  This utility program may be used to recreate your catalog
  590. database from an export file, combine multiple databases, or
  591. populate the catalog database created from some other software
  592. product.  The format must match that generated from the export
  593. command option.  For example,
  594.  
  595.                DMSIMP FILES.SDF
  596.  
  597. will import the files specified within the file "FILES.SDF" into
  598. the catalog database.  The file must contain valid String Delimited
  599. Format (SDF) records.  The fields are as follows:  file name, size,
  600. date, time, attributes, description, volume label, volume free
  601. space, group number, group name.  Information within the database
  602. will not be removed.
  603.  
  604. To first clear the contents of your catalog database, simply delete
  605. all data and index files from your DMS directory.  The following
  606. DOS command may be used:
  607.  
  608.                DEL DMS0*.*
  609.                                  Chapter 7
  610.                                XDESC Utility
  611.  
  612. A utility is included to automattically populate the 4DOS
  613. description for ZIP files.  Shareware authors usually include
  614. either "FILE_ID.DIZ" or "DESC.SDI" within their distribution
  615. archives.  These files, if present, are utilized to describe the
  616. archive file.  If neither of these files is found within the
  617. archive, a ROBOCOMM comment is utilized, if available.  When the
  618. ROBOCOMM software system is used to obtain the archive file, an
  619. archive comment may have been inserted.
  620.  
  621. The command line format is as follows:
  622.  
  623.                XDESC [-S] [-Gn] FILE1 [FILE2 ...]
  624.  
  625. The "-S" option is used to create short descriptions, as needed by
  626. DMS.  The "-G" option may be used to include a group number within
  627. the description.  The files may be specified using wildcards.  If
  628. a file is already described, it will be skipped.  A file will not
  629. be re-described by this utility.
  630.  
  631.  
  632. For example,
  633.  
  634.                XDESC -S -G2 *.ZIP
  635.  
  636. will create 4DOS descriptions for all ZIP files in the current
  637. directory, which do not already have descriptions.  The description
  638. will be limited to 40 characters due to the "-S" option.  A "2/"
  639. will be included in each description.
  640.