home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / database / wssi527b.zip / WSSI527.DOC < prev   
Text File  |  1993-06-06  |  247KB  |  6,403 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                              Wssindex
  9.  
  10.                       Disk Indexing Software
  11.  
  12.                   Version 5.27 for MS/PC-DOS and
  13.        Wssindex/Extended Version 5.27 for AT Class Machines
  14.  
  15.  
  16.         Programs and documentation copyright (c) 1985-1993
  17.            by Robert W. Babcock and WSS Division of DDC
  18.                        All Rights Reserved
  19.  
  20.  
  21.                       +-------+
  22.                  +----+--+    |               (tm)
  23.                --+       |    +-------------------
  24.                  |  +----+--+ |  Association of
  25.                  |  |       +-+  Shareware
  26.                  +--+   o   |    Professionals
  27.                -----+   |   +---------------------
  28.                     +---+---+    MEMBER
  29.  
  30.                           License Terms
  31.  
  32. The shareware  version of  WSSINDEX and  associated files  may be
  33. freely  distributed  provided that  the  entire  package is  made
  34. available  and only  a reasonable  copying fee  is charged.   The
  35. shareware version  is fully functional but  displays a commercial
  36. message  on startup.  Purchasers of the complete package will re-
  37. ceive the shareware package, a replacement for WSSINDEX.EXE with-
  38. out  the opening  screen,  and instructions  for suppressing  the
  39. opening  screen  in future  shareware  releases.   Purchasers  of
  40. WSSINDEX/EXTENDED will also receive  a protected mode  executable
  41. and setup files.  Files not included in the shareware package are
  42. licensed for use by a single user,  or on one machine at a  time,
  43. and  are not  to  be distributed.   Site  license  users may,  of
  44. course,  use as many  copies as specified  in their  license.  If
  45. there  is any  question  about multiple  machines  or users,  the
  46. "like-a-book" rule applies: it should be impossible for more than
  47. the licensed number of copies to be used simultaneously.
  48.  
  49.                      90 Day Limited Warranty
  50.  
  51. The software in the complete package is warranted to perform sub-
  52. stantially as documented for a  period of 90 days from  your date
  53. of receipt.  The media on which either the complete or evaluation
  54. version  of this software is provided is warranted to be readable
  55. for 30 days.   All  other warranties relating  to this  software,
  56. whether expressed  or implied, are disclaimed.   Determination of
  57. the  suitability of this software for a particular purpose is the
  58. responsibility of the  user.  In no  event shall WSS  Division of
  59. DDC  or Robert  W. Babcock  be liable  for damages  exceeding the
  60. price paid to license this software.
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                         Table of Contents
  74.  
  75. Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   1
  76.  
  77. Installation  . . . . . . . . . . . . . . . . . . . . . . . .   1
  78.  
  79. Wssindex/Extended Installation  . . . . . . . . . . . . . . .   2
  80.  
  81. Microsoft Windows Installation  . . . . . . . . . . . . . . .   3
  82.  
  83. Unlocking Demo Releases . . . . . . . . . . . . . . . . . . .   4
  84.  
  85. Overview and Tutorial . . . . . . . . . . . . . . . . . . . .   5
  86.  
  87. Setup and General Information . . . . . . . . . . . . . . . .   8
  88.  
  89. Starting up . . . . . . . . . . . . . . . . . . . . . . . . .   9
  90.  
  91. Pop-up File Selection . . . . . . . . . . . . . . . . . . . .  10
  92.  
  93. Command Defaults  . . . . . . . . . . . . . . . . . . . . . .  10
  94.  
  95. Aborting commands . . . . . . . . . . . . . . . . . . . . . .  10
  96.  
  97. The Dreaded Abort, Retry, Fail? . . . . . . . . . . . . . . .  10
  98.  
  99. Acknowledgements  . . . . . . . . . . . . . . . . . . . . . .  11
  100.  
  101. Archive and Graphics Files  . . . . . . . . . . . . . . . . .  11
  102.     Archive Formats Supported . . . . . . . . . . . . . . . .  13
  103.     Graphics Formats Supported  . . . . . . . . . . . . . . .  15
  104.  
  105. Navigating through the menus  . . . . . . . . . . . . . . . .  15
  106.  
  107. Main Menu . . . . . . . . . . . . . . . . . . . . . . . . . .  17
  108.     Add or label disks  . . . . . . . . . . . . . . . . . . .  17
  109.     Quick Find  . . . . . . . . . . . . . . . . . . . . . . .  17
  110.     Print and other output menu . . . . . . . . . . . . . . .  17
  111.     Write database on disk  . . . . . . . . . . . . . . . . .  17
  112.     Display statistics  . . . . . . . . . . . . . . . . . . .  18
  113.     List directory  . . . . . . . . . . . . . . . . . . . . .  18
  114.     Get or merge a database from disk . . . . . . . . . . . .  19
  115.     Get configuration file and matching database  . . . . . .  19
  116.     Change cOnfiguration  . . . . . . . . . . . . . . . . . .  19
  117.     Add/modify Comments . . . . . . . . . . . . . . . . . . .  19
  118.     Import comments . . . . . . . . . . . . . . . . . . . . .  19
  119.     ReName a disk in the database . . . . . . . . . . . . . .  21
  120.     ReName a disk with a mixed case label . . . . . . . . . .  21
  121.     Remove a disk from the database . . . . . . . . . . . . .  21
  122.     Remove all disks  . . . . . . . . . . . . . . . . . . . .  21
  123.     Purge duplicate Volumes . . . . . . . . . . . . . . . . .  21
  124.     Push to DOS . . . . . . . . . . . . . . . . . . . . . . .  22
  125.  
  126. Wssindex 5.27                   i               Table of Contents
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.     Quit and return to DOS  . . . . . . . . . . . . . . . . .  22
  140.     Quick Quit and return to DOS  . . . . . . . . . . . . . .  22
  141.  
  142. Print menu  . . . . . . . . . . . . . . . . . . . . . . . . .  23
  143.     Print (and sort)  . . . . . . . . . . . . . . . . . . . .  23
  144.     Find a file in the database . . . . . . . . . . . . . . .  27
  145.     Quick Find  . . . . . . . . . . . . . . . . . . . . . . .  27
  146.     Zippy text search . . . . . . . . . . . . . . . . . . . .  27
  147.     List Duplicate files  . . . . . . . . . . . . . . . . . .  27
  148.     List Unique files . . . . . . . . . . . . . . . . . . . .  27
  149.     List files which are not Backed up  . . . . . . . . . . .  28
  150.     List Volume names . . . . . . . . . . . . . . . . . . . .  29
  151.     Quick list of Volume names  . . . . . . . . . . . . . . .  29
  152.     Multi-column listings . . . . . . . . . . . . . . . . . .  29
  153.     MulTi-column listing  of duplicate, unique or  not backed
  154.         up files  . . . . . . . . . . . . . . . . . . . . . .  30
  155.     Disk Covers . . . . . . . . . . . . . . . . . . . . . . .  30
  156.     Disk Labels . . . . . . . . . . . . . . . . . . . . . . .  31
  157.     Read a printer definition file  . . . . . . . . . . . . .  32
  158.     COnfiguration menu  . . . . . . . . . . . . . . . . . . .  32
  159.     Return to main menu . . . . . . . . . . . . . . . . . . .  32
  160.  
  161. Indexing Menu . . . . . . . . . . . . . . . . . . . . . . . .  32
  162.     Start Indexing  . . . . . . . . . . . . . . . . . . . . .  33
  163.     Add Dummy entries . . . . . . . . . . . . . . . . . . . .  34
  164.     IndeX ignoring labels . . . . . . . . . . . . . . . . . .  34
  165.     List directory  . . . . . . . . . . . . . . . . . . . . .  34
  166.     Label a disk on the labeling drive  . . . . . . . . . . .  35
  167.     COnfiguration menu  . . . . . . . . . . . . . . . . . . .  35
  168.     Return to main menu . . . . . . . . . . . . . . . . . . .  35
  169.     First indexing drive  . . . . . . . . . . . . . . . . . .  35
  170.     Second indexing drive . . . . . . . . . . . . . . . . . .  35
  171.     LaBeling drive  . . . . . . . . . . . . . . . . . . . . .  35
  172.     Indexing sTarts from  . . . . . . . . . . . . . . . . . .  36
  173.     Auto-category strinG  . . . . . . . . . . . . . . . . . .  36
  174.     Ask before replacing  . . . . . . . . . . . . . . . . . .  36
  175.     Auto-Comment  . . . . . . . . . . . . . . . . . . . . . .  36
  176.     AUto-category . . . . . . . . . . . . . . . . . . . . . .  36
  177.     Make .ID entries  . . . . . . . . . . . . . . . . . . . .  36
  178.     DummY entries include subdirectory tree . . . . . . . . .  37
  179.     Query archive extraction  . . . . . . . . . . . . . . . .  37
  180.     Index Hidden files  . . . . . . . . . . . . . . . . . . .  37
  181.     Ignore bacKed up files  . . . . . . . . . . . . . . . . .  37
  182.     Extract archive comments  . . . . . . . . . . . . . . . .  37
  183.  
  184. Primary Configuration Menu  . . . . . . . . . . . . . . . . .  37
  185.     Printer configuration . . . . . . . . . . . . . . . . . .  38
  186.     SiZe limits . . . . . . . . . . . . . . . . . . . . . . .  38
  187.     Indexing options  . . . . . . . . . . . . . . . . . . . .  38
  188.     Screen, keyboard and Miscellaneous  . . . . . . . . . . .  38
  189.     Default sorting/selection options . . . . . . . . . . . .  38
  190.     Keyboard macros . . . . . . . . . . . . . . . . . . . . .  38
  191.  
  192. Wssindex 5.27                   ii              Table of Contents
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.     Configured Exception list . . . . . . . . . . . . . . . .  39
  206.     Which fields to print . . . . . . . . . . . . . . . . . .  39
  207.     Output Format . . . . . . . . . . . . . . . . . . . . . .  39
  208.     Load configuration file . . . . . . . . . . . . . . . . .  39
  209.     Save configuration file . . . . . . . . . . . . . . . . .  39
  210.     Return to previous menu . . . . . . . . . . . . . . . . .  40
  211.  
  212. Printer Configuration Menu  . . . . . . . . . . . . . . . . .  40
  213.     Paper Width to right margin . . . . . . . . . . . . . . .  40
  214.     Paper Length  . . . . . . . . . . . . . . . . . . . . . .  40
  215.     Left Margin . . . . . . . . . . . . . . . . . . . . . . .  41
  216.     Top margin  . . . . . . . . . . . . . . . . . . . . . . .  41
  217.     Bottom margin . . . . . . . . . . . . . . . . . . . . . .  41
  218.     Use Form feeds  . . . . . . . . . . . . . . . . . . . . .  41
  219.     Pause at page breaks  . . . . . . . . . . . . . . . . . .  41
  220.     Printer port Name . . . . . . . . . . . . . . . . . . . .  41
  221.     POstscript printer setup  . . . . . . . . . . . . . . . .  41
  222.  
  223. Postscript Printer Setup Menu . . . . . . . . . . . . . . . .  41
  224.     Use Postscript printer  . . . . . . . . . . . . . . . . .  42
  225.     Disk output also postscript . . . . . . . . . . . . . . .  42
  226.     Landscape output  . . . . . . . . . . . . . . . . . . . .  42
  227.     Font Size (points)  . . . . . . . . . . . . . . . . . . .  42
  228.     Extra line spacing (points) . . . . . . . . . . . . . . .  42
  229.     Database Size Limits  . . . . . . . . . . . . . . . . . .  42
  230.     Maximum number of Files . . . . . . . . . . . . . . . . .  43
  231.     Maximum number of Subdirectories  . . . . . . . . . . . .  43
  232.     Maximum number of Disks . . . . . . . . . . . . . . . . .  43
  233.     Allocate Memory . . . . . . . . . . . . . . . . . . . . .  44
  234.     Longest allowed Comment . . . . . . . . . . . . . . . . .  44
  235.     Longest allowed category  . . . . . . . . . . . . . . . .  44
  236.     Return to primary configuration menu  . . . . . . . . . .  44
  237.  
  238. Indexing Configuration Menu . . . . . . . . . . . . . . . . .  44
  239.     Indexing drive number . . . . . . . . . . . . . . . . . .  45
  240.     Make .ID entries  . . . . . . . . . . . . . . . . . . . .  45
  241.     Ask Before replacing  . . . . . . . . . . . . . . . . . .  45
  242.     Auto coMment  . . . . . . . . . . . . . . . . . . . . . .  45
  243.     Auto caTegory . . . . . . . . . . . . . . . . . . . . . .  46
  244.     Ask before eXtracting archive info  . . . . . . . . . . .  46
  245.     Extract comments from archive files . . . . . . . . . . .  46
  246.     Ignore archive extension when copying comments  . . . . .  46
  247.     Extract comments from 4DOS/NDOS description files . . . .  46
  248.     Auto cateGory string  . . . . . . . . . . . . . . . . . .  46
  249.     File extensions for Archive information extraction  . . .  46
  250.     File extensions for graPhics information extraction . . .  46
  251.  
  252. Archive file extraction configuration menu  . . . . . . . . .  47
  253.  
  254. Graphics file extraction configuration menu . . . . . . . . .  47
  255.  
  256. Self-extracting files configuration menu  . . . . . . . . . .  47
  257.  
  258. Wssindex 5.27                  iii              Table of Contents
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.     Extension for extraction  . . . . . . . . . . . . . . . .  48
  272.     TogglE all  . . . . . . . . . . . . . . . . . . . . . . .  48
  273.  
  274. Miscellaneous Configuration Menu  . . . . . . . . . . . . . .  48
  275.     Perform automatic inteGrity check . . . . . . . . . . . .  49
  276.     MaNual cursor motion in menus . . . . . . . . . . . . . .  50
  277.     Function key layout matching IBM  . . . . . . . . . . . .  50
  278.     Use BIOS to read Keyboard . . . . . . . . . . . . . . . .  50
  279.     Inverted meaning for PgUp/PgDn  . . . . . . . . . . . . .  51
  280.     Create .BAK files . . . . . . . . . . . . . . . . . . . .  51
  281.     Enable Alarm sound  . . . . . . . . . . . . . . . . . . .  51
  282.     Change Prompt in DOS shell  . . . . . . . . . . . . . . .  51
  283.     Strip High-bit when viewing files . . . . . . . . . . . .  51
  284.     Use color . . . . . . . . . . . . . . . . . . . . . . . .  51
  285.     Use Mouse . . . . . . . . . . . . . . . . . . . . . . . .  52
  286.     Mouse Sensitivity . . . . . . . . . . . . . . . . . . . .  52
  287.     Set Colors  . . . . . . . . . . . . . . . . . . . . . . .  52
  288.     Video board configuration . . . . . . . . . . . . . . . .  52
  289.     Return to primary configuration menu  . . . . . . . . . .  52
  290.  
  291. Default Sorting and Selection Options Menu  . . . . . . . . .  52
  292.     Selection list  . . . . . . . . . . . . . . . . . . . . .  52
  293.     Sort Keys . . . . . . . . . . . . . . . . . . . . . . . .  52
  294.     Return to previous menu . . . . . . . . . . . . . . . . .  53
  295.  
  296. Output Fields Configuration Menu  . . . . . . . . . . . . . .  53
  297.     DuPlicate flag  . . . . . . . . . . . . . . . . . . . . .  53
  298.     Size  . . . . . . . . . . . . . . . . . . . . . . . . . .  53
  299.     Date  . . . . . . . . . . . . . . . . . . . . . . . . . .  53
  300.     Time  . . . . . . . . . . . . . . . . . . . . . . . . . .  53
  301.     Seconds . . . . . . . . . . . . . . . . . . . . . . . . .  53
  302.     Volume  . . . . . . . . . . . . . . . . . . . . . . . . .  53
  303.     SuBdirectory  . . . . . . . . . . . . . . . . . . . . . .  54
  304.     Archive file name . . . . . . . . . . . . . . . . . . . .  54
  305.     Comment . . . . . . . . . . . . . . . . . . . . . . . . .  54
  306.     CateGory  . . . . . . . . . . . . . . . . . . . . . . . .  54
  307.  
  308. Output Format Configuration Menu  . . . . . . . . . . . . . .  54
  309.     Number of Blank lines between headers . . . . . . . . . .  54
  310.     Number of blank lines after Headers . . . . . . . . . . .  54
  311.     File name style . . . . . . . . . . . . . . . . . . . . .  55
  312.     Date style  . . . . . . . . . . . . . . . . . . . . . . .  55
  313.     Archive file delImiter  . . . . . . . . . . . . . . . . .  55
  314.     DeliMiter around first of comment/category  . . . . . . .  55
  315.     Field width for Subdirectories  . . . . . . . . . . . . .  55
  316.     Field width for Archive name  . . . . . . . . . . . . . .  55
  317.     Field width for Comment or category . . . . . . . . . . .  55
  318.     Print comments bEfore categories  . . . . . . . . . . . .  55
  319.     Always start New line for comment/category  . . . . . . .  55
  320.     MaX wrapped print lines per file  . . . . . . . . . . . .  56
  321.     Return to primary configuration menu  . . . . . . . . . .  56
  322.  
  323.  
  324. Wssindex 5.27                   iv              Table of Contents
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337. Video Board Configuration . . . . . . . . . . . . . . . . . .  56
  338.     Screen writing method . . . . . . . . . . . . . . . . . .  56
  339.     Use DOS calls for prompts (for screen readers)  . . . . .  57
  340.     Suppress snoW on CGA  . . . . . . . . . . . . . . . . . .  57
  341.     Raw Mode on screen output . . . . . . . . . . . . . . . .  57
  342.     Use BIOS call to set screen size  . . . . . . . . . . . .  57
  343.     AX value for BIOS call  . . . . . . . . . . . . . . . . .  57
  344.     BX value for BIOS call  . . . . . . . . . . . . . . . . .  57
  345.     Screen wIdth  . . . . . . . . . . . . . . . . . . . . . .  57
  346.     Screen Height . . . . . . . . . . . . . . . . . . . . . .  58
  347.     AX value for BIOS call on exit or push-to-DOS . . . . . .  58
  348.     BX Value for BIOS call on exit or push-to-DOS . . . . . .  58
  349.     Return to previous menu . . . . . . . . . . . . . . . . .  58
  350.  
  351. Color Selection Menu  . . . . . . . . . . . . . . . . . . . .  58
  352.  
  353. The Add-Comments Menu . . . . . . . . . . . . . . . . . . . .  58
  354.  
  355. WSSINDEX Utilities  . . . . . . . . . . . . . . . . . . . . .  63
  356.     IDADD Conversion Utility  . . . . . . . . . . . . . . . .  63
  357.     WSSMERGE Database Merging Utility . . . . . . . . . . . .  63
  358.     SPLIT Database Splitting Utility  . . . . . . . . . . . .  64
  359.     Database Conversion Utilities . . . . . . . . . . . . . .  65
  360.  
  361. Problems and Solutions  . . . . . . . . . . . . . . . . . . .  66
  362.     Hard/software requirements  . . . . . . . . . . . . . . .  66
  363.     Known incompatibilities with other software . . . . . . .  66
  364.         Disk Cache Warning  . . . . . . . . . . . . . . . . .  66
  365.         Incompatible TSR  . . . . . . . . . . . . . . . . . .  67
  366.     Answers to Common Questions . . . . . . . . . . . . . . .  67
  367.  
  368. Command Line Parameter Summary  . . . . . . . . . . . . . . .  70
  369.  
  370. Support . . . . . . . . . . . . . . . . . . . . . . . . . . .  71
  371.  
  372. The Distribution Package  . . . . . . . . . . . . . . . . . .  72
  373.  
  374. Ordering Information  . . . . . . . . . . . . . . . . . . . .  74
  375.     WSSINDEX Price schedule . . . . . . . . . . . . . . . . .  74
  376.  
  377. Appendix A - Forcing Video Board Type if Autodetection Fails   77
  378.  
  379. Appendix B - ANSI.SYS Screen Driver . . . . . . . . . . . . .  78
  380.  
  381. Appendix C - Expanding the DOS Environment  . . . . . . . . .  79
  382.  
  383. Appendix D - WSSINDEX Database Format . . . . . . . . . . . .  80
  384.  
  385. Appendix E - Printer Definition Files . . . . . . . . . . . .  81
  386.  
  387. Appendix F - Character Code Conversion Table  . . . . . . . .  86
  388.  
  389.  
  390. Wssindex 5.27                   v               Table of Contents
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403. Appendix G - WSSINDEX for DEC Rainbow . . . . . . . . . . . .  87
  404.  
  405. Appendix H - WSSINDEX for TI Professional . . . . . . . . . .  88
  406.  
  407. Appendix I - Parameters for setting screen sizes  . . . . . .  89
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456. Wssindex 5.27                   vi              Table of Contents
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.                            Introduction
  470.  
  471. Have you ever  had to  search through dozens  of disks trying  to
  472. find a  program or data  file which  you knew you  had somewhere?
  473. WSSINDEX.EXE is a program  designed to help keep track  of MS-DOS
  474. files  stored on  floppy or hard  disks.   A database  is created
  475. which  contains, for all of  your disks, the information normally
  476. available  from the DOS DIR command, as well as optional comments
  477. and categories  describing  each file.   The  information in  the
  478. database may be printed  with various sorting options, or  may be
  479. searched  for specific  file names  with wild  cards in  case you
  480. don't remember the exact  name of the  file you are looking  for.
  481. Additional functions include listing files without current backup
  482. copies and  extracting  directory information  from  archive  and
  483. graphics files of various types.  Don't be frightened by the size
  484. of  this documentation.   The program is menu  driven and easy to
  485. use without referring  to the  documentation.  Mostly  this is  a
  486. reference manual to use when the details of some program function
  487. aren't clear.  If you are a new user, you should read the Instal-
  488. lation, Overview and Tutorial sections.
  489.  
  490.                            Installation
  491.  
  492. Before you do anything else,  make sure that the disk(s)  you re-
  493. ceived are write  protected, and  then make at  least one  backup
  494. copy.   The disks are not  copy protected.  WSSINDEX  and related
  495. routines, including a machine readable version of this documenta-
  496. tion file,  are  shipped as  compressed,  self-extracting  files.
  497. This  lowers the number of  disks required, and  also provides an
  498. automatic check during the installation that the disk(s) have not
  499. been damaged.  The steps required for program extraction may vary
  500. from release to release; you will find an instruction sheet pack-
  501. aged with the distribution disks.
  502.  
  503. The extracted files generally include  the version number as part
  504. of the file  name.   For example, the  main program  WSSINDEX.EXE
  505. becomes WSSI527.EXE.   To  avoid  confusion, I  suggest that  you
  506. rename  the  executable  files  to  WSSINDEX,  IDADD,  SPLIT  and
  507. WSSMERGE (.EXE  in all cases).   If you are running  DOS 2.x, you
  508. must rename the program files this way if you want  to use either
  509. the overlaid version  of WSSINDEX or the virus checking code.  Of
  510. course, you can  name the files whatever you like,  but the above
  511. numbers  will  be  used   throughout  this  documentation.    The
  512. WSSINDEX/Extended executable is named WSDPM527.EXE; the suggested
  513. generic name  is WSSIDPM.EXE.   Since WSSINDEX/Extended  does not
  514. run  under DOS 2.x, the integrity check does not require renaming
  515. the executable.
  516.  
  517. All purchasers receive the  shareware evaluation version which is
  518. fully functional, but the main program, WSSINDEX.EXE, displays an
  519. opening  commercial.  The evaluation routine has a "D" (for demo)
  520. as the last  character of the file name, i.e. WSSI527D.EXE  (Note
  521.  
  522. Wssindex 5.27                   1                    Introduction
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535. that the file names vary slightly for the DEC Rainbow  and TI Pro
  536. versions.  Generally, a single letter is appended, and where this
  537. makes the file name  longer than 8 characters, another  letter is
  538. dropped.)   If  you  purchased the  complete package,  additional
  539. self-extracting files are  included which contain WSSI527.EXE,  a
  540. replacement   executable   without   the   opening   screen   and
  541. WSSI527.DOC, this documentation in ascii format.
  542.  
  543.                   Wssindex/Extended Installation
  544.  
  545. The  extended version  of Wssindex  uses a DOS  extender licensed
  546. from  Ergo Computing to  allow access to  up to 16MB  of extended
  547. memory with  an 80286, 80386 or 80486 CPU.  This requires switch-
  548. ing the CPU into what is called "protected mode".  However, it is
  549. necessary  to switch back to "real mode" before any DOS functions
  550. can  be used.   Since  Intel originally  envisioned that  the 286
  551. would be used with  an operating system which switched  into pro-
  552. tected  mode immediately and never came back, getting out of pro-
  553. tected mode was  made very  difficult.  But  MS-DOS has  remained
  554. popular, so motherboard manufacturers have used various tricks to
  555. allow switching back to real mode.  Generally these involve send-
  556. ing  a  special command  to the  keyboard controller,  which then
  557. sends a reset to the CPU.
  558.  
  559. The significance of all this is that the DOS extender has to test
  560. your system to find out which  way of switching back to real mode
  561. works  best.  This  testing is done  once using  a program called
  562. TUNE which  stores its results in the  protected mode executable.
  563. If TUNE tries something which doesn't work with your hardware, it
  564. may crash  your system,  probably disabling  the keyboard  in the
  565. process.   If  this happens,  use your  hardware reset  button or
  566. power switch to reboot  and try again.  TUNE writes  a checkpoint
  567. file and will continue from the point of failure.  If you have an
  568. expanded  memory manager  such  as QEMM  or 386-to-the-Max  which
  569. supports  the VCPI standard, TUNE  will detect this  and tell you
  570. that no tuning is  necessary.  TUNE has  an internal database  of
  571. common  machines and may recognize  your machine and  not need to
  572. run any  tests.  TUNE  may also generate  a small file  with your
  573. machine configuration  and ask you to upload  it to the Ergo Com-
  574. puting BBS.   Of course,  doing this is  optional, especially  if
  575. TUNE  did not crash your  machine.  TUNE  configuration files can
  576. also be sent to WSS/DDC for forwarding to Ergo.
  577.  
  578. Instructions   for   running   TUNE   are   included   with   the
  579. Wssindex/Extended disk.  Basically, you type
  580.  
  581.     TUNE -k filename
  582.  
  583. where filename is  WSDPM527.EXE (if not  renamed) and follow  the
  584. screen prompts.  TUNE'ing a 386  or 486 is usually a quick, pain-
  585. less task, but 286  processors are sometimes a problem.   If TUNE
  586. reports that it  is unable  to characterize your  machine, or  is
  587.  
  588. Wssindex 5.27                   2                    Installation
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601. unable  to  control the  A20 line,  try  again with  a simplified
  602. CONFIG.SYS  file.  286 expanded  memory drivers may  to be incom-
  603. patible with the Ergo extender (but XMS drivers are usually help-
  604. ful).  If all else fails, try the command
  605.  
  606.     TUNE -f 0/0/0/2/2 -k filename
  607.  
  608. This  writes generic  286 tuning  parameters into  the executable
  609. without running any tests.  Then try running WSDPM527.EXE; if you
  610. are lucky, it may work.
  611.  
  612.                   Microsoft Windows Installation
  613.  
  614. The DOS version of Wssindex requires no special  installation for
  615. running under  Windows 3.0  or 3.1 (earlier  versions of  Windows
  616. have not been tested).  From the program manager click on
  617.  
  618.     File
  619.     New
  620.     Program Item (OK)
  621.  
  622. and  enter the program name  (with a full path  if not on the DOS
  623. path) in the command line field, and the directory where you wish
  624. to store database files in the working directory field.
  625.  
  626. To install  Wssindex/Extended under  Windows, proceed as  for the
  627. DOS version, but instead  of entering the program name  and path,
  628. enter the name of a Program Information File (PIF).  A sample PIF
  629. file with the name  WSDPM527.PIF is included in the  distribution
  630. package.  The PIF file includes  the path C:\WSSINDEX and an  8MB
  631. XMS memory  limit.   These can  be changed  with the  Windows PIF
  632. editor.   Windows 3.1 in 386 enhanced mode provides virtual memo-
  633. ry,  so database  size is  limited by  a combination  of physical
  634. memory and disk swap space.
  635.  
  636. Wssindex/Extended requires that file LABELDLL.DLL be available on
  637. the DOS  PATH or in the  current directory.  If this  file is not
  638. found,  you will get  an error  message, but  if you  are running
  639. under Windows, the message may be cleared from the before you can
  640. read it.
  641.  
  642. One  software combination which is not guaranteed to work is QEMM
  643. plus Windows 3.0 in standard mode plus Wssindex/Extended.  Alter-
  644. natives  are to replace QEMM  with HIMEM.SYS, run  Windows 3.0 in
  645. 386  enhanced mode,  run Windows  3.1  in any  mode, or  only run
  646. Wssindex/Extended under DOS.
  647.  
  648.                         OS/2 Installation
  649.  
  650. Wssindex runs in a DOS window under OS/2 2.0 (earlier versions of
  651. OS/2 have  not been tested).   Neither the  DOS nor the  Extended
  652. versions  know about the long  file names possible  with the High
  653.  
  654. Wssindex 5.27                   3                    Installation
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667. Performance File System.  DOS settings for Wssindex/Extended must
  668. set the  DPMI_DOS_API to  enabled; the  default  setting of  AUTO
  669. doesn't work.   The  DPMI_MEMORY_LIMIT setting controls  how much
  670. memory is available for database storage.   OS/2 provides virtual
  671. memory,  so database size is limited by a combination of physical
  672. memory   and   disk   swap    space.      EMS_MEMORY_LIMIT    and
  673. XMS_MEMORY_LIMIT  can be set to 0 if desired; only DPMI memory is
  674. used.
  675.  
  676.                      Unlocking Demo Releases
  677.  
  678. The  acknowledgement letter  sent to  full purchasers  includes a
  679. personal  password which can be used to suppress the opening com-
  680. mercial of the  evaluation demo.  The DOS SET  command is used to
  681. define two  environment variables, WSSUSER and  WSSPASS, whenever
  682. the demo version  is run.   The first of  these is typically  the
  683. user name, the  second a 7 or 8-digit number.   For example, John
  684. Q. Public might include the lines
  685.  
  686.     SET WSSUSER=JPublic
  687.     SET WSSPASS=12345678
  688.  
  689. in his AUTOEXEC.BAT file.  The program retrieves the value of the
  690. WSSUSER  variable, does  some  arithmetic operations  on it,  and
  691. checks to see whether the result matches the value of the WSSPASS
  692. variable.   If so, the  opening commercial screen  is suppressed.
  693. The WSSUSER variable must be entered exactly as specified in your
  694. registration letter; changing the case or including spaces around
  695. the  equal signs will cause  the program to  either not recognize
  696. the password or  will change the expected value of WSSPASS.  Pur-
  697. chasers of versions released  before the password scheme  was im-
  698. plemented may contact WSS/DDC to receive a password.  The maximum
  699. database size will be slightly reduced by the memory  used by the
  700. code  which checks the password;  otherwise an unlocked demo ver-
  701. sion will be  indistinguishable from the standard  release.  This
  702. password scheme is probably  not very hard to  defeat; if you  do
  703. so, please keep the technique to yourself.
  704.  
  705. The  password does not turn  the evaluation version  into the Ex-
  706. tended version.  In the future, it may allow you  to download the
  707. Extended version from our BBS without requiring manual validation
  708. by the system operator.
  709.  
  710. Demo releases  sent to various  online and disk  copying services
  711. are compressed using PKWare's PKZIP version 1.1.  These files in-
  712. clude an  authenticity check  which is difficult,  but apparently
  713. not impossible, to defeat.   When such files are  extracted using
  714. PKZIP, you should see  the message "Authentic files Verified!   #
  715. RLQ256  Software by WSS Division of DDC."  If there is any change
  716. in this  message, particularly in  the serial  number RLQ256,  it
  717. means  that the file has been modified and should be treated with
  718. caution.  Various  BBS's may add a ZIPfile comment; this will not
  719.  
  720. Wssindex 5.27                   4                    Installation
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733. change the authenticity check.   On the other hand,  the self-ex-
  734. tracting files I  send to  purchasers may be  created by  another
  735. compression utility such as LHARC.  A ZIP file with no authentic-
  736. ity check may merely be a repackaging of files I send to purchas-
  737. ers.   PKZIP  2 includes  a supposedly  strengthened authenticity
  738. verification scheme; unfortunately, it was "cracked" within a few
  739. days  of release.  Public-key cryptography systems may be used to
  740. validate future Wssindex releases.
  741.  
  742.  
  743.                       Overview and Tutorial
  744.  
  745. This section  is an introduction to  WSSINDEX for new  users.  It
  746. contains enough  information to  get you started,  but eventually
  747. you  will probably want to  browse through the  Setup and Command
  748. Reference sections.
  749.  
  750. What is it?   WSSINDEX creates and maintains a  database with all
  751. the information about your disks available from the DIR  command,
  752. plus  optional  descriptive comments  and  categories.   You  can
  753. search the database interactively, or  you can print reports with
  754. various  sorting  and selection  options.    Output option  allow
  755. printing disk labels and disk covers.  The most common use of the
  756. program  is to  keep track  of files  on  a collection  of floppy
  757. disks, but you can index anything which looks like a disk to DOS,
  758. including hard disks, RAM  disks and some tape cartridges.   (Un-
  759. fortunately, almost  all tape  systems use special  formats which
  760. Wssindex cannot  read.  But if your  tape software makes the tape
  761. look like  a disk to  DOS, Wssindex can  probably read it.)   One
  762. option allows hard disk users to make a listing of all files on a
  763. hard disk which do not have backup copies on another disk.
  764.  
  765. What hardware  and software do I  need?  For the  DOS version, an
  766. IBM-PC or moderately compatible  MS-DOS machine (versions for the
  767. Dec Rainbow  and Texas  Instruments Professional are  also avail-
  768. able), DOS-2 or higher  and either an IBM compatible  video board
  769. or support for ANSI escape sequences.  If you lack both of these,
  770. the screen display will  be hopelessly garbled; more details  be-
  771. low.   The program will run  in 256K of memory,  but the database
  772. size will be extremely limited; 640K is recommended.  A mouse may
  773. be used.   Wssindex/Extended, which can  handle larger databases,
  774. requires an AT class machine (286  or higher CPU), DOS-3 or high-
  775. er, and a  disk larger than  360KB for saved  databases.  1MB  or
  776. more of extended memory is recommended.
  777.  
  778. How many disks  can I index?   With the DOS  version, there is  a
  779. hard limit (set by the 64K segment size of the Intel 80x8x series
  780. CPU's) of approximately 16K  files (or disks, or subdirectories),
  781. and a practical limit of 10-12K files if you have 640K of memory.
  782. Extended  or expanded memory is  not used, but  DOS memory beyond
  783. 640K  is used if your  system supports it.   The extended version
  784. does use extended  memory and  the maximum database  size is  in-
  785.  
  786. Wssindex 5.27                   5                    Installation
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799. creased  accordingly.   For example, with  6MB RAM,  over 100,000
  800. files can be indexed.
  801.  
  802. How do  I run the  program?  Start it  up by typing  WSSINDEX (or
  803. WSSInnn if you haven't  renamed the executable file and  it still
  804. includes the version number).  If you are not running  the regis-
  805. tered  version, read the opening commercial screen and hist a key
  806. to continue.   You will get a message that the configuration file
  807. was not  found; hit return and you will  get a prompt for a data-
  808. base  name.  You haven't created a  database yet, so just hit es-
  809. cape.
  810.  
  811. "Help!  my screen is all messed up.   I see funny numbers, square
  812. brackets  and other  garbage mixed  in with  normal text."   This
  813. isn't  supposed to happen  any more, but  if it does,  you may be
  814. able  to recover by hitting escape 2  or 3 times followed by con-
  815. trol-Q.  Then, read appendices A  and B for a description of what
  816. is happening and how to fix it.
  817.  
  818. At  this point you are  running with default  option settings in-
  819. cluding white-on-black colors and mouse disabled.  You can change
  820. options  at this point or later; simply select the change cOnfig-
  821. uration option  on the  main menu by  typing "O".   Probably  the
  822. first thing to check is the video output method; CGA, MDA, EGA or
  823. VGA  are much faster than DOS and  enable boxes around the menus.
  824. (Drawing  the menu boxes with DOS calls would be painfully slow.)
  825. To get to the menu screen which sets this option from the primary
  826. configuration menu, select  M and then  V.  This  menu option  is
  827. buried several menus deep  because you only need to  set it once,
  828. and you lose your screen display if you accidentally change it to
  829. the wrong  value.  You may also  want to enable use  of the mouse
  830. from the screen, keyboard and miscellaneous configuration menu.
  831.  
  832. From the main menu hit A to move to the indexing menu.  If neces-
  833. sary, hit F and S to  enter the first and second indexing drives.
  834. If you have  two drives, you can select A and  B and use then al-
  835. ternately; otherwise just select the same  drive twice.  Hit I to
  836. start indexing.   You will be told  to insert a disk  and hit the
  837. space bar; do so.  If the disk was previously labeled (by  the /V
  838. option of  FORMAT or by  some other utility),  the label will  be
  839. displayed and the disk directory information will be added to the
  840. database.   If the  disk was not  labeled, you will  be given the
  841. options to  write a label  on it, enter a  label to use  (but not
  842. write on  the disk), list  the directory on screen,  or return to
  843. the menu.  WSSINDEX  will spend a  few seconds reading the  disk,
  844. and will then prompt you  to hit the space bar to  index the next
  845. disk.  Feed  in a few disks this way, then  hit return instead of
  846. space to stop indexing, and then R to return to the main menu.
  847.  
  848. Now you can  try some of the program options.   Hit D and see how
  849. many files  and disks  you have entered.   Hit P  to move  to the
  850. File/volume listing menu, and then P again to print the database.
  851.  
  852. Wssindex 5.27                   6                        Overview
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865. When asked  for selection/rejection  options, just hit  return to
  866. select everything.  When asked for sorting options, enter 1,2 and
  867. hit return.  And  when asked to select  printer, screen, disk  or
  868. export output, hit S.  You should now get a screen listing of all
  869. files in the database, sorted by name and extension.  If the list
  870. does not fit on a  single screen, you can page forward  and back-
  871. ward with the PgDn and PgUp keys.  At the top of the list will be
  872. dummy entries for  each disk and subdirectory.   See page  24 for
  873. how to control whether or not these appear.  If you don't want to
  874. see the entire listing  you can interrupt it by hitting  ^C (con-
  875. trol-C) while  the screen is  being painted, or  hit Q  after the
  876. screen fills.  When  the listing finishes  and you return to  the
  877. menu display,  enter ^F for quick  find.  When  prompted for file
  878. specs, enter wildcard specifications one per line, ending with an
  879. empty line.  For example, *.COM  and *.EXE will match all execut-
  880. able files.  All files which match these  specs will be displayed
  881. on screen in the same format as before.
  882.  
  883. There are four different types of disk files which can be written
  884. by WSSINDEX:  (1) configuration files (default name WSSINDEX.CNF)
  885. which contain setup information and are short, (2) database files
  886. (default  name WSSINDEX.DIR)  which  contain  the disk  directory
  887. information  and can be quite large, (3) printer files which con-
  888. tain output which could instead have been sent to the screen or a
  889. printer, and (4) export  files which can be read by database pro-
  890. grams.  Only the first two of these can be read by WSSINDEX.
  891.  
  892. From the main  menu, select option  W to write  a database  file.
  893. You will be prompted with a default name of d:\path\WSSINDEX.DIR.
  894. You can  hit return to accept  this default, or you  can edit it:
  895. use the cursor keys, insert, delete,  control-arrow for word tab-
  896. bing, etc.  You can also hit TAB to get a pop-up list of database
  897. file names, but usually doing this doesn't make much sense unless
  898. you want to check  whether a database name already  exists before
  899. saving a new database.
  900.  
  901. Select option Q (or ^Q) and return to DOS.  Verify that the data-
  902. base file was written where you expected.
  903.  
  904. Restart  the program.  If you saved a configuration file with the
  905. default  name (the instructions above didn't tell you to do this,
  906. but you might  have done so anyway if you  were adventurous), no-
  907. tice that it is  automatically restored and you are  prompted for
  908. the name of a database file to read.   Otherwise, after configur-
  909. ing, select the G option  to get a database from disk  and reload
  910. the  database you  just saved.   From the  print menu,  use the V
  911. option to list the  volumes in the database, sorted by name, free
  912. space, date indexed or unsorted.
  913.  
  914. Now you have  a feel for how the program  operates and you should
  915. read  at least  up until  the detailed  menu descriptions.   Some
  916. important things you  will find are instructions for changing the
  917.  
  918. Wssindex 5.27                   7                        Overview
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931. default names for the  configuration and database files, detailed
  932. explanation  of all  the  program options,  and  how to  use  the
  933. add-comments section.   Also look  at the Problems  and Solutions
  934. chapter  for the answers to some commonly asked questions, and at
  935. the  Utilities chapter  for descriptions  of the  various utility
  936. routines.  If you want  to print disk labels or disk  covers, see
  937. the documentation for the print menu.
  938.  
  939.                   Setup and General Information
  940.  
  941. Before running WSSINDEX, there  are several DOS environment vari-
  942. ables  which you may  want to set  to establish defaults  for the
  943. configuration file name, the  database name, and your  video dis-
  944. play  type.  Doing this  is optional, but  recommended for smooth
  945. operation.
  946.  
  947. The DOS environment  is just a  list of character strings  of the
  948. form
  949.  
  950.         VARIABLE=value
  951.  
  952. You make,  view or delete entries  in this list with  the DOS SET
  953. command.   From the  DOS prompt, type  SET to  view your  current
  954. settings.   You should see something  like COMSPEC=d:COMMAND.COM,
  955. and probably other items  used by other software packages  or the
  956. PROMPT command.  You will probably  find it convenient to put SET
  957. commands in your AUTOEXEC.BAT file.  If you  get an error message
  958. that you have run out of environment space, see appendix B.
  959.  
  960. When issuing SET commands, do not include any blank spaces around
  961. the equals signs.  The four commands:
  962.  
  963.     SET X=Y
  964.     SET X =Y
  965.     SET X= Y
  966.     SET X = Y
  967.  
  968. mean different things.
  969.  
  970. The environment variables used by WSSINDEX are
  971.  
  972.     WSSDISP = default display type
  973.     WSSICNF = default configuration file name
  974.     WSSIDIR = default database name
  975.     WSSPRINT = default printer definition file
  976.  
  977. WSSINDEX and  the utility routines attempt to determine what type
  978. of video card  you have, but you can manually  override the auto-
  979. matic selection.  This  might be necessary on machines  with more
  980. than one  video board or when smart  hardware tries to sense what
  981. type of video board the software is trying to address.  The video
  982. type  is saved  in  configuration files,  but  you can  also  use
  983.  
  984. Wssindex 5.27                   8                        Overview
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997. WSSDISP to specify this; legal values are D, C, M, E or V for DOS
  998. calls, color graphics adapter, monochrome display adapter, EGA or
  999. VGA.   (Actually, only the first character is used, so you can be
  1000. more mnemonic.)
  1001.  
  1002. If you do  not specify  the configuration file  or database  file
  1003. names  on  the command  line,  they default  to  WSSINDEX.CNF and
  1004. WSSINDEX.DIR  on the current drive in the current directory.  You
  1005. can change these defaults  with the environment variables WSSICNF
  1006. and WSSIDIR.  Even  if you use multiple databases  and configura-
  1007. tions, you can still use these variables to specify the drive and
  1008. path.  For  example, if  you keep the  program and  configuration
  1009. files in  subdirectory C:\WSSINDEX, and databases in subdirectory
  1010. C:\WSSINDEX\INDEXES, you might specify
  1011.  
  1012.     SET WSSICNF=C:\WSSINDEX\
  1013.     SET WSSIDIR=C:\WSSINDEX\INDEXES\
  1014.  
  1015. (Remember, no spaces around  the equal signs.)  The  startup code
  1016. will use the specified paths and fill in the default file names.
  1017.  
  1018. The  WSSPRINT  environment variable  specifies  the  name of  the
  1019. printer  definition file  which is  used by  some options  on the
  1020. print menu.
  1021.  
  1022.  
  1023.                            Starting up
  1024.  
  1025. Type
  1026.           WSSINDEX <config name> <database name>
  1027.  
  1028. where the  angle brackets indicate  optional parameters.   If the
  1029. configuration file (first command line argument or default or de-
  1030. fined by WSSICNF)  is read successfully, the program will immedi-
  1031. ately ask for the name of  an existing database to read, and will
  1032. prompt  you with the default name.   If you don't  want to read a
  1033. database, you  can hit escape to  cancel.  On the  other hand, if
  1034. you  specify the database name  as the second  command line argu-
  1035. ment, it is read without confirmation.  If the configuration file
  1036. and database have the  same name (but the usual  extensions), you
  1037. can specify = (an equal sign) for the database  name.  In a batch
  1038. file, DOS treats an equal sign like a blank or comma, so Wssindex
  1039. won't  see it.  A - (hyphen)  can be substituted.  Either command
  1040. line  name can be replaced by  an * (asterisk) as an abbreviation
  1041. for the default name.
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050. Wssindex 5.27                   9                           Setup
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.                       Pop-up File Selection
  1064.  
  1065. When entering names for  input database, configuration or printer
  1066. definition files, you can hit TAB to switch to a list of possible
  1067. files.  These lists are  generated using the drive, path and  ex-
  1068. tension  of the default file name which was displayed just before
  1069. you hit TAB; the wildcard used is displayed at the  bottom of the
  1070. screen.   Also listed, surrounded  by brackets, are  the names of
  1071. subdirectories, including  the parent directory in  the usual DOS
  1072. notation [..].  Move  the highlight bar to the desired  entry and
  1073. hit enter, spacebar  or a mouse button.  If  no path is specified
  1074. in the wildcard and  you select the parent directory,  the selec-
  1075. tion is interpreted to mean fill in the current directory, but do
  1076. not move up the directory tree.  Once this has been done, you can
  1077. move up the directory tree by selecting  [..] again.  If you want
  1078. to  change to a different drive, edit  that part of the file name
  1079. before hitting TAB.
  1080.  
  1081.  
  1082.                          Command Defaults
  1083.  
  1084. In  many places, WSSINDEX gives you  a default which will be used
  1085. if you just hit enter.  For text input, you  can edit the default
  1086. with normal  editing keys: left, right  cursor arrows, backspace,
  1087. insert,  delete, control-arrows  for  word tabbing.   File  names
  1088. generally have default  drive, subdirectory,  name and  extension
  1089. components which are established at program startup and change to
  1090. match the last user input.
  1091.  
  1092.  
  1093.                         Aborting commands
  1094.  
  1095. At most  points you can hit  ESCAPE (CANCEL on a  Dec Rainbow) to
  1096. abort a command when  you are prompted  for text strings such  as
  1097. file name, disk name, etc.   ESCAPE also backs up one menu level,
  1098. or forces  a screen rewrite from the top level menu.  ESCAPE will
  1099. not stop print  operations, use  control-c instead.   If you  hit
  1100. ESCAPE when numeric input is expected, you will still see a "com-
  1101. mand aborted" message,  but all  this means is  that the  default
  1102. value has been used.
  1103.  
  1104.  
  1105.                  The Dreaded Abort, Retry, Fail?
  1106.  
  1107. Certain disk errors will produce a DOS error message, followed by
  1108. an "Abort, Retry, Fail?" prompt (Fail is replaced by Ignore under
  1109. DOS 2), possibly in  an inappropriate screen location if  you are
  1110. using direct video  writes for  screen output.   To minimize  the
  1111. chance  of triggering such a  message, WSSINDEX now  has an error
  1112. handler which will intercept such messages during indexing  or if
  1113. they are  triggered on the first  access of a disk,  and give you
  1114. the  opportunity to correct the  problem or cancel the operation.
  1115.  
  1116. Wssindex 5.27                   10                          Setup
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129. The usual problems which can be detected this way are disk  write
  1130. protected,  not ready  or not  formatted.   Disk full  errors are
  1131. handled properly, but at  a different level.  In  future releases
  1132. the error handling will be extended to catch all disk errors.
  1133.  
  1134. The current coding will not detect the various failures which can
  1135. occur in the middle of reading or writing a file, but such errors
  1136. generally indicate a serious problem which may not be recoverable
  1137. in any  case.  If you  do get the "Abort,  Retry, Fail?" message,
  1138. you must be  careful how you  respond.  If  you respond "A",  you
  1139. return to DOS and lose whatever you were working on.  But, that's
  1140. not the worst thing that can happen.  If the failure happens on a
  1141. write operation, and  you swap disks  before responding "R",  DOS
  1142. will  probably write the directory  and file access  table of the
  1143. original disk onto the second disk.  This is really a design flaw
  1144. in MS-DOS, not a WSSINDEX problem, and most  any program can suf-
  1145. fer from it.   It is generally safe to fix  the problem and retry
  1146. with the same disk.   The result of failing an error  will depend
  1147. on  exactly what operation failed, but you can usually recover by
  1148. responding fail, although you may have to do so several times.
  1149.  
  1150.  
  1151.                          Acknowledgements
  1152.  
  1153. WSSINDEX started out as an exercise to learn C for  my "real job"
  1154. and to  fill my needs for  a disk indexing package,  and ended up
  1155. growing into a major  project.  Two special software  tools which
  1156. have  proved invaluable  in  producing various  releases of  this
  1157. package are OPUS MAKE (D. G. Kneller & J. F. Thomason, Opus Soft-
  1158. ware, 1032 Irving  St. Suite 439, San  Francisco, CA   94122) and
  1159. the PD M4 macro preprocessor (Ozan S. Yigit with modifications by
  1160. John Levine).  The video board configuration information  is pri-
  1161. marily from DOSREF17  Programmer's Technical Reference for  MSDOS
  1162. and the IBM PC, Copyright 1990 by Dave Williams.  Special  thanks
  1163. to  Paul St. George, Nate Horowitz, Don Wetzel, and other members
  1164. of  the Sanyo New England Users Group  for encouraging me to dis-
  1165. tribute my early efforts as shareware.   Also thanks to all those
  1166. who  have registered the shareware version, and to those who sug-
  1167. gested  program  enhancements.     And  finally,  thanks  to  the
  1168. countless bulletin board sysops who provide the distribution net-
  1169. work for shareware programs.
  1170.  
  1171.  
  1172.                     Archive and Graphics Files
  1173.  
  1174. The idea  of combining files into an archive or library, and pos-
  1175. sibly compressing them at the same time, is older than MS-DOS.  A
  1176. more recent idea is the concept of appending a compressed file to
  1177. a  small extraction routine,  creating a  self-extracting archive
  1178. file.  WSSINDEX can peer into certain types of archive  files and
  1179. extract directory information.  Note that it is only the directo-
  1180. ry information  which is  extracted; file viewing  and extraction
  1181.  
  1182. Wssindex 5.27                   11                          Setup
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195. are not  implemented.  WSSINDEX can also  extract useful informa-
  1196. tion from graphics formats,  namely the image size and  number of
  1197. colors. 
  1198.  
  1199. Archive files are identified  by their file extension.   Since it
  1200. is possible  for a non-archive file to have a name which makes it
  1201. appear  to be an archive, you may get warnings when indexing that
  1202. such files are  either not archives or are corrupted.   If such a
  1203. message  is given for  a file which  you think is  a archive, you
  1204. should use the appropriate archive utility to test the  integrity
  1205. of  the file.   Self-extracting  archives all  have .COM  or .EXE
  1206. extensions, and  so are not easily  distinguishable from ordinary
  1207. executable files, nor is the archiver used immediately apparent.
  1208.  
  1209. In most but not all cases,  extraction of information from an ar-
  1210. chive file is  noticeably slower than reading a directory because
  1211. the  information is  scattered throughout  the file,  rather than
  1212. being  concentrated in one place.  You will probably notice a lot
  1213. of disk  activity when extracting archive  information.  Self-ex-
  1214. tracting archives are the  slowest because they must be  examined
  1215. to determine which archiver, if any, was used to create them.
  1216.  
  1217. Some of the  archive formats  may be used  on non-MS-DOS  systems
  1218. which  allow file  names which  are illegal  under MS-DOS.   When
  1219. WSSINDEX extracts information  from such an archive, the two com-
  1220. ponents of the file name are  truncated to 8 and 3 characters but
  1221. retain their original case.   If you transfer archive  files from
  1222. another operating system to MS-DOS, remember that these are bina-
  1223. ry files  and improper character  translations can make  them un-
  1224. readable.  Some  of the archive formats  can include subdirectory
  1225. information; WSSINDEX will ignore this information.   Some of the
  1226. archive  formats allow entries to be  marked as deleted; WSSINDEX
  1227. will  ignore such entries.  If an archive format allows inclusion
  1228. of comments,  and the WSSINDEX configuration  selects comment ex-
  1229. traction, the  leading characters of the  comment (after removing
  1230. any leading or trailing blanks, unprintable characters, box form-
  1231. ing characters or  strings of more  than two consecutive  blanks)
  1232. are included in the  database.  The maximum number  of characters
  1233. extracted used  to be fixed at  64 but is now  configurable up to
  1234. 1023.
  1235.  
  1236. Archive files introduce two complications in the operation of re-
  1237. placing a commented disk  in the database.  First,  which comment
  1238. should be  used if a  comment has been extracted  from an archive
  1239. and the  file already  had a comment  in the  database?   Current
  1240. choice is to accept  the comment extracted from the  archive, but
  1241. I'm  not certain  that this  is the  best choice.    Second, what
  1242. should be done if a member of an archive file matches the name of
  1243. an  ordinary,  commented file  in the  same subdirectory?   Quite
  1244. probably the  files are identical,  but they could  be completely
  1245. different,  and WSSINDEX has no reliable way to tell which is the
  1246. case.   The current program  version uses the following algorithm
  1247.  
  1248. Wssindex 5.27                   12     Archive and Graphics Files
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261. to decide whether  to copy a comment after  it has found matching
  1262. file and subdirectory names:  if both files are archive  members,
  1263. the archive file names must match, and if only one of the pair is
  1264. in an archive file, the size and date must match.   I am not com-
  1265. pletely  satisfied with this algorithm and am open to any sugges-
  1266. tions for a better technique.
  1267.  
  1268. The formats  of various archive  files sometimes change  with new
  1269. releases  of  archiving  programs.    Such  changes  may  prevent
  1270. WSSINDEX from  extracting information.   For example,  LHARC 2.0x
  1271. writes by default files which are not readable by  LHARC 1.xx, or
  1272. by  any version  of Wssindex  older than  5.1.   Fortunately, new
  1273. compression methods  usually do not require  changing header for-
  1274. mats, so WSSINDEX is usually not broken by archiver changes.
  1275.  
  1276.  
  1277.                     Archive Formats Supported
  1278.  
  1279. ARC, ARK, PAK, PKA, SDN - As far as WSSINDEX  is concerned, these
  1280. extensions all refer to variants of the same type of archive.  An
  1281. extraction program might not  be able to handle all of  these be-
  1282. cause some of them may use  unrecognized compression methods, but
  1283. the header information has the same  format in all four.  The ARC
  1284. extension  is used with the archive format which is currently the
  1285. most popular.  ARC  files may be created by ARC (Systems Enhance-
  1286. ment  Associates, 21 New Street, Wayne, NJ  07470) or PKARC/PKPAK
  1287. (PKWare  7545 N. Port  Washington Road,  Suite 205,  Glendale, WI
  1288. 53217).  ARK is the  extension used by a  CP/M port of ARC.   The
  1289. PAK  extension is used by PAK (NoGate Consulting, P.O. Box 88115,
  1290. Grand Rapids, MI  49518).  When a version of PKARC was introduced
  1291. which  had a compression method not recognized by ARC, some users
  1292. recommended changing the extension to PKA.   SDN is a format used
  1293. by the Software  Distribution Network, essentially the same  as a
  1294. PAK file.
  1295.  
  1296. ARJ - Files  with this  extension are created  by ARJ (Robert  K.
  1297. Jung, 2606 Village Road West, Norwood,  MA 02062).  ARJ files can
  1298. span volumes,  in which case  the continuation files  have exten-
  1299. sions A00,  A01,...  Wssindex recognizes  the continuation files,
  1300. but does not record  whether an archive member spans  two archive
  1301. files.  A  recent ARJ  release allows more  than 99  continuation
  1302. files,  in  which  case   the  extensions  are  3-digit  numbers.
  1303. Wssindex does not  test whether files with 3-digit extensions are
  1304. ARJ files  because too many  other files are likely  to have this
  1305. type of  extension.   The only conceivable  use for  an ARJ  file
  1306. which occupies more than 100 disks is a hard disk  backup, and if
  1307. your backups take more than 100 disks, you really should consider
  1308. getting a tape drive.  Self-extracting ARJ files are supported by
  1309. Wssindex.
  1310.  
  1311.  
  1312.  
  1313.  
  1314. Wssindex 5.27                   13     Archive and Graphics Files
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327. HYP - Hyper is a German program by Peter Sawatzki and Klaus Peter
  1328. Nischke.  An October 15, 1991 PC Magazine comparison of archiving
  1329. programs rated Hyper best at compressing spreadsheet files.
  1330.  
  1331. LBR - This format was defined by Gary Novosielski for use on CP/M
  1332. and  MS-DOS systems and many programs exist which can create this
  1333. type  of archive.  Although no longer popular, this format allows
  1334. quick access to any archive member because the directory informa-
  1335. tion is  all in one  place at the  beginning of  the file.   Time
  1336. stamps stored in a LBR file are relative to 1/1/76,  but are con-
  1337. verted to the MS-DOS standard by WSSINDEX.  This means that files
  1338. dated before 1/1/80  will appear to be dated  1/1/80.  There also
  1339. exist LBR utilities which do not fill in the date and time infor-
  1340. mation; these will also produce file dates of 1/1/80.  
  1341.  
  1342. LZH,  LZS - Files with  these extensions are created respectively
  1343. by the Japanese  programs LHARC (Haruyasu Yoshizaki)  or LARC (K.
  1344. Miki,  H. Okumura, K.  Masuyama).  Self-extracting  LZH files are
  1345. supported by Wssindex.
  1346.  
  1347. ZIP  - ZIP files are  created by PKWare's  PKZIP (address above).
  1348. ZIP  files  may  be  created  on  non-MS-DOS  operating  systems;
  1349. WSSINDEX  should be  able to  handle such  files, except  for the
  1350. above mentioned truncation of  file names.  A volume  name stored
  1351. by  PKZIP will appear as a zero-byte  file.  ZIP files created by
  1352. PKZip 2.04c or  higher may  span multiple disks.   Wssindex  will
  1353. normally flag all but the  last piece of a multi-volume ZIP  file
  1354. as  either corrupt or continued.  When  the last file of a multi-
  1355. volume ZIP  is cataloged, Wssindex  will prompt for  the previous
  1356. disk in  the set  if the ZIP  file directory itself  spans disks.
  1357. The  ZIP file format does not contain enough information to unam-
  1358. biguously identify the  middle files  of a multi-volume  ZIP.   A
  1359. particularly bad case would be  a ZIP inside a ZIP.   Such a file
  1360. is  most likely  not further  compressed, and  its  directory may
  1361. happen to  be positioned at the end of  a file, in which case its
  1362. directory is indistinguishable from  a directory for the contain-
  1363. ing ZIP file.  There is also some ambiguity in  the definition of
  1364. the file format, and the fact that PKZip  2.04g can write spanned
  1365. ZIP's  which PKUNZip  2.04g says  are corrupt  means that  future
  1366. format changes may be  necessary.  Self-extracting ZIP  files are
  1367. supported by Wssindex.
  1368.  
  1369. ZOO - The ZOO archive utility (by Rahul Dhesi) is available under
  1370. many different operating systems, and the file format is supposed
  1371. to be the same on all of them.
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380. Wssindex 5.27                   14     Archive and Graphics Files
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.                     Graphics Formats Supported
  1394.  
  1395. The image size  and number  of colors for  graphics files can  be
  1396. placed in the category field in the format width x  height x col-
  1397. ors.  If  an image appears to be black  and white, either because
  1398. of a flag in the file  or because the color table has equal  red,
  1399. green and blue  intensities for all colors, the category includes
  1400. the string "monochrome".   When reindexing, this information will
  1401. not replace an existing category.
  1402.  
  1403. BMP - Bitmapped  images used by Windows 3.0 and  OS/2.  I believe
  1404. that  earlier versions of Windows  used the same  extension but a
  1405. different file format, but I have no examples for testing.
  1406.  
  1407. GIF - Stands for  Graphics Interchange Format, a service  mark of
  1408. Compuserve.  The GIF format allows for files which do not contain
  1409. an image, but it is likely that only test files will use this op-
  1410. tion.  Such files will trigger a warning message.  A GIF file may
  1411. also contain multiple  images; WSSINDEX will  only see the  first
  1412. one.   I've seen one example  of what a viewing  program called a
  1413. GIF file with a MAC header.  Wssindex will reject such a file.
  1414.  
  1415. JPG - JPEG format, originally defined by the  Joint Photographics
  1416. Experts  Group.   This is a  lossy image compression  format.  It
  1417. allows for either 8-bit grayscale or 24-bit color images.  Gener-
  1418. ally, JPEG images require less disk space, but significantly more
  1419. time to display.  There are some documented header constructs for
  1420. which I have no samples for testing, and discussions of  the file
  1421. format include complaints of  programs which produce incompatible
  1422. JPEG  files.  Samples of  any valid files  which Wssindex rejects
  1423. would be appreciated.
  1424.  
  1425. PCX - Zsoft format commonly used by paint programs.
  1426.  
  1427. TIF - Tagged Image Format from Aldus.
  1428.  
  1429.  
  1430.                    Navigating through the menus
  1431.  
  1432. Wssindex  is controlled  by  a series  of  menus and  data  entry
  1433. screens.  The  overall structure  is shown in  the figure  below.
  1434. For the most part, related functions are put on the same menu.  A
  1435. few items which might logically be used in different contexts are
  1436. repeated  on multiple menus.  The appearance of the menus depends
  1437. on whether screen writing  is done by  DOS calls or direct  video
  1438. writes.  In DOS-calls mode, menus are not surrounded by boxes and
  1439. there is no highlight  bar because displaying these in  this mode
  1440. is very time consuming.
  1441.  
  1442. Operation of the menus is fairly straightforward.  A menu item is
  1443. selected  by either hitting a trigger key which is highlighted in
  1444. the menu, or  by hitting return or  space when the  highlight bar
  1445.  
  1446. Wssindex 5.27                   15     Archive and Graphics Files
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459. and cursor are positioned on the desired item.  The highlight bar
  1460. can be moved with the cursor  keys or with a mouse; HOME  and END
  1461. move the selector bar  to the first and  last menu items  respec-
  1462. tively; ESCAPE returns  to the  previous menu,  or refreshes  the
  1463. screen if at the top-level menu.  The left mouse button is equiv-
  1464. alent to the space bar, the  right button to the return key.   If
  1465. you hit a  key which is  not the trigger  for any displayed  menu
  1466. item, it is assumed that you are entering a value for the current
  1467. item.  The area below  a menu box is used for message display and
  1468. user entry of items such as file names.
  1469.  
  1470. After a menu item has been selected, and any processing for  that
  1471. item  is completed,  an attempt  is made  to make  an intelligent
  1472. choice whether to leave the cursor positioned on the same item or
  1473. to advance to the next item.  The method  used to select the menu
  1474. item  affects the decision whether to advance  to the next.  If a
  1475. menu item  is selected by hitting return  or the right mouse but-
  1476. ton, the  cursor will always advance  to the next menu  item.  On
  1477. the other hand, if a menu item is selected by hitting the trigger
  1478. key, the  space bar or  left mouse  button, the cursor  will only
  1479. advance to  the next menu item if it seems unlikely that the cur-
  1480. rent item will be reselected.  For example, if you have toggled a
  1481. YES/NO  value or typed  in a numeric  value for a  parameter, you
  1482. probably want to advance to the next item.  If you don't like the
  1483. automatic cursor advance,  there is a  menu selection to  disable
  1484. it.
  1485.  
  1486.       +---------------------------------------------------+
  1487.       | Main menu                                         |
  1488.       |     Listing menu                                  |
  1489.       |     Add disks menu                                |
  1490.       |     Add comments menu                             |
  1491.       |     Primary configuration menu                    |
  1492.       |          Printer configuration                    |
  1493.       |               Postscript printer setup            |
  1494.       |          Database size configuration              |
  1495.       |          Indexing options                         |
  1496.       |              Default sorting/selection options    |
  1497.       |              Archive file extraction selection    |
  1498.       |              Graphics file extraction selection   |
  1499.       |              Self-extracting file selection       |
  1500.       |          Screen, keyboard, miscellaneous          |
  1501.       |              Color selection                      |
  1502.       |              Video board configuration            |
  1503.       |          Keyboard macros                          |
  1504.       |          Exceptions list                          |
  1505.       |          Fields to print                          |
  1506.       |          Output format                            |
  1507.       |                                                   |
  1508.       +---------------------------------------------------+
  1509.           Figure 1. Structure of the Wssindex menu tree
  1510.  
  1511.  
  1512. Wssindex 5.27                   16                          Menus
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525. Figures show menus as  they appear on screen, or  slightly edited
  1526. to fit within the margins of this document.
  1527.  
  1528.                             Main Menu
  1529.  +-------------------------------------------------------------+
  1530.  |                     Wssindex Main Menu                      |
  1531.  |                                                             |
  1532.  | Major functions                 Database maintenance        |
  1533.  |   Add or label disks              Add/modify Comments       |
  1534.  |   ^F quick find                   Import comments           |
  1535.  |   Print and other output menu     ReName a disk in database |
  1536.  |   Write database to disk          ^N rename with mixed case |
  1537.  |   Display statistics              Remove disks              |
  1538.  |   ^D - list directory             ^R remove all disks       |
  1539.  |   ABout Wssindex                  Purge duplicate Volumes   |
  1540.  |                                                             |
  1541.  | Configuration                   Terminate/suspend           |
  1542.  |   Get or merge database           Push to DOS               |
  1543.  |   ^G get database and CNF file    Quit                      |
  1544.  |   Change cOnfiguration info       ^Q quick quit             |
  1545.  +-------------------------------------------------------------+
  1546.  
  1547. Figure 2. Wssindex Main Menu.  This top level menu provides imme-
  1548. diate access to some of the more commonly used functions, as well
  1549. as entry to the output, indexing and configuration menus.
  1550.  
  1551.  
  1552. A - Add or label disks
  1553.     This option leads to the indexing menu.
  1554.  
  1555. ^F - Quick Find (control-f)
  1556.     This is the option to use if you are looking for a particular
  1557.     file by  name and want  unsorted screen output.   You will be
  1558.     prompted to  enter one or more  wildcard file specifications.
  1559.     This option  is duplicated  on the  Print sub-menu  (page 23)
  1560.     where it is discussed in more detail.
  1561.  
  1562. P - Print and other output menu
  1563.     This option leads to the print sub-menu.
  1564.  
  1565. W - Write database on disk
  1566.     The  in-memory database is saved  on disk.   The default file
  1567.     name is the first of
  1568.  
  1569.     1.  The last file name used in a Get or Write command
  1570.     2.  The second command line argument
  1571.     3.  The  DOS  environment variable  WSSIDIR (DOS  command set
  1572.         WSSIDIR=filespec)
  1573.     4.  WSSINDEX.DIR
  1574.  
  1575.     which is defined.  The default file name is displayed and may
  1576.     be edited in  the usual way.  A previously existing file with
  1577.  
  1578. Wssindex 5.27                   17                          Menus
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.     the same name will either be renamed with a .BAK extension or
  1592.     overwritten (with verification),  depending on which configu-
  1593.     ration option you have  selected.  If creation of  .BAK files
  1594.     is enabled, you will not be allowed to use a  filename with a
  1595.     .BAK extension.
  1596.  
  1597. D - Display statistics
  1598.     This option displays the  number of files, subdirectories and
  1599.     disks  in the database,  and the amount  of contiguous memory
  1600.     remaining for additional  entries.  There  will always be  at
  1601.     least one subdirectory listed,  since the root directories of
  1602.     all  disks are treated as  one subdirectory.   Also listed is
  1603.     the current  database name,  either from the  last read/write
  1604.     operation or the default name.
  1605.  
  1606.     Some points about the  reported memory remaining: this number
  1607.     will only decrease when the number of subdirectories increas-
  1608.     es, or when  comments and  categories are added.   Space  for
  1609.     other  information  is allocated  during  the  initial setup.
  1610.     (This was not true in versions  older than 3.30.)  It is only
  1611.     the  contiguous space remaining which is reported.  If a disk
  1612.     with  subdirectories or  comments is  removed or  replaced, a
  1613.     "hole" may created in the memory space which will be used for
  1614.     comments,  etc. which are  added later.   Some operations may
  1615.     create  fragments of memory too small to be useful, hence the
  1616.     space remaining may change slightly  if you save the database
  1617.     on disk  and then reload it.   You will receive  a warning if
  1618.     the available space  drops below  4K.  The  program tries  to
  1619.     recover  gracefully from  out of  memory errors, but  doing a
  1620.     save to disk is  strongly recommend if you get  this warning.
  1621.     Also note that opening a file  requires at least 2K for buff-
  1622.     ers, so  you may not  even be able  to save your  database if
  1623.     there is too little memory free.
  1624.  
  1625. ^D - List directory (control-d)
  1626.     This  command lists  the directory  of a  disk to  the screen
  1627.     (file names only).   There are two options after  hitting ^D:
  1628.     either hit  return and the complete subdirectory tree is dis-
  1629.     played for  the disk in the first  indexing drive, or enter a
  1630.     wildcard file  specification including disk and  path and see
  1631.     everything which  matches that  specification.  Note,  if you
  1632.     enter a  file specification without specifying  the disk, the
  1633.     default  is the currently logged drive, not one of the index-
  1634.     ing drives, and to see all  files on a disk (in one subdirec-
  1635.     tory) you  must use the *.* wildcard, not just d:.  The list-
  1636.     ing can be terminated  by hitting control-c.  You  might want
  1637.     to use  this option to find  out what's on a  disk before you
  1638.     label it,  or to refresh your memory of the names of your da-
  1639.     tabases.    This option  is duplicated  on the  Indexing menu
  1640.     (page 32).
  1641.  
  1642.  
  1643.  
  1644. Wssindex 5.27                   18                      Main Menu
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657. B - ABout Wssindex
  1658.     Displays version number and copyright information.
  1659.  
  1660. G - Get or merge a database from disk
  1661.     Enter the name of a  file previously saved with the "W"  menu
  1662.     option. The default name is the first of
  1663.  
  1664.     1.  The last file name used in a Get or Write command
  1665.     2.  The second command line argument
  1666.     3.  The  DOS environment  variable WSSIDIR  (DOS command  set
  1667.         WSSIDIR=filespec)
  1668.     4.  WSSINDEX.DIR
  1669.  
  1670.     which is defined.  The default file name is displayed and may
  1671.     be edited in the usual way,  or you can hit TAB and  select a
  1672.     file from a full-screen display.   If you have a database  in
  1673.     memory, you will be  warned and given the options  of merging
  1674.     or replacing.   You will also be warned if you ask to replace
  1675.     a  database  which  has  been changed  without  being  saved.
  1676.     Merged databases are tested  for duplicate volume names.   If
  1677.     any are found, the "V" option should be used to delete them.
  1678.  
  1679. ^G - Get configuration file and matching database (control-g)
  1680.     This  option prompts for the name of a configuration file and
  1681.     loads it without displaying the configuration menu.  If there
  1682.     are  no problems  configuring, the  default database  name is
  1683.     changed  to be the same  as the configuration  file name, but
  1684.     with a DIR extension, and a get-database function is  execut-
  1685.     ed.  This same function can also be executed from the command
  1686.     line when  starting up  by specifying the  configuration file
  1687.     name as the first argument and an equal sign (=)  as the sec-
  1688.     ond.
  1689.  
  1690. O - Change cOnfiguration
  1691.     This option leads to the primary configuration sub-menu.
  1692.  
  1693. C - Add/modify Comments
  1694.     This options leads to the add-comments screen.
  1695.  
  1696. I - Import comments
  1697.     This option reads a text file containing file names, comments
  1698.     and  categories and  assigns the  comments and  categories to
  1699.     matching file names  in the currently  loaded database.   The
  1700.     text  file might be a listing  of files from a bulletin board
  1701.     or the ascii output from another disk indexing program.  This
  1702.     option  does not create a database from scratch from an ascii
  1703.     input file, so it  is not what is  normally called an  import
  1704.     routine.   In releases prior to 5.1, this function was imple-
  1705.     mented by a stand-alone utility called WSIMPORT.  That utili-
  1706.     ty is now obsolete.
  1707.  
  1708.  
  1709.  
  1710. Wssindex 5.27                   19                      Main Menu
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.     Features:
  1724.  
  1725.     1.  Filename format  may be  either FILENAME.EXT  or FILENAME
  1726.         EXT (but not a mixture).
  1727.     2.  File names, comments and categories may be in any order.
  1728.     3.  Filenames may be in mixed case.
  1729.     4.  Tabs are expanded.
  1730.     5.  Processing speed is around 1000 lines per minute, depend-
  1731.         ing on the database size and your CPU speed.
  1732.     6.  Header or other garbage lines are ignored.
  1733.  
  1734.     Requirements on the input file:
  1735.  
  1736.     1.  Anything appearing after the comment/category (except the
  1737.         file  name or  category/comment) will  be interpreted  as
  1738.         part of the comment or category.
  1739.     2.  File names,  comments and categories must  begin in fixed
  1740.         columns.
  1741.     3.  Comments and categories must  be on the same line  as the
  1742.         file name.
  1743.     4.  Lines must end with line feeds (if you can type the file,
  1744.         it meets this requirement).
  1745.  
  1746.     Before starting  the program, you should  examine the comment
  1747.     file, either by typing it or with a text editor, to determine
  1748.     in which columns the file names (and extensions if the format
  1749.     is not FILENAME.EXT), comments  and categories begin.  Number
  1750.     the columns  starting with one, not zero.   This step may not
  1751.     be  necessary since Wssindex will show you the first 15 lines
  1752.     of the import  file with a ruler line before asking you about
  1753.     the  file, but if the  comments start after  these lines, you
  1754.     won't see them, and if the lines  are longer than your screen
  1755.     width, the display may not be very readable.   In general, it
  1756.     is not necessary  to remove headers or other extraneous lines
  1757.     from the  input file; they will simply not match any files in
  1758.     the database and will thus be ignored.  But, if there are any
  1759.     control characters embedded in the comments (such as might be
  1760.     introduced by line noise in a downloaded file) they should be
  1761.     removed or else  they will be  interpreted as the end  of the
  1762.     comment.  You can be a little sloppy with the starting column
  1763.     for comments  since the program  will remove any  leading (or
  1764.     trailing) blanks.
  1765.  
  1766.     You are  prompted for the  name of the  comment file  and the
  1767.     format (FILENAME.EXT  or FILENAME EXT and  starting columns).
  1768.     You will be given  the option to override or  keep previously
  1769.     existing  comments in the database if a new comment is found.
  1770.     If the input file  does not include categories, you  can also
  1771.     specify a category string which will be applied to every file
  1772.     which has a new comment assigned (unless you prohibit replac-
  1773.     ing  comments and the file  had a category  but not a comment
  1774.     previously assigned).
  1775.  
  1776. Wssindex 5.27                   20                      Main Menu
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.     After initializing,  the database is sorted by  file name and
  1790.     extension.  You already know about how long this will take if
  1791.     you have used any  of the sorting options  in WSSINDEX.   The
  1792.     program remembers the sequence number where each letter first
  1793.     appears, and  starts searching for  matching files there.   A
  1794.     fancier  hashing algorithm and a binary search could be used,
  1795.     but my testing indicates that the sorting time will typically
  1796.     be  as long or longer than the processing time for reasonable
  1797.     sized input files, so not much can be gained here.
  1798.  
  1799.     The comment file is read line-by-line, and lines which appear
  1800.     to contain a filename and a comment are processed.  Note that
  1801.     the same comment may be applied to multiple database entries,
  1802.     since disk and subdirectory names are not checked.
  1803.  
  1804.     When  the program  finishes processing  the comment  file, it
  1805.     prints out a few statistics (number of input lines, number of
  1806.     comments applied, etc.)   and gives you the option  of making
  1807.     another  pass with  a different comment  file.   The database
  1808.     does not need  to be resorted for multiple passes,  so if you
  1809.     have multiple  comment files, it  saves time to  process them
  1810.     together.
  1811.  
  1812. N - ReName a disk in the database
  1813.     You  are prompted for old and new  names and the disk name in
  1814.     the database is changed.  Names  are forced to upper case.  A
  1815.     carriage return aborts back to the main menu.
  1816.  
  1817. ^N - ReName a disk with a mixed case label (control-n)
  1818.     This is the same as option  "N" except that it accepts  lower
  1819.     case characters.
  1820.  
  1821. R - Remove a disk from the database
  1822.     The volume name to remove may be either typed in or read from
  1823.     disk.   When  typing in a  name, you can  either let WSSINDEX
  1824.     force your input to upper case or use mixed case.
  1825.  
  1826. ^R - Remove all disks (control-r)
  1827.     This option clears the database currently in memory.  A warn-
  1828.     ing is  given if the  database has not  been saved since  the
  1829.     last modification.
  1830.  
  1831. V - Purge duplicate Volumes
  1832.     If  you merge two databases,  you may end  up with duplicated
  1833.     volume names.  Selecting this  option purges duplicates.   To
  1834.     decide  which entry  to discard, the  dates indexed  are com-
  1835.     pared.   If the dates are different,  the oldest entry is de-
  1836.     leted.  Otherwise, the number of files on disk is checked and
  1837.     the  entry with the larger number is  kept.  If the number of
  1838.     files  also matches,  the first  entry is  kept.   Deleting a
  1839.     small number  of duplicates  doesn't take terribly  long, but
  1840.  
  1841.  
  1842. Wssindex 5.27                   21                      Main Menu
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.     deleting many duplicates  from a large  database can be  time
  1856.     consuming.
  1857.  
  1858. S - Push to DOS
  1859.     Load a secondary copy of COMMAND.COM (or alternate processor)
  1860.     and  temporarily pass control to  it.  Return  to WSSINDEX by
  1861.     typing EXIT at the DOS prompt.  To remind you that you are in
  1862.     a secondary shell, the configuration can be set to change the
  1863.     DOS prompt  to  "EXIT to  return to  Wssindex <newline>  <old
  1864.     prompt>".  You  can do anything  you can  normally do at  DOS
  1865.     level, but you  will have less free memory to  work with.  It
  1866.     is best not  to load  a terminate and  stay resident  program
  1867.     here because  it will fragment the memory space.  The DOS en-
  1868.     vironment variable COMSPEC is used to locate the command pro-
  1869.     cessor, so this option will work even if you have renamed, or
  1870.     are using a replacement for, COMMAND.COM.  COMSPEC is normal-
  1871.     ly set up  correctly during  the boot process  and you  don't
  1872.     need  to worry  about it  unless you  have done  something to
  1873.     change it.  If COMSPEC is not defined, an attempt  is made to
  1874.     load COMMAND.COM from the root directory of the logged drive.
  1875.  
  1876.     You must have some free memory to use this option, and insuf-
  1877.     ficient space is the usual cause when this command fails.  On
  1878.     a DOS 2.11 system, I need about 17.5K (as reported by the "D"
  1879.     option);  later DOS's are larger  and will require  more.  Of
  1880.     course, if you want to run  a program in the secondary shell,
  1881.     you    must   also   consider    its   memory   requirements.
  1882.     Wssindex/Extended leaves considerably more memory free  for a
  1883.     DOS shell.
  1884.  
  1885. Q - Quit and return to DOS
  1886.     You will be warned if the in-memory database has been changed
  1887.     without being saved, and in any case you must verify that you
  1888.     really want to exit.  For your protection, the default option
  1889.     is  N (don't  quit) if  the in-memory  database has  not been
  1890.     saved.
  1891.  
  1892. ^Q - Quick Quit and return to DOS (control-q)
  1893.     If the  in-memory database has  not been changed  since being
  1894.     saved, this option returns to DOS  without asking for verifi-
  1895.     cation, otherwise it's the same as option "Q".
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908. Wssindex 5.27                   22                      Main Menu
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.                             Print menu
  1922. +---------------------------------------------------------------+
  1923. |                   File/volume listing Menu                    |
  1924. |                                                               |
  1925. |   Select/sort/Print   Options requiring printer config file   |
  1926. |   Find a file                                                 |
  1927. |   ^F quick find           Multi-column printing               |
  1928. |   Zippy text search       MulTi-column dup/unique/no backup   |
  1929. |   Duplicate files         Disk Covers                         |
  1930. |   Unique files            Disk Labels                         |
  1931. |   Files not Backed up     REad printer definition file        |
  1932. |                                                               |
  1933. |   List Volumes            COnfiguration menu                  |
  1934. |   ^V quick volume list    Return to main menu                 |
  1935. +---------------------------------------------------------------+
  1936. Figure 3. Wssindex print menu.  The options marked as requiring a
  1937. printer configuration file are intended for printer or disk  out-
  1938. put.  You can direct their  output to the screen, but there  will
  1939. not be pauses when the screen fills.
  1940.  
  1941.  
  1942. P - Print (and sort)
  1943.     The print option first  allows you to select what  files will
  1944.     be listed.   Files to be  listed may be  selected by combina-
  1945.     tions of
  1946.  
  1947.       1. names and extensions  10. category
  1948.       2. subdirectory          11. date range
  1949.       3. disk name             12. size range
  1950.       4. names starting from   13. exclude configured exceptions
  1951.       5. extensions from       14. exclude archive file members
  1952.       6. subdirs starting from 15. only archive files and members
  1953.       7. disks starting from   16. archive members by arc name
  1954.       8. disk numerically from 17. zippy search
  1955.       9. comment               18. select from previous subset
  1956.  
  1957.     You tell the program  which selection criteria to use  by en-
  1958.     tering a list of  numbers separated by commas.   Depending on
  1959.     which options  you chose,  further prompts  will be  made for
  1960.     file  names, etc.    Each file  in  the database  is  checked
  1961.     against all of the selection criteria, and is included in the
  1962.     listing only if  it passes all tests.  This  means, for exam-
  1963.     ple, that while you  can select files in which are  in subdi-
  1964.     rectory \ABCD and match *.DAT, you can not select files which
  1965.     are either in the subdirectory or match the file spec.   This
  1966.     restriction  does not interfere with most selection requests;
  1967.     the  occasional odd request can often be built up with multi-
  1968.     ple passes.
  1969.  
  1970.     Files in the database  can also be excluded from  the listing
  1971.     by the first 10 options  in this list.  You indicate  this by
  1972.     using a negative  selection option number.  Option -1, rejec-
  1973.  
  1974. Wssindex 5.27                   23                     Print Menu
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.     tion by file name, is essentially the same as option 13,  ex-
  1988.     clusion of configured exceptions, except that different lists
  1989.     of  names are used.  The recommended  mode of operation is to
  1990.     put the file names which you  always want to exclude into the
  1991.     configured exceptions list (which is semi-permanent and rela-
  1992.     tively awkward to  revise), and  use the option  -1 list  for
  1993.     special cases.  For example, depending on the sort order, you
  1994.     may or  may not want to  see the .ID entries  for volumes and
  1995.     subdirectories.  The option -1 rejection list  is the obvious
  1996.     way to get rid of these entries, although you can  also do it
  1997.     by selecting only files larger than 0 bytes.
  1998.  
  1999.     Selection  option numbers  are entered  in  a comma-delimited
  2000.     list; the order is  not significant.  All but options 13, 14,
  2001.     15 and 18 lead to prompts  for more information.  Options -1,
  2002.     1 and 17 accept multiple  items, one per line, ending with  a
  2003.     null  line.  All selection options are case insensitive.  The
  2004.     default list of options is configurable, and can be edited in
  2005.     the usual way.
  2006.  
  2007.     When entering  a list  of wild-card file  specifications, you
  2008.     can  switch to full-screen editing  mode by hitting  tab.  If
  2009.     you immediately tab into full-screen after having  previously
  2010.     entered file selection specifications, the  previous specifi-
  2011.     cations are remembered and  displayed for editing.    You can
  2012.     make  up to  100 entries  (5 columns  of 20  specifications).
  2013.     Normal editing commands are available.  Any  cursor arrow mo-
  2014.     tion off the left or right end of an entry  is interpreted as
  2015.     a move to the next column.   Hitting HOME moves the cursor to
  2016.     the beginning of  the current entry, or if already there,  to
  2017.     the first entry in the list.  Similarly, hitting END moves to
  2018.     either the  end of the current  entry or to the  last item in
  2019.     the  list.  ^E deletes the  current entry, ^A deletes all en-
  2020.     tries, ^R redraws the  screen (useful after deleting entries)
  2021.     and F10 indicates that all entries are completed.
  2022.  
  2023.     If you want archive  file members, but not the  archive files
  2024.     themselves, include *.ARC, *.LBR,  etc. in one of the  excep-
  2025.     tion lists.
  2026.  
  2027.     When character  string input is  required, you can  enter two
  2028.     different  types of wildcard.   The first is  similar to what
  2029.     the  DOS DIR  command accepts:  a question  mark  matches any
  2030.     character and an  asterisk matches all characters  to the end
  2031.     of the string.  A few examples:
  2032.  
  2033.         * or *.*    matches any file.
  2034.         *.          matches any file with no extension.
  2035.         xy*         matches any subdirectory, disk name, comment,
  2036.                     or category which begins with the letters xy.
  2037.         ???         matches anything 0 to 3 characters long.
  2038.         return      matches absence of comment or category.
  2039.  
  2040. Wssindex 5.27                   24                     Print Menu
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.     The  second type of wildcard allows you to search for charac-
  2054.     ters when you don't know  their position in the string.   Es-
  2055.     sentially, this  is a  keyword search,  except that  parts of
  2056.     words can also  be matched.  Simply begin the  string with an
  2057.     asterisk  and put the text immediately after it.  The primary
  2058.     use  for this type of wildcard is for searching comments, but
  2059.     it also works for other string items.  For example:
  2060.  
  2061.         *LOTUS   matches a string containing the substring LOTUS.
  2062.         *123     matches a file name containing characters 123.
  2063.         **       matches any string which contains an asterisk
  2064.         ?*123.*  doesn't  work  because  the  asterisk  isn't the
  2065.                  first character.   123 will be  ignored; this is
  2066.                  equivalent to *.*.
  2067.  
  2068.     Options  4-8  select ranges  of  file,  subdirectory or  disk
  2069.     names.  For  example, using  option 4, "select  by file  name
  2070.     starting from"  and  the wildcard  FI* would  all select  all
  2071.     files with names  beginning with FI, as well as all files be-
  2072.     ginning with G,H,...   Suppose you have disks filed  in boxes
  2073.     of 100 and you want to make separate listings of the contents
  2074.     of each  group.  If the  disks have numbers as  part of their
  2075.     volume labels, either of the form 321UTILITY or MISC123, then
  2076.     combining options 8 and  -8, you could select files  on disks
  2077.     numbered 100  or greater,  and reject  disks numbered 201  or
  2078.     higher, thus effectively selecting range 100 to 200.
  2079.  
  2080.     Option 17, the zippy search, is a wildcard search which looks
  2081.     almost everywhere: file name,  extension, comment and catego-
  2082.     ry.  A leading asterisk is assumed; you must not add another.
  2083.     The more  comprehensive search  options are slower  than just
  2084.     looking  at the beginning of each string, but they aren't too
  2085.     bad.  The name zippy search is taken from  a similar function
  2086.     in the PC Board bulletin board program; it's actually one the
  2087.     slowest selection options.
  2088.  
  2089.     Option 18, select  from previous subset,  is only offered  if
  2090.     you have previously selected files and have not done anything
  2091.     to invalidate the selection list.   Possible uses include ed-
  2092.     iting the previous selection  if it included too  many files,
  2093.     printing  the  same set  of files  that  were just  viewed on
  2094.     screen, or re-viewing with different sort keys.
  2095.  
  2096.     The selected files are optionally  sorted in ascending or de-
  2097.     scending order by any combination of
  2098.  
  2099.         1. file name                7. date and time
  2100.         2. extension                8. category
  2101.         3. disk name                9. comment
  2102.         4. disk name as number     10. archive file name
  2103.         5. subdirectory            11. archive file extension
  2104.         6. size
  2105.  
  2106. Wssindex 5.27                   25                     Print Menu
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.     When prompted,  enter or edit a comma-separated  list of sort
  2120.     key numbers,  changing the sign for  any key you  want in de-
  2121.     scending order.  (The default list is configurable.)  Most of
  2122.     the keys are self-explanatory, but the last two need a little
  2123.     explanation.  If you have elected to extract information from
  2124.     archive files, the file  name and extension used with  keys 1
  2125.     and 2 for members of an archive file are those of the archive
  2126.     file member.  Thus, with only  keys 1 and 2, the archive file
  2127.     members sort by their own  names.  Keys 10 and 11  select the
  2128.     archive file name for members of an archive file, or the usu-
  2129.     al name for ordinary files.  In addition, there  are two spe-
  2130.     cial conditions checked:
  2131.  
  2132.     1.  If sort keys 10  and 11 are used and have higher priority
  2133.         than 1 and 2, the archive  file itself will sort ahead of
  2134.         any of its members; 
  2135.     2.  If keys 1 and 2 have higher priority than 10 and 11, then
  2136.         archive members (and other files) are sorted by their own
  2137.         names.
  2138.  
  2139.     An interleaved list  of keys such as  1,10,2,11 will probably
  2140.     not  do anything useful.  If  there are multiple copies of an
  2141.     archive  file, you will probably want to have the disk and/or
  2142.     subdirectory  as an  intermediate key  when sorting  first by
  2143.     archive file name.  To summarize, 10,11,3,4,1,2 will list ar-
  2144.     chive members following  the containing  archive file,  while
  2145.     1,2 will list all files alphabetically.
  2146.  
  2147.     Sorting  by category  and comment  is case insensitive.   Any
  2148.     votes  on whether  this should  also be  true for  disk name?
  2149.     There is a noticeable  time penalty for making the  sort case
  2150.     insensitive.
  2151.  
  2152.     The  sort is done using  the Quicksort algorithm. The sorting
  2153.     time for a randomly ordered database of N files is O(N*logN),
  2154.     i.e., for large number of files, the sort time is proportion-
  2155.     al to N*log(N).
  2156.  
  2157.     If you elect not to sort (sort key equal zero or just hit re-
  2158.     turn), the selected files  will appear in the order  they are
  2159.     found  in the database, unless the files were selected from a
  2160.     previously  sorted subset,  in which  case the  previous sort
  2161.     order is preserved.
  2162.  
  2163.     When  the sort is finished, you can select whether the output
  2164.     goes  to your  printer, screen, a  disk file or  export.  For
  2165.     disk output you will be given the options of suppressing page
  2166.     headers and margins.  Disk output might be massaged by a text
  2167.     editor to change the format, read by another program, printed
  2168.     by a background printing utility while you do  something else
  2169.     in  the foreground,  or  transported to  another machine  for
  2170.     printing; it  is not  readable by the  "G" menu option.   For
  2171.  
  2172. Wssindex 5.27                   26                     Print Menu
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.     printer or disk  output, you will be given  the option to in-
  2186.     sert a variable number of blank lines whenever the first sort
  2187.     key changes (for screen output one blank line is inserted).
  2188.  
  2189.     Export  output is  in "Mailmerge"  format, a  standard format
  2190.     which can be read by many database programs.  Fields are sep-
  2191.     arated by a user-selected  character, normally a comma, hence
  2192.     this format  is often  called comma-delimited.   Fields which
  2193.     contain the separator character are surrounded by quotes, and
  2194.     fields which  contain a quote receive special  handling.  For
  2195.     some database  programs, in particular Lotus 1-2-3, it may be
  2196.     necessary  to enclose all fields in quotes; you are given the
  2197.     option to do this.
  2198.  
  2199.     Information in the configuration file is used to select which
  2200.     fields  are printed  for each  file, and  to  control paging.
  2201.     When  screen output  is selected,  you can  page forward  and
  2202.     backward with  the PgUp and PgDn  keys, go to the  top of the
  2203.     list with the HOME key (PF1 key for DEC Rainbow) or return to
  2204.     the main menu by hitting Q (or escape).  Control-s will pause
  2205.     any screen display; control-c will abort printing.
  2206.  
  2207. F - Find a file in the database
  2208.     Find is equivalent  to Print (described above) to  the screen
  2209.     unsorted.
  2210.  
  2211. ^F - Quick Find (control-f)
  2212.     Quick find  is equivalent  to  Print with  screen output  and
  2213.     files selected by name only.
  2214.  
  2215. Z - Zippy text search
  2216.     This option is equivalent to Print, with selection option 17,
  2217.     unsorted,  with output  to  the screen.    That is,  you  are
  2218.     prompted for a  string to  search for in  file names,  exten-
  2219.     sions, comments and categories.
  2220.  
  2221. D - List Duplicate files
  2222.     This option  lists all files which match the selection crite-
  2223.     ria  and have duplicates (which  also match).   Only the file
  2224.     name and extension,  and optionally the  time stamp and  file
  2225.     size, are  used to decide  whether two files  are duplicates.
  2226.     The dummy entries for volumes and subdirectories are automat-
  2227.     ically excluded.
  2228.  
  2229. U - List Unique files
  2230.     This option lists all files which match the selection  crite-
  2231.     ria and do  not have  duplicates which also  match.  This  is
  2232.     similar to the "B" option, but checks all files in a database
  2233.     rather than just those on  a single disk.  The dummy  entries
  2234.     for  volumes and  subdirectories are  automatically excluded.
  2235.     As with the  "D" option, you can optionally  require matching
  2236.  
  2237.  
  2238. Wssindex 5.27                   27                     Print Menu
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.     time stamps  or sizes before two files  are considered dupli-
  2252.     cates.
  2253.  
  2254. B - List files which are not Backed up
  2255.     This option is intended primarily for listing files on a hard
  2256.     disk which have not been  backed up, but can also be  used on
  2257.     floppies.   A file is  considered to be  backed up if another
  2258.     file with  the same name  and the same  or later time  tag is
  2259.     found on another disk  (possibly in an archive file).   Exact
  2260.     time and size matches are not required because some copy pro-
  2261.     grams do  not preserve the  time stamp, or even  the size for
  2262.     files which are not padded to a full disk sector.
  2263.  
  2264.     When you select this  option, you are given the  usual selec-
  2265.     tion options  (described under  the "P" option).   These  are
  2266.     applied to both the disk being checked for backups and to all
  2267.     other  files in your database.   Thus, selecting  by some op-
  2268.     tions,  such as disk name, doesn't make much sense.  However,
  2269.     to allow  checking a subdirectory rather than  an entire disk
  2270.     for backups,  any subdirectory selection criteria are applied
  2271.     only to files on the  disk being checked for backup.   On the
  2272.     other hand,  subdirectory rejection  criteria are  applied to
  2273.     all files.  Since only files from a single disk will be list-
  2274.     ed,  you might as well set the configuration to skip printing
  2275.     the  disk name (it will be listed  in the title anyway).  You
  2276.     will  almost certainly want to  use an exception  list to ex-
  2277.     clude *.BAK  (or whatever your favorite  word processing pro-
  2278.     gram names its backup files).  The dummy .ID entries for vol-
  2279.     umes and  subdirectories are automatically excluded.   If you
  2280.     are using the configured exception  list, don't forget to re-
  2281.     quest selection option 13 to use the list, otherwise you will
  2282.     have to stop the listing and try again.  After selection, the
  2283.     database  is sorted using  an internally defined  set of sort
  2284.     keys.
  2285.  
  2286.     If you have  a hard  disk which is  logically partitioned  so
  2287.     that it looks like multiple disks, you probably don't want to
  2288.     consider  a file to  be backed up just  because it appears in
  2289.     two partitions.  To avoid this problem you can either  load a
  2290.     database  with only  floppies included,  then index  a single
  2291.     partition  before checking it for backups, or you can use the
  2292.     "R"  option to remove all  but one partition  from your data-
  2293.     base.
  2294.  
  2295.     See also the "U" option for checking backups on all disks  at
  2296.     once.
  2297.  
  2298.     If you use a backup utility which creates special files which
  2299.     only it can read, you  probably will not find the "B"  option
  2300.     useful.
  2301.  
  2302.  
  2303.  
  2304. Wssindex 5.27                   28                     Print Menu
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317. V - List Volume names
  2318.     The  volumes in the database are listed to printer, screen or
  2319.     disk, sorted by name, by  decreasing free space, backwards by
  2320.     date  indexed, or unsorted (which  will be about  the same as
  2321.     forward by  date indexed unless  the database was  created by
  2322.     merging two databases).
  2323.  
  2324.     When sorting by volume name, you can either treat the name as
  2325.     a text  string or you can  extract any numerical part  of the
  2326.     name  and use that as the key.   As a text string, "DISK 100"
  2327.     would  sort before "DISK 2", but if the numerical part is ex-
  2328.     tracted, "DISK 2" sorts first.  If a disk label has two  dis-
  2329.     tinct numeric parts, only the first is used as a numeric sort
  2330.     key.
  2331.  
  2332.     The printer configuration information is used to control pag-
  2333.     ing  for printer output; for screen output, you can page for-
  2334.     ward and backward with the  PgUp and PgDn keys, or hit  Q (or
  2335.     escape) to return to the menu.   The display for each  volume
  2336.     includes the volume name, the number of free bytes, the total
  2337.     number  of bytes  available, the  number of  files (excluding
  2338.     hidden files),  the number  of subdirectories other  than the
  2339.     root directory, the date the disk was last added to the data-
  2340.     base,  whether or not the disk is bootable and optionally any
  2341.     comments entered describing  the disk.   The disk is  assumed
  2342.     bootable  if it has a  COMMAND.COM file, the  presence of the
  2343.     hidden  system files is not verified.  You may abort printing
  2344.     by hitting control-c.
  2345.  
  2346. ^V - Quick list of Volume names (control-v)
  2347.     This option lists the  volume names to the screen,  sorted by
  2348.     name and without comments.
  2349.  
  2350. Output options on the  right half of  this menu are designed  for
  2351. printer output.   Output may be directed to the screen (or disk),
  2352. but will  not pause when the screen fills.  Control-s may be used
  2353. to pause screen output.   A printer definition file  is automati-
  2354. cally read the  first time you select one of  these options.  See
  2355. Appendix  E if you need information on creating a printer defini-
  2356. tion file.
  2357.  
  2358. M - Multi-column listings
  2359.     Similar to the "P"  option, but an additional prompt  is made
  2360.     for  the number of columns used  for the printed output.  The
  2361.     output page width (from the printer definition  file) will be
  2362.     divided into the requested number of columns, separated by at
  2363.     least two spaces.   Comments and categories will go  to sepa-
  2364.     rate lines if necessary and so configured.
  2365.  
  2366.     Note:  if the fields prior to  the subdirectory name selected
  2367.     for printing do not  fit in the column width,  output will be
  2368.     truncated, probably in the middle of a field.
  2369.  
  2370. Wssindex 5.27                   29                     Print Menu
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.     In order to produce columnar output running down rather  than
  2384.     across the page, an entire page is formatted in memory before
  2385.     printing anything.  On slower machines, this leads to a delay
  2386.     of a few  seconds at the start  of each page.   A hardware or
  2387.     software  print spooler may enable you  to drive your printer
  2388.     more efficiently.   You  must have enough  memory left  after
  2389.     loading  the  database  to  hold  an  entire  formatted  page
  2390.     (slightly more than page width times page length bytes).
  2391.  
  2392.     You  can  include a  printer  initialization  command in  the
  2393.     printer definition  file which will  be sent to  your printer
  2394.     before multi-column output is started.
  2395.  
  2396. T - MulTi-column listing  of duplicate,  unique or not  backed up
  2397.     files
  2398.     This  option selects duplicate or unique files, or files on a
  2399.     particular disk which are not duplicated on another disk, and
  2400.     lists them in multiple columns.
  2401.  
  2402. C - Disk Covers
  2403.     A disk cover is a listing of all the files on a single  disk,
  2404.     small enough to fit into a disk envelope or be  pasted on the
  2405.     front of the envelope.  (You could even define a small  cover
  2406.     format and print it on  a label as an alternative to  the "L"
  2407.     option format labels.)  The edges are marked by a box to make
  2408.     cutting to  size easy.  You  can select which disks  to print
  2409.     covers for by volume name  (with wildcards), date indexed  or
  2410.     disk  size.  (3.5", 5.25"  and other sizes  are recognized by
  2411.     disk capacity.  Odd  disk formats may not be  identified cor-
  2412.     rectly.)   The output format  is similar to  the multi-column
  2413.     output described above, plus  a header with information about
  2414.     the disk.   You will be  prompted for  the desired number  of
  2415.     print columns.
  2416.  
  2417.     The fields  printed are  selected by the  usual configuration
  2418.     menu.  The disk name and subdirectory names are printed sepa-
  2419.     rately, so  you should  not  include them  in the  configured
  2420.     print fields.  If you use the printer  definition in the sup-
  2421.     plied file GENEPSON.DEF, you can fit file size, date and time
  2422.     in  2 columns, date or size in  3 columns, or file names only
  2423.     in 4 or 5 columns.   In a single  column, you could even  fit
  2424.     comments of moderate  length.  The characters which  are used
  2425.     to form the box  around the cover when printing may  not look
  2426.     at all  like box forming  characters on your  monitor screen.
  2427.     The supplied file SCREEN.DEF has more appropriate box charac-
  2428.     ters,  and also sets the width to  fit on an 80 column screen
  2429.     (which might  not be what you  want to do if  you are experi-
  2430.     menting  to see what  will fit on  a printer).   To avoid the
  2431.     necessity  of changing  the  configuration by  hand (and  the
  2432.     probability of forgetting which parameters work best) whenev-
  2433.     er you print covers, you will almost certainly want to have a
  2434.  
  2435.  
  2436. Wssindex 5.27                   30                     Print Menu
  2437.  
  2438.  
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.     special configuration  file to  control the printing  of disk
  2450.     covers.
  2451.  
  2452.     Note: as  with multi-column  output, if the  configured print
  2453.     items do not fit in the column width, they will be truncated,
  2454.     probably in the middle of a field.
  2455.  
  2456.     When sorting files for disk covers, the disk name must be the
  2457.     primary sort  key.  Cover printing  enforces this requirement
  2458.     and  the prompt for sort options shows  3 as the first key in
  2459.     the list, followed by  any configured sort keys.   You cannot
  2460.     print covers without sorting,  so you might as well  add file
  2461.     name and extension  or other  sort options in  the order  you
  2462.     prefer.
  2463.  
  2464.     If you want to print disk covers for any disks with subdirec-
  2465.     tories, and these disks were added to your database by a ver-
  2466.     sion  of WSSINDEX  older than  3.2, then  you should  run the
  2467.     IDADD utility on your database first.  If you do not do this,
  2468.     the disk cover will not include subdirectory names.
  2469.  
  2470. L - Disk Labels
  2471.     Disk labels are meant  to be printed on small,  self adhesive
  2472.     forms and pasted on your disks.  Suitable forms are generally
  2473.     1 by 3 inches or smaller, so there is only room for a limited
  2474.     amount of information.   WSSINDEX prints the  disk volume id,
  2475.     total and free space, date indexed, number of files (and sub-
  2476.     directories, if  any), descriptive comments for  the disk and
  2477.     subdirectories (if found in database), and directory info for
  2478.     as many files  as will fit, starting  from the largest.   You
  2479.     can also specify one  line of text in the  printer definition
  2480.     file, such as your name, which will  be printed at the bottom
  2481.     of  every label.  You can  select which disks to print labels
  2482.     for by a wildcard name, by date indexed or by size.
  2483.  
  2484.     Blank label forms which are one or several labels wide may be
  2485.     used.  You  can also direct  output to the  screen or a  disk
  2486.     file.
  2487.  
  2488.     Another option for printing disk labels is the shareware pro-
  2489.     gram Disk  Labeling System, DLS, (Jim  Clark, 2130 Knollshire
  2490.     Road, Cedar  Rapids, Iowa  52402).   Version 2.0 or  later of
  2491.     this program can  print disk labels from a Wssindex database.
  2492.     DLS can be downloaded from the WSS/DDC Tech Support BBS.
  2493.  
  2494.     I am occasionally asked  for a source for blank  disk labels.
  2495.     One vendor I have dealt with is Disks & Labels to Go, Rte 206
  2496.     Eastampton Business  Park, Mount  Holly, NJ   08060, 800-426-
  2497.     3303.
  2498.  
  2499.  
  2500.  
  2501.  
  2502. Wssindex 5.27                   31                     Print Menu
  2503.  
  2504.  
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515. R - Read a printer definition file
  2516.     Normally, a printer definition file is read automatically the
  2517.     first time you select a print operation which requires a def-
  2518.     inition file,  so this option is  only needed if you  want to
  2519.     use  two different configurations in the  same session, or if
  2520.     you  have used the  S option to  run an editor  to change the
  2521.     definition file.   The default name of the printer definition
  2522.     file is the first of
  2523.  
  2524.     1.  The last printer definition file read
  2525.     2.  The  DOS environment  variable WSSPRINT (DOS  command set
  2526.         WSSPRINT=filespec)
  2527.     3.  WSSPRINT.DEF
  2528.  
  2529.     which is defined.  The default name may be edited in the usu-
  2530.     al  manner,  and TAB  brings  up a  full-screen  selection of
  2531.     printer definition files.
  2532.  
  2533.     See Appendix E for a discussion of the format of printer def-
  2534.     inition files.
  2535.  
  2536. O - COnfiguration menu
  2537.     This  option takes  you  to the  primary configuration  menu.
  2538.     From  there, you  can make  changes  or save  a configuration
  2539.     file. 
  2540.  
  2541. R - Return to main menu
  2542.     Returns to previous menu.
  2543.  
  2544.                           Indexing Menu
  2545.  
  2546. Additions to the database are made from  this menu.  Many control
  2547. options are  found here, but a few are only available on the con-
  2548. figuration menus.
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568. Wssindex 5.27                   32                     Print Menu
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  +-------------------------------------------------------------+
  2582.  |                    Wssindex Indexing Menu                   |
  2583.  |                                                             |
  2584.  | Start Indexing            Ask before replacing           NO |
  2585.  | Dummy entry index         Auto-Comment                   NO |
  2586.  | IndeX ignoring labels     AUto-category                  NO |
  2587.  | ^D list directory         Make .ID entries              YES |
  2588.  | Label disk                DummY entries inc subdir tree  NO |
  2589.  | COnfiguration menu        Query archive extraction       NO |
  2590.  | Return to main menu       Index Hidden files             NO |
  2591.  | First indexing drive   A  Ignore bacKed up files         NO |
  2592.  | Second indexing drive  A  Extract archive comments       NO |
  2593.  | LaBeling drive         A                                    |
  2594.  | Indexing sTarts from   (none)                               |
  2595.  | Auto-category strinG   (none)                               |
  2596.  +-------------------------------------------------------------+
  2597.                  Figure 4. Wssindex Indexing Menu
  2598.  
  2599.  
  2600. I - Start Indexing
  2601.     Insert the first disk  to be indexed into the  first indexing
  2602.     drive and hit the space bar when ready.   The processing time
  2603.     is roughly proportional to  the number of files on  the disk,
  2604.     and will typically be only  a few seconds for a  floppy disk.
  2605.     If  the disk is not labeled, you  will be given the option to
  2606.     either  write  a label  on the  disk,  enter an  11 character
  2607.     string to be used in place of a label, list the disk directo-
  2608.     ry or abort back to the menu.  See the "L" option below for a
  2609.     discussion  of "legal" volume names.   If the  Ask before re-
  2610.     placing option is  YES, you  will be informed  if the  volume
  2611.     name matches a volume  already in the database and  given the
  2612.     option  to replace the previous  entry or not  enter the disk
  2613.     into  the database.  Wssindex will  also look at the time tag
  2614.     of the label, compare  it to the  time tag of the  previously
  2615.     indexed disk, and tell you whether the disk appears to really
  2616.     be the same one  or a different one  with a duplicate  volume
  2617.     label.  This test  is not foolproof; a DISKCOPY'ed  disk will
  2618.     have the same time tag.  Versions of  Wssindex older than 5.2
  2619.     did not record  the time tag  for volume labels,  so you  may
  2620.     also be told that the time tag is not available.   The infor-
  2621.     mative  message "NO FILES MATCH d:\*.*"  will be generated if
  2622.     there  are no files in the root directory, along with similar
  2623.     messages for other  empty directories.  When prompted you may
  2624.     either insert  another disk (in the  alternate indexing drive
  2625.     if  configured to alternate drives) and hit the space bar, or
  2626.     hit any other key to return to the menu.
  2627.  
  2628.     An  important feature: if you replace a disk in the database,
  2629.     any comments or categories which have been previously entered
  2630.     are not  lost, they are copied  over to the new  entry if the
  2631.     file and subdirectory names match.  Thus you should feel free
  2632.     to re-enter a disk into the database after even small changes
  2633.  
  2634. Wssindex 5.27                   33                  Indexing Menu
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.     have  been made.  During a replacement operation, the old and
  2648.     new entries are temporarily  in memory at the same  time, and
  2649.     both  count toward the limits  on the number  of files, disks
  2650.     and subdirectories.
  2651.  
  2652.     There is one  circumstance which could make replacing  a disk
  2653.     in the database very  time consuming.  The code  which copies
  2654.     old comments to new entries is a straightforward doubly nest-
  2655.     ed loop, which means that the running time is roughly propor-
  2656.     tional to the square of the number  of commented files.  This
  2657.     is not a problem with floppy disks which seldom have even 100
  2658.     files, but on a hard disk with a few thousand files, the pro-
  2659.     cessing time could stretch  to several minutes.   The obvious
  2660.     solution is to  sort both  sets of names  first, which  would
  2661.     reduce  the processing time  for commented disks,  at the ex-
  2662.     pense  of increasing it for non-commented ones, and I may im-
  2663.     plement this in  a future release.   Comments from registered
  2664.     users are  solicited.   (Does anyone actually  comment enough
  2665.     files on their hard disk to  make this a problem?  So far  no
  2666.     one  has complained  about replacement  time.)  It  may prove
  2667.     worthwhile to go back to the main menu and delete a huge disk
  2668.     from the database before reindexing it.
  2669.  
  2670. D - Add Dummy entries
  2671.     This option is similar to the "I" option, but does not make a
  2672.     complete database  entry.   Instead, the database  entry will
  2673.     show that there is only the dummy zero-length file named .ID.
  2674.     (The  volume name, free space and total disk space will match
  2675.     the  actual disk directory.)   This allows you  to record the
  2676.     existence of a disk when you  don't want to include the  file
  2677.     names, say for  a program master  disk which contains  driver
  2678.     files for many different printers, graphics cards, etc.   The
  2679.     .ID file is a place to hang a descriptive comment and catego-
  2680.     ry.  Older  versions of WSSINDEX used DUMMY_EN.TRY instead of
  2681.     .ID; the auxiliary routine IDADD will translate such entries.
  2682.     The  Make .ID entries option must be  set to YES before dummy
  2683.     entries can be made.
  2684.  
  2685. X - IndeX ignoring labels
  2686.     This option allows indexing of disks  with manual override of
  2687.     the volume name.  The volume  name is displayed, and you  can
  2688.     either accept it or type in  an alternate (so the label isn't
  2689.     really ignored).  The label on the disk is not  altered.  The
  2690.     mode of operation is suggested for things like write-protect-
  2691.     ed master disks which  might all have  the same label (or  no
  2692.     label at all).
  2693.  
  2694. ^D -List directory (control-d)
  2695.     This  option performs the  same way on  this menu  as it does
  2696.     from the main menu (page 18).
  2697.  
  2698.  
  2699.  
  2700. Wssindex 5.27                   34                  Indexing Menu
  2701.  
  2702.  
  2703.  
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  
  2711.  
  2712.  
  2713. L - Label a disk on the labeling drive
  2714.     A volume label is an optional entry in a disk directory which
  2715.     looks much like a  file name, but is given  special treatment
  2716.     by DOS.   If present, it can  be displayed by the  DOS DIR or
  2717.     VOL commands.  Labels are usually written when a disk is for-
  2718.     matted,  but  can  be   added  later  by  various  utilities.
  2719.     WSSINDEX uses the volume name to distinguish different disks.
  2720.  
  2721.     This  option displays the  current volume label,  if any, and
  2722.     prompts you for a  new label.  A carriage return  aborts back
  2723.     to  the menu without changing anything.  The labeling is done
  2724.     by  a DOS call, so DOS restrictions on allowed characters ap-
  2725.     ply (in particular, your  input will be forced to  upper case
  2726.     because lower  case letters are  not allowed, but  blanks are
  2727.     ok).  If in doubt, try the label you  want to use; an illegal
  2728.     name  will be rejected with no harmful consequences.  I would
  2729.     suggest  that you not trust  a copy protected  master disk to
  2730.     any  disk labeling program; who knows what sort of games they
  2731.     might  have  played with  the  directory.   I  also recommend
  2732.     against writing on  a 360K disk in a 1.2  MB drive since this
  2733.     could make it unreadable on some 360K drives.
  2734.  
  2735.     Note: if you  have a disk with a mixed  case label (which you
  2736.     can easily  create with  the Norton Utilities  or some  other
  2737.     programs), WSSINDEX will not be able to change the label (DOS
  2738.     rename call fails).  If you need to change such a label while
  2739.     Wssindex  is running, you can  use the DOS  Shell option from
  2740.     the main  menu to run a labeling  utility.  Disks with labels
  2741.     differing only  in case are  considered to be  different when
  2742.     adding  disks to  the database,  but cannot  be distinguished
  2743.     when selecting by volume name.   If you use really weird vol-
  2744.     ume  labels, such  as ANSI  cursor positioning  commands, you
  2745.     probably deserve whatever happens to you.
  2746.  
  2747.     Technical  note: disk labeling  in Wssindex/Extended uses the
  2748.     LABELDLL.DLL  file.  This is a real mode program which inter-
  2749.     faces with DOS to write or change labels.  No other method of
  2750.     manipulating labels seems to work under all DPMI hosts.
  2751.  
  2752. O - COnfiguration menu
  2753.     This  option takes  you  to the  primary configuration  menu.
  2754.     From there, you can make changes or save a configuration file
  2755.     including the control settings from the indexing menu.
  2756.  
  2757. R - Return to main menu
  2758.     This option returns you to the main menu.
  2759.  
  2760. F - First indexing drive
  2761. S - Second indexing drive
  2762. B - LaBeling drive
  2763.     These  three options select the drive letters used for index-
  2764.     ing or labeling  disks.  If you  only have one  floppy drive,
  2765.  
  2766. Wssindex 5.27                   35                  Indexing Menu
  2767.  
  2768.  
  2769.  
  2770.  
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  
  2777.  
  2778.  
  2779.     the three  drive letters will usually be  identical, but they
  2780.     can be changed to index or label hard disk partitions.
  2781.  
  2782. T - Indexing sTarts from
  2783.     This option allows for  partial indexing of a disk.   Instead
  2784.     of  starting from the root directory and including all files,
  2785.     only  files in or below  the specified directory are indexed.
  2786.     (The disk volume  label is  read from the  root directory  as
  2787.     usual.)  The format of the subdirectory specification will be
  2788.     adjusted  to canonical form so  you need not  worry about de-
  2789.     tails like whether a leading or trailing backslash is needed.
  2790.     Making a partial  index might be useful as  the first step in
  2791.     checking a critical subdirectory  for backups, or as  a means
  2792.     of indexing a CD  ROM or very large  disk which contains  too
  2793.     many files to fit in a single database.
  2794.  
  2795. G - Auto-category strinG
  2796.     This  is the string which is used for the category if config-
  2797.     ured to add categories automatically.
  2798.  
  2799. A - Ask before replacing
  2800.     This  flag controls the action  taken when a  volume label is
  2801.     found which matches one already in the database.  If YES, you
  2802.     are  asked whether to replace the existing database entry; if
  2803.     NO,  the entry  is replaced  automatically.   Generally, this
  2804.     flag  should be YES when  indexing a collection  of disks for
  2805.     the  first time  since  duplicate volume  names on  different
  2806.     disks  are easy to generate.  On  the other hand, if you have
  2807.     not kept track of which disks have been changed without being
  2808.     re-indexed and are re-indexing disks  you know are already in
  2809.     the database, you can set the  flag to NO and replace without
  2810.     verification.
  2811.  
  2812. C - Auto-Comment
  2813.     If YES, you are transferred  to the add-comments screen after
  2814.     each disk is indexed.  All files on the disk just entered are
  2815.     selected for commenting.
  2816.  
  2817. U - AUto-category
  2818.     If  YES, all files on disks indexed are assigned the category
  2819.     shown in  the auto-category string.   Assigning categories to
  2820.     everything uses  up database  storage space, so  don't enable
  2821.     this option unless you need it.
  2822.  
  2823. M - Make .ID entries
  2824.     In  order to record the subdirectory structure of a disk, and
  2825.     to allow comments to be assigned to disks and subdirectories,
  2826.     it is necessary to make special database entries for the vol-
  2827.     ume label and  each subdirectory.   These  entries look  like
  2828.     files with the (illegal)  name .ID.  These entries  count to-
  2829.     wards the limits on the number of files, so if you don't want
  2830.  
  2831.  
  2832. Wssindex 5.27                   36                  Indexing Menu
  2833.  
  2834.  
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.     to assign comments  to disks or  subdirectories, you can  set
  2846.     this option to NO and decrease the database size slightly.
  2847.  
  2848. Y - DummY entries include subdirectory tree
  2849.     If this option is set  to YES, dummy entry indexing will  in-
  2850.     clude  the entire subdirectory tree;  if set to  NO, only one
  2851.     entry will be made for the volume id.
  2852.  
  2853. Q - Query archive extraction
  2854.     You may  want to extract file information  only from selected
  2855.     archive  and graphics files.  If  this option is YES, you are
  2856.     asked before file information is extracted from any file with
  2857.     an extension in one of the  extraction lists (including self-
  2858.     extracting archives).
  2859.  
  2860. H - Index Hidden files
  2861.     Bootable disks have two  hidden files which are not  shown by
  2862.     the  DOS DIR command.   If this  option is set  to YES, these
  2863.     files are included when a disk is indexed, otherwise they are
  2864.     ignored.   (Indexing of any  other hidden files  is also con-
  2865.     trolled by this flag.)
  2866.  
  2867. K - Ignore bacKed up files
  2868.     One version  of Wssindex had a bug which caused it to not see
  2869.     files which had the  archive bit clear when indexing  a disk.
  2870.     (The archive bit is a flag  in the directory entry for a file
  2871.     which is set when a  file is created or modified and  cleared
  2872.     by some backup programs.)  One user felt that this was a fea-
  2873.     ture and asked that it be  made a program option.  Most users
  2874.     will want to set this option to  NO, but a YES setting can be
  2875.     used in conjunction  with the DOS  ATTRIB command to  control
  2876.     which files are indexed.
  2877.  
  2878. E - Extract archive comments
  2879.     Some of the archive formats allow comments for the archive or
  2880.     members.  If this  option is YES, and extraction  of informa-
  2881.     tion from the appropriate archive file type is enabled,  such
  2882.     comments are extracted, filtered  to remove unprintable char-
  2883.     acters, and assigned to database files.  On the indexing con-
  2884.     figuration menu, you can elect to extract comments describing
  2885.     the archive  files and  self-extracting archives without  ex-
  2886.     tracting file information.  This flag does not control wheth-
  2887.     er  image size and number of colors are extracted from graph-
  2888.     ics files.
  2889.  
  2890.                     Primary Configuration Menu
  2891.  
  2892. Most of  the items in this  menu lead to sub-menus  which are de-
  2893. scribed in detail below.  The exceptions are  the options to load
  2894. or save  a configuration file, and, of  course, the option to re-
  2895. turn to the previous  menu.  When loading or  saving a configura-
  2896. tion  file, the prompt shows the file  name which will be used by
  2897.  
  2898. Wssindex 5.27                   37                  Indexing Menu
  2899.  
  2900.  
  2901.  
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.  
  2909.  
  2910.  
  2911. default.  You  can accept this default by  hitting return, or you
  2912. can edit the file name using cursor keys, insert/delete, etc.
  2913.  
  2914.               +------------------------------------+
  2915.               |    Primary Configuration Menu      |
  2916.               |                                    |
  2917.               | Printer configuration              |
  2918.               | SiZe limits                        |
  2919.               | Indexing options                   |
  2920.               | Screen, keyboard and Miscellaneous |
  2921.               | Default sorting/selection options  |
  2922.               | Keyboard macros                    |
  2923.               | Configured Exception list          |
  2924.               | Which fields to print              |
  2925.               | Output Format                      |
  2926.               |                                    |
  2927.               | Load configuration file            |
  2928.               | Save configuration file            |
  2929.               |                                    |
  2930.               | Return to previous menu            |
  2931.               +------------------------------------+
  2932.           Figure 5. Wssindex Primary Configuration Menu
  2933.  
  2934.  
  2935. P - Printer configuration
  2936.     Leads to a menu describing printer characteristics.
  2937.  
  2938. Z - SiZe limits
  2939.     Leads to a menu to set database size limits.
  2940.  
  2941. I - Indexing options
  2942.     Leads to a menu of options controlling behavior when indexing
  2943.     disks.
  2944.  
  2945. M - Screen, keyboard and Miscellaneous
  2946.     Leads to a menu of miscellaneous items.
  2947.  
  2948. D - Default sorting/selection options
  2949.     Leads to  a menu for  entering default sorting  and selection
  2950.     options.
  2951.  
  2952. K - Keyboard macros
  2953.     This option displays the 26 keyboard macros available by hit-
  2954.     ting Alt-letter in the add-comments section (or anywhere else
  2955.     that multi-character text input is allowed) and allows you to
  2956.     change them.   These macros are  stored in the  configuration
  2957.     file,  not the database file.  If  you make any changes here,
  2958.     you  will be given the  option to save  a configuration file.
  2959.     (In earlier releases, keyboard macros were  called predefined
  2960.     categories  and  could  only  be  used  in  the  add-comments
  2961.     screen.)
  2962.  
  2963.  
  2964. Wssindex 5.27                   38     Primary Configuration Menu
  2965.  
  2966.  
  2967.  
  2968.  
  2969.  
  2970.  
  2971.  
  2972.  
  2973.  
  2974.  
  2975.  
  2976.  
  2977. E - Configured Exception list
  2978.     The exception  list is list of  up to 100  special case names
  2979.     which can be excluded  from printing.  By default,  this list
  2980.     consists  of only COMMAND.COM, but you might also want to add
  2981.     *.BAK, AUTOEXEC.BAT or anything else you have many copies of.
  2982.     Wild card names are allowed.  List entries are made  in full-
  2983.     screen mode (the same as is optionally used for entering file
  2984.     specifications when selecting files).  This list is only used
  2985.     if you  ask for it  as one  of the selection  options.   This
  2986.     semi-permanent list  serves the same purpose  as the one-shot
  2987.     rejection list which you can enter whenever selecting files.
  2988.  
  2989. W - Which fields to print
  2990.     Leads to a menu for selecting what information to print.
  2991.  
  2992. F - Output Format
  2993.     Leads to a menu for controlling output format.
  2994.  
  2995. L - Load configuration file
  2996. S - Save configuration file
  2997.     Configuration files  hold the option settings  entered in the
  2998.     various menus, including the  keyboard macros.  You  can save
  2999.     or load a configuration file at any time, but a newly  loaded
  3000.     configuration file cannot change  the database size limits if
  3001.     a database  is currently  in memory.   If  you attempt to  do
  3002.     this, you will be given the  option to clear the loaded data-
  3003.     base.  If you decline,  all configuration options except  the
  3004.     changed size limits will take effect.
  3005.  
  3006.     If  you read or save  a configuration file,  the default file
  3007.     name is the first of
  3008.  
  3009.     1.  The last configuration file saved or read
  3010.     2.  The first command line argument
  3011.     3.  The DOS  environment  variable WSSICNF  (DOS command  set
  3012.         WSSICNF=filespec)
  3013.     4.  WSSINDEX.CNF (with  drive and path  whatever was  current
  3014.         when the program was loaded)
  3015.  
  3016.     which is defined.  The default name can be edited in the usu-
  3017.     al  manner, and TAB brings up a full-screen selection of con-
  3018.     figuration  files.  If an error is encountered when reading a
  3019.     configuration file, WSSINDEX will assume the worst and revert
  3020.     to  using the  screen output  method set  by the  environment
  3021.     variable WSSDISP,  or determined automatically if  WSSDISP is
  3022.     not defined.
  3023.  
  3024.     The format of the configuration  file often changes from ver-
  3025.     sion to version; compatibility is not  guaranteed.  Usually I
  3026.     try to arrange  things so  that most information  can be  ex-
  3027.     tracted  from an older configuration file before a read error
  3028.     occurs, but major  program upgrades always seem to require so
  3029.  
  3030. Wssindex 5.27                   39     Primary Configuration Menu
  3031.  
  3032.  
  3033.  
  3034.  
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040.  
  3041.  
  3042.  
  3043.     many new configuration  items that maintaining  compatibility
  3044.     with older  configuration files is not always possible.  Gen-
  3045.     erally, Wssindex will realize that  it is reading an obsolete
  3046.     format before very many  garbage values have been read.   One
  3047.     of the  first things you should  do with a new  version is to
  3048.     review your configurations settings.
  3049.  
  3050. R - Return to previous menu
  3051.     Returns to higher level menu.
  3052.  
  3053.  
  3054.                     Printer Configuration Menu
  3055.  
  3056. Items in this menu  define the characteristics of your  printer. 
  3057. They are  also used for disk output, but have no effect on screen
  3058. output.   Distances on a printed page are expressed in characters
  3059. and lines.   Proportionally spaced fonts are  not supported; they
  3060. will cause misaligned columns.
  3061.  
  3062.             +---------------------------------------+
  3063.             |      Printer configuration menu       |
  3064.             |                                       |
  3065.             | Paper Width to right margin        80 |
  3066.             | Paper Length                       66 |
  3067.             | Left Margin                         0 |
  3068.             | Top margin                          3 |
  3069.             | Bottom margin                       8 |
  3070.             | Use Form feeds                    YES |
  3071.             | Pause at page breaks               NO |
  3072.             | Printer port Name                LPT1 |
  3073.             |                                       |
  3074.             | POstscript printer setup              |
  3075.             |                                       |
  3076.             | Return to primary configuration menu  |
  3077.             +---------------------------------------+
  3078. Figure 6. Wssindex Printer Configuration Menu.  Some commands use
  3079. additional printer controls from the printer definition file.
  3080.  
  3081.  
  3082. W - Paper Width to right margin
  3083.     This  is the width of  the paper, less  any desired allowance
  3084.     for a right margin.  (The number entered here does not depend
  3085.     on the left margin  setting.)  If your printer does  an auto-
  3086.     matic carriage return and linefeed when a character is print-
  3087.     ed in the rightmost column, you should set the width to  pre-
  3088.     vent  using this column.  Page numbers are right justified to
  3089.     the page width setting.
  3090.  
  3091. L - Paper Length
  3092.     This is the  length of the  paper, typically 66 lines  for 11
  3093.     inch paper at 6  lines per inch, but slightly  smaller (60 or
  3094.  
  3095.  
  3096. Wssindex 5.27                   40     Primary Configuration Menu
  3097.  
  3098.  
  3099.  
  3100.  
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109.     62) for laser printers which can't print on the first or last
  3110.     few lines of a page, or larger for A4 size paper.
  3111.  
  3112. M - Left Margin
  3113. T - Top margin
  3114. B - Bottom margin
  3115.     The  number of spaces or lines to leave blank in each margin.
  3116.     Note that a right margin allowance is made by using a smaller
  3117.     paper width specification.
  3118.  
  3119. F - Use Form feeds
  3120.     Most, but not all, printers respond to a form feed command to
  3121.     eject  the current page.  For printers which do not recognize
  3122.     form feeds, set this  option to NO and  page advance will  be
  3123.     done by inserting blank lines.  The disadvantage of disabling
  3124.     this option is that if some glitch messes  up the line count-
  3125.     ing, the  error will   propagate to following  pages, whereas
  3126.     doing a line feed resynchronizes the program and printer line
  3127.     counting.   Depending  on your printer,  if you  are printing
  3128.     with zero bottom margin, it may  be necessary to set this op-
  3129.     tion to NO to prevent printing every other page blank.
  3130.  
  3131. P - Pause at page breaks
  3132.     If  a manual-feed sheet printer  is used, set  this option to
  3133.     YES so that output will pause for paper change.
  3134.  
  3135. N - Printer port Name
  3136.     The  default printer port is device PRN, which is usually the
  3137.     same as LPT1.   You may select PRN, LPT1,  LPT2, LPT3 or EPT.
  3138.     If you have  a serial printer, and port PRN doesn't work, use
  3139.     the  DOS mode command to redirect LPT1 to the appropriate COM
  3140.     port.
  3141.  
  3142. O - POstscript printer setup
  3143.     Leads to menu for selecting postscript options.
  3144.  
  3145.  
  3146.  
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162. Wssindex 5.27                   41     Printer Configuration Menu
  3163.  
  3164.  
  3165.  
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.  
  3173.  
  3174.  
  3175.                   Postscript Printer Setup Menu
  3176.  
  3177.             +---------------------------------------+
  3178.             |       Postscript Printer Setup        |
  3179.             |                                       |
  3180.             | Use Postscript printer            YES |
  3181.             | Disk output also postscript        NO |
  3182.             | Landscape output                   NO |
  3183.             | Font Size (points)                 10 |
  3184.             | Extra line spacing (points)         2 |
  3185.             |                                       |
  3186.             | Return to previous menu               |
  3187.             +---------------------------------------+
  3188. Figure 7. Wssindex Postscript Printer  Setup Menu.  Some commands
  3189. use additional printer controls from the printer definition file.
  3190.  
  3191. P - Use Postscript printer
  3192.     Select YES  if you want  to use a  postscript printer.   Note
  3193.     that  Wssindex does  not take  full advantage  of power  of a
  3194.     postscript printer.   In  particular, only Courier  fonts are
  3195.     supported because that's the only non-proportional font which
  3196.     all postscript printers contain.
  3197.  
  3198. D - Disk output also postscript
  3199.     Select  YES if output directed  to disk should  also be post-
  3200.     script format.
  3201.  
  3202. L - Landscape output
  3203.     Select YES  for landscape (90  degree rotated) output.   Note
  3204.     that for  non-postscript printers, landscape  output can only
  3205.     be selected by commands in a printer definition file.
  3206.  
  3207. S - Font Size (points)
  3208. E - Extra line spacing (points)
  3209.     Print size  and inter-line  spacing are specified  in points;
  3210.     there  are approximately 72 points in one inch.  Typical font
  3211.     sizes would  be 10-12  points  for ordinary  text, perhaps  7
  3212.     points  or smaller for disk  covers or labels.   Wssindex ex-
  3213.     pects integral  point sizes.   Spacing  between lines  is the
  3214.     font size plus the  extra spacing.  Word  processing programs
  3215.     often default to  2 points more for spacing than for the font
  3216.     size, but you may find that 1 or even 0 points looks better.
  3217.  
  3218.  
  3219.                        Database Size Limits
  3220.  
  3221. The entire Wssindex database  is kept in memory.  Thus, the maxi-
  3222. mum database size  depends on available memory,  and under MS/PC-
  3223. DOS, that usually means less than 640K.  (However, if your system
  3224. provides  more  conventional  memory,   Wssindex  will  use  it.)
  3225. Wssindex/Extended also  keeps the entire database  in memory, but
  3226. it can  use up  to 16 MB  of extended  memory.  The  overhead for
  3227.  
  3228. Wssindex 5.27                   42     Printer Configuration Menu
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241. memory management  is greatly reduced if space  for certain fixed
  3242. sized  items is  allocated in a  few large chunks  rather than in
  3243. small pieces as  a database  grows.  Also,  the DOS Shell  option
  3244. requires  some memory which could otherwise be used for the data-
  3245. base.  These considerations  mean that the program must  know the
  3246. maximum  database size before  the database is  loaded.  However,
  3247. these limits can be  changed before a database loaded  from disk,
  3248. so numbers entered here do not restrict future database growth.
  3249.  
  3250.           +-------------------------------------------+
  3251.           |           Database size limits            |
  3252.           |                                           |
  3253.           | Maximum number of Files              3000 |
  3254.           | Maximum number of Subdirectories      600 |
  3255.           | Maximum number of Disks               300 |
  3256.           |                                           |
  3257.           | Allocate Memory and display status        |
  3258.           |                                           |
  3259.           | Longest allowed Comment                64 |
  3260.           | Longest allowed category               64 |
  3261.           |                                           |
  3262.           | Return to primary configuration menu      |
  3263.           +-------------------------------------------+
  3264.        Figure 8. Wssindex Database Size Configuration Menu
  3265.  
  3266.  
  3267. F - Maximum number of Files
  3268. S - Maximum number of Subdirectories
  3269. D - Maximum number of Disks
  3270.     These  options set the limits on the numbers of files, subdi-
  3271.     rectories and  disks in a  database.   In the DOS  version of
  3272.     Wssindex, each must be less than 16,384, regardless of avail-
  3273.     able memory.  In  practice, it's usually the number  of files
  3274.     which  is most constricting.   10-12,000 files can usually be
  3275.     accommodated in  640K, provided that a  significant amount of
  3276.     memory  is not also  being used for  comments and categories.
  3277.     With Wssindex/Extended  and 16 MB of RAM,  you could probably
  3278.     handle 300,000 files.  The  number of bytes used is given  in
  3279.     the table below.   In addition, each  subdirectory name takes
  3280.     some space.
  3281.  
  3282.           Bytes per           DOS       Extended
  3283.                             version     version
  3284.           File                36           42
  3285.           Subdirectory         6            8
  3286.           Disk                27           29
  3287.  
  3288.     A maximum length  comment or category takes  up more database
  3289.     memory  than 3 file  entries, so a heavily commented database
  3290.     could run into memory space problems even at 3000 files.
  3291.  
  3292.  
  3293.  
  3294. Wssindex 5.27                   43           Database Size Limits
  3295.  
  3296.  
  3297.  
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.  
  3305.  
  3306.  
  3307. M - Allocate Memory
  3308.     Memory is not allocated  until you either leave this  menu or
  3309.     select this item.   When  you select this  item, you get  the
  3310.     same  summary of size limits and available memory as is given
  3311.     by the display statistics option from the main menu.  So, you
  3312.     can make repeated adjustments  and check status without leav-
  3313.     ing this menu.   If there  is not enough  memory for the  re-
  3314.     quested  size limits, you will  get an error  message and the
  3315.     option to  give up and return  to DOS; the default  answer is
  3316.     no.  The size limits revert to the last successfully allocat-
  3317.     ed values, but the display will still show the last requested
  3318.     values.  Insufficient memory  for variable length items (sub-
  3319.     directory names, comments and categories) will be detected as
  3320.     a database is read or expanded.
  3321.  
  3322. C - Longest allowed Comment
  3323. L - Longest allowed category
  3324.     Comments and  categories extracted from archive  files or en-
  3325.     tered on the add-comments screen can only be as long as spec-
  3326.     ified here.   The longest comment allowed is 1023 characters;
  3327.     the longest category 64.   (Prior to version 5.2,  both maxi-
  3328.     mums were fixed at 64.  Comments longer than this will make a
  3329.     database unreadable  by older versions  of Wssindex.)   If  a
  3330.     comment  or category  longer than  the configured  maximum is
  3331.     found when a database is loaded, it will be truncated to this
  3332.     maximum  and a warning issued.   Setting the  maximum to zero
  3333.     forces removal of the comment  or category when the  database
  3334.     is  read.  Setting the maximum has  no effect on a comment or
  3335.     category already in memory.
  3336.  
  3337. R - Return to primary configuration menu
  3338.     Returns to the previous menu.
  3339.  
  3340.  
  3341.                    Indexing Configuration Menu
  3342.  
  3343. Items in this menu control program behavior during disk indexing.
  3344. Many of these items are duplicated on the indexing sub-menu.
  3345.  
  3346.  
  3347.  
  3348.  
  3349.  
  3350.  
  3351.  
  3352.  
  3353.  
  3354.  
  3355.  
  3356.  
  3357.  
  3358.  
  3359.  
  3360. Wssindex 5.27                   44           Database Size Limits
  3361.  
  3362.  
  3363.  
  3364.  
  3365.  
  3366.  
  3367.  
  3368.  
  3369.  
  3370.  
  3371.  
  3372.  
  3373.     +-------------------------------------------------------+
  3374.     |             Indexing configuration menu               |
  3375.     |                                                       |
  3376.     | Indexing drive number 1                             A |
  3377.     | Indexing drive number 2                             B |
  3378.     | Make .ID entries (allows disk/subdir comments)    YES |
  3379.     | Ask Before replacing                               NO |
  3380.     | Auto coMment after disk indexed                    NO |
  3381.     | Auto caTegory for all files                        NO |
  3382.     | Ask before eXtracting archive info                 NO |
  3383.     | Extract comments from archive files               YES |
  3384.     | Ignore archive extension when copying comments     NO |
  3385.     | Extract comments from 4DOS/NDOS description files YES |
  3386.     | Auto cateGory string        (none)                    |
  3387.     |                                                       |
  3388.     | File extensions for Archive information extraction    |
  3389.     | File extensions for graPhics information extraction   |
  3390.     | File extensions for Self-extracting file processing   |
  3391.     |                                                       |
  3392.     | Return to primary configuration menu                  |
  3393.     +-------------------------------------------------------+
  3394.       Figure 9. Wssindex Indexing Options Configuration Menu
  3395.  
  3396.  
  3397. 1,2 - Indexing drive number
  3398.     If you have two  drives, Wssindex will read from  them alter-
  3399.     nately when indexing so that you can be swapping disks in one
  3400.     drive while  the other is being  used.  If you  have only one
  3401.     drive (or if you only want  to use one drive), just enter the
  3402.     same letter for both drives.
  3403.  
  3404. I - Make .ID entries
  3405.     In  order to record the subdirectory structure of a disk, and
  3406.     to allow comments to be assigned to disks and subdirectories,
  3407.     it is necessary to make special database entries for the vol-
  3408.     ume  label and each  subdirectory.   These entries  look like
  3409.     files with the (illegal)  name .ID.  These entries  count to-
  3410.     wards the limits on the number of files, so if you don't want
  3411.     to assign  comments to disks  or subdirectories, you  can set
  3412.     this option to NO and decrease the database size slightly.
  3413.  
  3414. B - Ask Before replacing
  3415.     If  a disk is encountered  while indexing which  has the same
  3416.     volume label as one already in the database, it  could be ei-
  3417.     ther a different disk with a duplicate name or the same  disk
  3418.     being re-indexed.   This option controls  whether any warning
  3419.     is given before a duplicate disk is replaced.
  3420.  
  3421. M - Auto coMment
  3422.     If  YES, automatically  go to  the add-comments  screen after
  3423.     each disk is indexed, with all files from the disk selected.
  3424.  
  3425.  
  3426. Wssindex 5.27                   45    Indexing Configuration Menu
  3427.  
  3428.  
  3429.  
  3430.  
  3431.  
  3432.  
  3433.  
  3434.  
  3435.  
  3436.  
  3437.  
  3438.  
  3439. T - Auto caTegory
  3440.     If YES, assign the auto-category string to all files as disks
  3441.     are indexed.
  3442.  
  3443. X - Ask before eXtracting archive info
  3444.     You may want  to extract file information only  from selected
  3445.     archive and graphics files.   If this option is  YES, you are
  3446.     asked before file information is extracted from any file with
  3447.     an extension in one of the extraction lists.
  3448.  
  3449. E - Extract comments from archive files
  3450.     Some of the archive formats allow comments for the archive or
  3451.     members.  If this option is YES, such comments are extracted,
  3452.     filtered to remove unprintable characters and  excess blanks,
  3453.     and assigned to database files.
  3454.  
  3455. I - Ignore archive extension when copying comments
  3456.     If  you were to switch to a different archiving program, con-
  3457.     vert files on previously indexed disks and reindex, you would
  3458.     normally lose  any database comments for  these files because
  3459.     the archive file names  would be different.  But if  this op-
  3460.     tion is YES,  the archive extension  is ignored when  copying
  3461.     comments  after reindexing.  Note that this is only useful if
  3462.     the  conversion is done in-place; it doesn't help if you also
  3463.     move the files to different disks.
  3464.  
  3465. 4 - Extract comments from 4DOS/NDOS description files
  3466.     4DOS and NDOS are COMMAND.COM replacements which support file
  3467.     descriptions in each directory in a file called DESCRIPT.ION.
  3468.     This flag enables extraction of comments from these files.
  3469.  
  3470. G - Auto cateGory string
  3471.     This string is  used for  the category if  configured to  add
  3472.     categories automatically.
  3473.  
  3474. A - File extensions for Archive information extraction
  3475. P - File extensions for graPhics information extraction
  3476. S - File extensions for Self-extracting file processing
  3477.     These three options lead to menus to select what types of ar-
  3478.     chive and graphics files  should be processed to  extract di-
  3479.     rectory, comment or image size information.
  3480.  
  3481.  
  3482.  
  3483.  
  3484.  
  3485.  
  3486.  
  3487.  
  3488.  
  3489.  
  3490.  
  3491.  
  3492. Wssindex 5.27                   46    Indexing Configuration Menu
  3493.  
  3494.  
  3495.  
  3496.  
  3497.  
  3498.  
  3499.  
  3500.  
  3501.  
  3502.  
  3503.  
  3504.  
  3505.             Archive file extraction configuration menu
  3506.         +------------------------------------------------+
  3507.         |   Archive file extraction configuration menu   |
  3508.         |                                                |
  3509.         |     ARC     YES            LZS    YES          |
  3510.         |     ARJ     YES            PAK    YES          |
  3511.         |     ARK     YES            PKA    YES          |
  3512.         |     HYP     YES            SDN    YES          |
  3513.         |     LBR     YES            ZIP    YES          |
  3514.         |     LZH     YES            ZOO    YES          |
  3515.         |                                                |
  3516.         |   TogglE all                                   |
  3517.         |                                                |
  3518.         |   Return to indexing configuration menu        |
  3519.         +------------------------------------------------+
  3520.   Figure 10. Archive file types from which information can be ex-
  3521. tracted.
  3522.  
  3523.  
  3524.            Graphics file extraction configuration menu
  3525.  
  3526.        +-------------------------------------------------+
  3527.        |   Graphics file extraction configuration menu   |
  3528.        |                                                 |
  3529.        |       BMP                               YES     |
  3530.        |       GIF                               YES     |
  3531.        |       JPG                               YES     |
  3532.        |       PCX                               YES     |
  3533.        |       TIF                               YES     |
  3534.        |                                                 |
  3535.        |   TogglE all                                    |
  3536.        |                                                 |
  3537.        |   Return to indexing configuration menu         |
  3538.        +-------------------------------------------------+
  3539.  Figure 11. Graphics file types from which image size information
  3540. can be extracted.
  3541.  
  3542.  
  3543.  
  3544.  
  3545.  
  3546.  
  3547.  
  3548.  
  3549.  
  3550.  
  3551.  
  3552.  
  3553.  
  3554.  
  3555.  
  3556.  
  3557.  
  3558. Wssindex 5.27                   47     Archive and Graphics files
  3559.  
  3560.  
  3561.  
  3562.  
  3563.  
  3564.  
  3565.  
  3566.  
  3567.  
  3568.  
  3569.  
  3570.  
  3571.              Self-extracting files configuration menu
  3572.        +-------------------------------------------------+
  3573.        |    Self-extracting files configuration menu     |
  3574.        |                                                 |
  3575.        |   EXE files                                     |
  3576.        |                                                 |
  3577.        |       ARJ                         NO            |
  3578.        |       LZH                         YES           |
  3579.        |       ZIP                         Comments only |
  3580.        |                                                 |
  3581.        |   TogglE all                                    |
  3582.        |                                                 |
  3583.        |   Return to indexing configuration menu         |
  3584.        +-------------------------------------------------+
  3585.  Figure 12. Self-extracting file types from which information can
  3586. be extracted.
  3587.  
  3588.  
  3589. Extension for extraction
  3590.     Files with extensions marked YES on these three menus will be
  3591.     processed as  archive or  graphics files  when disks  are in-
  3592.     dexed.  Archive  types which  allow archive  comments can  be
  3593.     marked "Only comments", meaning  that file information is not
  3594.     extracted,  but an archive  comment will be  extracted if Ex-
  3595.     tract comments is YES.   Enabling processing of self-extract-
  3596.     ing  files will slow indexing  because all EXE  files will be
  3597.     tested as possible archives.
  3598.  
  3599. E - TogglE all
  3600.     Sets all extraction options on the menu to the same value and
  3601.     toggles them between YES and NO.
  3602.  
  3603.                  Miscellaneous Configuration Menu
  3604.  
  3605. This menu  includes a  variety of miscellaneous  items, including
  3606. the  paths to the  color selection and  video board configuration
  3607. menus.
  3608.  
  3609.  
  3610.  
  3611.  
  3612.  
  3613.  
  3614.  
  3615.  
  3616.  
  3617.  
  3618.  
  3619.  
  3620.  
  3621.  
  3622.  
  3623.  
  3624. Wssindex 5.27                   48     Archive and Graphics files
  3625.  
  3626.  
  3627.  
  3628.  
  3629.  
  3630.  
  3631.  
  3632.  
  3633.  
  3634.  
  3635.  
  3636.  
  3637.     +-------------------------------------------------------+
  3638.     |   Screen, keyboard and miscellaneous configuration    |
  3639.     |                                                       |
  3640.     | Perform automatic inteGrity check                  NO |
  3641.     | MaNual cursor motion in menus                      NO |
  3642.     | Function key layout matching IBM                  YES |
  3643.     | Use BIOS to read Keyboard                          NO |
  3644.     | Inverted meaning for PgUp/PgDn                     NO |
  3645.     | Create .BAK files                                 YES |
  3646.     | Enable Alarm sound                                YES |
  3647.     | Change Prompt in DOS shell                        YES |
  3648.     | Strip High-bit when viewing files                 YES |
  3649.     | Use color                                         YES |
  3650.     | Use Mouse                                          NO |
  3651.     | Mouse Sensitivity                                  50 |
  3652.     |                                                       |
  3653.     | Set Colors                                            |
  3654.     | Video board configuration                             |
  3655.     |                                                       |
  3656.     | Return to primary configuration menu                  |
  3657.     +-------------------------------------------------------+
  3658.     Figure 13. Wssindex  Screen,  Keyboard and  Miscellaneous
  3659.     Options Configuration Menu
  3660.  
  3661.  
  3662. G - Perform automatic inteGrity check
  3663.     A  disk indexing program  infected by a  computer virus could
  3664.     spread the infection to every write-enabled disk indexed.  To
  3665.     provide partial protection, Wssindex will read its executable
  3666.     file from disk  and perform a checksum test.  If the expected
  3667.     checksum  is not found, a warning will be displayed the first
  3668.     time you enter the main menu.  Since this test requires read-
  3669.     ing  the program from disk, it requires about the same amount
  3670.     of time as loading the program.  With a fast  hard disk, this
  3671.     time  is negligible, but on  a floppy it  could be annoyingly
  3672.     long, hence the option of disabling the test.
  3673.  
  3674.     This type of integrity test is far from foolproof.  First, it
  3675.     only tests whether the program itself is infected, not wheth-
  3676.     er  a virus from a previously run program is active.  Second,
  3677.     viruses exist which detect that a program is reading its disk
  3678.     image and feed back  the uninfected image.  Finally,  a virus
  3679.     targeted  against   a  specific  program  could   remove  the
  3680.     checksumming code entirely.   I intend to  change the details
  3681.     of  the integrity check from  release to release  in order to
  3682.     make  this last attack more difficult.  There are now several
  3683.     programs available  which attempt  to check for  virus infec-
  3684.     tions  by known  viruses,  or to  block destructive  actions.
  3685.     Since I have  never actually  encountered a  virus, I  cannot
  3686.     comment on  how effective such programs might  be.  I do know
  3687.     that  computer scientists  have  demonstrated that  writing a
  3688.     "universal virus detector" is not possible.
  3689.  
  3690. Wssindex 5.27                   49    Miscellaneous Configuration
  3691.  
  3692.  
  3693.  
  3694.  
  3695.  
  3696.  
  3697.  
  3698.  
  3699.  
  3700.  
  3701.  
  3702.  
  3703.     In  order to perform the checksum test, the program must know
  3704.     its name  and where  it was  loaded from.   Under DOS  3.0 or
  3705.     higher, this is  trivial, and under previous  DOS versions it
  3706.     is  impossible.  When running under DOS 2.x, the program name
  3707.     is assumed to be WSSINDEX.EXE, and the current  directory and
  3708.     the PATH  are searched for this  name.  Thus, if  you wish to
  3709.     use  the integrity check under  DOS 2.x, you  must change the
  3710.     program  name from  the distributed  name which  includes the
  3711.     version number.
  3712.  
  3713.     There are various utilities  available which compress an exe-
  3714.     cutable file  on disk  and automatically decompress  when the
  3715.     program  is loaded.  If such a  utility is used, the disk im-
  3716.     age, and  hence the checksum,  is changed,  so the  integrity
  3717.     check will  fail.   However, such a  compression utility  may
  3718.     provide an equivalent checksum test.  Except for this consid-
  3719.     eration,  the DOS  version of  WSSINDEX has  been tested  and
  3720.     found  to be compatible  with the program  LZEXE version 0.91
  3721.     (Fabrice Bellard, 451 chemin du mas de Matour, 34790 Grabels,
  3722.     France) and  the LZESHELL program (Pete  Petrakis, 1236 River
  3723.     Bay Road, Annapolis, Maryland 21401) which translates LZEXE's
  3724.     messages  into  English.     LZEXE  compresses  the  unpacked
  3725.     WSSI527.EXE by  about 50% and  the reduced  disk access  time
  3726.     more than compensates for the decompression overhead.  PKLite
  3727.     (PKWare)   and  DIET  (Teddy  Matsumoto)  perform  similarly.
  3728.     Wssindex/Extended cannot  be compressed by any  of these pro-
  3729.     grams.
  3730.  
  3731. N - MaNual cursor motion in menus
  3732.     When you select  menu items, Wssindex tries  to guess whether
  3733.     you  will want to keep the cursor  on that item or advance to
  3734.     the next item.   Set this option to YES  to disable this fea-
  3735.     ture.
  3736.  
  3737. F - Function key layout matching IBM
  3738.     The function key help in the add-comments  screen is arranged
  3739.     in  two columns, just as the function keys on many keyboards.
  3740.     If you have an unusual keyboard which has  F2 below F1 rather
  3741.     than beside  it, such as is found  on your author's old Sanyo
  3742.     555,  set this option to  NO and the  help screen arrangement
  3743.     will  match the key arrangement.   If your  function keys run
  3744.     across the  top of  the keyboard, pick  whichever arrangement
  3745.     seems best.
  3746.  
  3747. K - Use BIOS to read Keyboard
  3748.     If YES, the keyboard is read using a BIOS call  rather than a
  3749.     DOS call.  Select YES here if you have used ANSI.SYS to rede-
  3750.     fine keys and  do not  want Wssindex to  use these  redefini-
  3751.     tions.  Select NO if your machine is not IBM  compatible.  If
  3752.     neither of  these applies, the  setting of this  flag doesn't
  3753.     really   matter.     This  option   is   forced  to   YES  in
  3754.  
  3755.  
  3756. Wssindex 5.27                   50    Miscellaneous Configuration
  3757.  
  3758.  
  3759.  
  3760.  
  3761.  
  3762.  
  3763.  
  3764.  
  3765.  
  3766.  
  3767.  
  3768.  
  3769.     Wssindex/Extended to avoid a known problem in the DOS extend-
  3770.     er.
  3771.  
  3772. I - Inverted meaning for PgUp/PgDn
  3773.     Your  author became accustomed to an  hp terminal long before
  3774.     he ever saw a PC  keyboard.  The hp keyboard had  NEXT SCREEN
  3775.     and  PREVIOUS SCREEN keys in  the same positions  as PgUp and
  3776.     PgDn, but the positions were interchanged relative to meaning
  3777.     most  programs assign to the  PC keyboard keys.   Your author
  3778.     sets this option to  YES and goes through contortions  to get
  3779.     other programs  to do  the  equivalent translation;  probably
  3780.     everyone else will set it to NO.
  3781.  
  3782. B - Create .BAK files
  3783.     When a  database is saved, and  an existing file of  the same
  3784.     name is found, the old file can be  either overwritten or re-
  3785.     named  with a .BAK extension.  The latter option is obviously
  3786.     safer since the old  file remains if the save  fails, but the
  3787.     output disk might not have enough room for two databases.  If
  3788.     you elect not  to create .BAK files, you will  be warned that
  3789.     an old file of the same name exists and must confirm that you
  3790.     really  want to overwrite it.   If creating .BAK files, a two
  3791.     generation  old .BAK file will be erased so that the previous
  3792.     database file can be renamed.
  3793.  
  3794. A - Enable Alarm sound
  3795.     Some error messages include  a beep.  This option  allows you
  3796.     do disable all such sounds.
  3797.  
  3798. P - Change Prompt in DOS shell
  3799.     The prompt when shelled to DOS can be either changed to "EXIT
  3800.     to  return to Wssindex" followed by a newline and your origi-
  3801.     nal  prompt to remind  you that you  are in a  shell, or left
  3802.     unchanged.
  3803.  
  3804. H - Strip High-bit when viewing files
  3805.     Files created by WordStar, and possibly other files, have the
  3806.     high-bit  set on  some characters.   When viewing  such files
  3807.     from the add-comments screen, it is desirable to turn off the
  3808.     high-bit  to make the text readable.  On the other hand, lan-
  3809.     guages other  than English  use characters with  the high-bit
  3810.     set.  So, generally this option should be set to YES for Eng-
  3811.     lish language users and NO for other languages.
  3812.  
  3813. U - Use color
  3814.     By default, the program  will run in monochrome.   (This does
  3815.     not refer to the type of  video board which is a separate se-
  3816.     lection.)   To get color, set this option to YES and also se-
  3817.     lect set Colors to get a color-selection menu.  Actually, the
  3818.     setting  of this control is only important if using DOS calls
  3819.     for screen output.   With  direct video writes,  you can  get
  3820.     colors even if this option is set to NO.
  3821.  
  3822. Wssindex 5.27                   51    Miscellaneous Configuration
  3823.  
  3824.  
  3825.  
  3826.  
  3827.  
  3828.  
  3829.  
  3830.  
  3831.  
  3832.  
  3833.  
  3834.  
  3835. M - Use Mouse
  3836.     Set this  option to YES to  enable the mouse.   There are two
  3837.     possible  reasons why you might  not want to  do this: first,
  3838.     the standard method  of testing  whether a  mouse is  present
  3839.     causes  some  non-compatible machines  to crash,  and second,
  3840.     when the  mouse is active, the program  sits in a loop alter-
  3841.     nately checking for  keyboard or mouse input rather than sim-
  3842.     ply asking DOS  to read the next keystroke.  In a multi-task-
  3843.     ing environment this wastes CPU cycles which could be used by
  3844.     tasks in other windows.  (Wssindex will  detect if it is run-
  3845.     ning under DESQview, DOS 5 or  OS/2 and will give up its time
  3846.     slice if there is no keyboard or mouse input pending.)
  3847.  
  3848. S - Mouse Sensitivity
  3849.     A smaller number here means less mouse motion is necessary to
  3850.     move the highlight bar.
  3851.  
  3852. C - Set Colors
  3853.     This option leads to the color selection menu.
  3854.  
  3855. V - Video board configuration
  3856.     This option leads to the video board selection menu.
  3857.  
  3858. R - Return to primary configuration menu
  3859.     Returns to the previous menu.
  3860.  
  3861.  
  3862.             Default Sorting and Selection Options Menu
  3863.  
  3864.         +-------------------------------------------------+
  3865.         |     Default Sorting and Selection Options       |
  3866.         |                                                 |
  3867.         | Selection list (none)                           |
  3868.         | Sort Keys      (none)                           |
  3869.         |                                                 |
  3870.         | Return to main menu                             |
  3871.         +-------------------------------------------------+
  3872.   Figure 14. Wssindex Default Sorting and Selection Options Menu
  3873.  
  3874.  
  3875. S - Selection list
  3876. K - Sort Keys
  3877.     When  listing files with the  Find or Print  options, you are
  3878.     prompted  for selection and sort options.  The two menu items
  3879.     here  allow you to specify the default selection and sort key
  3880.     lists.  If present, each will be a list of numbers, separated
  3881.     by commas.  These lists may be edited at the time of use, but
  3882.     such editing  does not change the  defaults.  If you  want to
  3883.     erase one of these lists, just delete the characters.  Do not
  3884.     type "none"  else you will  find that  the characters  "none"
  3885.     become the default, which isn't what you want.
  3886.  
  3887.  
  3888. Wssindex 5.27                   52    Miscellaneous Configuration
  3889.  
  3890.  
  3891.  
  3892.  
  3893.  
  3894.  
  3895.  
  3896.  
  3897.  
  3898.  
  3899.  
  3900.  
  3901. R - Return to previous menu
  3902.     Returns to the primary configuration menu.
  3903.  
  3904.  
  3905.                  Output Fields Configuration Menu
  3906.  
  3907. This  menu is used to  select what information  is displayed when
  3908. files are listed.   Note that displaying all items  requires con-
  3909. siderably more than  80 characters.   The output  format menu  is
  3910. used to control how long lines are handled.
  3911.  
  3912.  
  3913.     +-------------------------------------------------------+
  3914.     |           Output fields configuration menu            |
  3915.     |                                                       |
  3916.     | Print File name and extension plus                    |
  3917.     |                                                       |
  3918.     |      DuPlicate flag  NO    Volume            YES      |
  3919.     |      Size           YES    SuBdirectory      YES      |
  3920.     |      Date           YES    Archive file name YES      |
  3921.     |      Time           YES    Comment           YES      |
  3922.     |      SEconds        YES    CateGory          YES      |
  3923.     |                                                       |
  3924.     | Return to primary configuration menu                  |
  3925.     +-------------------------------------------------------+
  3926.        Figure 15. Wssindex Output fields configuration menu
  3927.  
  3928.  
  3929. P - DuPlicate flag
  3930.     An asterisk following the file name  if the name is the  same
  3931.     as the  previous file listed.   Note  that whether a  file is
  3932.     flagged depends on the sort order and selection options.
  3933.  
  3934. S - Size
  3935.     File size in bytes.
  3936.  
  3937. D - Date
  3938.     Date  of last  modification; date  format is selected  in the
  3939.     output format menu.
  3940.  
  3941. T - Time
  3942.     Time  of last  modification; always  omitted  if date  is not
  3943.     printed.
  3944.  
  3945. S - Seconds
  3946.     Seconds field of modification time; always omitted if time is
  3947.     not  printed.  Since MS-DOS only stores  the file time to the
  3948.     nearest two seconds, this will always be an even number.
  3949.  
  3950. V - Volume
  3951.     Disk volume label.
  3952.  
  3953.  
  3954. Wssindex 5.27                   53           Sort/select Defaults
  3955.  
  3956.  
  3957.  
  3958.  
  3959.  
  3960.  
  3961.  
  3962.  
  3963.  
  3964.  
  3965.  
  3966.  
  3967. B - SuBdirectory
  3968.     Subdirectory name or "Root" for root directory.
  3969.  
  3970. A - Archive file name
  3971.     The name of the containing archive file, if any.
  3972.  
  3973. C - Comment
  3974.     File comment, if any.
  3975.  
  3976. G - CateGory
  3977.     File category, if any.
  3978.  
  3979.  
  3980.                  Output Format Configuration Menu
  3981.  
  3982.   +------------------------------------------------------------+
  3983.   |             Output format configuration menu               |
  3984.   |                                                            |
  3985.   | Number of Blank lines between headers               0      |
  3986.   | Number of blank lines after Headers                 1      |
  3987.   |                                                            |
  3988.   | File name style                                   FN  EXT  |
  3989.   | Date style                                        mm/dd/yy |
  3990.   | Archive file delImiter                             [...]   |
  3991.   | DeliMiter around first of comment/category         (...)   |
  3992.   |                                                            |
  3993.   | Enter 0 width to use variable field size                   |
  3994.   |                                                            |
  3995.   |    Field width for Subdirectories                     0    |
  3996.   |    Field width for Archive name                       0    |
  3997.   |    Field width for Comment or category                0    |
  3998.   |                                                            |
  3999.   | Print comments bEfore categories                     NO    |
  4000.   | Always start New line for comment/category info      NO    |
  4001.   | MaX wrapped print lines per file                      2    |
  4002.   | Indentation for Wrapped lines                        10    |
  4003.   |                                                            |
  4004.   | Return to primary configuration menu                       |
  4005.   +------------------------------------------------------------+
  4006.        Figure 16. Wssindex output format configuration menu
  4007.  
  4008.  
  4009. B - Number of Blank lines between headers
  4010. H - Number of blank lines after Headers
  4011.     File  and volume listings have  two header lines,  one with a
  4012.     title, the second with column headings.  These options select
  4013.     how many blank lines  to insert between header lines,  or be-
  4014.     tween  the header lines and the data lines.  These parameters
  4015.     are ignored for screen output.
  4016.  
  4017.  
  4018.  
  4019.  
  4020. Wssindex 5.27                   54    Output Fields Configuration
  4021.  
  4022.  
  4023.  
  4024.  
  4025.  
  4026.  
  4027.  
  4028.  
  4029.  
  4030.  
  4031.  
  4032.  
  4033. F - File name style
  4034.     Selecting this  option will toggle  the file name  format be-
  4035.     tween FN EXT and FN.EXT.
  4036.  
  4037. D - Date style
  4038.     Selecting  this option  will cycle  through the  various date
  4039.     formats: mm/dd/yy, dd/mm/yy, yy/mm/dd or 01-Jan-80.  The day,
  4040.     month,  year order selected here  is used for  both input and
  4041.     output.   The date format  implied by the  COUNTRY= option in
  4042.     CONFIG.SYS is not used.
  4043.  
  4044. I - Archive file delImiter
  4045.     The name of the  archive file containing the listed  file can
  4046.     be  printed surrounded by (),  <> or [];  selecting this item
  4047.     cycles through the possible delimiters.  One of these markers
  4048.     is recommend to distinguish the archive name from the follow-
  4049.     ing field if a fixed field width is not used.
  4050.  
  4051. M - DeliMiter around first of comment/category
  4052.     The same sets  of delimiters can be used to  mark comments or
  4053.     categories as are  used to  mark archive  files.   It is  the
  4054.     field which is configured to print  first which is surrounded
  4055.     by this delimiter.
  4056.  
  4057. S - Field width for Subdirectories
  4058. A - Field width for Archive name
  4059. C - Field width for Comment or category
  4060.     Displaying all  possible file  information on a  single line,
  4061.     neatly arranged  in columns and allowing for the maximum pos-
  4062.     sible length of all fields, would require well over 200 print
  4063.     positions  even  if comments  were restricted  to the  old 64
  4064.     character  length limit.    Perhaps some  printers can  print
  4065.     lines  this long, but generally some compromise must be made.
  4066.     The  possibilities are  to  not print  everything, limit  the
  4067.     field widths, not require columnar alignment  for potentially
  4068.     long, variable length items,  or print multiple lines.   If a
  4069.     field width is specified as 0,  as many spaces as needed will
  4070.     be  used  and line  wrapping will  be  done, subject  to line
  4071.     length constraints.   Non-zero widths should  be specified if
  4072.     neat columns are desired; overly long items will be truncated
  4073.     at the field width.
  4074.  
  4075. E - Print comments bEfore categories
  4076.     Either comments or categories can be printed first.
  4077.  
  4078. N - Always start New line for comment/category
  4079.     If YES, a  new print line will be started  for any comment or
  4080.     category.
  4081.  
  4082.  
  4083.  
  4084.  
  4085.  
  4086. Wssindex 5.27                   55    Output Format Configuration
  4087.  
  4088.  
  4089.  
  4090.  
  4091.  
  4092.  
  4093.  
  4094.  
  4095.  
  4096.  
  4097.  
  4098.  
  4099. X - MaX wrapped print lines per file
  4100.     Specifies the maximum number  of continuation lines which may
  4101.     be printed for  a single file.   Subdirectory names, comments
  4102.     and categories are word-wrapped if they don't fit on the cur-
  4103.     rent  print line.   A zero  here means  only one  line, which
  4104.     probably isn't enough to  print comments or categories unless
  4105.     you are using a small font or a wide-carriage printer.
  4106.  
  4107. W - Indentation for Wrapped lines
  4108.     Specifies the  number of  spaces that continuation  lines are
  4109.     indented.  You can reasonably enter a small number  like 5 or
  4110.     10 here, or you can use a number sufficient to align  wrapped
  4111.     comments with the first character of the comment.
  4112.  
  4113. R - Return to primary configuration menu
  4114.     Return to the previous menu.
  4115.  
  4116.  
  4117.                     Video Board Configuration
  4118.  
  4119. This  menu selects the screen  output method.   This selection is
  4120. buried in  this menu because it  only needs to be  made once, and
  4121. because  accidentally configuring  for  the wrong  type of  video
  4122. board is  likely to cause an  immediate crash.   Any changes made
  4123. here take effect when you leave this menu.
  4124.  
  4125.     +-------------------------------------------------------+
  4126.     |            Video board configuration Menu             |
  4127.     |                                                       |
  4128.     | Screen writing method (changes only on menu exit) CGA |
  4129.     | Use DOS calls for prompts (for screen readers)     NO |
  4130.     | Suppress snoW on CGA                               NO |
  4131.     | Raw Mode screen output                             NO |
  4132.     |                                                       |
  4133.     | Use BIOS call to set screen size                   NO |
  4134.     | AX value for BIOS call                              0 |
  4135.     | BX value for BIOS call                              0 |
  4136.     | Screen wIdth                                       80 |
  4137.     | Screen Height                                      25 |
  4138.     | AX value for BIOS call on exit or push-to-DOS       0 |
  4139.     | BX Value for BIOS call on exit or push-to-DOS       0 |
  4140.     |                                                       |
  4141.     | Return to previous configuration menu                 |
  4142.     +-------------------------------------------------------+
  4143.         Figure 17. Wssindex video board configuration menu
  4144.  
  4145.  
  4146. S - Screen writing method
  4147.     Screen  output may be done  using either DOS  calls or direct
  4148.     video writes.  The former is slower, and on most  systems re-
  4149.     quires  that ANSI.SYS be installed (see Appendix B, page 78).
  4150.     However,  if running in a  background window, using DOS calls
  4151.  
  4152. Wssindex 5.27                   56    Output Format Configuration
  4153.  
  4154.  
  4155.  
  4156.  
  4157.  
  4158.  
  4159.  
  4160.  
  4161.  
  4162.  
  4163.  
  4164.  
  4165.     may prevent screen output from bleeding through to the  fore-
  4166.     ground  window.  The direct  write methods are  MDA for Mono-
  4167.     chrome Graphics Adapter, CGA  for Color Graphics Adaptor, EGA
  4168.     for  Enhanced Graphics  Adapter, and  VGA for  Video Graphics
  4169.     Array.  EGA  and VGA differ (here) from CGA  only in the com-
  4170.     mands to set  the border color.   A Hercules board  should be
  4171.     configured as an MDA.
  4172.  
  4173.     Normally the value here  is determined automatically, but you
  4174.     might need to change it if the auto-detection fails or if you
  4175.     change  your hardware.   If  you enter  the wrong  video type
  4176.     here,  you will likely have to reboot after leaving this menu
  4177.     because the screen will no longer be updated properly.
  4178.  
  4179. D - Use DOS calls for prompts (for screen readers)
  4180.     This  option is for  blind users.   If YES,  prompts for user
  4181.     input,  status reports  and error  messages are  displayed by
  4182.     temporarily  switching to  DOS-calls video display,  then re-
  4183.     turning to the configured screen-writing method.  This allows
  4184.     screen-reading programs  to separate important  messages from
  4185.     menu displays.  Note  that in all cases, the DOS  cursor fol-
  4186.     lows  the  highlight bar,  so screen  readers should  have no
  4187.     problem in telling where Wssindex thinks the cursor is locat-
  4188.     ed.
  4189.  
  4190. W - Suppress snoW on CGA
  4191.     Older CGA boards cannot display properly while they are being
  4192.     written to.   If this option  is YES, writes to  video memory
  4193.     will be synchronized with  the horizontal retrace to minimize
  4194.     screen disruption.  This will slow down the updating.
  4195.  
  4196. M - Raw Mode on screen output
  4197.     Raw  mode means do not check for control-c or control-s after
  4198.     every character of screen output.  Setting this option to YES
  4199.     will speed DOS calls screen  output slightly, but the differ-
  4200.     ence will probably not be noticeable.
  4201.  
  4202. B - Use BIOS call to set screen size
  4203.     If yes, a BIOS interrupt 10H is used to set the screen dimen-
  4204.     sions.  This option should only be enabled on a machine which
  4205.     is at least moderately IBM compatible.
  4206.  
  4207. A - AX value for BIOS call
  4208. B - BX value for BIOS call
  4209.     If non-zero, the  values passed  in the AX  and BX  registers
  4210.     when the video interrupt is generated.  Most boards need only
  4211.     AX;  set BX=0 unless you need another  value.  See the manual
  4212.     for your video board or appendix I,  page 89 for a listing of
  4213.     values for various boards.  Manuals may give hex values; con-
  4214.     vert them to decimal for this menu.
  4215.  
  4216. I - Screen wIdth
  4217.  
  4218. Wssindex 5.27                   57      Video Board Configuration
  4219.  
  4220.  
  4221.  
  4222.  
  4223.  
  4224.  
  4225.  
  4226.  
  4227.  
  4228.  
  4229.  
  4230.  
  4231. H - Screen Height
  4232.     The screen width and height in characters, either on entry or
  4233.     after the video interrupt to set the screen size.
  4234.  
  4235. X - AX value for BIOS call on exit or push-to-DOS
  4236. B - BX Value for BIOS call on exit or push-to-DOS
  4237.     These parameters,  if non-zero,  are used  to set the  screen
  4238.     dimensions before exiting or pushing to DOS.  Typically an AX
  4239.     value of 2,3 or 7 would be used here to return to 80x25 mode.
  4240.  
  4241. R - Return to previous menu
  4242.     Returns to the miscellaneous configuration menu.
  4243.  
  4244.  
  4245.                        Color Selection Menu
  4246.      +-----------------------------------------------------+
  4247.      |                  Attribute   Foreground  Background |
  4248.      |                                                     |
  4249.      | Normal text      none        white       blue       |
  4250.      | Highlights       bold        yellow      blue       |
  4251.      | Status info      bold        white       white      |
  4252.      | Selector bar     bold        yellow      magenta    |
  4253.      | Border color     none        blue                   |
  4254.      +-----------------------------------------------------+
  4255.             Figure 18. Wssindex color selection screen
  4256.  
  4257. Use + and - keys to cycle forward and backward through colors, or
  4258. left mouse button to advance colors.  Cursor arrow keys  or mouse
  4259. select which item is to be changed.  Hit ENTER or the right mouse
  4260. button when done.  A selector bar  is not used if using DOS calls
  4261. for screen  output, so  this option  may not  be displayed.   The
  4262. border color control is not functional on all systems, in partic-
  4263. ular, EGA cards may not allow colored borders.  Also, while there
  4264. is an ANSI  escape sequence  for setting the  border color,  most
  4265. implementations  of ANSI.SYS  do not  support it,  so the  border
  4266. color selection will  usually not  work in DOS-calls  mode.   The
  4267. actual screen colors  may not match the labels exactly.   For in-
  4268. stance,  on a monochrome system,  blue on black  will give under-
  4269. line, and non-bold  yellow may display  as brown.   As you  cycle
  4270. through colors, the labels at the left will change to the select-
  4271. ed colors.
  4272.  
  4273.  
  4274.                       The Add-Comments Menu
  4275.  
  4276. The  add-comments menu  screen displays  each matching  file name
  4277. along with the  disk and subdirectory it is found  on, as well as
  4278. the containing archive  file for archive file  members.  Starting
  4279. with  version 3.2, each disk  and each subdirectory  will cause a
  4280. dummy database entry to be made with a blank file name and exten-
  4281. sion of  "ID".   These entries, which  receive special  treatment
  4282.  
  4283.  
  4284. Wssindex 5.27                   58      Video Board Configuration
  4285.  
  4286.  
  4287.  
  4288.  
  4289.  
  4290.  
  4291.  
  4292.  
  4293.  
  4294.  
  4295.  
  4296.  
  4297. when  printing, give you a  place to hang  comments describing an
  4298. entire disk or subdirectory.
  4299.  
  4300.  +-------------------------------------------------------------+
  4301.  |                       Add comments menu                     |
  4302.  |                                                             |
  4303.  | Disk id: MS-RAMDRIVE File name:   .ID                       |
  4304.  | Subdirectory:  Root                                         |
  4305.  |                                                             |
  4306.  | Copy buffer:                                                |
  4307.  |                                                             |
  4308.  |                                                             |
  4309.  | Current file:                                               |
  4310.  |                                                             |
  4311.  |                                                             |
  4312.  | New comment:                                                |
  4313.  |    category:                                                |
  4314.  |                                                             |
  4315.  |                                                             |
  4316.  | F 1 - copy comment               F 2 - delete comment       |
  4317.  | F 3 - copy category              F 4 - delete category      |
  4318.  | F 5 - copy both                  F 6 - chng srch direction  |
  4319.  | F 7 - skip to next               F 8 - view file            |
  4320.  | F 9 - add comment and advance    F10 - return to main menu  |
  4321.  | ENTER  - comment/category toggle INSERT  - insert/overtype  |
  4322.  | Alt-F1 - toggle help             Ctrl-END - delete to end   |
  4323.  |                                                             |
  4324.  |                               Searching  forward INSERT OFF |
  4325.  +-------------------------------------------------------------+
  4326.              Figure 19. Wssindex add-comments screen
  4327.  
  4328.  
  4329. The ten  function keys, alt-letter keys,  plus BACKSPACE, INSERT,
  4330. DELETE, ENTER, HOME, and the left/right cursor arrows are used to
  4331. control this part of the program.  Two different sets of function
  4332. key  assignments can be  selected from the  configuration menu to
  4333. support  different keyboard layouts.  (A third set of key assign-
  4334. ments is used in the  Rainbow version.)  While it doesn't  really
  4335. matter which arrangement you use,  the placement of the functions
  4336. and the position of the on-screen help  are more  rational if you
  4337. select the layout which matches your keyboard.   The descriptions
  4338. below assume  that you are using the IBM layout, which is now the
  4339. default if no configuration file is found (early program releases
  4340. supported only the alternate layout).
  4341.  
  4342.  
  4343.  
  4344.  
  4345.  
  4346.  
  4347.  
  4348.  
  4349.  
  4350. Wssindex 5.27                   59              Add-Comments Menu
  4351.  
  4352.  
  4353.  
  4354.  
  4355.  
  4356.  
  4357.  
  4358.  
  4359.  
  4360.  
  4361.  
  4362.  
  4363.                        Function Key layouts
  4364.  
  4365.           F1   F2        F1   F6       PF1          F17
  4366.           F3   F4        F2   F7       PF2          F18
  4367.           F5   F6        F3   F8       PF3          SELECT
  4368.           F7   F8        F4   F9       NEXT SCREEN  FIND
  4369.           F9   F10       F5   F10      PF4          EXIT
  4370.  
  4371.             IBM          Alternate         Dec Rainbow
  4372.              (Function keys may be labeled Fn or PFn)
  4373.  
  4374.  
  4375. A help menu and three sets of information are displayed:
  4376.  
  4377. Copy buffer -  a comment/category  pair which can be  copied into
  4378.                the new comment field.
  4379. Current file - the comment/category currently in the database for
  4380.                the displayed file.
  4381. New comment/category  - the comment and  category currently being
  4382.                entered.
  4383.  
  4384. The special functions available are:
  4385.  
  4386. F1 -   Copy comment:  if the file has  a comment, copy  it to the
  4387.        new comment field; otherwise, copy the comment in the copy
  4388.        buffer.  If you  want to replace an existing  comment with
  4389.        one  from the copy buffer,  you must first  delete the old
  4390.        comment  (F2). Note that this does not actually add a com-
  4391.        ment to the file until you hit F9.
  4392.  
  4393. F2 -   Delete comment: any  comment for the  current file is  de-
  4394.        leted  immediately.  If you have  entered something in the
  4395.        new comment field, and decide that you do not want to have
  4396.        any comment associated with  the file, just hit F2  to de-
  4397.        lete the old comment, followed  by F7 to skip to  the next
  4398.        file without adding the  contents of the new field  to the
  4399.        database.  It is  not necessary to clear the  text entered
  4400.        into the new comment field.
  4401.  
  4402. F3 -   Copy  category: if the file has a category, copy it to the
  4403.        new category  field; otherwise,  copy the category  in the
  4404.        copy buffer.   As with  F1, this  does not actually  add a
  4405.        category until F9 is hit.
  4406.  
  4407. F4 -   Delete category: any category for the current  file is de-
  4408.        leted immediately.   Proceed as described under  F2 to de-
  4409.        lete a  category after  having entered something  into the
  4410.        new category field.
  4411.  
  4412. F5 -   Copy both: the same as hitting both F1 and F3.
  4413.  
  4414.  
  4415.  
  4416. Wssindex 5.27                   60              Add-Comments Menu
  4417.  
  4418.  
  4419.  
  4420.  
  4421.  
  4422.  
  4423.  
  4424.  
  4425.  
  4426.  
  4427.  
  4428.  
  4429. F6 -   Change search direction: toggles  the search direction for
  4430.        the next matching file between forward and backward.  
  4431.  
  4432. F7 -   Skip to next: advance  to the next file,  without changing
  4433.        the  current comment  and  category fields.   You  will be
  4434.        warned  if you have entered  text into the  new comment or
  4435.        category  fields but have not added this text to the data-
  4436.        base.
  4437.  
  4438. F8 -   View file: the  first indexing drive  is searched for  the
  4439.        current file.  The  disk volume name must match  (an unla-
  4440.        beled disk will be accepted).  If the file is found, it is
  4441.        displayed on the bottom half of  the screen.  Non-printing
  4442.        characters are translated to periods, so there is no prob-
  4443.        lem  with viewing a non-ascii file.  The configuration may
  4444.        be  set to clear  the high bit  of each  character to make
  4445.        WordStar files  printable.   Lines longer than  the screen
  4446.        width  are truncated.   This function will  fail and claim
  4447.        that the file  could not be found  if there is  not enough
  4448.        free memory to open a file.
  4449.  
  4450. F9 -   Add comment and advance: the new  comment and category (if
  4451.        any) are added to the current file and copied to the  copy
  4452.        buffer.   Blank  fields will  not be  copied and  will not
  4453.        change the record for the current file.
  4454.  
  4455. F10 -  Return to the main menu.   You will be warned if  you have
  4456.        entered text  into the new comment or  category fields but
  4457.        have not added this text to the database.
  4458.  
  4459. BACKSPACE - (or Delete key on  Rainbow)  Delete character to left
  4460.        of cursor.
  4461.  
  4462. DELETE - (Remove key on Rainbow)  Delete character under the cur-
  4463.        sor.
  4464.  
  4465. INSERT  - (Insert  Here on  Rainbow)   Toggle between  insert and
  4466.        overwrite mode.
  4467.  
  4468. ENTER - Toggle between comment and category.
  4469.  
  4470. Left/right cursor arrows - Move around in the comment or category
  4471.        strings for editing.
  4472.  
  4473. Control-left/right cursor arrows - Move the cursor in word rather
  4474.        than character steps.
  4475.  
  4476. PgUp/PgDn  - (Prev/Next  screen on  Rainbow) Move  the cursor  in
  4477.        steps  5 characters less than the field width.  These keys
  4478.        are primarily useful if you are entering long comments.
  4479.  
  4480.  
  4481.  
  4482. Wssindex 5.27                   61              Add-Comments Menu
  4483.  
  4484.  
  4485.  
  4486.  
  4487.  
  4488.  
  4489.  
  4490.  
  4491.  
  4492.  
  4493.  
  4494.  
  4495. HOME - (Prev Screen on Rainbow) Move the cursor to the  beginning
  4496.        of the current field.  
  4497.  
  4498. END -  (F19 key  on Rainbow) Move  the cursor  to the end  of the
  4499.        current field.  (Hitting return twice will also do this.)
  4500.  
  4501. Control-END  - (F4 key on  Rainbow) Delete characters from cursor
  4502.        to end of field.
  4503.  
  4504. Alt-F1 or Shift-F1  - (Help  key on Rainbow,  control-1 on  Sanyo
  4505.        550) toggle help display between function key descriptions
  4506.        and list of keyboard macros.
  4507.  
  4508. ^R -   Redraw the  entire screen.   It shouldn't be  necessary to
  4509.        use this key very  often, if ever, but occasionally  a DOS
  4510.        error message or a program problem can scroll or otherwise
  4511.        mess  up the parts of  the screen which  are normally con-
  4512.        stant.
  4513.  
  4514. Alt-letter - Append one of the 26 keyboard macros to the category
  4515.        field, along with a comma and a space if anything was pre-
  4516.        viously  entered there.   (The  behavior here  is slightly
  4517.        different than  in other parts  of the  program where  the
  4518.        macro strings are simply  appended to any previous input).
  4519.        Note that changing the keyboard macros will not change the
  4520.        categories which  have already been assigned  to files; it
  4521.        is the actual string which is saved for  each file.  Also,
  4522.        the macros  are stored in the configuration  file, not the
  4523.        database.  (In the  DEC Rainbow version, F20 is  used as a
  4524.        substitute for the Alt key.   On a 100A, you can  also use
  4525.        the Compose key.)
  4526.  
  4527. When  all files which match the selection criteria specified have
  4528. been processed, you normally  return to the previous menu.   This
  4529. would make it  inconvenient to apply corrections  to a previously
  4530. commented database, or otherwise  process several groups of files
  4531. selected by  name.  So,  if the  only selection criterion  is the
  4532. filename, you will be prompted  for a new list of filespecs  when
  4533. all matching  files have been  processed, and the  selected files
  4534. will automatically be sorted  using the same sort keys  (if any).
  4535. At this point, you can also just hit ESCAPE to return to the main
  4536. menu.
  4537.  
  4538. Comment and category  lengths are  limited to values  set in  the
  4539. configuration.  If you use  the category field as it is  named it
  4540. will usually be one or more relatively short phrases.  Some users
  4541. may want  to use this field  as a version number.   WSSINDEX will
  4542. not  allow control  characters  in comments,  but anything  else,
  4543. including high-bit ascii, is  acceptable.  If the  comment length
  4544. is larger than will fit on screen, the display will  scroll left-
  4545. right in steps as you move the cursor through the comment.  
  4546.  
  4547.  
  4548. Wssindex 5.27                   62              Add-Comments Menu
  4549.  
  4550.  
  4551.  
  4552.  
  4553.  
  4554.  
  4555.  
  4556.  
  4557.  
  4558.  
  4559.  
  4560.  
  4561.                         WSSINDEX Utilities
  4562.  
  4563. All of the utilities read a standard configuration file, although
  4564. in  some cases the only  information actually used  is the screen
  4565. writing method and screen colors.
  4566.  
  4567.  
  4568.                      IDADD Conversion Utility
  4569.  
  4570. WSSINDEX version  3.2 introduced a new option  to assign comments
  4571. to disks and subdirectories  in addition to files.   This feature
  4572. was implemented by making dummy database entries (which look like
  4573. files  with name .ID) for  each disk and  subdirectory.  However,
  4574. databases  created by older versions of the program will not have
  4575. these entries, and WSSINDEX  would only create them if  the disks
  4576. were  re-indexed.  Also,  it is now possible  to configure to not
  4577. generate .ID entries for volume names.
  4578.  
  4579. IDADD is a utility for adding  these dummy entries to a  database
  4580. without re-indexing.  It will also insert a .ID entry in place of
  4581. the DUMMY_EN.TRY  file which  older versions of  WSSINDEX created
  4582. when a disk was indexed with the control-a option  (and will pre-
  4583. serve any comment associated with the old entry).  It will recog-
  4584. nize disks  which already have .ID entries and just copy them, so
  4585. you can use this  utility on any database (except old version 1.x
  4586. databases which  must first  be converted  by loading  and saving
  4587. with WSSINDEX).
  4588.  
  4589. IDADD reads  a standard  configuration file,  mostly  to get  the
  4590. video output mode and screen colors.  You can specify the config-
  4591. uration and input  database file  names on the  command line,  or
  4592. allow IDADD to  prompt you for  them.   The output database  name
  4593. must be entered interactively.
  4594.  
  4595.                          *** Warning ***
  4596.  
  4597. The name of the output database must not be the same as the input
  4598. database, else the output will overwrite the input during the up-
  4599. dating process.
  4600.  
  4601. One small quirk: if you have  a subdirectory with no files in it,
  4602. IDADD  will not  create a  dummy entry  for it,  whereas WSSINDEX
  4603. would if the disk were reindexed.   It would be moderately diffi-
  4604. cult to change this, so I won't do it unless I get complaints.
  4605.  
  4606.  
  4607.                 WSSMERGE Database Merging Utility
  4608.  
  4609. WSSMERGE merges  two WSSINDEX databases.   Only databases written
  4610. by WSSINDEX version 2.0 or higher can be merged.  Older databases
  4611. can  be converted  by  loading them  into  a current  version  of
  4612.  
  4613.  
  4614. Wssindex 5.27 Utilities         63                       Custprnt
  4615.  
  4616.  
  4617.  
  4618.  
  4619.  
  4620.  
  4621.  
  4622.  
  4623.  
  4624.  
  4625.  
  4626.  
  4627. WSSINDEX  and resaving them.  Since WSSINDEX itself can now merge
  4628. databases, this utility is almost obsolete.
  4629.  
  4630. WSSMERGE reads a standard  configuration file, mostly to  get the
  4631. video output mode and screen colors.
  4632.  
  4633. When  merging, you can elect  to assign a  common category to all
  4634. files from the  first database,  and a second  category to  files
  4635. from the  second database.  This might be useful if you had small
  4636. databases  organized by category, and wanted to merge them into a
  4637. single database.  You can suppress either common category by just
  4638. hitting  return when  prompted for  the category.   In  any case,
  4639. previously entered categories are not changed.
  4640.  
  4641. The  names of  the  configuration file,  input databases,  merged
  4642. database, and  common categories  can be  entered on the  command
  4643. line (in  this order).  If  some or all are  omitted, the program
  4644. will  prompt you for them.   The WSSICNF  environment variable is
  4645. used for the default configuration file  name, and if you do  not
  4646. specify file extensions, .CNF  or .DIR is assumed, but  otherwise
  4647. there are no defaults  for the names.  If  you want to specify  a
  4648. null category, enter a hyphen.
  4649.  
  4650.                          *** Warning ***
  4651.  
  4652. The name of the output database must not be the same as either of
  4653. the  input databases, else  the output  will overwrite  the input
  4654. during the merging process.
  4655.  
  4656. The disk space required for the output file will be approximately
  4657. the sum of  the input sizes, but the entire  merged database will
  4658. not  be in core at once, so you  may be able to create a database
  4659. larger than you can restore.  If the output file would exceed the
  4660. 16K  file limit,  you will  be warned  that  WSSINDEX/Extended is
  4661. required to read the file.
  4662.  
  4663. One error which the  program may warn you about  after completing
  4664. the merging  operation is duplicate volume names in the database.
  4665. The duplicate  entries are not  deleted from the  merged database
  4666. because that  operation is  difficult to perform  without loading
  4667. the entire database into memory.   WSSINDEX has an option to  de-
  4668. lete these duplicate volumes.
  4669.  
  4670.  
  4671.                  SPLIT Database Splitting Utility
  4672.  
  4673. SPLIT  takes a WSSINDEX database  and splits it  into two smaller
  4674. databases.   This function is something you might want to do if a
  4675. database  is pushing against the memory limits.  The output data-
  4676. bases will be written in the format compatible with the  DOS ver-
  4677. sion unless the number of files exceeds 16K.
  4678.  
  4679.  
  4680. Wssindex 5.27                   64                       Wssmerge
  4681.  
  4682.  
  4683.  
  4684.  
  4685.  
  4686.  
  4687.  
  4688.  
  4689.  
  4690.  
  4691.  
  4692.  
  4693. SPLIT accepts  4 optional command line  parameters: configuration
  4694. file name,  input database name,  and two output  database names.
  4695. If specified,  the database names  become defaults which  must be
  4696. confirmed by hitting return.
  4697.  
  4698. After entering the database  names, you are shown all  the volume
  4699. names on one or a  few screens with volumes which will  go to the
  4700. second database highlighted.   (Initially, all volumes are marked
  4701. as going  to the first database.)   Move the cursor  (allowed mo-
  4702. tions summarized below)  to the volumes which  you want to go  to
  4703. the second output database and hit the spacebar.  The volume name
  4704. will be  highlighted to  indicate that the  disk will  go to  the
  4705. second database, and the cursor  will move to the next  volume in
  4706. the list.  If you change your mind, just tag the volume again and
  4707. it will toggle back.
  4708.  
  4709. At any time, you  can sort the list of volumes  by name, date in-
  4710. dexed, free disk space or numeric part of volume name.  (It's not
  4711. clear how useful  some of these sort  keys are, but  they already
  4712. existed from other places.)   After marking volumes, you  can ei-
  4713. ther abort the program or write the two databases.
  4714.  
  4715. This is a  rather crude utility in that it  doesn't give you very
  4716. much  information to  help you  decide how  to divide  the disks.
  4717. However, because it is  simple, it can handle large  databases in
  4718. limited memory, hence it can be used to break up a database which
  4719. is too large to loaded on some machines.
  4720.  
  4721.      Cursor motions       Standard keyboard    Rainbow keyboard
  4722.  
  4723.      up/down/left/right   arrow keys           arrow keys
  4724.      first volume shown   home                 Help
  4725.      1st column           ctl left arrow       ctl left arrow
  4726.      last column          ctl right arrow      ctl right arrow
  4727.      bottom of column     end                  Insert Here
  4728.      last volume shown    ctl end              Select
  4729.      next page            PgDn                 Next Screen
  4730.      previous page        PgUp                 Prev Screen
  4731.  
  4732.  
  4733.                   Database Conversion Utilities
  4734.  
  4735. There  has been surprisingly little  demand for utilities to con-
  4736. vert  databases from  other  disk indexing  programs to  WSSINDEX
  4737. format.  The following conversion programs, not normally included
  4738. in the distribution package,   can be supplied with any  order at
  4739. no extra charge.
  4740.  
  4741. Backup  Master -  not exactly  what I  had in  mind when  I first
  4742. thought about  conversion utilities.   This is a  commercial disk
  4743. backup  program which  produces  a "history  file" listing  where
  4744.  
  4745.  
  4746. Wssindex 5.27                   65                          Split
  4747.  
  4748.  
  4749.  
  4750.  
  4751.  
  4752.  
  4753.  
  4754.  
  4755.  
  4756.  
  4757.  
  4758.  
  4759. backup copies of files are stored.  The history file is converted
  4760. into a WSSINDEX database.
  4761.  
  4762. Fastback Plus (under  development) -  Backup Master  was sold  to
  4763. Fastback, and the author  wrote Fastback Plus.  Backup  log files
  4764. similar  to those produced by  Backup Master can  be written, and
  4765. the  Backup Master conversion utility  is being revised to handle
  4766. these files.
  4767.  
  4768. Dos File Tracker - this is a disk cataloguer sold by IBM; a fair-
  4769. ly straightforward conversion.
  4770.  
  4771. Other formats are under consideration for future releases.
  4772.  
  4773.  
  4774.                       Problems and Solutions
  4775.  
  4776.                     Hard/software requirements
  4777.  
  4778. You must have  MS- or PC-DOS level 2.0 or  higher to run WSSINDEX
  4779. (3.2 for extended version) because  it uses operating system fea-
  4780. tures  not supported by DOS-1.   If configured for DOS video out-
  4781. put, WSSINDEX requires only a moderate level of IBM compatibility
  4782. to  run, but your system  must support ANSI  escape sequences for
  4783. cursor  positioning and  highlighting.   This support  may  be an
  4784. integral part  of your system (as  is the case for  the Sanyo 55x
  4785. series  without the video board option), but is often provided by
  4786. an installable device driver  called ANSI.SYS (ANSI55.SYS for the
  4787. Sanyo 55x with the video board).  If your system does not support
  4788. ANSI.SYS  commands, you  will see  the control  sequences on  the
  4789. screen; they begin with  a left arrow and a [.   If you find that
  4790. you are having this problem, read about ANSI.SYS in Appendix B.
  4791.  
  4792. Many  MS-DOS machines which are not fully IBM compatible are able
  4793. to run  WSSINDEX, although often  only with the  slower DOS-calls
  4794. video  option.  Such machines often have hardware or software IBM
  4795. emulators;  these may enable WSSINDEX to run.  Machines with suf-
  4796. ficiently incompatible keyboards cannot run the standard version.
  4797. Versions for the  DEC Rainbow  and TI Professional  exist or  are
  4798. under development and will be released shortly after the IBM ver-
  4799. sion.
  4800.  
  4801.  
  4802.            Known incompatibilities with other software
  4803.  
  4804.                         Disk Cache Warning
  4805.  
  4806. WSSINDEX may not be compatible with the disk cache utility Light-
  4807. ning,  (old) version 4.2 (not to be confused with Borland's Turbo
  4808. Lightning).   Based on user reports, it  appears that if two non-
  4809. system  disks (with labels but  no files on  them) are indexed in
  4810. succession,  the volume  name and  directory of  the  second will
  4811.  
  4812. Wssindex 5.27                   66                     Conversion
  4813.  
  4814.  
  4815.  
  4816.  
  4817.  
  4818.  
  4819.  
  4820.  
  4821.  
  4822.  
  4823.  
  4824.  
  4825. appear to be identical  to the first.  This is not a WSSINDEX bug
  4826. because it can be reproduced  using the DOS VOL and  DIR commands
  4827. when Lightning is active.  I'm not sure exactly what circumstanc-
  4828. es will trigger the bug, and I don't have a copy of Lightning for
  4829. testing, but it is potentially catastrophic if directory informa-
  4830. tion is improperly  buffered when you  write to a disk.   Similar
  4831. problems could conceivably also occur with other disk cache util-
  4832. ities, although none have been reported.
  4833.  
  4834.  
  4835.                          Incompatible TSR
  4836.  
  4837. A user reports that if the Word Perfect program SHELLDOS is load-
  4838. ed, the Alt-letter  keys are  not functional in  Wssindex on  his
  4839. Tandy 2000.   This is an  ancient report, quite likely  no longer
  4840. true, but it  does point  out that memory  resident programs  can
  4841. cause unexpected side effects.
  4842.  
  4843.  
  4844.                    Answers to Common Questions
  4845.  
  4846. Q.  Help, my screen  is filled with  garbage, mostly numbers  and
  4847.     square brackets, but also some text.
  4848.  
  4849. A.  You  are configured to use  DOS calls for  screen output, but
  4850.     have not installed ANSI.SYS.  If  your video board is not IBM
  4851.     compatible, see  Appendix B  for information about  ANSI.SYS,
  4852.     otherwise read  about selecting  video mode in  the introduc-
  4853.     tion.
  4854.  
  4855. Q.  I  upgraded to a new  machine, and now  Wssindex doesn't work
  4856.     any more.
  4857.  
  4858. A.  Three possibilities:  (1) the old machine had monochrome vid-
  4859.     eo, the new machine color (or vice versa).  The configuration
  4860.     file is telling Wssindex to use the wrong screen driver.  Try
  4861.     deleting  or renaming  the configuration  file.   (2) You are
  4862.     running the  extended version  and need  to  run TUNE  again.
  4863.     (3) You are using  DOS calls for screen  output, but ANSI.SYS
  4864.     is not installed.  See the previous question.
  4865.  
  4866. Q.  The menus would look better if they were enclosed in a box.
  4867.  
  4868. A.  They are boxed if you configure for direct video writes.  The
  4869.     menu  boxes are suppressed  when using DOS  calls because the
  4870.     large number  of cursor  positioning calls makes  drawing the
  4871.     boxes really slow.
  4872.  
  4873.  
  4874. Q.  Is Wssindex compatible with Microsoft Windows 3.x?
  4875.  
  4876.  
  4877.  
  4878. Wssindex 5.27                   67                       Problems
  4879.  
  4880.  
  4881.  
  4882.  
  4883.  
  4884.  
  4885.  
  4886.  
  4887.  
  4888.  
  4889.  
  4890.  
  4891. A.  WSSINDEX (DOS version)  will run under  Windows, but it  will
  4892.     not take  advantage of any Windows features and the available
  4893.     memory for database  storage will  be less than  if run  from
  4894.     DOS.  WSSINDEX/Extended will run under Windows in real, stan-
  4895.     dard or 386 enhanced mode.  To find out which mode Windows is
  4896.     in, click  on Help,  About Program Manager  from the  Program
  4897.     Manager window.  In  386 mode under Windows 3.1,  the Windows
  4898.     DPMI server will  provide virtual memory so  that the maximum
  4899.     database size will be set by a combination of free memory and
  4900.     disk swap space.
  4901.  
  4902.  
  4903. Q.  Is Wssindex compatible with OS/2 2.x?
  4904.  
  4905. A.  Yes.  The maximum database size with Wssindex/Extended is set
  4906.     by  free memory  and disk  swap space.   Under  DOS Settings,
  4907.     DPMI_DOS_API must be set to enabled; the default AUTO doesn't
  4908.     seem to work.
  4909.  
  4910.  
  4911. Q.  I set up a big RAM disk to increase storage capacity, but I'm
  4912.     still getting out of memory errors.
  4913.  
  4914. A.  WSSINDEX keeps  a database entirely in memory.  A RAM disk in
  4915.     conventional memory  will only  serve to decrease  the memory
  4916.     available to the program.  If  you are running out of memory,
  4917.     try removing any memory resident programs such as Sidekick.
  4918.  
  4919.  
  4920. Q.  When I  print my  database, I get  all the volume  names (and
  4921.     subdirectories) first.
  4922.  
  4923. A.  These are the "dummy entries" which give you a  place to hang
  4924.     comments about  disks and subdirectories.   You probably want
  4925.     to  exclude them when sorting first by file name, and include
  4926.     them when sorting  first by  disk name.   The easiest way  to
  4927.     exclude them is  to use  selection option -1  to reject  file
  4928.     name .ID.
  4929.  
  4930.  
  4931. Q.  I don't  have any subdirectories  on my  disks, yet  WSSINDEX
  4932.     won't  let me configure for 0 subdirectories, and it tells me
  4933.     I have one, even if there are no disks in the database.
  4934.  
  4935. A.  Internally, the root directories of all disks  are treated as
  4936.     a single  subdirectory, and this pseudo-directory  is the one
  4937.     you see.
  4938.  
  4939.  
  4940. Q.  When I print,  every other page  is either blank or  has only
  4941.     one or a few lines printed on it.
  4942.  
  4943.  
  4944. Wssindex 5.27                   68               Common Questions
  4945.  
  4946.  
  4947.  
  4948.  
  4949.  
  4950.  
  4951.  
  4952.  
  4953.  
  4954.  
  4955.  
  4956.  
  4957. A.  Check your configuration.  The number of lines on the printer
  4958.     is the  number of printable  lines with no  margin allowance.
  4959.     So,  if you are using 8.5x11" paper  at 6 lines/inch, and ask
  4960.     for 66 print  lines, your printer will have just  gone to the
  4961.     top of a new page when WSSINDEX sends out a form feed.
  4962.  
  4963.  
  4964. Q.  My laser printer  only prints 60 lines/page.  How can I print
  4965.     your documentation file which is formatted for 66 lines/page?
  4966.  
  4967. A.  I  can supply replacement documentation formatted for differ-
  4968.     ent page lengths,  or WordPerfect 5.1 files.   Although Word-
  4969.     Perfect  will attempt to convert  the document to  5.0 or 4.2
  4970.     format, some of the formatting does not survive conversion to
  4971.     5.0, and  even some of the  text gets lost converting  to 4.2
  4972.     format.
  4973.  
  4974.  
  4975. Q.  Some or all of the environment variables don't seem to work.
  4976.  
  4977. A.  Are you  setting them in  your AUTOEXEC.BAT file  and running
  4978.     out  of  environment  space?   Often  other  programs run  in
  4979.     AUTOEXEC  will clear the screen before you can read the error
  4980.     message.
  4981.  
  4982.  
  4983. Q.  When  I try to make multi-column listings or disk covers, the
  4984.     last item printed for each file is partially cut off.
  4985.  
  4986. A.  WSSINDEX  builds up  a print  line containing  all the  items
  4987.     specified in the configuration, and then  truncates it to fit
  4988.     in  the available number of  columns.  You  need to configure
  4989.     for fewer items printed, wider paper, or fewer columns.
  4990.  
  4991.  
  4992. Q.  When  I print disk covers or multi-column listings for a disk
  4993.     with subdirectories, the separator line which should have the
  4994.     subdirectory name just says "Subdirectory".
  4995.  
  4996. A.  You are configured  to print the  subdirectory name for  each
  4997.     file, so the  name is not shown a second  time.  However, the
  4998.     page  is too  narrow to  display  the column  of subdirectory
  4999.     names, so it  is truncated.  The  same thing can happen  with
  5000.     volume labels.   The solution  is not to  configure to  print
  5001.     items which are truncated due to page width.
  5002.  
  5003.  
  5004.  
  5005.  
  5006.  
  5007.  
  5008.  
  5009.  
  5010. Wssindex 5.27                   69               Common Questions
  5011.  
  5012.  
  5013.  
  5014.  
  5015.  
  5016.  
  5017.  
  5018.  
  5019.  
  5020.  
  5021.  
  5022.  
  5023. Q.  I use ANSI.SYS to  redefine my function keys.   Wssindex sees
  5024.     these redefinitions so I can't use F10 to get out of the add-
  5025.     comments screen.
  5026.  
  5027. A.  If your  machine is reasonably  IBM compatible, set  the "Use
  5028.     BIOS to read keyboard" option to YES.
  5029.  
  5030.  
  5031. Q.  I can't seem to  make the push-to-DOS option work,  even with
  5032.     lots of memory free.
  5033.  
  5034. A.  Does  the  COMSPEC environment  variable  specify  a complete
  5035.     path?  If COMMAND.COM  (or whatever) is in the  root, COMSPEC
  5036.     says  d:COMMAND.COM rather then  d:\COMMAND.COM, and  you are
  5037.     logged into a subdirectory, COMMAND.COM will not be found.
  5038.  
  5039.  
  5040. Q.  I have  an ARC file which  PKXARC or PKUNPAK says  is ok, but
  5041.     WSSINDEX says it is corrupt.
  5042.  
  5043. A.  The  PKWare extraction  program will  silently skip  over any
  5044.     ascii text which is prepended to an ARC file.  SEA's ARC will
  5045.     warn you  that it is  doing this.   The one file I  have seen
  5046.     with  this  problem had  the text  "Ready  to send  file with
  5047.     XMODEM  protocol" prepended.  The  solution is to extract the
  5048.     files and recreate the archive.
  5049.  
  5050.  
  5051.                   Command Line Parameter Summary
  5052.  
  5053. The various programs in the WSSINDEX package accept optional com-
  5054. mand line parameters.  Summarized below are the parameters recog-
  5055. nized by  each program.  Names in upper case are the default file
  5056. names, other abbreviations are:
  5057.  
  5058. cnf  - a  configuration file.   Default  name set  by environment
  5059. variable WSSICNF, otherwise WSSINDEX.CNF.
  5060.  
  5061. dir - a database file,  Default name set by  environment variable
  5062. WSSIDIR, otherwise WSSINDEX.DIR.
  5063.  
  5064. * - use default.
  5065.  
  5066. =  or - - generate database  name from configuration file name by
  5067. adding .DIR extension.
  5068.  
  5069. cat1,2 - categories  to be  assigned to all  files from first  or
  5070. second  database.   Hyphen  means  none.   Multi-word  categories
  5071. should be enclosed in quotes.
  5072.  
  5073. WSSINDEX  cnf  dir
  5074.           *    *,=
  5075.  
  5076. Wssindex 5.27                   70               Common Questions
  5077.  
  5078.  
  5079.  
  5080.  
  5081.  
  5082.  
  5083.  
  5084.  
  5085.  
  5086.  
  5087.  
  5088.  
  5089. IDADD     cnf  dir
  5090.           *    *
  5091.  
  5092. SPLIT     cnf  dir  1ST_HALF.DIR  2ND_HALF.DIR
  5093.           *    *,=  *             *
  5094.  
  5095. WSSMERGE  cnf  1ST_HALF.DIR  2ND_HALF.DIR  MERGED.DIR  cat1  cat2
  5096.           *    *             *             *           -     -
  5097.  
  5098.                              Support
  5099.  
  5100. The  DOS version  of WSSINDEX  is distributed  as shareware.   In
  5101. various past releases, the shareware program file has ranged from
  5102. identical to the  registered version  to limited to  a 1000  file
  5103. database.  Currently, the  shareware executable displays an open-
  5104. ing commercial, but is otherwise identical to the version sent to
  5105. purchasers (and  as an ASP member, I  have pledged not to release
  5106. crippled  software).  If  you purchase the  complete package, you
  5107. will  receive the demo package  which you can  distribute, plus a
  5108. replacement for WSSINDEX.EXE without  the opening commercial  and
  5109. instructions  for removing whatever  limitations are  included in
  5110. future demo releases.  See  page 74 for a fee schedule.  An order
  5111. form and fee  schedule are  included in the  file ORDERFRM.DOC  .
  5112. Orders and inquiries should be directed to:
  5113.  
  5114. Robert W. Babcock
  5115. WSS Division of DDC
  5116. 4 Reeves Road
  5117. Bedford, MA  01730
  5118. USA
  5119. Phone: 617-275-1183 or 9104
  5120. Support BBS: 617-275-5834
  5121. Email addresses:
  5122.     BIX:       rbabcock
  5123.     BitNet:    babcock@cfa
  5124.     Internet: babcock@cfa.harvard.edu
  5125.     Compuserve:     >INTERNET:babcock@cfa.harvard.edu
  5126. (babcock@cfa... goes to a  server machine which forwards mail  to
  5127. my current  address.  Mail I  send out may have  a return address
  5128. which is only valid for a limited time.)
  5129.  
  5130. The  1183 number above has an answering machine which serves both
  5131. my  business and household, so don't be surprised if the recorded
  5132. announcement says  you have reached  the Babcock household.   The
  5133. 9104 number does not have an answering machine, so that's the one
  5134. to try first if you want to talk to  a real person.  I don't mind
  5135. receiving phone calls, but  you will probably only get to leave a
  5136. short message before my answering machine cuts you off.  I do try
  5137. to respond to all correspondence.  If you do call, the best times
  5138. to try  would be early  weekday mornings, weekend  afternoons, or
  5139. evenings  8:45-10:00 (Eastern time) any day but Thursday.  If you
  5140.  
  5141.  
  5142. Wssindex 5.27                   71        Command Line Parameters
  5143.  
  5144.  
  5145.  
  5146.  
  5147.  
  5148.  
  5149.  
  5150.  
  5151.  
  5152.  
  5153.  
  5154.  
  5155. don't get a call  back within a few days, it usually means that I
  5156. called and got no answer.  Please try again or send a letter.
  5157.  
  5158. If you have  a bug report, please mention the  version number and
  5159. describe your machine and operating environment in as much detail
  5160. as seems appropriate.   If I  am unable to  reproduce a  reported
  5161. problem I may ask you to send a copy of your database, but usual-
  5162. ly this is not required.  Reports of incompatibility with partic-
  5163. ular brands of machine will always be accepted even from unregis-
  5164. tered users (I can hardly ask you to buy the  complete package if
  5165. the program doesn't work on your machine).
  5166.  
  5167.  
  5168.                      The Distribution Package
  5169.  
  5170. You should  have received the following  files, possibly combined
  5171. in one or more self-extracting or archive files.  Version numbers
  5172. for  the various executables (nnn in the names below) may not all
  5173. be the same.  Demo versions of executables will have a D appended
  5174. to the file  name, Rainbow and TI Pro versions  will have respec-
  5175. tively an  R or T  appended to the  file name (and  the name will
  5176. vary slightly if this would make it longer than 8 characters).
  5177.  
  5178. BUGLIST.DOC -  a  list of known  bugs in previous  versions and a
  5179.                summary of enhancements.
  5180. CGA.CNF -      configuration file selecting  CGA (color  graphics
  5181.                adapter) video,  other options set to default val-
  5182.                ues.
  5183. CUTPAST3.COM,.DOC -  a public domain  cut and paste  utility, re-
  5184.                quires a somewhat higher degree of IBM compatibil-
  5185.                ity than WSSINDEX.  RPN.COM substituted with Rain-
  5186.                bow version.
  5187. DOSCALLS.CNF - configuration file selecting all  default options,
  5188.                including DOS calls video output.
  5189. IDADDnnn.EXE - a utility to modify old WSSINDEX databases so that
  5190.                comments may  be assigned  to disks  and subdirec-
  5191.                tories, not just files.
  5192. LATEST.VER -   list of current version numbers.
  5193. MDA.CNF -      configuration file selecting MDA  (monochrome dis-
  5194.                play adaptor) video, other options  set to default
  5195.                values.
  5196. PRNDEF.DOC -   a  description  of  the  various  included printer
  5197.                definition files.
  5198. *.DEF -        printer definition files.
  5199. README.DOC -   a very brief description of the other files.
  5200. SCREEN.DEF -   printer  definition file optimized for screen out-
  5201.                put (used by CUSTPRNT)
  5202. SITELIC.DOC -  a sample site license agreement.
  5203. SPLITnnn.EXE - database splitting utility.
  5204. TUNE.EXE -     (WSSINDEX/Extended only) utility to  configure DOS
  5205.                extender for your hardware.
  5206. VIEW.COM -     a simple, public domain document viewing utility.
  5207.  
  5208. Wssindex 5.27                   72                        Support
  5209.  
  5210.  
  5211.  
  5212.  
  5213.  
  5214.  
  5215.  
  5216.  
  5217.  
  5218.  
  5219.  
  5220.  
  5221. VIEW.DOC -     documentation for VIEW.COM
  5222. WHATMEM.EXE -  (WSSINDEX/Extended only) utility which reports how
  5223.                much extended memory is available.
  5224. WSDPMnnn.EXE - (WSSINDEX/Extended only) protected mode  main exe-
  5225.                cutable.
  5226. WSSInnn.DOC -  this documentation file in ascii form.
  5227. WSSInnn.WP -   (registered  version  only) this  documentation in
  5228.                Word Perfect 5.1 format.
  5229. WSSInnn.EXE -  (registered version only) WSSINDEX, the  main exe-
  5230.                cutable program.
  5231. WSSInnnD.EXE - evaluation version  of WSSINDEX, the  main execut-
  5232.                able.
  5233. WSSMnnn.EXE -  WSSMERGE,  a utility for merging WSSINDEX databas-
  5234.                es.
  5235.  
  5236.  
  5237.  
  5238.  
  5239.  
  5240.  
  5241.  
  5242.  
  5243.  
  5244.  
  5245.  
  5246.  
  5247.  
  5248.  
  5249.  
  5250.  
  5251.  
  5252.  
  5253.  
  5254.  
  5255.  
  5256.  
  5257.  
  5258.  
  5259.  
  5260.  
  5261.  
  5262.  
  5263.  
  5264.  
  5265.  
  5266.  
  5267.  
  5268.  
  5269.  
  5270.  
  5271.  
  5272.  
  5273.  
  5274. Wssindex 5.27                   73           Distribution Package
  5275.  
  5276.  
  5277.  
  5278.  
  5279.  
  5280.  
  5281.  
  5282.  
  5283.  
  5284.  
  5285.  
  5286.  
  5287.                        Ordering Information
  5288.  
  5289.                      WSSINDEX Price schedule
  5290.  
  5291. This fee schedule replaces any previous editions, except for site
  5292. license  agreements previously in effect.   All prices  are in US
  5293. dollars.  Extended version includes the DOS version.
  5294.  
  5295. Registration Level       Wssindex (DOS)      Wssindex/Extended
  5296.  
  5297. Level 1  Single user     $35                 $50
  5298. Level 2  2-10 users      $10 + 25 per user   $15 + 35 per user
  5299. Level 3  11-20 users     $60 + 20 per user   $115 + 25 per user
  5300. Level 4  21-50 users     $160 + 15 per user  $215 + 20 per user
  5301. Level 5  51-100 users    $410 + 10 per user  $465 + 15 per user
  5302. Level 6  101-500 users   $910 + 5 per user   $965 + 10 per user
  5303. Level 7  >500 users      $3410               $5965
  5304.  
  5305. Evaluation copy (DOS versions only)   $5.00
  5306.   (cost credited towards purchase of complete package)
  5307.  
  5308. Upgrade (plus shipping)
  5309.      DOS                               5.00
  5310.      Extended                          5.00
  5311.      DOS to Extended                  15.00
  5312.  
  5313. Printed manuals (including postage)
  5314.      USA or Canada                    10.00
  5315.      Other countries                  16.00
  5316.  
  5317. Media, shipping and handling, required for all orders
  5318.      USA and Canada                    2.50 ($2 evaluation)
  5319.      Other countries                   4.50 ($4 evaluation)
  5320.  
  5321. Check not drawn on US bank
  5322.      Canada                            1.00
  5323.      Elsewhere (use credit card to avoid this fee)25.00
  5324.  
  5325. Registration level upgrade
  5326.      price differential between old and new  levels plus $10 ser-
  5327.      vice charge
  5328.  
  5329. Please include sales tax or exemption number for orders delivered
  5330. in Massachusetts.
  5331.  
  5332. Software  upgrades: your  license covers  all future  versions of
  5333. WSSINDEX and related utilities.   Level 2 registrants will  auto-
  5334. matically  be  sent one  copy of  the  next release  of WSSINDEX.
  5335. Level 3, 4, 5, 6 and  7 registrants will be sent one copy  of all
  5336. new releases made,  respectively, in  the 6 month,  12 month,  18
  5337. month, 2 year or 3 year period following purchase.
  5338.  
  5339.  
  5340. Wssindex 5.27                   74                     Order Info
  5341.  
  5342.  
  5343.  
  5344.  
  5345.  
  5346.  
  5347.  
  5348.  
  5349.  
  5350.  
  5351.  
  5352.  
  5353. Notes:
  5354.  
  5355. 1.  The  DOS version  of  WSSINDEX is  distributed as  shareware.
  5356.     WSSINDEX is not  and has never  been public domain  software.
  5357.     If you have received the evaluation version, you  are granted
  5358.     a  limited license  to evaluate it  to see  if it  meets your
  5359.     needs.  After a 60 day evaluation period, you are expected to
  5360.     either register or stop using the  program.  With a paid reg-
  5361.     istration (and postage) you  will receive a copy of  the cur-
  5362.     rent evaluation release, plus a replacement for the main rou-
  5363.     tine which does not display the opening screen and a personal
  5364.     password for disabling the opening screen from future evalua-
  5365.     tion releases.  The evaluation version  may be distributed to
  5366.     other users for their evaluation.
  5367.  
  5368. 2.  WSSINDEX is mainly written in Turbo C (with a little assembly
  5369.     language  code), but it uses a few routines derived with only
  5370.     small  modifications from the Computer Innovations C86 source
  5371.     library.  This makes it essentially impossible for me to sell
  5372.     source code, although something  could probably be worked out
  5373.     if someone had a sufficient need.
  5374.  
  5375. 3.  I recognize that determining the exact number of users is im-
  5376.     possible in a large  organization.  A good faith  estimate is
  5377.     sufficient.  When  counting users, you  may use the  "like-a-
  5378.     book" rule: just as a book can only be read by one  person at
  5379.     a time, it should not be possible for  more than the licensed
  5380.     number of users to use the software simultaneously.
  5381.  
  5382. 4.  This price schedule is continuous at the price breaks.  It is
  5383.     never true that the total cost decreases when you add another
  5384.     user, but  the marginal  cost  declines, eventually  reaching
  5385.     zero at the highest registration level.
  5386.  
  5387. 5.  The question may arise in this era of multi-national corpora-
  5388.     tions,  who can be covered under a  single site license?  The
  5389.     answer is a single  company including wholly owned subsidiar-
  5390.     ies.  For complicated situations, please contact WSS Division
  5391.     of DDC for a price quote.
  5392.  
  5393. 6.  If you have needs which might  be met by a special version of
  5394.     WSSINDEX, or a related custom utility, please contact the au-
  5395.     thor at the  address below for estimates of feasibility, cost
  5396.     and development time.
  5397.  
  5398. 7.  To register  or to upgrade, you may print copies of the order
  5399.     form  in file ORDERFRM.DOC, or use any convenient form.  Pay-
  5400.     ment may be  by check or credit card (Mastercard  or Visa); I
  5401.     can  also handle purchase orders.  Checks may be made payable
  5402.     to Robert  W. Babcock or to WSS Division of DDC.  If you have
  5403.     any  comments about the program, please attach them and indi-
  5404.     cate which version they apply to.
  5405.  
  5406. Wssindex 5.27                   75                     Order Info
  5407.  
  5408.  
  5409.  
  5410.  
  5411.  
  5412.  
  5413.  
  5414.  
  5415.  
  5416.  
  5417.  
  5418.  
  5419. 8.  The charge for  bug correction upgrades  (only last digit  of
  5420.     version number changed) is only the shipping and handling fee
  5421.     ($2.50 US and Canada,  $4.50 elsewhere), or free if a bug be-
  5422.     ing fixed substantially interfered with your  use of the pro-
  5423.     grams.
  5424.  
  5425. 9.  If you need a  receipt for tax or accounting  purposes, check
  5426.     the appropriate  box.  Otherwise,  you will receive  a letter
  5427.     with your personal password.
  5428.  
  5429.  
  5430.  
  5431.  
  5432.  
  5433.  
  5434.  
  5435.  
  5436.  
  5437.  
  5438.  
  5439.  
  5440.  
  5441.  
  5442.  
  5443.  
  5444.  
  5445.  
  5446.  
  5447.  
  5448.  
  5449.  
  5450.  
  5451.  
  5452.  
  5453.  
  5454.  
  5455.  
  5456.  
  5457.  
  5458.  
  5459.  
  5460.  
  5461.  
  5462.  
  5463.  
  5464.  
  5465.  
  5466.  
  5467.  
  5468.  
  5469.  
  5470.  
  5471.  
  5472. Wssindex 5.27                   76                     Order Info
  5473.  
  5474.  
  5475.  
  5476.  
  5477.  
  5478.  
  5479.  
  5480.  
  5481.  
  5482.  
  5483.  
  5484.  
  5485.    Appendix A - Forcing Video Board Type if Autodetection Fails
  5486.  
  5487. Wssindex attempts to identify the type of video adapter installed
  5488. so that  it can update  the screen  by writing directly  to video
  5489. memory.  If  Wssindex does  not recognize your  video adapter  it
  5490. will  instead use ANSI escape sequences for highlighting and cur-
  5491. sor  positioning.  If your system is not configured to respond to
  5492. these sequences, the  screen display will be  unusable.  Instruc-
  5493. tions  for adding  this capability  to your  system are  given in
  5494. Appendix B, but for most machines performance will be much better
  5495. if you tell Wssindex which video driver to use.   Available driv-
  5496. ers  support  monochrome  display  adapter (MDA)  color  graphics
  5497. adapter (CGA),  EGA and VGA.   Since Wssindex is  strictly a text
  5498. mode  application, other types of video  board will normally emu-
  5499. late one of these.  As part of the standard distribution package,
  5500. you should find  configuration files MDA.CNF and CGA.CNF.  Figure
  5501. out  which  one is  appropriate  for  your hardware,  and  invoke
  5502. WSSINDEX by
  5503.  
  5504.     WSSINDEX CGA
  5505. or  WSSINDEX MDA
  5506.  
  5507. (note that  the extension .CNF  is supplied automatically  if you
  5508. leave  it off.   You can specify  a drive or  path if necessary.)
  5509. Use CGA.CNF for initial  setup with an EGA  and VGA; these  cards
  5510. are  compatible with  a  CGA except  for  setting border  colors.
  5511. Alternatively,  before starting you can issue one of the DOS com-
  5512. mands
  5513.  
  5514.     SET WSSDISP=monochrome
  5515.     SET WSSDISP=color
  5516.     SET WSSDISP=ega
  5517. or  SET WSSDISP=vga
  5518.  
  5519. as appropriate  to set the default screen writing method.  If you
  5520. select the  wrong  display type,  you may  find yourself  "flying
  5521. blind" and a reboot  will likely be necessary although  you might
  5522. be able  to recover by hitting  escape a few times  and then con-
  5523. trol-q.  Once you get running with the proper video  type select-
  5524. ed, save a configuration file with the default name WSSINDEX.CNF.
  5525.  
  5526. Some non-IBM-compatible machines, such as the Sanyo 555, may hang
  5527. when Wssindex attempts to determine the video  type.  If you want
  5528. to force Wssindex to use ANSI escape sequences without performing
  5529. the video type checks, use SET WSSDISP=doscalls.  (Any recognized
  5530. setting of WSSDISP prevents  the video type checking.)   There is
  5531. also a  DOSCALLS.CNF configuration file included  in the standard
  5532. distribution, but the configuration file  is read after the video
  5533. type checks.
  5534.  
  5535.  
  5536.  
  5537.  
  5538. Wssindex 5.27                   77                     Appendix A
  5539.  
  5540.  
  5541.  
  5542.  
  5543.  
  5544.  
  5545.  
  5546.  
  5547.  
  5548.  
  5549.  
  5550.  
  5551.                Appendix B - ANSI.SYS Screen Driver
  5552.  
  5553. MS/PC-DOS 2  and higher  allow  you to  install software  "device
  5554. drivers"  when  you boot  your computer.   These  are essentially
  5555. extensions  of the operating system to  handle specific pieces of
  5556. hardware.  If WSSINDEX is configured to use DOS calls  for screen
  5557. output, most systems will need to use the screen driver ANSI.SYS,
  5558. otherwise  the control  sequences  which are  supposed to  select
  5559. colors, position  the  cursor or  clear the  screen will  instead
  5560. appear as characters on the screen.
  5561.  
  5562. Installation  of ANSI.SYS is simple:   Check your  boot disk with
  5563. the DIR  command to see if  you have a file  called CONFIG.SYS in
  5564. the  root directory.  If  not, use your  favorite word processing
  5565. program to create such a file, and include in it the line
  5566.  
  5567.           DEVICE=ANSI.SYS
  5568.  
  5569. Either  upper or lower case is allowed,  but if you use an editor
  5570. such as WordStar which  can encode formatting information in  the
  5571. text,  be sure  to  specify  non-document  mode.    If  you  TYPE
  5572. CONFIG.SYS, you shouldn't see any funny  graphics characters.  If
  5573. you already have a CONFIG.SYS file, simply add the above line  to
  5574. it with a word processor, again in non-document mode.
  5575.  
  5576. Make sure that  the file ANSI.SYS is on your  boot disk, then re-
  5577. boot your system.  Watch  for any error messages during the  boot
  5578. process.  The display  should now be much more  intelligible when
  5579. you run WSSINDEX in DOS calls mode.
  5580.  
  5581. Notes:
  5582.  
  5583. 1.  The  Dec Rainbow and the  Sanyo 555 (without  the video board
  5584.     option) don't need ANSI.SYS because these functions are built
  5585.     into the operating system.  There are probably other machines
  5586.     for which  this is also true.  It is verrrrrry obvious if you
  5587.     lack ANSI support.
  5588.  
  5589. 2.  ANSI.SYS is not  particularly fast at screen  display.  There
  5590.     are alternative commercial, shareware and  public domain pro-
  5591.     grams with names like FANSI.SYS, NANSI.SYS, which do  a some-
  5592.     what  better job on IBM-PC compatibles.  Also, different ver-
  5593.     sions  of ANSI.SYS  and replacements  support different  com-
  5594.     mands.  I believe  that WSSINDEX now uses only  commands sup-
  5595.     ported by all  ANSI.SYS variants,  but this was  not true  in
  5596.     early releases.
  5597.  
  5598. 3.  A  user once  complained that  ANSI.SYS interfered  with some
  5599.     other applications software, but normally having it installed
  5600.     all the time will do nothing worse than use up a little memo-
  5601.     ry.   However,  ANSI.SYS also  supports control  sequences to
  5602.     redefine keys.  A  rogue program could play games  like rede-
  5603.  
  5604. Wssindex 5.27                   78                     Appendix B
  5605.  
  5606.  
  5607.  
  5608.  
  5609.  
  5610.  
  5611.  
  5612.  
  5613.  
  5614.  
  5615.  
  5616.  
  5617.     fining some key to mean DEL *.* or FORMAT C:  with the appro-
  5618.     priate confirmation.   PC Magazine published  an ANSI.SYS re-
  5619.     placement which could be configured  to not allow key redefi-
  5620.     nitions; other  ANSI.SYS replacements  may  have similar  op-
  5621.     tions.
  5622.  
  5623.  
  5624.             Appendix C - Expanding the DOS Environment
  5625.  
  5626. MS-DOS versions 2.0 and  higher reserve an area of  memory called
  5627. the environment  space which can  be used to hold  strings of the
  5628. form
  5629.  
  5630.      VARIABLE=value
  5631.  
  5632. You can view the environment variables by typing  SET, or you can
  5633. change them by typing SET something=whatever.  DOS puts the PATH,
  5634. PROMPT and COMSPEC variables  here.  Wssindex looks in  the envi-
  5635. ronment  for WSSICNF,  WSSIDIR, WSSDISP  and WSSPRINT,  and other
  5636. programs do similar things.  By default, the environment space is
  5637. only  160 characters long  (256 in DOS  5), and if  you have more
  5638. than one  or two programs  using the environment, you  may get an
  5639. "out of environment space" error from DOS.  This message is  most
  5640. likely to occur when the  SET commands are in a BAT  file because
  5641. DOS is able to  expand the environment beyond  160 bytes only  if
  5642. there  is nothing  in the  way.   Running a  BAT file  (including
  5643. AUTOEXEC) gets in the way until the BAT file exits, as does load-
  5644. ing a terminate-and-stay-resident program.
  5645.  
  5646. The  initial environment size can be increased easily, if you are
  5647. using  DOS  3.0  or  higher,  by  the  SHELL  directive  in  your
  5648. CONFIG.SYS file.  The syntax is
  5649.  
  5650.      SHELL = [path]COMMAND.COM [path] /P /E:nnn
  5651.  
  5652. where  nnn specifies the environment size.   For DOS 3.0 and 3.1,
  5653. nnn is in paragraphs (16  bytes); for DOS 3.2 or higher it  is in
  5654. bytes, and is  rounded up to a  multiple of 16.   Don't forget to
  5655. include the /P or else your AUTOEXEC.BAT file will not be execut-
  5656. ed.   The  second [path]  tells COMMAND.COM  where to  reload its
  5657. transient portion from.   Typically both paths are the same.  Any
  5658. change will not take effect until you reboot.
  5659.  
  5660. The DOS 2.x SHELL directive does not recognize the  /E option, so
  5661. the only way to increase the default environment size is to patch
  5662. COMMAND.COM.   Also, under any DOS version, if you load a second-
  5663. ary command processor (S option from Wssindex), the size environ-
  5664. ment you  will have until you  exit is the larger  of the current
  5665. environment  and the 160 or 256 byte default.  Microsoft supplies
  5666. a utility called SETENV with some of its compilers to  change the
  5667. default environment  size, but it does  not recognize COMMAND.COM
  5668. from all  vendors (for example, it  doesn't recognize COMMAND.COM
  5669.  
  5670. Wssindex 5.27                   79                     Appendix B
  5671.  
  5672.  
  5673.  
  5674.  
  5675.  
  5676.  
  5677.  
  5678.  
  5679.  
  5680.  
  5681.  
  5682.  
  5683. for my old Sanyo 555).  It isn't too difficult to do the patch by
  5684. hand; details  are given in an  article by Richard  Hale Shaw, PC
  5685. Magazine, April 14, 1987, page 295.
  5686.  
  5687.  
  5688.               Appendix D - WSSINDEX Database Format
  5689.  
  5690. This is a description of the format of a WSSINDEX database.  This
  5691. information is not needed for  normal program operation, but  may
  5692. be  useful if you want to write  a program to convert an existing
  5693. database into a WSSINDEX database, read the database with another
  5694. program to  produce a  customized listing,  or recover  a damaged
  5695. disk  file.  This description may be  easier to follow if you use
  5696. it as a guide while examining a small database with DEBUG or some
  5697. other utility.
  5698.  
  5699. Dates and times are stored in the  same format as used in an FCB.
  5700. Date has  7 bits for years since  1980, 4 bits for  month, 5 bits
  5701. for day.  Time has 5 bits for hour, 6 bits for minute, 5 bits for
  5702. second.
  5703.  
  5704. The  database is stored with disks  in the order they are indexed
  5705. and files in the order of the disk directories.
  5706.  
  5707. Wssindex/Extended can write two formats, the "small" format which
  5708. is compatible with the  DOS version and the "large"  format which
  5709. allows for more than 16K files.
  5710.  
  5711. Notation:
  5712.     \n   - a newline, that is an ASCII linefeed, hex 0A
  5713.     \EOS - end of string marker, hex 0
  5714.     *    - a field dependent on the WSSINDEX version
  5715.     var  - variable length
  5716.  
  5717.     Length Contents
  5718.     (bytes)
  5719.  
  5720. Header:
  5721.  
  5722.     9      "WSSINDEX\n"  (small  format)  of "WSEXTEND\n"  (large
  5723.            format)
  5724.     4-6*   version number\n
  5725.     2 or 4 number of disks in database, 4 bytes if large format
  5726.     2 or 4 number of subdirectories (including root), 4 bytes  if
  5727.            large format
  5728.     2 or 4 number of files, 4 bytes if large format
  5729.  
  5730. Disk record, repeated for each disk:
  5731.  
  5732.     11     volume name, blank padded to 11 chars (no \n or EOS)
  5733.     4      bytes on disk
  5734.     4      free bytes on disk
  5735.  
  5736. Wssindex 5.27                   80                     Appendix C
  5737.  
  5738.  
  5739.  
  5740.  
  5741.  
  5742.  
  5743.  
  5744.  
  5745.  
  5746.  
  5747.  
  5748.  
  5749.     2 or 4 number of files on disk, 4 bytes if large format
  5750.     2 or 4 number of subdirectories on disk (not counting  root),
  5751.            4 bytes if large format
  5752.     2      date indexed
  5753.     1      "Y" or "N" for bootable or not, "?" for dummy entry
  5754.  
  5755. Subdirectory record, repeated for each subdirectory:
  5756.  
  5757.     2 or 4 disk  number, count starts  at zero, 4  bytes if large
  5758.            format
  5759.     var    subdirectory name\n
  5760.  
  5761. File record, repeated for each file:
  5762.  
  5763.     9      file name\EOS    there may be garbage after  the \EOS.
  5764.            \EOS is 1st character if this is a .ID record
  5765.     4      extension\EOS   there may be garbage after the \EOS
  5766.     2      date
  5767.     2      time
  5768.     4      size
  5769.     2 or 4 disk number, high  bit set if file  is a member of  an
  5770.            archive file, 4 bytes if large format
  5771.     2 or 4 subdirectory  number (root  is  0) for  ordinary file,
  5772.            file  number of  containing archive  file for  archive
  5773.            member, 4 bytes if large format
  5774.     1      "C" (if commented), else blank
  5775.     var    comment\n   if comments flag is "C"
  5776.     1*     "C"  (if categorized), else  blank; field only present
  5777.            if written by version 2.00 or later
  5778.     var*   category\n  if category flag is "C"
  5779.  
  5780. Note that there is not a  control-Z to mark the end of file,  and
  5781. there may  be embedded  control-Z's in the  binary fields  (date,
  5782. time, size, etc.).
  5783.  
  5784. This information is subject to change in future releases.  Howev-
  5785. er, I  do guarantee  that WSSINDEX  will always  be able  to read
  5786. databases written by older versions of the program (possibly with
  5787. a conversion utility).   Note that this guarantee does  not apply
  5788. to configuration files.
  5789.  
  5790.  
  5791.               Appendix E - Printer Definition Files
  5792.  
  5793. Some of  the Wssindex output options  need to be able  to set the
  5794. print pitch and line spacing on your printer (e.g., printing disk
  5795. covers  or labels  which  require small  print).   Unfortunately,
  5796. there is no standard way to  do this; all printers are different.
  5797. So, Wssindex must be told how to control your printer.   You sup-
  5798. ply this information in a printer definition file.  (I'd  call it
  5799. a  configuration file, but that term is already being used.)  The
  5800. name of the  printer definition  file is set  by the  environment
  5801.  
  5802. Wssindex 5.27                   81                     Appendix D
  5803.  
  5804.  
  5805.  
  5806.  
  5807.  
  5808.  
  5809.  
  5810.  
  5811.  
  5812.  
  5813.  
  5814.  
  5815. variable WSSPRINT,  analogous to  WSSICNF  and WSSIDIR.   If  not
  5816. specified,  the default name is  WSSPRINT.DEF.  The  file is read
  5817. the  first time a print operation which needs the definition file
  5818. is requested, or when you select "E" from the print menu.  
  5819.  
  5820. The standard distribution package  includes definition files  for
  5821. several  popular printers.   Some  of these  have been  tested on
  5822. printers  available to me, some  have been donated  by users, and
  5823. some were created by  looking at printer manuals or  driver files
  5824. from  word processing programs.  The comments at the beginning of
  5825. each  file indicate  whether or  not the  file has  been properly
  5826. tested.  If none of the supplied definition files is adequate for
  5827. your printer,  you will  need to  look up control  codes in  your
  5828. printer  manual and modify one of the  supplied files.  I realize
  5829. that it would  be better if I supplied definition  files for hun-
  5830. dreds  of different printers, but  I don't have  the resources to
  5831. create and test them.  Registered users who have problems config-
  5832. uring  should send me a  photocopy of the  appropriate pages from
  5833. their printer manual (usually the control codes are summarized in
  5834. a few pages) and I will try to assist.  Of course, it may be that
  5835. your printer does not accept any commands, in which case you must
  5836. make any necessary selections manually.
  5837.  
  5838. The format of the  definition files is designed for  easy editing
  5839. with a word  processing program.   The file  begins with as  many
  5840. lines of comments as desired, until a line beginning with ---- is
  5841. encountered.  After this, alternate lines are comments and param-
  5842. eters.  The comment lines are ignored when the file  is read, but
  5843. since  they tell you what  the parameters mean,  the only changes
  5844. you should make  are to add more detail.  Printer command strings
  5845. can be omitted, but  other parameters should have a  value filled
  5846. in.
  5847.  
  5848. Characters in the printer definition (other than the printer name
  5849. and  owner id) are interpreted  as a series  of tokens optionally
  5850. separated by blanks or commas.  Each token may be an octal, deci-
  5851. mal,  or hex number, an  ascii character, or  a special abbrevia-
  5852. tion.   Blank or comma  delimiters are only  necessary to resolve
  5853. ambiguities about where one  token ends and the next  begins, but
  5854. are recommended to improve human readability.
  5855.  
  5856. Octal numbers  - begin with a 0, contain only the digits 0-7, and
  5857. are not larger than 377.  Terminated by a comma, blank or special
  5858. abbreviation.
  5859.  
  5860. Decimal numbers  - begin with a non-zero digit and are not larger
  5861. than 255.   Of course,  zero is entered  as 0.   Terminated by  a
  5862. comma, blank or special abbreviation.
  5863.  
  5864. Hexadecimal numbers - begin with 0x or 0X and are not larger than
  5865. 0xff.  Letters A-F (if used) can  be lower or upper case.  Termi-
  5866. nated by a comma, blank or special abbreviation.
  5867.  
  5868. Wssindex 5.27                   82                     Appendix E
  5869.  
  5870.  
  5871.  
  5872.  
  5873.  
  5874.  
  5875.  
  5876.  
  5877.  
  5878.  
  5879.  
  5880.  
  5881. Ascii characters  - any  normal  character other  than a  number,
  5882. comma, blank or backslash.  No terminator needed.
  5883.  
  5884. Special abbreviations (may also be upper case) - 
  5885.  
  5886.    \digit - number as a character rather than a binary value
  5887.    \b     - backspace
  5888.    \c     - comma
  5889.    \e     - escape
  5890.    \f     - form feed
  5891.    \n     - newline (linefeed)
  5892.    \r     - carriage return
  5893.    \s     - blank (space)
  5894.    \t     - tab
  5895.    \\     - \
  5896.  
  5897. Be careful of numbers; 1 means  the binary value 1 while \1 means
  5898. the ascii character one which  has the binary value 31 hex  or 49
  5899. decimal.   Printer manuals often are unclear  about this distinc-
  5900. tion.
  5901.  
  5902. To make the entries in the printer definition file more readable,
  5903. I have adopted the convention that entries which code for a  sin-
  5904. gle output  byte are separated by blanks, and the groups of char-
  5905. acters which make up a single command to the printer are separat-
  5906. ed by  commas.   For example:  suppose you want  to set  an Epson
  5907. printer to 
  5908.  
  5909.    8 lines per inch           (command ESC "0")  (character 0)
  5910.    12 characters per inch     (command ESC "B" 2)
  5911.    double strike              (command ESC "G")
  5912.  
  5913. The printer definition file entry could be:  \e \0,\e B 2,\e G
  5914.  
  5915. To  continue a sequence on the following line, terminate the cur-
  5916. rent line with a backslash.   There is a conversion table  in Ap-
  5917. pendix E which may be useful in creating definition files.
  5918.  
  5919. Margins, width  and length  specifications in this  file override
  5920. those found in WSSINDEX.CNF when printing labels or covers.
  5921.  
  5922. The definable items are:
  5923.  
  5924. Printer name  - echoed to  the screen during  initialization, but
  5925. otherwise not used.
  5926.  
  5927. Three  sets of  printer initialization  commands - 50  chars max.
  5928. (That's 50 characters after converting  to internal form.  Multi-
  5929. digit numbers count as  one character, and blanks don't  count at
  5930. all.)  The first set is used for multi-column printing,  the sec-
  5931. ond  for disk labels, and  the third for  disk covers.  Typically
  5932. this would include  commands to select  the number of  characters
  5933.  
  5934. Wssindex 5.27                   83                     Appendix E
  5935.  
  5936.  
  5937.  
  5938.  
  5939.  
  5940.  
  5941.  
  5942.  
  5943.  
  5944.  
  5945.  
  5946.  
  5947. per  inch printed and line spacing.   You may also be able to get
  5948. very small characters by selecting subscript or superscript mode,
  5949. although  some printers (like mine) are slow  in this mode and do
  5950. not print characters  with descenders  very well.   You can  also
  5951. include any other necessary initialization commands here, such as
  5952. bold printing or form length.
  5953.  
  5954. Printer deinitialization  command - 50  chars max.   This command
  5955. string is  sent to the printer  after a print task  is completed.
  5956. It could include a form feed to eject the last  page from a laser
  5957. printer, or could reset default printer options.
  5958.  
  5959. Left margin for labels - number of print positions to leave blank
  5960. before printing the first column of labels.
  5961.  
  5962. Number of columns for labels - the number  of blank labels across
  5963. a row of your forms.
  5964.  
  5965. Width of labels  - The number of characters which will fit across
  5966. a  label (starting from the  left margin).   This effectively de-
  5967. fines the right margin.
  5968.  
  5969. Number  of characters  between labels  - for  multi-column forms,
  5970. this is  the number of characters between the right margin of one
  5971. label and the left margin of the next.
  5972.  
  5973. Length of label in lines  - label size, including top and  bottom
  5974. margin lines which you don't want to print on.
  5975.  
  5976. Number of  usable lines  for label -  maximum number of  lines to
  5977. print on a label.
  5978.  
  5979. Left margin for disk covers - number of print  positions to leave
  5980. blank  before printing left side of box which surrounds disk cov-
  5981. ers.
  5982.  
  5983. Width of paper for disk covers  - number of characters which will
  5984. fit in 5.25 inches (or 3.5 or whatever disk size you use).
  5985.  
  5986. Length  of page in lines for disk  covers - number of lines which
  5987. will fit in 5.25 inches (or 3.75 inches for paste-on size).
  5988.  
  5989. Position for the  next disk cover -  70 characters max.   Printer
  5990. command to  position the paper  for the  next disk  cover.   This
  5991. could be a form feed, or a number of line feeds.  A 0 (zero) here
  5992. is  interpreted to mean manual  positioning, with a  pause at the
  5993. end of each cover.
  5994.  
  5995. Command  to use for sides of disk  cover box - 70 characters max.
  5996. Disk cover  listings have a border drawn  around them.  The sides
  5997. of  this border could be  a vertical stroke,  or your printer may
  5998. have a better graphics character available.  If no suitable char-
  5999.  
  6000. Wssindex 5.27                   84                     Appendix E
  6001.  
  6002.  
  6003.  
  6004.  
  6005.  
  6006.  
  6007.  
  6008.  
  6009.  
  6010.  
  6011.  
  6012.  
  6013. acter  is available,  or for  faster printing,  just use  a blank
  6014. (32).   Characters which form boxes on a printer may display very
  6015. differently on screen.
  6016.  
  6017. Command  to use for  top and  bottom lines  - 70  characters max.
  6018. Probably a hyphen or a graphics character.
  6019.  
  6020. Command to use for top left corner - 70 characters max.  If  your
  6021. printer has box forming characters in its graphics character set,
  6022. use them for  the corner  characters, otherwise you  can use  the
  6023. same character as the top or sides, or a blank, or a plus, which-
  6024. ever you think looks best.
  6025.  
  6026. Command to use for top right corner - 70 characters max.
  6027.  
  6028. Command to use for bottom left corner - 70 characters max.
  6029.  
  6030. Command to use for bottom right corner - 70 characters max.
  6031.  
  6032. End of printer definition file
  6033. ----------
  6034.  
  6035. Additional items may be added to this file in future releases  if
  6036. users report that  there are printers which cannot  be adequately
  6037. defined.  If you  create a definition file for a different print-
  6038. er, especially  a laser printer,  I would appreciate  receiving a
  6039. listing so that I will have it when the inevitable cries for help
  6040. come in from other users.
  6041.  
  6042. Registered users are encouraged to  suggest the custom print for-
  6043. mats which they would like to see added to Wssindex.
  6044.  
  6045.  
  6046.  
  6047.  
  6048.  
  6049.  
  6050.  
  6051.  
  6052.  
  6053.  
  6054.  
  6055.  
  6056.  
  6057.  
  6058.  
  6059.  
  6060.  
  6061.  
  6062.  
  6063.  
  6064.  
  6065.  
  6066. Wssindex 5.27                   85                     Appendix E
  6067.  
  6068.  
  6069.  
  6070.  
  6071.  
  6072.  
  6073.  
  6074.  
  6075.  
  6076.  
  6077.  
  6078.  
  6079.            Appendix F - Character Code Conversion Table
  6080.  
  6081.   ascii decimal hex     ascii decimal hex     ascii decimal  hex
  6082.  
  6083.    NUL     0      0       +     43     2B       V      86     56
  6084.    SOH     1      1       ,     44     2C       W      87     57
  6085.    STX     2      2       -     45     2D       X      88     58
  6086.    ETX     3      3       .     46     2E       Y      89     59
  6087.    EOT     4      4       /     47     2F       Z      90     5A
  6088.    ENQ     5      5       0     48     30       [      91     5B
  6089.    ACK     6      6       1     49     31       \      92     5C
  6090.    BEL     7      7       2     50     32       ]      93     5D
  6091.    BS      8      8       3     51     33       ^      94     5E
  6092.    TAB     9      9       4     52     34       _      95     5F
  6093.    LF     10      A       5     53     35       `      96     60
  6094.    VT     11      B       6     54     36       a      97     61
  6095.    FF     12      C       7     55     37       b      98     62
  6096.    CR     13      D       8     56     38       c      99     63
  6097.    SO     14      E       9     57     39       d     100     64
  6098.    SI     15      F       :     58     3A       e     101     65
  6099.    DLE    16     10       ;     59     3B       f     102     66
  6100.    DC1    17     11       <     60     3C       g     103     67
  6101.    DC2    18     12       =     61     3D       h     104     68
  6102.    DC3    19     13       >     62     3E       i     105     69
  6103.    DC4    20     14       ?     63     3F       j     106     6A
  6104.    NAK    21     15       @     64     40       k     107     6B
  6105.    SYN    22     16       A     65     41       l     108     6C
  6106.    ETB    23     17       B     66     42       m     109     6D
  6107.    CAN    24     18       C     67     43       n     110     6E
  6108.    EM     25     19       D     68     44       o     111     6F
  6109.    SUB    26     1A       E     69     45       p     112     70
  6110.    ESC    27     1B       F     70     46       q     113     71
  6111.    FS     28     1C       G     71     47       r     114     72
  6112.    GS     29     1D       H     72     48       s     115     73
  6113.    RS     30     1E       I     73     49       t     116     74
  6114.    US     31     1F       J     74     4A       u     117     75
  6115.           32     20       K     75     4B       v     118     76
  6116.    !      33     21       L     76     4C       w     119     77
  6117.    "      34     22       M     77     4D       x     120     78
  6118.    #      35     23       N     78     4E       y     121     79
  6119.    $      36     24       O     79     4F       z     122     7A
  6120.    %      37     25       P     80     50       {     123     7B
  6121.    &      38     26       Q     81     51       |     124     7C
  6122.    '      39     27       R     82     52       }     125     7D
  6123.    (      40     28       S     83     53       ~     126     7E
  6124.    )      41     29       T     84     54       DEL   127     7F
  6125.    *      42     2A       U     85     55
  6126.  
  6127. Three letter combinations are non-printing control characters.
  6128.  
  6129.  
  6130.  
  6131.  
  6132. Wssindex 5.27                   86                     Appendix F
  6133.  
  6134.  
  6135.  
  6136.  
  6137.  
  6138.  
  6139.  
  6140.  
  6141.  
  6142.  
  6143.  
  6144.  
  6145. In WSSINDEX versions for non-IBM compatible machines, all of  the
  6146. executable files  are different,  but this documentation  file is
  6147. unchanged.  Beware of trying  to transfer configuration files be-
  6148. tween versions  of WSSINDEX  for different machines.   Generally,
  6149. this is only safe if  DOS-calls video is selected, and even  then
  6150. you should  examine the transferred configuration  for any anoma-
  6151. lies.   Printer definition  files and databases  are transferable
  6152. between versions.
  6153.  
  6154.  
  6155.               Appendix G - WSSINDEX for DEC Rainbow
  6156.  
  6157. I  now own  a minimally  configured Rainbow  100A for  testing so
  6158. Rainbow  and IBM releases should be  roughly coincident.  Rainbow
  6159. versions will normally be sent on RX-50 format disks, which I can
  6160. write  either on the Rainbow or on a 1.2 MB drive using a special
  6161. device driver.
  6162.  
  6163. The  Rainbow  version of WSSINDEX is the same as the IBM  version
  6164. with the following exceptions:
  6165.  
  6166. 1.  Color  is not supported but fast video display and 132 column
  6167.     screens are supported.  For fast video, specify SET WSSDISP=V
  6168.     or use the included RAINBOW.CNF configuration file.
  6169.  
  6170. 2.  The add-comments menu uses a different set of keys, which are
  6171.     shown  in the menu.  Keyboard macros are triggered by COMPOSE
  6172.     CHARACTER or F20 followed by a letter rather than Alt-letter.
  6173.     For hardware reasons, the  COMPOSE key can only be  used as a
  6174.     function  key  on a  100A,  so  I have  dropped  it from  the
  6175.     on-screen menus.
  6176.  
  6177. 3.  Use the CANCEL key rather than the ESCAPE key  to cancel com-
  6178.     mands.   If the  screen gets messed  up, the MAIN  SCREEN key
  6179.     forces a screen reset the next time the screen is cleared.
  6180.  
  6181. 4.  HELP, F19 and F4 substitute for Alt-F1, END and control-END.
  6182.  
  6183. 5.  Line editing  uses the delete  key rather than  the backspace
  6184.     key (actually either can be used).
  6185.  
  6186. 6.  The version number has an "R" appended.  A database stored on
  6187.     disk will be one byte longer, but  readable by an IBM version
  6188.     of the program (assuming  you can get around disk  format in-
  6189.     compatibilities).
  6190.  
  6191. 7.  The cut-and-paste program CUTPAST3 doesn't work on a Rainbow.
  6192.     I instead include  RNP.COM, but it is  not really equivalent.
  6193.     VIEW.COM doesn't work either, and I do not  know of an alter-
  6194.     native viewer.
  6195.  
  6196.  
  6197.  
  6198. Wssindex 5.27                   87                     Appendix G
  6199.  
  6200.  
  6201.  
  6202.  
  6203.  
  6204.  
  6205.  
  6206.  
  6207.  
  6208.  
  6209.  
  6210.  
  6211.             Appendix H - WSSINDEX for TI Professional
  6212.  
  6213. I now own a minimally  configured TI Pro for testing, so  Pro and
  6214. IBM releases should be roughly coincident.
  6215.  
  6216. The  Texas Instruments  Professional computer  does not  have IBM
  6217. compatible video, so the standard version cannot run using direct
  6218. video writes.   Also, there is  a bug in the  TI ANSI.SYS support
  6219. which prevents color selection from working properly.  Patches to
  6220. fix this are available, but they depend  on the DOS version being
  6221. used.   They should not  be necessary if direct  video writes are
  6222. enabled.  (While  I have some of  the patch files, I  do not have
  6223. one for the version of DOS which came with my TI Pro.  However, a
  6224. user verifies  that color selection  works properly in  DOS calls
  6225. mode.)
  6226.  
  6227. The major difference  in the TI  Pro version is  that the  screen
  6228. output  routines know how to  access the TI  video hardware.  Ad-
  6229. justments are also  made for IBM  keys not found  on the TI  key-
  6230. board.
  6231.  
  6232. The built-in default colors are not appropriate for the TI Pro; I
  6233. suggest  using the included TI.CNF  file as a  starting point for
  6234. configuring.   Set WSSDISP=V  for fast screen  updating by direct
  6235. video writes.
  6236.  
  6237.  
  6238.  
  6239.  
  6240.  
  6241.  
  6242.  
  6243.  
  6244.  
  6245.  
  6246.  
  6247.  
  6248.  
  6249.  
  6250.  
  6251.  
  6252.  
  6253.  
  6254.  
  6255.  
  6256.  
  6257.  
  6258.  
  6259.  
  6260.  
  6261.  
  6262.  
  6263.  
  6264. Wssindex 5.27                   88                     Appendix H
  6265.  
  6266.  
  6267.  
  6268.  
  6269.  
  6270.  
  6271.  
  6272.  
  6273.  
  6274.  
  6275.  
  6276.  
  6277.          Appendix I - Parameters for setting screen sizes
  6278.  
  6279. Video board BIOS's often  support text modes beyond the  usual 80
  6280. columns    25 rows.   Unfortunately, there are  few standards for
  6281. selecting  these modes.  In  particular, the modes  wider than 80
  6282. columns,  which can be very  useful when viewing  a database with
  6283. comments,  cannot be set without knowing what brand of video card
  6284. is in use.  The table below lists the AX values which need  to be
  6285. entered into the Video Board Configuration menu and the resulting
  6286. screen sizes.  (BX value is also listed for the Vega VGA.)  Modes
  6287. are color unless specified as mono.  Available modes  may be lim-
  6288. ited by the amount of video memory on your board, or by the capa-
  6289. bilities of your monitor.  If your board is not listed here, your
  6290. manual may include the  necessary information.  Note that  the AX
  6291. value listed  here is decimal  and the  selected mode must  be an
  6292. alpha mode, not a graphics mode.
  6293.  
  6294. The  first 5  entries should  work with  almost any  video board.
  6295. AX=2,3 or 7 is usually what you want to set when exiting or push-
  6296. ing to DOS.
  6297.  
  6298. Board     AX    Screen size       Board     AX    Screen size
  6299.  
  6300. CGA (or    2    80x25  mono       AT&T      84    132x43
  6301.   higher)  3    80x25               VDC600  85    132x25
  6302. MDA        7    80x25  mono                 86    132x43 2-color
  6303. EGA     4370    80x43                       87    132x25 2-color
  6304. VGA     4370    80x50
  6305.  
  6306. 2-the-Max 34    132x44 2-color    ATI EGA   35    132x25
  6307.   VGA     36    132x28 2-color      Wonder  39    132x25 mono
  6308.           37    132x25 2-color              51    132x44
  6309.           38    80x60  2-color              55    132x44 mono
  6310.           42    100x40 2-color              88    80x33
  6311.  
  6312. Ahead Sys 34    132x44            ATI VIP   35    132x25
  6313.   EGA2001 35    132x25                      39    132x25 mono
  6314.           80    132x25 mono                 51    132x44
  6315.           82    132x44 mono                 55    132x44 mono
  6316.                                             85    80x66
  6317. Allstar   34    132x43                      88    80x33
  6318.   Peacock 35    132x28                      89    80x66
  6319.           36    132x25
  6320.           38    80x60             ATI VGA   51    132x44
  6321.           42    100x40              Wonder  35    132x25
  6322.                                             55    132x44 mono
  6323. AST VGA   84    132x43                      39    132x25 mono
  6324.   Plus    85    132x25
  6325.                                   Hewlett-  84    132x43
  6326.                                     Packard 85    132x25
  6327.                                     D1180A
  6328.  
  6329.  
  6330. Wssindex 5.27                   89                     Appendix I
  6331.  
  6332.  
  6333.  
  6334.  
  6335.  
  6336.  
  6337.  
  6338.  
  6339.  
  6340.  
  6341.  
  6342.  
  6343. Board     AX    Screen size       Board     AX    Screen size
  6344.  
  6345. Lava      80    80x34             Tseng     24    132x44 mono
  6346.   Chrome  81    80x30               Labs    25    132x25 mono
  6347.   II EGA  82    80x60               EVA     26    132x28 mono
  6348.           83    132x43                      34    132x44
  6349.           84    132x25                      35    132x25
  6350.                                             36    132x28
  6351. NSI Smart 86    132x43                      38    80x60
  6352.   EGA+    87    132x25
  6353.                                   VEGA VGA  BX    AX=28421
  6354. Paradise  81    80x30                       64    80x43
  6355.   EGA-480 84    132x43                      65    132x25
  6356.           85    132x25                      66    132x43
  6357.                                             67    80x60
  6358. Paradise  84    132x43                      68    100x60
  6359.   VGA     85    132x25                      77    120x25
  6360.           86    132x43                      78    120x43
  6361.           87    132x25                      79    132x25
  6362.                                             80    80x43  mono
  6363. Tatung    64    80x43                       81    132x25 mono
  6364.   VGA     65    132x25                      82    132x43 mono
  6365.           66    132x43
  6366.           67    80x60             Video 7   64    80x43
  6367.           68    100x60              V-RAM   65    132x25
  6368.           69    132x28                      66    132x43
  6369.                                             67    80x60
  6370. Taxan 565 84    132x43                      68    100x60
  6371.   EGA     85    132x25                      69    132x28
  6372.           86    132x43 mono
  6373.           87    132x25 mono
  6374.  
  6375. Tecmar    23    132x25
  6376.   VGA/AD  64    80x43
  6377.  
  6378.  
  6379.  
  6380.  
  6381.  
  6382.  
  6383.  
  6384.  
  6385.  
  6386.  
  6387.  
  6388.  
  6389.  
  6390.  
  6391.  
  6392.  
  6393.  
  6394.  
  6395.  
  6396. Wssindex 5.27                   90                     Appendix I
  6397.  
  6398.  
  6399.  
  6400.  
  6401.  
  6402.  
  6403.