home *** CD-ROM | disk | FTP | other *** search
/ RBBS in a Box Volume 1 #2 / RBBS_vol1_no2.iso / add2 / sd62.zip / SD.DOC < prev    next >
Text File  |  1989-06-02  |  144KB  |  2,921 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                    SD: IBM-PC SORTED DIRECTORY UTILITY V6.2
  21.  
  22.                    Copyright (C) 1986-89 By John F. Stetson
  23.  
  24.                        SHAREWARE - All Rights Reserved
  25.  
  26. 1.0  INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . .  1
  27.      1.1  Program Requirements  . . . . . . . . . . . . . . . . . . .  1
  28.      1.2  Design Philosophy . . . . . . . . . . . . . . . . . . . . .  1
  29.      1.3  Distribution Files  . . . . . . . . . . . . . . . . . . . .  2
  30.      1.4  Installation  . . . . . . . . . . . . . . . . . . . . . . .  3
  31.  
  32. 2.0  OVERVIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . .  4
  33.      2.1  Modes of Operation  . . . . . . . . . . . . . . . . . . . .  4
  34.      2.2  Command Line Syntax . . . . . . . . . . . . . . . . . . . .  4
  35.      2.3  Controlling Program Output  . . . . . . . . . . . . . . . .  6
  36.      2.4  Summary of Switches . . . . . . . . . . . . . . . . . . . .  7
  37.      2.5  Examples of Use . . . . . . . . . . . . . . . . . . . . . .  8
  38.  
  39. 3.0  FILE SELECTION AND SORTING . . . . . . . . . . . . . . . . . . . 11
  40.      3.1  File Selection By Attribute . . . . . . . . . . . . . . . . 11
  41.      3.2  File Selection By Date  . . . . . . . . . . . . . . . . . . 12
  42.      3.3  ARC and ZIP File Processing . . . . . . . . . . . . . . . . 12
  43.      3.4  Global Subdirectory Processing  . . . . . . . . . . . . . . 14
  44.      3.5  Sort Field Selection Switches . . . . . . . . . . . . . . . 14
  45.  
  46. 4.0  OUTPUT FORMAT CONTROL  . . . . . . . . . . . . . . . . . . . . . 16
  47.      4.1  Output Mode Switches  . . . . . . . . . . . . . . . . . . . 16
  48.      4.2  Output Toggle Switches  . . . . . . . . . . . . . . . . . . 17
  49.      4.3  Filename Column Switches  . . . . . . . . . . . . . . . . . 19
  50.      4.4  EGA and VGA Switches  . . . . . . . . . . . . . . . . . . . 20
  51.  
  52. 5.0  SYSTEM INFORMATION SUMMARY . . . . . . . . . . . . . . . . . . . 22
  53.      5.1  System Hardware . . . . . . . . . . . . . . . . . . . . . . 22
  54.      5.2  System Memory . . . . . . . . . . . . . . . . . . . . . . . 23
  55.      5.3  Disk Parameters . . . . . . . . . . . . . . . . . . . . . . 24
  56.      5.4  VSN Utility Program . . . . . . . . . . . . . . . . . . . . 26
  57.  
  58. 6.0  SPECIAL ENVIRONMENTS . . . . . . . . . . . . . . . . . . . . . . 29
  59.      6.1  Batch File Operation  . . . . . . . . . . . . . . . . . . . 29
  60.      6.2  Multitasking Environments . . . . . . . . . . . . . . . . . 31
  61.      6.3  Local Area Networks and OS/2  . . . . . . . . . . . . . . . 31
  62.  
  63. 7.0  MEMORY RESIDENT VERSION (SDR)  . . . . . . . . . . . . . . . . . 32
  64.      7.1  Overview  . . . . . . . . . . . . . . . . . . . . . . . . . 32
  65.      7.2  Installation  . . . . . . . . . . . . . . . . . . . . . . . 33
  66.      7.3  Activation  . . . . . . . . . . . . . . . . . . . . . . . . 34
  67.      7.4  Execution . . . . . . . . . . . . . . . . . . . . . . . . . 35
  68.      7.5  Termination . . . . . . . . . . . . . . . . . . . . . . . . 36
  69.      7.6  Removal . . . . . . . . . . . . . . . . . . . . . . . . . . 37
  70.      7.7  Switch Differences  . . . . . . . . . . . . . . . . . . . . 38
  71.      7.8  Configuration . . . . . . . . . . . . . . . . . . . . . . . 39
  72.      7.9  Error Messages  . . . . . . . . . . . . . . . . . . . . . . 41
  73.  
  74. 8.0  CUSTOMIZATION  . . . . . . . . . . . . . . . . . . . . . . . . . 42
  75.      8.1  Configuring the Program . . . . . . . . . . . . . . . . . . 42
  76.      8.2  SDC Configuration Program . . . . . . . . . . . . . . . . . 44
  77.      8.3  Patch Area Format . . . . . . . . . . . . . . . . . . . . . 46
  78.  
  79. 9.0  APPENDICES . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
  80.      9.1  Error Messages and Return Codes . . . . . . . . . . . . . . 49
  81.      9.2  Modification History  . . . . . . . . . . . . . . . . . . . 50
  82.      9.3  Product Support . . . . . . . . . . . . . . . . . . . . . . 50
  83.  
  84. SD V6.2 User's Guide                                             Page  1
  85.  
  86. 1.0  INTRODUCTION
  87.  
  88. 1.1  Program Requirements
  89.  
  90. This is a user-supported  SHAREWARE  product.  Please  see  the  section
  91. titled Product Support at the end of this document for details.
  92.  
  93. SD.COM is a Sorted Directory utility program which  operates  on  IBM-PC
  94. compatible computer systems using the IBM  PC-DOS  or  Microsoft  MS-DOS
  95. Operating System Version 2.0 through 4.0 and  also  under  the  IBM  and
  96. Microsoft OS/2 Operating System in the  DOS 3.X  compatibility  mode.  A
  97. memory resident (TSR) version called SDR.COM is also provided.
  98.  
  99. This version of the program  requires  about  16Kb  of  disk  space  and
  100. about 32-64Kb of  memory  during  execution,  depending  on  the  number
  101. of files and directories being processed.
  102.  
  103. Current  program  limitations  are  about  625  total  directories  when
  104. processing global directories, about 1525 files per directory, and about
  105. 1315 files per ARC or ZIP file, assuming 64Kb of memory is available.
  106.  
  107. File sizes up to 100Mb and disk sizes up to 1000Mb are fully supported.
  108.  
  109. Support is provided for IBM-PC  compatible  MDA, CGA, MCGA, EGA, and VGA
  110. video adaptors and monitors.
  111.  
  112. 1.2  Design Philosophy
  113.  
  114. SD provides more information than the resident DOS DIR command about the
  115. files on a disk, and allows  the  user  to  select,  sort,  format,  and
  116. display the information in a variety of ways.  This is  accomplished  by
  117. specifying  a pattern name to select the desired files and by specifying
  118. any of a variety of command line "switches" which allow  you  to  modify
  119. the  behavior of the program.  The switch names have been designed using
  120. letters, as much as possible, so that it  is  easier  to  associate  the
  121. function  of  a  switch  with its name.  In addition, the default switch
  122. values have been carefully chosen to reflect their most common use.
  123.  
  124. Although the program is relatively small, it is possible to use it in an
  125. almost  infinite  variety  of  ways  by  using the switches in different
  126. combinations.  A significant amount of effort has gone  into  optimizing
  127. the  performance  of  the  program,  due  to  the  number of times it is
  128. typically used.  The  program  is  designed  to  be  as  transparent  as
  129. possible  in  normal  operation,  and does not impose itself between the
  130. user  and  the  operating  system.    This  allows  both   novice    and
  131. experienced users to use it in the way that best meets their needs.
  132.  
  133. As a default, the program writes output directly to video display memory
  134. which results in noticeably faster output than that possible  with  DOS.
  135. Output can still be redirected to an output device or file by specifying
  136. the standard DOS redirection symbol (>) on the DOS command line.
  137.  
  138. Maximum possible use is made of the horizontal dimension of  the  screen
  139. to minimize the loss of previously displayed data by screen scrolling.
  140.  
  141. Support is provided for a variety of file selection attributes.
  142.  
  143. Support is provided for a variety of screen display formats with varying
  144. amounts of detailed file information displayed.
  145.  
  146. SD V6.2 User's Guide                                             Page  2
  147.  
  148. A variety of user customizable command line switches  and  screen  field
  149. display colors are also supported.
  150.  
  151. Every effort has been made to keep the size of the program to a minimum,
  152. for  efficient use on systems having floppy disks.  However, many of the
  153. capabilities of both DOS and this program are only fully  realized  when
  154. using large hard (fixed) disks with  hierarchical  directory  structures
  155. to organize files.
  156.  
  157. Two of the most valuable resources in a computer system are  memory  and
  158. disk storage.  Many applications make little or no attempt to use  these
  159. resources efficiently.  Not only does this program  attempt  to  provide
  160. many useful (and hopefully frequently used) capabilities in an efficient
  161. package, but it can be used to manage the system memory and  disk  space
  162. so that they are used to best advantage.
  163.  
  164. 1.3  Distribution Files
  165.  
  166. The SD program and associated files are distributed in the  form  of  an
  167. archive file called SD62.ARC or SD62.ZIP.  This is  done  to  save  disk
  168. space and time when transferring  files  over  Computer  Bulletin  Board
  169. systems and to insure the integrity  of  the  files.  You  will  need  a
  170. utility program (ARC or PKUNZIP) which  is  capable  of  extracting  the
  171. files from the distribution file.  These types of programs are  normally
  172. available from most Computer Bulletin Boards or Software Libraries.
  173.  
  174. The distribution file contains the following files:
  175.  
  176. SD      .COM - Executable File for SD - Sorted Directory Utility
  177. SDR     .COM - Executable File for SDR - Memory Resident Version of SD
  178. VSN     .COM - Executable File for VSN - Volume Serial Number Utility
  179. SD      .DOC - Documentation File for SD, SDR, SDC, and VSN
  180. SD      .PIF - Microsoft Windows PIF File for SD
  181.  
  182. SDB     .BAT - Batch File - Browse SD Output Using LIST Program
  183. SDD     .BAT - Batch File - Execute SD Commands for Multiple Drives
  184. SDM     .BAT - Batch File - Execute SD with Multiple Command Parameters
  185.  
  186. DEMO    .BAT - Batch File Demonstrating the SD Program
  187. DEMO2   .BAT - Batch File Demonstrating Related Products
  188. DEMO3-6 .COM - Executable Files Called By DEMO2.BAT
  189. ORDER   .FRM - Order and Registration Form
  190. SITE    .FRM - Site License Agreement Form
  191.  
  192. The following file is also provided when you register SD:
  193.  
  194. SDC     .EXE - Executable File for SDC - Configuration Program
  195.  
  196. The following source code files are also available separately:
  197.  
  198. SD      .ASM - Assembly Language Source File for SD
  199. SDR     .ASM - Assembly Language Source File for SDR
  200. VSN     .ASM - Assembly Language Source File for VSN
  201. SDC     .BAS - BASIC Language Source File for SDC
  202.  
  203. SD V6.2 User's Guide                                             Page  3
  204.  
  205. 1.4  Installation
  206.  
  207. Copy the .BAT and .COM files from the  distribution  file  to  the  root
  208. directory of the system boot disk (normally C:\) or to another directory
  209. of your choice which is specified in the DOS PATH command  in  the  file
  210. AUTOEXEC.BAT.
  211.  
  212. The best way to quickly  familiarize  yourself  with  the  features  and
  213. capabilities of SD is to run the DEMO.BAT file.  For best results,  copy
  214. the DEMO.BAT file to the root directory of the system  boot  disk,  make
  215. sure this is the default directory (type CD C:\), and type the  command:
  216.  
  217. DEMO
  218.  
  219. You can optionally specify a target drive and/or directory for the files
  220. to be displayed.  For example:
  221.  
  222. DEMO D: or DEMO D:\BIGDIR
  223.  
  224. You can also run the demonstration in "quick mode", where  you  will  be
  225. able to see the program running at full speed, without user prompts:
  226.  
  227. DEMO C:\ /Q
  228.  
  229. Only the files in the target directory and its  subdirectories  will  be
  230. processed, so it is best to specify the root directory of the  drive  in
  231. order to be able to access a large number of  files.  The  demonstration
  232. is designed to be run with a copy of the distributed SD.COM file, before
  233. any program defaults are changed by the user.  This demonstration simply
  234. displays information about the computer system  and  the  files  on  the
  235. selected disk; it does not write anything to the disk.
  236.  
  237. Once you are familiar with SD, you may wish to run  the  DEMO2.BAT  file
  238. for  a  quick  demonstration  of  several   related  products.  See  the
  239. section titled Product Support for additional information.
  240.  
  241. SD V6.2 User's Guide                                             Page  4
  242.  
  243. 2.0  OVERVIEW
  244.  
  245. 2.1  Modes of Operation
  246.  
  247. SD is a versatile program that can be used in a variety of ways:
  248.  
  249. The most common use is to simply display information  about  files  (and
  250. subdirectories)  in  a  single (usually the current) directory.  Most of
  251. the sort field switches are used in this mode.
  252.  
  253. The program can be  used  to  display  detailed  information  about  the
  254. system hardware configuration,  the  availability  and  current  use  of
  255. different kinds of system memory and fundamental  disk  characteristics.
  256. The /i switch is used in this mode.
  257.  
  258. The program can be used to search or scan  all  (or  a  subset)  of  the
  259. ARC and/or ZIP files on a disk for one or  more  files  which  meet  the
  260. specified criteria  (file name pattern or age).  This  processing  makes
  261. effective use of ARC and ZIP compressed files by allowing easy access to
  262. ARC and ZIP directories.  The /a and /z switches are used in this mode.
  263.  
  264. The program can be used to search or scan  all  (or  a  subset)  of  the
  265. directories  on  a  disk for one or more files or directories which meet
  266. the  specified  criteria  (file name pattern,  file attributes, or age).
  267. The /g switch is used in this mode.
  268.  
  269. The program can be used to display a graphical directory tree map of all
  270. (or a subset) of the directories on a  disk  which  meet  the  specified
  271. criteria (file name pattern or age). The /m switch is used in this mode.
  272.  
  273. The program can be used to create an output file by redirecting  console
  274. output  which may be subsequently used as input to another program.  The
  275. /r switch can be used in this mode, but is optional  since  the  program
  276. will automatically detect the use of DOS command line redirection.
  277.  
  278. 2.2  Command Line Syntax
  279.  
  280. The complete form of the DOS command line to run the program is:
  281.  
  282. D>sd [drive][path][filespec] [/switches] [>[>]device/file]
  283.  
  284. In most cases, only one or two parameters are specified, so the  command
  285. syntax  isn't  as  formidable  as  it  may appear at first.  Each of the
  286. command line parameters is optional (as the [] characters indicate)  and
  287. may  be  used  together in any combination or order.  Spaces may also be
  288. freely used at any point to improve readability.   The  various  command
  289. line parameters are described below:
  290.  
  291. [drive]
  292.  
  293. This parameter specifies the name of the disk  drive  to  be  processed.
  294. Typical  drive  letters  are A: or B: for floppy disks and C: for a hard
  295. disk.  RAM (memory) disks implemented via device  drivers  may  also  be
  296. specified, as can other types of disks, such as CD-ROM drives or logical
  297. Network drives. If no drive letter is specified, the currently logged-in
  298. drive (shown in the DOS prompt) is used.
  299.  
  300. SD V6.2 User's Guide                                             Page  5
  301.  
  302. [path]
  303.  
  304. This parameter specifies the path  through  the  hierarchical  directory
  305. structure  to  the  desired  directory  which  contains  the files to be
  306. processed.  The general form of the path parameter is shown below:
  307.  
  308. [\][directory][\directory]...[\directory][\]
  309.  
  310. The path name may simply be the name of the root directory (\),  or  the
  311. name of a subdirectory in the root directory.  The standard DOS . and ..
  312. directory names  may  be  used  to  refer  to  the  current  and  parent
  313. directories,  respectively.    If  a  path is not specified, the current
  314. directory on the specified disk drive is used.  If the path name is  the
  315. first parameter on the DOS command line after  the  program  name,  then
  316. they must be separated by a space.
  317.  
  318. [filespec]
  319.  
  320. This parameter specifies  which  file  names  are  to  be  selected  for
  321. processing from the previously specified directory (if any).  A complete
  322. (unambiguous) file name may be specified, or  an  ambiguous  file  name,
  323. containing  "wildcard"  characters  (? or *)  may be specified to select
  324. several files.  Either the file name (first 8 characters)  or  the  file
  325. extension  (last  3  characters)  or both may be completely omitted.  In
  326. these cases, wildcard characters are automatically  used  to  match  all
  327. possible  file names in the selected directory.  You may specify leading
  328. characters of the file names you wish to match,  omitting  the  trailing
  329. characters of the name, the period delimiter, and the file extension. In
  330. this respect, SD processes  file  specifications  differently than  DIR.
  331.  
  332. For example: SD ABC is equivalent to DIR ABC*.*
  333.  
  334. If you specify a filespec which exactly  matches  a  subdirectory  name,
  335. then only the files in the subdirectory will be selected.  If  you  wish
  336. to select other files in the parent directory  with  leading  characters
  337. the same as the subdirectory name, you must use the following  notation:
  338.  
  339. Instead of SD ABC, use SD ABC*, where ABC is a subdirectory name.
  340.  
  341. [/switches]
  342.  
  343. This parameter specifies one or more "switch"  or  option  values  which
  344. modify  the operation of the command.  All switches are optional and may
  345. be specified before the drive, path, and filespec, after them,  or  both
  346. before  and  after.  Each switch has a  default  value  which  has  been
  347. carefully selected to represent the  most  frequently  used  option  for
  348. most users.  Specifying a switch overrides or "toggles" the  current  or
  349. default value of that command  option.  The  SDC  program  can  be  used
  350. to change the default values of the switches, or  they  can  be  patched
  351. using the standard DOS DEBUG utility  program.  If  you  find  that  you
  352. frequently wish to override a default switch value, you can  permanently
  353. change the default switch  value  by  using  either  of  these  methods.
  354. If a default switch value is overridden, specification  of  that  option
  355. will toggle the option back  to  its  original  state,  if  appropriate.
  356. Detailed descriptions of all switches are given below.
  357.  
  358. SD V6.2 User's Guide                                             Page  6
  359.  
  360. [>[>]device/file]
  361.  
  362. This parameter is actually a standard feature of DOS called  redirection
  363. of  output  to  the  "standard output" (STDOUT) device.  This allows the
  364. console output generated by the program  to  be  transmitted  to  either
  365. another device (usually the printer device: PRN), or to a disk file.  By
  366. redirecting the output of the command to a file, you can later  use  the
  367. file  as  input  to a word processor, disk catalog system, etc.  If this
  368. parameter is specified, the program will automatically detect  this  and
  369. will use  standard  DOS console  output  services  rather  than  writing
  370. directly to video display memory.
  371.  
  372. 2.3  Controlling Program Output
  373.  
  374. Unlike most programs, you can't type ahead while the program is running.
  375. This is due to the need to monitor the keyboard in order  to  pause  the
  376. screen output.  If you wish to begin typing a new command, simply  press
  377. ESCAPE or CTRL-C to  terminate  the  output,  and  then  type  the  next
  378. command.  ESCAPE causes the program to  terminate  immediately,  whereas
  379. CTRL-C closes the file box and displays the disk space totals line.
  380.  
  381. Console output may be paused by  pressing  any  other  key  and  may  be
  382. restarted in two different ways.  If the  RETURN  or  PAGE-DOWN  key  is
  383. pressed, screen output resumes until the either the screen fills or  the
  384. output finishes.  If any other key is pressed, only  a  single  line  of
  385. additional screen  output  is  displayed.  This  allows  you  to  easily
  386. control the displayed output so as to  minimize  the  loss  of  existing
  387. screen data by scrolling.  The  Space  Bar  or  the  DOWN-ARROW  key  is
  388. recommended for use in single line scrolling mode.
  389.  
  390. As an experiment, try typing the command  SD,  immediately  followed  by
  391. two carriage returns.  You will see only one line of output and can  use
  392. the space bar to display additional lines.  When you have  seen  enough,
  393. press the ESCAPE key to terminate the program.  By  carefully  selecting
  394. the proper switch values and using this technique, you can minimize  the
  395. loss of previously displayed information on the display screen.
  396.  
  397. If /q is specified, the console output  isn't  paused  when  the  screen
  398. fills.  This is necessary when redirecting output to a file  or  device,
  399. or when you wish to browse through large amounts of output.
  400.  
  401. Output lines which are longer than the current screen width  (usually 80
  402. columns) are truncated at the right screen margin when writing to  video
  403. display memory, but not when redirecting output to a file or device.
  404.  
  405. Program output may be sent to a printer in several different ways:
  406.  
  407. You can use the technique of "echoing" console output  to the printer by
  408. pressing either Control-P or Control-Print-Screen to start and stop.
  409.  
  410. You can use the technique of printing the entire contents of the  screen
  411. by pressing Shift-Print-Screen.
  412.  
  413. You can use the technique of  redirecting  all  program  output  to  the
  414. printer by using the DOS command line redirection symbol and the printer
  415. device name: SD ... >PRN
  416.  
  417. SD V6.2 User's Guide                                             Page  7
  418.  
  419. 2.4  Summary of Switches
  420.  
  421. /s  - Select all files and directories
  422. /sd - Select Directories only (no files)
  423. /sf - Select Files only (no directories)
  424. /ss - Select files with the System attribute
  425. /sh - Select files with the Hidden attribute
  426. /sr - Select files with the Read/Only attribute
  427. /sa - Select files with the Archive attribute
  428. /sn - Select files with No attributes
  429. /@n - Select files after/before (+/-) today-n
  430.  
  431. /a  - Process ARC files (+) (:filespec)
  432. /z  - Process ZIP files (+) (:filespec)
  433. /az - Process both ARC and ZIP files (+) (:filespec)
  434. /g  - Process Global directories (n)osort (t)otals
  435.  
  436. /f  - Sort by (1) File Name and (2) extension (+/-)
  437. /x  - Sort by (1) file Extension and (2) name (+/-)
  438. /b  - Sort by file size in Bytes (+/-)
  439. /d  - Sort by (1) file Date and (2) time (+/-)
  440. /c  - Sort by file Cluster number or ARC/ZIP CRC (+/-)
  441. /n  - Do Not sort directory entries
  442.  
  443. /?  - Display program Help information
  444. /i  - Display system Information summary
  445. /j  - Just display configured screen colors
  446. /l  - List file names and (p)ath names only
  447. /m  - Display graphical directory tree Map
  448. /r* - Redirect output to device or file using * char
  449. /t  - Display Totals output lines only (n)o totals
  450.  
  451. /e  - Erase the screen before displaying output
  452. /h  - Display output using Horizontal sequence
  453. /k  - Display memory and disk space in Kilobytes
  454. /o  - Switch between long and short date and time formats
  455. /p  - Measure CPU performance for /i switch
  456. /q  - Quick output (no prompts when the screen fills)
  457. /u  - Switch between Upper and Lower case filenames
  458. /v  - Display disk Volume label and path at start
  459. /w  - Reset the screen to 25 lines at exit
  460. /y  - Restore the original screen at exit
  461.  
  462. /1  - Display file information in 1 column
  463. /2  - Display file information in 2 columns
  464. /4  - Display file information in 4 columns
  465. /6  - Display file information in 6 columns
  466.  
  467. /25 - Display 25 lines on EGA or VGA monitor
  468. /35 - Display 35 lines on EGA or VGA monitor
  469. /43 - Display 43 lines on EGA or VGA monitor
  470. /50 - Display 50 lines on EGA or VGA monitor
  471.  
  472. /$  - Display prompt and read keyboard in .BAT file
  473. /$$ - Don't move cursor up when exiting from .BAT file
  474.  
  475. SD V6.2 User's Guide                                             Page  8
  476.  
  477. 2.5  Examples of Use
  478.  
  479. The following examples assume that the original program switch  defaults
  480. have not been altered by the SDC configuration program or DEBUG.
  481.  
  482. A>sd
  483. Display the current directory of drive A.
  484.  
  485. C>sd /?
  486. Display program help information.
  487.  
  488. A>sd c:/i/p
  489. Measure CPU performance and display system information summary including
  490. information for the disk in drive C.
  491.  
  492. C>sd d:\/m
  493. Display a graphical directory tree map of all directories on drive D.
  494.  
  495. C>sd d:\work/m/u >prn
  496. Write a graphical directory tree map of all directories on drive D which
  497. are subdirectories of the "work" directory to the printer in upper case.
  498.  
  499. B>sd/f/6
  500. Display the current directory of drive B, sorted by file name, using the
  501. six column format (file names only).
  502.  
  503. D>sd c:\/ss/1
  504. Display only the system files in the root directory of  drive  C,  using
  505. the one column output format.
  506.  
  507. C>sd /j
  508. Display the currently configured screen colors.
  509.  
  510. A>sd c:\/sd
  511. Display all of the subdirectories in the root directory of drive C.
  512.  
  513. A>sd /lp/sf c:\ >files.dat
  514. Create a file called "a:files.dat" which contains a sorted list  of  all
  515. files with path names (no directories) in the root directory of drive C.
  516.  
  517. A>sd .asm/b-
  518. Display all files having an extension of "asm" in the current  directory
  519. of drive A and sort the output by descending file size.
  520.  
  521. B>sd \/n/4/y
  522. Select all files in the root directory of drive B, do not sort the file
  523. entries, display the output using the four column  format  and  restore
  524. the original console screen when done.
  525.  
  526. C>sd \/35
  527. Display all of the files in the root directory of drive C using 35 lines
  528. on the screen with an EGA or VGA.
  529.  
  530. C>sd \/u/50/w
  531. Display all of the files in the root directory of drive C in upper  case
  532. using 50 lines on the screen with an EGA or VGA and automatically  reset
  533. to 25 lines when done.
  534.  
  535. SD V6.2 User's Guide                                             Page  9
  536.  
  537. C>sd d:/i /r= >prn
  538. Write system information for drive D to the printer, substituting the  =
  539. character for all graphics characters.
  540.  
  541. B>sd temp.* >c:temp.dir
  542. Select all files having a name of "temp" in  the  current  directory  of
  543. drive B, and redirect the console output to file "c:temp.dir".
  544.  
  545. B>sd/1 c:\*.com >>c:temp.dir
  546. Select all files with an extension of "com" in  the  root  directory  of
  547. drive  C,  format  using  one  output  column,  and redirect the console
  548. output, appending to the file "c:temp.dir".
  549.  
  550. B>sd e:/k/u
  551. Display the current directory of drive E, rounding the space  values  to
  552. Kilobytes and displaying the file names in upper case.
  553.  
  554. C>sd /h/2
  555. Display all files and directories in the current directory  on  drive  C
  556. sorted and displayed from left to right, using the two column format.
  557.  
  558. A>sd t/e/k/q
  559. Select all files in the current directory of drive A whose  names  begin
  560. with  "t",  erase the screen before displaying output, display file size
  561. and disk space values in Kilobytes and do not pause the console output.
  562.  
  563. C>sd \
  564. Display all files in the root  directory  of  drive  C  sorted  by  file
  565. extension and by file name using the two column format.
  566.  
  567. B>sd temp
  568. If temp is an existing subdirectory in the current directory of drive B,
  569. then  select  all of the files in that directory.  Otherwise, select all
  570. files in the current directory of drive B whose names begin with "temp".
  571.  
  572. B>sd temp*
  573. Display all directories and files in the current directory  of  drive  B
  574. whose names begin with "temp".
  575.  
  576. A>sd ../sar
  577. Display all files in the parent directory of the  current  directory  of
  578. drive A with either the archive or read/only attribute.
  579.  
  580. A>sd c:/d/@+30
  581. Display all files in the current directory of drive C which were created
  582. during the past month sorted by date and time, using two output columns.
  583.  
  584. C>sd \/v/g/1
  585. Display the disk volume label and all information for all files  in  all
  586. directories of drive C.
  587.  
  588. C>sd \/gt
  589. Display grand totals information only for all directories on drive C.
  590.  
  591. C>sd \/g/t/s
  592. Display totals information only for all directories on drive C.
  593.  
  594. SD V6.2 User's Guide                                             Page 10
  595.  
  596. C>sd c:\command.com/2/tn >check.cmd
  597. Create a file called "check.cmd" which  contains  directory  information
  598. for the file command.com, but without the disk and directory totals.
  599.  
  600. C>sd d:\test/gn
  601. Display information for files and directories at and  below  the  "test"
  602. directory level of drive D without sorting directory names.
  603.  
  604. A>sd c:\*.exe/g
  605. Display information for all .exe files in all directories on drive C.
  606.  
  607. C>sd /sn
  608. Display all files without any attributes on drive C.
  609.  
  610. A>sd c:\/g/sd
  611. Display all directory names on drive C.
  612.  
  613. B>sd ..\*.a?m/d+/1
  614. Display all files in the parent directory of the  current  directory  of
  615. drive  B  whose  extensions begin with "a" and end with "m" and sort the
  616. output by ascending date and time using the one column output format.
  617.  
  618. C>sd /a/1
  619. Display all files in all ARC files in the current directory of  drive  C
  620. using the one column format.
  621.  
  622. C>sd /z:*.com/4
  623. Display all .com files in all ZIP files  in  the  current  directory  of
  624. drive C using the 4 column format.
  625.  
  626. C>sd abc/a/@+365
  627. Display all files less than one year old in all ARC  files  whose  names
  628. begin with "abc" in the current directory of drive C in 2 column format.
  629.  
  630. C>sd \/az+/gt
  631. Display grand totals information only for all files in  all  directories
  632. and all files in all ARC and ZIP files in all directories of drive C.
  633.  
  634. C>sd/v/1 b:\dir1\dir2\dir3\*.doc/d >prn
  635. Select  all  files  having  an  extension  of  "doc"  in  the  directory
  636. "\dir1\dir2\dir3"  of  drive  B.  Sort the output by date and time.  Use
  637. the one  column  output  format  and  include  the  disk  volume  label.
  638. Redirect the console output to the printer.
  639.  
  640. A>sd/r/q b: (Type Control-P/RETURN)
  641. Display the current directory of  drive  B  and  duplicate  the  console
  642. output on the printer.  Type Control-P/RETURN again  to stop the output.
  643.  
  644. SD V6.2 User's Guide                                             Page 11
  645.  
  646. 3.0  FILE SELECTION AND SORTING
  647.  
  648. 3.1  File Selection By Attribute
  649.  
  650. Syntax: /s[attr-switch]...[attr-switch]
  651.  
  652. /s  - Select all files and directories
  653. /sd - Select Directories only (no files)
  654. /sf - Select Files only (no directories)
  655. /ss - Select files with the System attribute
  656. /sh - Select files with the Hidden attribute
  657. /sr - Select files with the Read/Only attribute
  658. /sa - Select files with the Archive attribute
  659. /sn - Select files with No attributes
  660.  
  661. These switches are used to further restrict  which  files  are  selected
  662. (in addition to any filespec) based on the attributes of the files.
  663.  
  664. As a default, the /s switch is configured ON.  This means that all files
  665. (including Hidden and System files) are selected as a  default.  If  you
  666. prefer to not see these files (like DIR) unless you type /s, set the  /s
  667. switch OFF using the SDC program or DEBUG.
  668.  
  669. If /sd is specified, all and only the subdirectories  in  the  specified
  670. directory are selected, including the current (.) and parent (..).
  671.  
  672. If /sf is specified, all files (regardless of attribute) and none of the
  673. directories are selected.
  674.  
  675. If /sn is specified, all and only  the  files  with  none  of  the  four
  676. possible  file  attributes   are  selected.   This  switch  is  mutually
  677. exclusive with the other /s switches.
  678.  
  679. If a /ss, /sh, /sr, or /sa switch is specified by itself, all  and  only
  680. the files with the specified attribute are selected.  These switches may
  681. also be combined in any order and the intervening /s switch(es) omitted.
  682. For example: SD C:\DIR/SA/SR is equivalent to SD C:\DIR/SAR
  683.  
  684. When multiple /s switches are specified, the effect is "additive";  i.e.
  685. for  the  example  above, all files with either the Archive or Read/Only
  686. attribute will be selected from the specified directory.
  687.  
  688. Specification of any /s switch(es) other than /sd causes  an  additional
  689. 'totals' line to be displayed which summarizes the number of files which
  690. have each of  the  requested  attributes.  If  files  with  the  Archive
  691. attribute are selected, the percent of files with this attribute is also
  692. displayed.  This provides an indication of the need to back up files  on
  693. a hard disk.
  694.  
  695. Since separate colors are used to identify System and Hidden files  from
  696. normal files, it is possible to permanently configure the /s  switch  ON
  697. without losing the ability to distinguish the different file types.
  698.  
  699. SD V6.2 User's Guide                                             Page 12
  700.  
  701. 3.2  File Selection By Date
  702.  
  703. Syntax: /@[+/-][days][+/-]
  704.  
  705. The /@ switch is used to select files based on their age (the  date  the
  706. file was created or last updated). Since dates are specified relative to
  707. the current system date (normally set by the DATE command or  real  time
  708. clock  at  boot  time),  it  is  essential  that  the system date be set
  709. correctly in order for this feature to work properly.
  710.  
  711. Files may be selected which are exactly the  specified  number  of  days
  712. old, or either newer (+) or older (-) than the specified number of days.
  713. The number of days specified may range from 0  to  9999,  syntactically,
  714. but cannot be so large as to predate January 1, 1980, which is when  the
  715. universe was created (according to DOS!).
  716.  
  717. Think of the date specification  process  in  two  steps:  go  back  the
  718. specified number of days and then find the files written before (-), on,
  719. or after (+) that date.
  720.  
  721. For example:
  722.  
  723. /@      select files written today (days=0)
  724. /@1+    select files written during last 2 days
  725. /@7     select files written exactly one week ago
  726. /@+30   select files written during the past month
  727. /@-365  select files written more than a year ago
  728.  
  729. The +/- may be specified either before or after the number of days.
  730.  
  731. Regardless of the default sort type, specifying the /@ switch will cause
  732. the /d switch to be  set  automatically.   If  you  wish  to  specify  a
  733. different sort switch, you must specify it after the /@ switch.  If  the
  734. number of filename columns is not already set to 1,  specifying  the  /@
  735. switch will cause the /2 switch to be set automatically.  If you wish to
  736. specify a different number of filename  columns,  you  must  specify  it
  737. after the /@ switch.
  738.  
  739. 3.3  ARC and ZIP File Processing
  740.  
  741. Syntax: /a or /z or /az or /za [+][:filespec]
  742.  
  743. These switches request special processing for compressed  archive  files
  744. instead of OR in addition to normal file  processing.  These  files  are
  745. created by utility programs such as ARC.EXE and PKZIP.EXE.  Although the
  746. format of ARC and ZIP files differs, the use of the /a and  /z  switches
  747. is the same, and file information is displayed using the same format.
  748.  
  749. The /a switch causes all .ARC, .PKA, and .PAK  files  to  be  processed.
  750. The /z switch causes all .ZIP files to be processed.  Specifying  either
  751. /a/z, /az, or /za will cause BOTH types of files  to  be  processed.  To
  752. simplify the discussion below, only the  /a  switch  is  explained.  The
  753. same information applies to the use of the /z switch,  either  alone  or
  754. when used together with  the  /a  switch.  All  other  program  switches
  755. operate as usual with the exception of those noted below.
  756.  
  757. SD V6.2 User's Guide                                             Page 13
  758.  
  759. In  the  simplest  case  (/a specified),  all  files  in  the  specified
  760. directory  with  extensions  of  .ARC   are   automatically   processed.
  761. Although the .ARC file type is assumed, any  other  file  type  (such as
  762. .PAK or .PKA) may be explicitly specified to select the desired files.
  763.  
  764. Each archive file is opened, the directory entries are read  and  saved,
  765. and the file is closed.  Information for each of the  files  inside  the
  766. selected archive file is then displayed.  This process repeats until all
  767. of the selected archive files have been  processed.  The  archive  files
  768. are processed in the order they are found in the directory and  are  not
  769. sorted.  Entries inside  each  selected  archive  file  are  sorted  and
  770. displayed in the usual way except that some  additional  information  is
  771. displayed if the /1 switch is specified.
  772.  
  773. The information displayed for each file in  an  archive  file  includes:
  774. Filename, Original Length, Storage Method, Packing Percent, Packed Size,
  775. Date, Time, and CRC code.  After the entries in  each  archive file  are
  776. displayed, a totals line is displayed which summarizes this  information
  777. for the archive file as a whole.  After  all  archive  files  have  been
  778. processed, a  grand  totals  line  is  displayed  which  summarizes  the
  779. information for all of the selected archive files.
  780.  
  781. If a primary file specification is used with /a (SD ABC/A), it  is  used
  782. to select a subset of the available  ARC  files.  If  a  secondary  file
  783. specification is used (SD /A:ABC), it is used  to  select  a  subset  of
  784. the available files INSIDE the selected ARC files.  The  /@  switch  may
  785. also be used to select files INSIDE ARC files by the age of the files.
  786.  
  787. If /a+ is specified, normal file processing occurs  first,  followed  by
  788. archive file processing for each of the selected ARC files. This process
  789. can also be applied to all directories on a disk by using the /g switch.
  790. Processing for /a may take considerable  time  if  many  ARC  files  are
  791. present and the disk space is heavily fragmented.  In this case, you may
  792. wish to specify the /q switch and control the console output manually.
  793.  
  794. The /s switches are not applicable to archive file entries since no file
  795. attribute information is maintained inside  ARC  files.  The  /c  switch
  796. is not particularly useful either since it sorts by the file CRC  codes!
  797. Nested ARC files (ARC files inside ARC files) cannot be processed  since
  798. this would require the full extraction  code  for  the  ARC  compression
  799. algorithms to be included in this program, which is not appropriate.
  800.  
  801. The following limitations apply to ZIP file processing:
  802.  
  803. 1) Only the least significant four hexadecimal digits of the file
  804.    CRC codes are displayed, due to space limitations.
  805.  
  806. 2) Embedded path names stored in ZIP files are not displayed, due
  807.    to space limitations.
  808.  
  809. 3) ZIP files which span multiple disks are not supported.
  810.  
  811. SD V6.2 User's Guide                                             Page 14
  812.  
  813. ARC and ZIP files have become a standard means of transferring DOS  disk
  814. files across Computer Bulletin Board systems  since  they  significantly
  815. reduce the transfer time, allow multiple files to  be  combined  into  a
  816. single file, insure the integrity of the files by storing  and  checking
  817. CRC codes, and preserve the original file dates, times and  sizes.  They
  818. are also useful for long term disk storage since they reduce the  number
  819. of floppy disks needed to store data.  It is therefore highly  desirable
  820. to be able to display the directories of these files in an efficient and
  821. flexible manner.  The integration of ARC and ZIP  file  processing  with
  822. normal directory processing in this program  allows  you  to  take  full
  823. advantage of the benefits inherent in compressed archive files.
  824.  
  825. 3.4  Global Subdirectory Processing
  826.  
  827. Syntax: /g or /gn or /gt
  828.  
  829. The  /g  switch  requests  global  subdirectory  processing.  All  other
  830. switches  operate  as  usual.    After  the  specified  target directory
  831. (usually, but not necessarily,  a  root  directory)  is  processed,  all
  832. subdirectories below that directory are processed.  The  directories are
  833. sorted into alphabetic order unless /gn is specified when they  are  not
  834. sorted and are processed in the order they are found on the disk.
  835.  
  836. After all directories have been processed, a grand totals line  for  all
  837. of  the  directories and files is displayed,  followed by a grand totals
  838. line for file attributes (if a /s switch was specified).  Specifying the
  839. /gt switch suppresses the totals lines for  individual  directories  and
  840. only displays the grand totals.
  841.  
  842. If the current directory on the target drive is not the root  directory,
  843. you must explicitly specify it (\), if you wish to process  all  of  the
  844. directories on that drive: SD \/G ...
  845.  
  846. Processing for /g may take considerable time  if  many  directories  are
  847. present and the disk space is heavily fragmented.  In this case, you may
  848. wish to specify the /q switch and control the console output manually.
  849.  
  850. The /g switch has a variety of uses. It can be used to display a summary
  851. of the total number of directories and files on a disk  similar  to  the
  852. CHKDSK command if /gt is specified.  Somewhat more information for  each
  853. individual directory is displayed if /g/t is specified.
  854.  
  855. It can be used to locate any and all occurrences of a file anywhere on a
  856. disk with a complex directory structure by simply specifying a filename.
  857. If no matching files are found, the displayed path name is that  of  the
  858. last directory which was searched for the file.
  859.  
  860. Another interesting use is to specify the /sd switch, which will display
  861. all of the directories on the disk below the specified directory.
  862.  
  863. 3.5  Sort Field Selection Switches
  864.  
  865. Syntax: /sort-switch[+/-]
  866.  
  867. /f  - Sort by (1) File Name and (2) extension
  868. /x  - Sort by (1) file Extension and (2) name
  869. /b  - Sort by file size in Bytes
  870. /d  - Sort by (1) file Date and (2) time
  871. /c  - Sort by file Cluster number or ARC/ZIP CRC
  872. /n  - Do Not sort directory entries
  873.  
  874. SD V6.2 User's Guide                                             Page 15
  875.  
  876. These switches specify which fields are to be used as sort  "keys"  when
  877. formatting  the  output  information.    These switches are all mutually
  878. exclusive; i.e. only one sort switch should be specified.   If  no  sort
  879. switch is specified, the default is by file extension and name (/x).
  880.  
  881. Sort switches may be optionally followed by a + for an ascending sort or
  882. a -  for a descending sort.  The default sort direction is ascending for
  883. all sort switches except /d, which is descending  (so  the  newer  files
  884. appear first). The + and - options are not meaningful for the /n switch.
  885.  
  886. The /f switch simply sorts the selected directory entries by  file  name
  887. and extension.  Any "strange" file names beginning with unusual  special
  888. characters will tend to collect at the beginning and end  of  the  list,
  889. where they can be easily identified.
  890.  
  891. The /x switch is helpful  in  identifying  which,  if  any,  files  have
  892. "strange"  file  name extensions.  Since most standard files have one of
  893. only a few possible types (extensions), such as .BAT, .COM,  .EXE,  etc.
  894. using this switch will separate out any non-standard file names.
  895.  
  896. The /b switch is used to find either the smallest or largest files on  a
  897. disk,  or  to  discover  which  file(s)  have sizes which lie in a given
  898. range.  This can be helpful when it is known that  a  file  of  a  given
  899. size is missing from a disk, and it is desired to find its  identity  by
  900. examining the contents of another disk which does contain the file.
  901.  
  902. The /d switch is a  frequently  used  sorting  option,  especially  when
  903. combined  with  the  /1  or /2 switch.  This allows either the newest or
  904. oldest files on a disk to be easily identified.  Of course, the validity
  905. of  this  information  is once again dependent on the correct setting of
  906. the system date at the time the files were written.  If  the  number  of
  907. filename columns is not already set to 1, specifying the /d switch  will
  908. cause the /2 switch to be set automatically.  If you wish to  specify  a
  909. different number of filename columns, you must specify it after  the  /d
  910. switch.
  911.  
  912. The /c switch sorts the file entries by the first  or  starting  cluster
  913. number allocated to the file.  This is simply the absolute  location  on
  914. the disk where the file  begins.  Although  not  used  very  frequently,
  915. this switch can be used to determine the actual order of the files on  a
  916. disk, which is independent of  their  order  in  the  disk's  directory,
  917. especially on a disk whose space has become "fragmented" by the creation
  918. and deletion of many files  with  differing  sizes.  Regardless  of  the
  919. default value for the number of  filename  columns,  specifying  the  /c
  920. switch will cause the /1 switch to be set automatically.  If you wish to
  921. specify a different number of filename  columns,  you  must  specify  it
  922. after the /c switch.  For ARC or ZIP files, /c causes the  files  to  be
  923. sorted by the file CRC codes which is not very useful.
  924.  
  925. The /n switch bypasses the sort process with the result  that  the  file
  926. entries  are  displayed  in  the order they occur in the disk directory.
  927. This is helpful when examining a bootable disk to insure that the  order
  928. of  files  is  optimal  (in  the  order  they are needed during the boot
  929. sequence, and by frequency of use  after  boot-up).  This  is  the  same
  930. order of file names as that displayed by the DIR command.
  931.  
  932. SD V6.2 User's Guide                                             Page 16
  933.  
  934. 4.0  OUTPUT FORMAT CONTROL
  935.  
  936. 4.1  Output Mode Switches
  937.  
  938. Syntax: /output-switch ... /output-switch
  939.  
  940. /?  - Display program Help information
  941. /i  - Display system Information summary
  942. /j  - Just display configured screen colors
  943. /l  - List file names and (p)ath names only
  944. /m  - Display graphical directory tree Map
  945. /r* - Redirect output to device or file using * char
  946. /t  - Display Totals output lines only (n)o totals
  947.  
  948. The /? switch requests that a help screen be displayed which  summarizes
  949. the command line syntax used to invoke the program and switch  meanings.
  950. The /? switch output may be redirected to a file as follows: SD /? >FILE
  951.  
  952. The /i switch requests that a screen be displayed which  summarizes  the
  953. system hardware configuration and memory and disk  characteristics.  See
  954. the section titled System Information Summary for details.
  955.  
  956. The /j switch requests that a summary of the  configured  screen  colors
  957. be displayed.  This switch is useful when you can't  remember  what  the
  958. color values are for a specific type of file attribute or screen area.
  959.  
  960. The /l switch requests that a list of  file names (only)  be  generated.
  961. All other output (file information  and  totals  lines)  is  suppressed.
  962. This switch is normally used  with  the  /sf  switch  (to  suppress  any
  963. directories),  and  the  /r  switch to redirect the output to a file for
  964. processing by another program.  The filename column switches are ignored
  965. (/1 is assumed) if they are specified with  the  /l  switch.  Since  any
  966. embedded spaces are removed, the file names are ready to be operated  on
  967. by  copy  commands  which  might  be  generated automatically by another
  968. program.  Specifying the /lp (path name) option causes the file names to
  969. be prefixed with their path names.  This  can  be  useful  when  another
  970. program is to subsequently process  the  file  name  list  from  another
  971. directory.  /l is mutually exclusive with the /t and /gt switches.
  972.  
  973. The /m switch requests that a graphical directory tree map be  displayed
  974. for the specified drive and directory.  Processing for /m is similar  to
  975. that requested by the /g, /t, and /sd switches.  A subdirectory  of  the
  976. root directory may be specified to limit the directories  selected.  The
  977. directories are always sorted and links to higher level  directories are
  978. shown using graphics characters.  Processing may take  a while  if  many
  979. directories are selected.
  980.  
  981. The /r  switch  requests  that  console  output  be  written  using  DOS
  982. services, rather than directly to video display memory for higher speed.
  983. Although this slows down the output and suppresses  the  screen  colors,
  984. this is necessary when the need arises to redirect the output to a  file
  985. or a device (printer) for subsequent processing.  /r is also used to run
  986. the program in a window with a multitasking environment (see below).
  987.  
  988. If /r is specified, it should be the first parameter on the command line
  989. after the command name, so that any error messages which  are  generated
  990. for subsequent parameters can be redirected.  Although the program  will
  991. usually be able to automatically detect the fact that  output  is  being
  992. redirected, you can always force  redirection  to  occur  by  explicitly
  993. specifying the /r switch (with the /q switch).
  994.  
  995. SD V6.2 User's Guide                                             Page 17
  996.  
  997. If the character immediately following the /r switch is something  other
  998. than a slash (/) or carriage return character, it is substituted for all
  999. of the graphics characters which are normally generated by the  program.
  1000. This feature can be handy when sending  output  to  a  device  which  is
  1001. incapable of interpreting graphics characters  correctly.  Some  typical
  1002. characters which might be used include a space, asterisk, or equal sign.
  1003.  
  1004. You may wish to place the output file on a different drive or  directory
  1005. than the one being processed or the output file may be included  in  the
  1006. directory list as a zero byte file.  For example: SD A: >C:\TEMP.DIR
  1007.  
  1008. The /t  switch  suppresses  the  display  of  detailed  information  for
  1009. individual  files  and  directories  and only  displays  the  directory,
  1010. file attribute (see the /s switch) and disk space totals lines.
  1011.  
  1012. The directory totals line includes the target directory path  (if the /v
  1013. switch isn't specified), the number of  subdirectories,  the  number  of
  1014. files selected, the total number of bytes and clusters in  the  selected
  1015. files, and the percent of space used in the clusters  allocated  to  the
  1016. selected  files.  This  last  value   provides   an  indication  of  how
  1017. efficiently disk space is being utilized  for  the  selected  files  and
  1018. depends on the number of files selected, the file  sizes  and  the  disk
  1019. cluster size.  If a long path name is selected, it  is  displayed  on  a
  1020. separate output line to prevent truncation  of  the  other  information.
  1021. The disk space totals line includes the space used, percent used,  space
  1022. free, total space on the disk, and the current date and time.
  1023.  
  1024. The /t switch is used  when you wish to compare the total number or size
  1025. of  files  on  two  different  disks or directories.  If a difference is
  1026. detected, other switches (such as /b or /d) can  be  used  to  determine
  1027. which files are missing (or different).
  1028.  
  1029. The /tn switch requests that the disk and directory  totals  information
  1030. be suppressed, and only the individual directory entries  be  displayed.
  1031. This option can be useful when it is desired to create  an  output  file
  1032. which will subsequently be  compared  to  another  file  to  detect  any
  1033. differences between several files, directories, or even entire disks.
  1034.  
  1035. 4.2  Output Toggle Switches
  1036.  
  1037. Syntax: /output-switch ... /output-switch
  1038.  
  1039. /e  - Erase the screen before displaying output
  1040. /h  - Display output using Horizontal sequence
  1041. /k  - Display memory and disk space in Kilobytes
  1042. /o  - Switch between long and short date and time formats
  1043. /p  - Measure CPU performance for /i switch
  1044. /q  - Quick output (no prompts when the screen fills)
  1045. /u  - Switch between Upper and Lower case filenames
  1046. /v  - Display disk Volume label and path at start
  1047. /w  - Reset the screen to 25 lines at exit
  1048. /y  - Restore the original screen at exit
  1049.  
  1050. SD V6.2 User's Guide                                             Page 18
  1051.  
  1052. These output switches are all "toggles".  This means that specifying the
  1053. switch on the command line toggles the  switch  value  to  the  opposite
  1054. state of the default value (either ON or OFF).  For example,  the  value
  1055. of the /k switch is normally OFF.  Specifying /k  on  the  command  line
  1056. will cause space values to be shown in  Kilobytes,  rather  than  Bytes.
  1057. However, if /k is configured to be ON as a default, specifying it on the
  1058. command line will cause space values to be shown in  Bytes  rather  than
  1059. Kilobytes.  These switches may be used together and with other  switches
  1060. in many different combinations.
  1061.  
  1062. The /e switch causes the display screen to be cleared before any  output
  1063. is displayed.  The screen is cleared using the current number of  screen
  1064. lines (rows), which may be different from the standard 25  lines  if  an
  1065. EGA or VGA adaptor and monitor are being used.
  1066.  
  1067. The /h switch causes the file  entries to  be  displayed  in  horizontal
  1068. rather than vertical sequence according to the  sort  option  specified.
  1069. This is handy when more than a screen's worth of output is generated, so
  1070. that the sequence of file entries is continuous when the screen scrolls.
  1071.  
  1072. The /k switch requests that system memory and disk space information  be
  1073. displayed  in  units  of Kilobytes (1024 bytes), rather than the default
  1074. units of bytes.  In addition, these values are  rounded  upward,  taking
  1075. into  account the allocation unit (cluster) size for the specified disk.
  1076. System memory values are simply rounded to the next higher Kilobyte. Use
  1077. of  the  /k  switch  will reveal the actual amount of disk space used by
  1078. each file, rather than the normal file size  which  may  be  much  less.
  1079. Depending on the file size and the number of output  columns  specified,
  1080. the file size value may be displayed in Kilobytes, even if the /k switch
  1081. isn't specified, due to space limitations.
  1082.  
  1083. The /o switch requests that an alternate format be used when  displaying
  1084. system and file date and time values.  Two formats are  supported,  long
  1085. and short.  For example, for the long format values: 21-May-89 18:32:10,
  1086. the equivalent short format would be 05-21-89 06:32p.  The advantage  of
  1087. using the long format is that the month is more readable and  times  are
  1088. displayed in seconds for better accuracy.  The advantage  of  the  short
  1089. format is that dates are easier to compare when using the /d switch, and
  1090. the format is similar to the standard DOS date and time format.
  1091.  
  1092. The /p switch requests that the system CPU performance be  measured  and
  1093. displayed when the /i switch is also specified.  Since this process  can
  1094. take up to about 10 seconds on an 8088 system, the default  is  OFF.  If
  1095. you are using a fast system, you may prefer to configure the  value  ON.
  1096. See the section titled System Information Summary for details.
  1097.  
  1098. The /q switch suppresses the console reads  which  normally  occur  when
  1099. output information is about to scroll off the screen.  You may  wish  to
  1100. specify this switch when a large amount of  output  is  being  generated
  1101. (/g or /a used without /t) or when specifying the /r switch.
  1102.  
  1103. The /u switch requests that an alternate format be used when  displaying
  1104. individual path and file names.  Two formats are  supported,  upper  and
  1105. lower case.  The lower case format is usually more  readable,  but  this
  1106. depends on the video monitor and number of screen lines being used.
  1107.  
  1108. SD V6.2 User's Guide                                             Page 19
  1109.  
  1110. The /v switch causes the disk volume label  (if  any),  and  the  target
  1111. path name to be displayed before the information for  individual  files.
  1112. In this case, the path name is not displayed on the first  totals  line,
  1113. which is the normal default.  You may wish to avoid  using  this  switch
  1114. when you are working with long  path  names, to  prevent  truncation  of
  1115. information on the output line.
  1116.  
  1117. The /w switch requests that the number of screen lines be  reset  to  25
  1118. when the program is about to exit in a video  mode  with  more  than  25
  1119. screen lines when an EGA or VGA adaptor is  in  use.  A  necessary  side
  1120. effect of this is that the program must wait for the user to press a key
  1121. just prior to exiting and the screen  is  cleared.  If  this  switch  is
  1122. configured ON, you will have to specify /w/y when you wish to use the /y
  1123. switch.  See the section titled EGA  and  VGA  Switches  for  additional
  1124. information.
  1125.  
  1126. The /y switch requests that the program save the contents of the  screen
  1127. (including the cursor location and size) on entry,  and  that  these  be
  1128. restored when the program terminates.  This requires  that  the  program
  1129. wait for the user to press a key just prior  to  exiting,  so  that  the
  1130. final screen output is not prematurely lost.  Screen sizes of up  to  80
  1131. columns by 50 lines for EGA and VGA adaptors are supported.  /y  may  be
  1132. ignored  if  used  together  with  either  the /w, /25, /35, /43, or /50
  1133. switch since the restored screen size could be incorrect after the video
  1134. mode change requested by these other switches.
  1135.  
  1136. It is also possible that /y will be ignored if used  together  with  the
  1137. /g switch when processing a large number of directories.  The  directory
  1138. buffer size is 2000 bytes  which  allows  up  to  about 125 16 character
  1139. directory names to be processed.  If  the  directory  buffer  fills,  it
  1140. automatically expands into the screen save buffer  (an  additional  8000
  1141. bytes), which allows up to a total of about 625 16  character  directory
  1142. names to be processed.
  1143.  
  1144. 4.3  Filename Column Switches
  1145.  
  1146. The /1, /2, /4, and /6 switches specify the number  of  filename  output
  1147. columns and, inversely, the amount of file information displayed:
  1148.  
  1149. /1 - 1 column  - File name, size,  clusters allocated,  % of space used,
  1150.                  date, time, starting cluster and sector, and attributes
  1151.  
  1152. /2 - 2 columns - File name, size, date and time
  1153.  
  1154. /4 - 4 columns - File name and size
  1155.  
  1156. /6 - 6 columns - File name only
  1157.  
  1158. A larger number of columns allows more files  to  be  displayed  on  the
  1159. display  screen  at one time, at the cost of losing some of the detailed
  1160. file information.  A smaller number of columns allows more detailed file
  1161. information to be displayed, at the cost of only being able to display a
  1162. limited number of files.  All of these switches are mutually  exclusive;
  1163. only one should be specified.  The default switch is /2.
  1164.  
  1165. SD V6.2 User's Guide                                             Page 20
  1166.  
  1167. Subdirectory entries  (normally found in the root directory)  are  shown
  1168. with special screen colors, for emphasis.   This is  especially  helpful
  1169. when using the /6 switch, since there isn't room for the <Dir> indicator
  1170. (directory names may be up to 11 characters long, just like file names).
  1171. File name colors indicate the most significant attribute of the file  in
  1172. the order: System, Hidden, Read-Only, Archive, and Normal.
  1173.  
  1174. The file size is normally displayed in bytes, or  Kilobytes  if  the  /k
  1175. switch is specified.  If /2 is specified, file sizes larger than 999,999
  1176. bytes are displayed in Kilobytes and  if  /4  is  specified  file  sizes
  1177. larger than 99,999 bytes  are  displayed  in  Kilobytes,  due  to  space
  1178. limitations.  If /1 is specified,  the  number  of  clusters  which  are
  1179. allocated to the file and the percent of space actually  used  are  also
  1180. displayed.
  1181.  
  1182. The date and time the file was last modified  are  displayed  in  either
  1183. long or short format, depending on the /o switch value.  The time a file
  1184. was last written is only accurate to a resolution of  two  seconds;  all
  1185. values will have an even number of seconds.  Files  created  with  early
  1186. versions of DOS may not have either a date or time stamp.  In this case,
  1187. the date and time fields will appear as periods.
  1188.  
  1189. If /1 is specified, the starting cluster  number  and  starting  logical
  1190. sector number for the file are displayed, as are the file attributes:
  1191.  
  1192. A - Archive     R - Read/Only   H - Hidden      S - System
  1193.  
  1194. 4.4  EGA and VGA Switches
  1195.  
  1196. /25 - Display 25 lines on EGA or VGA monitor
  1197. /35 - Display 35 lines on EGA or VGA monitor
  1198. /43 - Display 43 lines on EGA or VGA monitor
  1199. /50 - Display 50 lines on EGA or VGA monitor
  1200.  
  1201. These switches change to the specified number  of  screen  lines  (rows)
  1202. when an Enhanced Graphics Adaptor (EGA) or Video  Graphics  Array  (VGA)
  1203. video adaptor and monitor  are  in  use.  The  screen  is  automatically
  1204. cleared and the screen  remains  set  to  this  size  when  the  program
  1205. terminates (unless /w is specified  when  it  is  reset  to  25  lines).
  1206. If the number of screen lines has already been set to  a  value  greater
  1207. than 25, the program will  automatically  use  the  current  value.  The
  1208. use of a monochrome monitor connected to an EGA card  is  not  supported
  1209. by these switches.
  1210.  
  1211. For an EGA, the native modes are 25 and 43 lines.  The 35  and  50  line
  1212. modes are synthesized by dynamically creating  new  EGA  fonts.  The  35
  1213. line mode is more readable than the 43 line mode.  The 50 line  mode  is
  1214. rather difficult to read since it is formed by dropping  the  last  scan
  1215. line of each character which causes the partial loss of  the  descenders
  1216. of some lower case letters.
  1217.  
  1218. For a VGA, the native modes are 25, 43, and 50 lines.  The 35 line  mode
  1219. is synthesized as for the EGA.  The 50 line mode is readable, since  the
  1220. VGA can use 400 vertical scan lines, rather than the 350 of the EGA.
  1221.  
  1222. SD V6.2 User's Guide                                             Page 21
  1223.  
  1224. Since versions of DOS prior to 4.0 neither properly recognize nor  fully
  1225. support all of the operational modes  possible  with  the  EGA/VGA  BIOS
  1226. (43 line mode, for example), you may  experience  strange  results  when
  1227. using these modes at the DOS command  prompt.  In  particular,  ANSI.SYS
  1228. does not recognize 43 line mode and may cause the DOS command prompt  to
  1229. appear on screen line 25, overlaying data  previously  displayed  there.
  1230. If you normally use ANSI.SYS (or other equivalent  ANSI  console  device
  1231. drivers) with an EGA/VGA monitor, you  may  wish  to  configure  the  /w
  1232. switch ON which handles this problem.  Turning the option ON will  cause
  1233. SD to wait for a character to be typed when it is about to  exit  in  an
  1234. EGA/VGA video mode with more than 25 screen lines.  After a character is
  1235. typed, the standard 25 line video mode is reset, the screen  is  cleared
  1236. and the program terminates.
  1237.  
  1238. If you are using DOS 4.0 with ANSI.SYS, you MUST specify the new /L ANSI
  1239. command line switch if you plan to use more than 25  screen  lines.  You
  1240. may also change the number of screen lines using the MODE command:
  1241.  
  1242. DEVICE=ANSI.SYS /L              (In CONFIG.SYS)
  1243. MODE CON LINES=25 or 43 or 50   (In AUTOEXEC.BAT or at DOS prompt)
  1244.  
  1245. The standard IBM video modes are those  from  0 to 19.  If  the  current
  1246. video mode at the time SD is executed is in this range and  not equal to
  1247. 2 (25 x 80 B/W) or 3 (25 x 80 Color) when a color monitor is in use, the
  1248. program will automatically reset the video mode to 3 before running. The
  1249. other standard IBM 40 column text  modes  and  graphics  modes  are  not
  1250. supported, but it is rare to encounter these modes other than  in  BASIC
  1251. programs.  SD will operate if the current video mode is greater than 19,
  1252. for compatibility with high resolution video  modes  supported  by  many
  1253. non-IBM EGA and VGA video cards.  SD dynamically detects both the number
  1254. of screen rows and columns and uses these values when writing  to  video
  1255. display memory.  Screen sizes up to at least 50 rows by 132 columns  are
  1256. fully supported.  However, the 8000 byte  screen  save  buffer  is  only
  1257. large enough to fully save and restore screens of 50 x 80 or 30 x 132.
  1258.  
  1259. SD V6.2 User's Guide                                             Page 22
  1260.  
  1261. 5.0  SYSTEM INFORMATION SUMMARY
  1262.  
  1263. The /i switch requests that a screen be displayed which  summarizes  the
  1264. system hardware configuration  and  memory  and  disk  information.  The
  1265. information is presented in six boxes.  The upper  left  box  summarizes
  1266. the system hardware configuration.  The upper  middle  and  right  boxes
  1267. summarize DOS and system  memory  information.  The  lower  three  boxes
  1268. summarize the  technical  information  for  the  specified  disk.  Other
  1269. switches which can be used with the /i switch include /e, /k, /o and /p.
  1270. For example, to compare two sets of drive parameters using an EGA/VGA:
  1271.  
  1272. D>sd c:/i/50 - display info for drive C using 50 lines
  1273. D>sd d:/i/e  - display info for drive D without clearing screen
  1274.  
  1275. Output generated by the /i switch may be redirected as follows:
  1276.  
  1277. D>sd c:/i >file
  1278.  
  1279. 5.1  System Hardware
  1280.  
  1281. PC System Type - The PC System Type Code,  followed by the Submodel Type
  1282. and BIOS Level for PS/2 systems.  Typical system codes are as follows:
  1283.  
  1284. Code    System Types
  1285. ----    ------------
  1286.  FF     IBM PC
  1287.  FE     IBM PC-XT, IBM PC-PORTABLE
  1288.  FD     IBM PC-Jr
  1289.  FC     IBM PC-AT, IBM PC-XT/286, IBM PS/2-50,60
  1290.  FB     IBM PC-XT/2
  1291.  FA     IBM PS/2-30
  1292.  F9     IBM PC-CONVERTIBLE
  1293.  F8     IBM PS/2-70,80
  1294.  
  1295. ROM BIOS Date - The date contained in the ROM BIOS chip  which  provides
  1296. an indication of when the system was manufactured.
  1297.  
  1298. Processor Type and Performance - The type of CPU chip in the system  and
  1299. its computing performance relative to the original IBM PC.  Possible CPU
  1300. types are 8088, 80286, or 80386.  The /p switch  must  be  specified  or
  1301. configured ON or the performance value will be reported as  N/A.  Memory
  1302. Resident (TSR) programs that intercept the timer interrupt may make  the
  1303. computed CPU performance value appear artificially low.  You may wish to
  1304. temporarily rename the CONFIG.SYS and  AUTOEXEC.BAT  files,  reboot  the
  1305. system and execute  the  command:  SD/I/P  to  determine  the  true  CPU
  1306. performance.  Processing time for /p ranges  from  10  seconds  on  8088
  1307. systems to less than 1 second on 80386 systems.  You may wish to run the
  1308. test several times, since the value may fluctuate slightly.
  1309.  
  1310. SD V6.2 User's Guide                                             Page 23
  1311.  
  1312. Typical CPU performance values are as follows:
  1313.  
  1314. System          CPU     MHz   Waits   Perf
  1315. ------          ---     ---   -----   ----
  1316. INTEL          80386    25      0    18.18
  1317. COMPAQ 386     80386    20      0    15.15
  1318. IBM PS/2-70    80386    20      1    14.08
  1319. IBM PS/2-80    80386    16      0    11.36
  1320. AT-CLONE       80286    12      1     8.69
  1321. IBM PS/2-60    80286    10      1     6.99
  1322. AT-CLONE       80286    8       0     5.88
  1323. IBM PC-AT      80286    8       1     5.52
  1324. AT-CLONE       80286    6       0     4.23
  1325. IBM PC-AT      80286    6       1     4.14
  1326. IBM PC-XT      8088     4.77    -     1.00
  1327.  
  1328. Screen Size - The number of rows (normally 25) and columns (normally 80)
  1329. used on the screen by the current video mode.
  1330.  
  1331. Video Adaptor and Mode - The type of Video  Display  Adaptor  (MDA, CGA,
  1332. MCGA, EGA or VGA) currently being used and the Video Mode Number.
  1333.  
  1334. Drives (F/H/L) - The number of  (F)loppy and (H)ard drives in the system
  1335. and the DOS (L)ASTDRIVE value which may be specified in CONFIG.SYS.
  1336.  
  1337. Ports (S/P/G) - The number of  (S)erial, (P)arallel, and (G)ame ports in
  1338. the system.  Serial ports are often used for a modem or mouse,  parallel
  1339. ports are often used for printers and game ports are used for joysticks.
  1340.  
  1341. ANSI/CP/Mouse - ANSI indicates whether or not  an  ANSI  Console  Device
  1342. Driver  is  installed  in  the  system  (via CONFIG.SYS).  CP  indicates
  1343. whether or not an 80x87  math  Coprocessor  chip  is  installed  in  the
  1344. system.  Mouse   Type   indicates  whether  or  not  a  Microsoft  Mouse
  1345. compatible software device driver is installed in the system.
  1346.  
  1347. 5.2  System Memory
  1348.  
  1349. DOS Version - The version of PC-DOS or MS-DOS installed in the system.
  1350.  
  1351. Environment - The amount of memory  currently  being  used  by  the  DOS
  1352. Environment allocated to the program.  The DOS SET command  is  used  to
  1353. add or delete Environment variables.
  1354.  
  1355. Video Memory - The amount of video memory installed in the  system.  MDA
  1356. adaptors use 4Kb, CGA adaptors use 16Kb, and EGA/VGA  adaptors  normally
  1357. use up to 256Kb (some EGA or VGA adaptors may actually use up to 512Kb).
  1358.  
  1359. DOS Memory - The amount of memory  used  by  the  following  DOS  system
  1360. components: Interrupt Vectors in low memory, the Disk BIOS (IBMBIO.COM),
  1361. the  DOS kernel  (IBMDOS.COM),  FILES,  BUFFERS,  and any Device Drivers
  1362. specified in CONFIG.SYS, and any memory they allocate.
  1363.  
  1364. TSR Memory - The amount of  memory  used  by  the  resident  portion  of
  1365. COMMAND.COM (at a minimum) and  memory  allocated  to  any  subsequently
  1366. loaded  Terminate-and-Stay-Resident  type  programs  (such as  SDR.COM).
  1367. It also includes any currently free memory blocks which do not reside in
  1368. high memory (those previously released by TSR programs).
  1369.  
  1370. SD V6.2 User's Guide                                             Page 24
  1371.  
  1372. The DOS and TSR memory values can be very useful in  analyzing  how  the
  1373. memory currently being used is allocated and in finding overallocations.
  1374.  
  1375. Memory Used - The amount of system memory currently in use.
  1376.  
  1377. Memory Free - The amount of system memory currently not in use.
  1378.  
  1379. Total Memory - The total amount of system memory (below 640Kb).
  1380.  
  1381. EMS Version - The version of the Lotus-Intel-Microsoft  Expanded  Memory
  1382. Manager installed in the system, if any.  EMS allows any  PC  system  to
  1383. share paged memory on an EMS memory card between applications.  A device
  1384. driver must be installed in CONFIG.SYS to use this memory.
  1385.  
  1386. Memory Used - The amount of EMS memory currently in use.
  1387.  
  1388. Memory Free - The amount of EMS memory currently not in use.
  1389.  
  1390. Total Memory - The total amount of EMS memory in the system.
  1391.  
  1392. XMS Version - The version of the Lotus-Intel-Microsoft  Extended  Memory
  1393. Manager installed in the system, if any.  XMS allows an 80286  or  80386
  1394. system to share Extended  memory  (above 1Mb)  between  applications.  A
  1395. device driver must be installed in CONFIG.SYS to use this memory.
  1396.  
  1397. Memory Used - The amount of Extended memory currently in use.
  1398.  
  1399. Memory Free - The amount of Extended memory currently not in use.
  1400.  
  1401. Total Memory - The total amount of Extended memory in the system.
  1402.  
  1403. 5.3  Disk Parameters
  1404.  
  1405. Disk Drive - The name of the target disk drive from A: to Z:.  The drive
  1406. letter will be followed by one of  the  following  descriptors,  if  the
  1407. drive type can be determined:
  1408.  
  1409. NET     - Logical Network Drive
  1410. BIG     - Hard Disk Partition GT 32Mb
  1411. HARD    - Hard Disk Partition LE 32Mb
  1412. 5.25"   - 5.25" Floppy Drive
  1413. 3.5"    - 3.5"  Floppy Drive
  1414.  
  1415. OEM Boot Information - The name of the Original  Equipment  Manufacturer
  1416. (OEM) and the version of DOS used to format the disk.
  1417.  
  1418. Hidden Sectors - The number of sectors on a hard disk hidden from use by
  1419. DOS when processing the current disk partition.  This area on  the  disk
  1420. may either contain partition table information, or the data  in  another
  1421. partition, depending on the partitioning scheme used.
  1422.  
  1423. Reserved Sectors - The number of sectors reserved at  the  beginning  of
  1424. the disk for the boot sector, partition tables, etc.
  1425.  
  1426. FATs/EntrySize - The number of File  Allocation  Tables  (FATs) and  the
  1427. number of Bits Per File Allocation Table Entry for the disk.  This value
  1428. is 12 for disks formatted prior to DOS 3.0 and either 12 or 16 for disks
  1429. formatted with DOS 3.0 or later.  DOS uses 16 bit FAT entries if a  disk
  1430. has 4086 or more data clusters.
  1431.  
  1432. SD V6.2 User's Guide                                             Page 25
  1433.  
  1434. Sectors Per FAT - The number of Sectors Per File Allocation Table.
  1435.  
  1436. Directory Sector - The logical sector number of the Root  Directory  for
  1437. the disk (or hard disk partition).
  1438.  
  1439. Data Sector - The logical sector number of the Data (File) Area  on  the
  1440. disk (or hard disk partition).
  1441.  
  1442. Root Directory Size - The maximum number of entries in the  disk's  Root
  1443. Directory.
  1444.  
  1445. Total Sectors - The total number of sectors on the disk,  including  the
  1446. Boot sector(s), FAT sectors, Root Directory sectors, and Data sectors.
  1447.  
  1448. Sectors Per Track - The number of Sectors Per Track on the disk.
  1449.  
  1450. Heads (Sides) - The number of Heads (Sides or Surfaces) for  a  hard  or
  1451. floppy disk.  Some RAMDISKs may have too many heads for their own good!
  1452.  
  1453. Cylinders - The number of Tracks Per Side (Head or Surface) for a floppy
  1454. disk or a hard disk partition.  This value may be slightly smaller  than
  1455. the number of physical cylinders for a hard disk partition, due  to  the
  1456. use of some cylinders for partition information,  bad sector tables,  or
  1457. diagnostic purposes.  For a hard disk, the total number of  cylinders on
  1458. the drive is also displayed, but only for the first drive and partition.
  1459.  
  1460. Media Byte - The Media Descriptor Byte is used to describe the size  and
  1461. format of the disk media and is based on the following disk  parameters:
  1462. Sectors per Track,  Heads  (Sides),  and  Cylinders  (Tracks Per  Side).
  1463. Although the Media Byte is used  by  the  BIOS  to  determine  the  disk
  1464. characteristics  in  certain  cases, not all  DOS  BIOS  implementations
  1465. use exactly the same Media Bytes for the same disk types.  An example is
  1466. the 5.25" 1.2Mb and 3.5" 720Kb disk types which both use media byte F9.
  1467.  
  1468. Bytes Per Sector - The number of Bytes Per Sector on the disk.
  1469.  
  1470. Sectors Per Cluster - The number of Sectors Per Cluster on the disk.
  1471.  
  1472. Bytes Per Cluster - The number of Bytes Per Cluster on the disk.
  1473.  
  1474. Volume Serial Number - The Volume Serial Number for  the  disk.  DOS 4.0
  1475. places an 8 digit hexadecimal Volume Serial Number in the Boot Sector of
  1476. each disk when it is formatted.  This value  can  be  used  to  uniquely
  1477. identify a disk since it is different for each disk  (unlike disk Volume
  1478. Labels which may be the same).  The VSN.COM utility provided can be used
  1479. to create, change and delete Volume Serial Numbers on  disks  which  are
  1480. either formatted or used with any version of DOS.  See  the  section  on
  1481. VSN for additional information.
  1482.  
  1483. Volume Label - The Volume Label for the disk.  Volume Labels are created
  1484. either when the disk is formatted or when the LABEL command is used.
  1485.  
  1486. Create Date - The date when the Volume Label was created.
  1487.  
  1488. Create Time - The time when the Volume Label was created.
  1489.  
  1490. Used Clusters - The number of Clusters in use on the disk.
  1491.  
  1492. Free Clusters - The number of Clusters not in use on the disk.
  1493.  
  1494. SD V6.2 User's Guide                                             Page 26
  1495.  
  1496. Total Clusters - The total number of Clusters  available  on  the  disk.
  1497. This does not include the space used by  the Boot Sector,  the FATs,  or
  1498. the Root Directory.
  1499.  
  1500. Used Space - The number of Bytes used and the Percent of space  used  on
  1501. the disk.
  1502.  
  1503. Free Space - The number of Bytes free and the Percent of space  free  on
  1504. the disk.
  1505.  
  1506. Total Space - The total number of Bytes  available  on  the  disk.  This
  1507. does not include the space used by  the Boot Sector,  the FATs,  or  the
  1508. Root Directory.
  1509.  
  1510. Some of the disk information is obtained by reading  the  Boot Sector of
  1511. the disk.  If either an error occurs when  reading  the  Boot Sector, or
  1512. invalid data is detected, this information will appear as NONE or zeros.
  1513. The values affected are the OEM Boot Information through  Cylinders  and
  1514. the Volume Serial Number value.
  1515.  
  1516. Standard DOS disk formats and their characteristics are shown below:
  1517.  
  1518. Disk Type          Size   SPT   Heads   Cyls   Media    BPC   FAT
  1519. ---------          ----   ---   -----   ----   -----    ---   ---
  1520. 5.25" SS  48 TPI   160K    8      1      40      FE     512   12
  1521. 5.25" SS  48 TPI   180K    9      1      40      FC     512   12
  1522. 5.25" DS  48 TPI   320K    8      2      40      FF    1024   12
  1523. 5.25" DS  48 TPI   360K    9      2      40      FD    1024   12
  1524. 5.25" DS  96 TPI   1.2M   15      2      80      F9     512   12
  1525.  
  1526. 3.5"  DS 135 TPI   720K    9      2      80      F9    1024   12
  1527. 3.5"  DS 135 TPI   1.4M   18      2      80      F0     512   12
  1528.  
  1529. PC-XT Hard Disk     10M   17      4     305      F8    4096   12
  1530. PC-AT Hard Disk     20M   17      4     611      F8    2048   16
  1531. PC-AT Hard Disk     30M   17      5     731      F8    2048   16
  1532.  
  1533. 5.4  VSN Utility Program
  1534.  
  1535. VSN.COM is utility program which is  used  to  manage  DOS  Disk  Volume
  1536. Serial Numbers.  It operates on IBM-PC compatible computer systems using
  1537. the IBM PC-DOS or Microsoft  MS-DOS  Operating  System  Version  2.0  or
  1538. higher.
  1539.  
  1540. Disk Volume Serial Numbers were introduced with DOS 4.0.  When a disk is
  1541. formatted by FORMAT or copied with  DISKCOPY,  an  8  digit  hexadecimal
  1542. Volume Serial Number is automatically placed in the Boot Sector  of  the
  1543. disk.  Subsequent execution of the  DOS  CHKDSK, DIR, LABEL, TREE or VOL
  1544. command will cause the Volume Serial Number to  be  displayed.  However,
  1545. no mechanism is provided for the user to create a specified VSN,  change
  1546. an existing VSN, or to delete  an  existing  VSN.  The  VSN.COM  utility
  1547. provides these functions.
  1548.  
  1549. Perhaps even more useful is its ability to perform these  functions  for
  1550. disks formatted under ANY version of DOS from 2.0 through  4.0,  and  it
  1551. can be executed under ANY version of DOS  from  2.0  through  4.0.  This
  1552. greatly enhances the possible benefits of using Volume Serial Numbers.
  1553.  
  1554. SD V6.2 User's Guide                                             Page 27
  1555.  
  1556. The main reason for using Volume Serial Numbers is to establish a unique
  1557. means of identifying a removable (floppy) disk.  Floppy disks  may  have
  1558. identical Volume Labels or even identical  Directories,  but  may  still
  1559. contain different data.  Since DOS 4.0 forces the user to accept the VSN
  1560. it selects for a disk and the method is based on the  current  date  and
  1561. time, each VSN will be unique.
  1562.  
  1563. However, this means that the assigned VSN's follow  no  logical  pattern
  1564. and are difficult to relate to one another.  The VSN utility retains the
  1565. benefits of the concept, but allows the user to  establish  a  numbering
  1566. scheme which can be used to form a disk cataloging sequence which  makes
  1567. sense, and is compatible with the format used by DOS 4.0.  An option  is
  1568. also provided to allow a VSN to be assigned using the  DOS  4.0  method,
  1569. for full compatibility with disks formatted under DOS 4.0.
  1570.  
  1571. The DOS command line syntax for the VSN program is as follows:
  1572.  
  1573. VSN [drive:] [xxxx-xxxx] [/d] [/u]
  1574.  
  1575. where all parameters are optional.  If no parameters are specified, help
  1576. information is displayed.  If a drive letter is specified,  the  current
  1577. Volume Serial Number is displayed, or the user  is  informed  that  none
  1578. exists.  If an 8 hexadecimal digit value is specified, the VSN  for  the
  1579. specified disk is changed  to  the  specified  value.  If  no  drive  is
  1580. specified, the current drive is used.  VSN's are  always  specified  and
  1581. displayed as 4 hex digits (0-9 or A-F), followed by a dash (-), followed
  1582. by 4 hex digits.
  1583.  
  1584. The /d switch causes the current  VSN  for  the  specified  disk  to  be
  1585. deleted, if one exists.
  1586.  
  1587. The /u switch causes a unique VSN to be created for the  specified  disk
  1588. using the DOS 4.0 method.  This method uses the current  date  and  time
  1589. obtained from DOS to generate the VSN.
  1590.  
  1591. The Most Significant Word of the VSN is the sum of the current Month and
  1592. Month Day with the current Seconds and Seconds/100.
  1593.  
  1594. The Least Significant Word of the VSN is the sum  of  the  current  Year
  1595. with the current Hours and Minutes.
  1596.  
  1597. SD V6.2 User's Guide                                             Page 28
  1598.  
  1599. Status Messages
  1600.  
  1601. Drive D: Has No Disk Volume Serial Number
  1602. Drive D: Old Disk Volume Serial Number is: XXXX-XXXX
  1603. Drive D: New Disk Volume Serial Number is: XXXX-XXXX
  1604. Drive D: Volume Serial Number Deleted
  1605.  
  1606. Error Messages
  1607.  
  1608. Unable to Read Disk Boot Sector - an error occurred when trying to  read
  1609. the boot sector of the specified disk.  VSN will not  create  VSN's  for
  1610. hard disk partitions whose size exceeds 32Mb.
  1611.  
  1612. Unable to Locate System Boot Code - there was no jump instruction at the
  1613. start of the boot sector of the specified disk.
  1614.  
  1615. Insufficient Room for Volume Serial Number - the  data  area  after  the
  1616. jump instruction in the boot sector was too small to contain the VSN.
  1617. Unable to Write Disk Boot Sector - an  error  occurred  when  trying  to
  1618. write the boot sector of the specified disk.
  1619.  
  1620. Examples of Use
  1621.  
  1622. D>vsn              - display help information
  1623.  
  1624. D>vsn c:           - display the VSN (if any) for the disk in drive C
  1625.  
  1626. D>vsn a: 1989-0001 - create or change the VSN for the disk in drive A
  1627.  
  1628. D>vsn b: /d        - delete the VSN for the disk in drive B
  1629.  
  1630. D>vsn a: /u        - create a unique VSN for the disk in drive A
  1631.  
  1632. SD V6.2 User's Guide                                             Page 29
  1633.  
  1634. 6.0  SPECIAL ENVIRONMENTS
  1635.  
  1636. 6.1  Batch File Operation
  1637.  
  1638. There are a variety of ways to effectively use SD  inside a Batch (.BAT)
  1639. file.  Three .BAT files are provided as examples: SDB, SDD and SDM.  All
  1640. three files will  display  help  information  if  executed  without  any
  1641. command line parameters.  They may be modified using any  standard  text
  1642. editor.  Once you are familiar with the use of these files, you may wish
  1643. to remove the help information at the beginning of  each  file  to  keep
  1644. them as small as possible.  If you are using DOS 3.3 or higher, you  may
  1645. wish to add an @ character to the ECHO OFF statement to suppress it.
  1646.  
  1647. Although you can use almost any valid SD command line with  these files,
  1648. the following restrictions exist:
  1649.  
  1650. 1) You must type a space before any command line parameters.
  1651.  
  1652. 2) Output redirection to a device or file isn't supported.
  1653.  
  1654. 3) If you don't specify any command line parameters, help information
  1655.    is displayed.  To select the current directory, specify * or ? or
  1656.    edit the file to remove the help information as described above.
  1657.  
  1658. The SDB.BAT file allows you to browse the output generated by  SD  using
  1659. another program (the default is LIST).  You may edit  the  SDB.BAT  file
  1660. to change the name of the browse program  to  any  program  you  prefer.
  1661. This Batch file is most useful when you are generating many  screens  of
  1662. output and wish to be able to scroll forward and  backward  through  the
  1663. output, find character strings, etc.  However, there may be a long  wait
  1664. before the output file is written, so a RAM disk should be used.
  1665.  
  1666. An example of using SDB is provided below:
  1667.  
  1668. C>sdb /az/1
  1669. Browse all information for all files inside all ARC and ZIP files in the
  1670. current directory of drive C using the one column output format.
  1671.  
  1672. The SDD.BAT Batch file allows you to execute the SD program for multiple
  1673. disk drives automatically.  This is especially useful when searching for
  1674. files which may be on other drives and possibly in other directories  or
  1675. ARC or ZIP files on other  drives.  It is  also  handy  when  displaying
  1676. totals information for one or more directories or ARC or  ZIP  files  on
  1677. several drives.
  1678.  
  1679. Before using SDD, you must use a text editor to edit the file to  select
  1680. the disk drives you wish to process (the default is drives C, D, and E).
  1681. It is recommended that you only select partitions  on  hard  disks,  and
  1682. possibly other drives which are not floppy disk drives,  but  any  valid
  1683. drive letters may be selected, and  in  any  desired  order.  Since  the
  1684. drive letters are contained within the Batch file itself,  you  must not
  1685. specify a specific drive letter on the command line.  You may abort  the
  1686. output at any point by pressing ESCAPE or CTRL-C, so  you  should  order
  1687. the drive letters by  expected  frequency  of  use.  The  following  two
  1688. statements must appear in the Batch file for each drive (d):
  1689.  
  1690. sd d:%1%2%3%4%5%6%7%8%9/$
  1691. if errorlevel 2 goto end
  1692.  
  1693. SD V6.2 User's Guide                                             Page 30
  1694.  
  1695. The last drive is an exception, where the /$ switch must be  changed  to
  1696. /$$ and the if statement should be omitted.  The /$  switch  tells SD to
  1697. provide a pause between successive drives in order to synchronize screen
  1698. scrolling.  The /$$ switch prevents the  last  output  line  from  being
  1699. overwritten by the DOS command line prompt.
  1700.  
  1701. Some typical examples of using SDD are provided below:
  1702.  
  1703. D>sdd \abc/g
  1704. Display information for  all files  whose names  begin with  abc in  all
  1705. directories on all selected drives.
  1706.  
  1707. D>sdd /v/t
  1708. Display volume label and totals information for  the  current  directory
  1709. on all selected drives.
  1710.  
  1711. D>sdd \/gt
  1712. Display volume label and  grand totals  information for  all directories
  1713. on all selected drives.
  1714.  
  1715. The SDM.BAT Batch file  allows  you  to  execute  the  SD  program  with
  1716. multiple command line parameters  including  drives,  paths,  file  name
  1717. specifications and/or  switches  all  on  the  same  command  line.  SDM
  1718. executes the SD program repeatedly,  passing  a  separate  command  line
  1719. parameter to SD each time it is executed.  Since each Batch file command
  1720. line parameter is separated from another by one or more spaces, you  can
  1721. group multiple sets of parameters together and separate the groups  with
  1722. one or more spaces.
  1723.  
  1724. Some typical examples of using SDM are provided below:
  1725.  
  1726. C>sdm d:\/gt e:\/gt
  1727. Display volume label and  grand totals  information for  all directories
  1728. on drives D and E.
  1729.  
  1730. D>sdm *.bat *.com *.exe
  1731. Display information for all .BAT, .COM and .EXE  files  in  the  current
  1732. directory of drive D.
  1733.  
  1734. C>sdm \dir1 \dir3 \dir5 \dir7
  1735. Display information for the files in each of the  specified  directories
  1736. on drive C.
  1737.  
  1738. SD V6.2 User's Guide                                             Page 31
  1739.  
  1740. 6.2  Multitasking Environments
  1741.  
  1742. There are two  different  ways  to  use  SD  with  various  multitasking
  1743. environments such as  DESQview or Microsoft Windows.  The  first  method
  1744. is to use SD in its normal mode  where  it  writes  output  directly  to
  1745. video memory for fast color output.  This method will allow the  program
  1746. to run inside a window under DESQview, but not under Microsoft  Windows.
  1747. The supplied SD.PIF file tells Microsoft Windows that SD writes directly
  1748. to video display memory and can therefore not run inside a  window.  The
  1749. second method is to make a copy of SD (called SDW) which will  have  the
  1750. /r switch turned on as a default.  This will allow it to  run  inside  a
  1751. window, but more slowly and without color.
  1752.  
  1753. Create the SDW file as follows:
  1754.  
  1755. D>COPY SD.COM SDW.COM
  1756. D>DEBUG SDW.COM
  1757. -E114 1
  1758. -W
  1759. -Q
  1760.  
  1761. Copy SD.PIF to SDW.PIF and use the Microsoft Windows PIFEDIT utility  to
  1762. edit the SDW.PIF file to indicate that the  program  does  not  directly
  1763. modify the screen.
  1764.  
  1765. 6.3  Local Area Networks and OS/2
  1766.  
  1767. SD and SDR have been tested with IBM,  NOVELL,  3COM,  10NET  and  other
  1768. Local Area  Networks  for  compatibility.  Logical  Network  drives  are
  1769. detected and identified.  When the /i switch is specified, no attempt is
  1770. made to read the Boot Sector for Network drives, so not all of the  disk
  1771. parameter information is available.  ARC and ZIP files are opened  using
  1772. "Deny Write" sharing mode to allow concurrent Read mode access on LANs.
  1773.  
  1774. SD and SDR have been tested with several versions of the  OS/2  DOS  3.X
  1775. "Compatibility Box" with good results.  An OS/2 protected  mode  version
  1776. of SD is under development.  Please let  the  author  know  if  you  are
  1777. interested in this version of the program.
  1778.  
  1779. SD V6.2 User's Guide                                             Page 32
  1780.  
  1781. 7.0  MEMORY RESIDENT VERSION (SDR)
  1782.  
  1783. 7.1  Overview
  1784.  
  1785. SDR.COM is a memory resident  sorted  directory  utility  program  which
  1786. operates on IBM-PC compatible computer systems using the IBM  PC-DOS  or
  1787. Microsoft MS-DOS Operating System Version 2.0 or higher.
  1788.  
  1789. SD.COM is the non-memory resident version of the  program.    Since  the
  1790. capabilities  and  command  syntax  of  the  two  programs are virtually
  1791. identical, only the differences and additional capabilities  of  SDR.COM
  1792. are covered in this section of the document.  It is recommended that the
  1793. user first become familiar with the use of SD.COM before using  SDR.COM.
  1794. The bulk of the command syntax for SDR.COM is therefore covered  in  the
  1795. section for SD.COM.
  1796.  
  1797. This version of the program  requires  about  18Kb  of  disk  space  and
  1798. about 25-70Kb of memory during  execution,  depending  on  the  size  of
  1799. the directory, file and screen buffers configured by the user.  With the
  1800. default buffer sizes, the program uses about 31Kb of system memory.
  1801.  
  1802. The advantage of a memory resident program is that it is  almost  always
  1803. available for use, regardless of the other program(s) currently running.
  1804. Otherwise, it would be necessary to either exit the current program  and
  1805. return to the  DOS system command prompt in order to run the program, or
  1806. use the "shell" facility that some programs  provide  to  execute  other
  1807. programs  and  then regain control.  Since not all programs provide this
  1808. capability, having your frequently used  utilities  in  memory  resident
  1809. form  greatly increases their availability.  In addition, execution of a
  1810. memory resident program is virtually instantaneous, since the program is
  1811. only loaded from disk once.
  1812.  
  1813. The primary disadvantage  of  a  memory  resident  program  is  that  it
  1814. consumes  system  memory  which  would otherwise be available to execute
  1815. other programs.  Most memory resident programs are loaded once at system
  1816. boot time  and  remain  in  memory  permanently.  Well  designed  memory
  1817. resident programs are carefully written to minimize the amount of memory
  1818. they use, and allow the user to configure the program to achieve a  good
  1819. balance between functionality and  memory  consumption.    Another  more
  1820. subtle disadvantage is that most  non-trivial  memory resident  programs
  1821. must employ a variety of techniques to work around  the  limitations  in
  1822. the DOS operating system and the IBM-PC BIOS.  Since there is not yet  a
  1823. universally accepted standard for what these techniques should be, there
  1824. is  no guarantee that any one memory resident program will be compatible
  1825. with another, or even with other non-memory resident programs.
  1826.  
  1827. However, enough of  a  standard  has  emerged  to  write  useful  memory
  1828. resident  programs, and the benefits of frequently used programs greatly
  1829. outweigh the occasional incompatibilities for most users.  This  program
  1830. has been designed in such a way as to try and maximize its compatibility
  1831. with   other   programs.    However,  there  is   no   guarantee    that
  1832. incompatibilities  will  not  arise  with a specific program.  When this
  1833. occurs, a good strategy to follow is to try to simplify the  environment
  1834. as  much  as  possible;  remove  other memory resident programs one at a
  1835. time, or try changing the order in which they are loaded.
  1836.  
  1837. SD V6.2 User's Guide                                             Page 33
  1838.  
  1839. 7.2  Installation
  1840.  
  1841. Unlike non-memory resident programs, SDR is normally only executed once,
  1842. immediately  after the operating system is booted.  This is best done by
  1843. placing  the  command  "SDR"  in  the  AUTOEXEC.BAT  file    which    is
  1844. automatically executed by DOS after boot-up.  As mentioned above, it may
  1845. be necessary to experiment with different  loading  orders  of  multiple
  1846. Terminate-and-Stay-Resident  programs.  In general, the more complex TSR
  1847. type programs (such  as  BORLAND's  SideKick)  should  be  loaded  after
  1848. simpler TSR  programs.  Like  most  TSR  programs, SDR  should  only  be
  1849. installed at the top DOS command level, not from inside another program.
  1850.  
  1851. There are two SDR DOS command line switches  (/q and /y)  which  may  be
  1852. specified at installation time.  A third switch (/r) is used  to  remove
  1853. the program from memory and is described below.  These  switches  should
  1854. not be confused with those used once you have activated the program  and
  1855. are operating inside it.  The help screen displayed in response  to  the
  1856. /? switch (inside SDR) flags these switches with an (*) character  as  a
  1857. reminder that they are to be used on the DOS (not the SDR) command line.
  1858.  
  1859. The /q switch requests  "quiet"  installation  mode.  Normally,  if  the
  1860. installation is successful, SDR will display a message in a box  showing
  1861. the total amount of memory it is using and the activation key  sequence.
  1862. This message cannot be suppressed by redirecting it  to  the  DOS  "NUL"
  1863. device, since it is not displayed using  standard  DOS  video  services.
  1864. Specifying the /q switch will prevent the message from being  displayed.
  1865.  
  1866. Similarly, the /y switch causes suppression of the message box which  is
  1867. normally displayed when the program is activated by pressing the hot key
  1868. sequence.  See the sections below  for  additional  information.  As  an
  1869. example, you can install SDR and suppress both message boxes as follows:
  1870.  
  1871. D>SDR /Q/Y
  1872.  
  1873. Although it is rather unlikely, installation of SDR can  be  denied  for
  1874. the following reasons:
  1875.  
  1876. 1) DOS 2.0 or later is required.
  1877.  
  1878. 2) The program has already been loaded into memory.
  1879.  
  1880. 3) The directory or file buffer sizes requested are out of bounds.   The
  1881.    program was incorrectly  patched - this can't happen if the available
  1882.    configuration program (SDC) is used.
  1883.  
  1884. 4) There is insufficient system memory available for the resident  code,
  1885.    data, directory and file buffers.
  1886.  
  1887. 5) The program is unable to release memory it no longer needs.
  1888.  
  1889. 6) The program is unable to allocate memory for the screen buffer.
  1890.  
  1891. SD V6.2 User's Guide                                             Page 34
  1892.  
  1893. 7.3  Activation
  1894.  
  1895. Since the program is "memory resident", it is  available  for  use  even
  1896. though another program is currently running. The program is activated by
  1897. pressing the activation or "hot" key combination. The default activation
  1898. key combination is CTRL-ESC (while holding down the CTRL key, press  the
  1899. ESC key at the same time).  These key combinations can be changed  using
  1900. the configuration program so as not to conflict with their possible  use
  1901. by other programs.
  1902.  
  1903. Although the program will usually be able to  "go active"  or  "pop up",
  1904. there are a few situations where this is not possible (or desirable!):
  1905.  
  1906. 1) If the program is already active.  Pressing the activation key  while
  1907.    inside the  program is sometimes used to exit a TSR program.  Since a
  1908.    different key (ESC) is used for this purpose  in  SDR,  this  is  not
  1909.    allowed.
  1910.  
  1911. 2) If Disk I/O is in progress.  Although not recommended,  you may  find
  1912.    that you can safely pop up SDR in the middle of reading or writing to
  1913.    a disk.  At other times, the request may be denied.  This is  due  to
  1914.    the need to serialize access to non-reentrant code in the PC BIOS.
  1915.  
  1916. 3) If the current video mode doesn't support at least 80  text  columns.
  1917.    Since SDR requires at least 80 columns on the screen in a valid  text
  1918.    mode, it will decline to  activate  if  the  current  video  mode  is
  1919.    incompatible with these requirements.  The primary programs which use
  1920.    incompatible video modes are BASIC programs which use 40 column  text
  1921.    mode or various dot graphics modes.
  1922.  
  1923. 4) If a multitasking environment such as Microsoft Windows  or  DESQview
  1924.    is currently being used.  Since these  environments  involve  complex
  1925.    memory management functions, you should use SD rather than  SDR.  You
  1926.    CAN use SDR with Windows/386 if you install it while inside Windows.
  1927.  
  1928. In the situations above, the activation request will be acknowledged  by
  1929. an  audible  tone  or "beep", so that there is no doubt that the request
  1930. was declined.  However, there is another situation where the program may
  1931. not  appear  to activate.  Some programs or commands may perform certain
  1932. long-running functions which do  not  provide  an  opportunity  for  TSR
  1933. programs  to  activate.    A simple example is the TYPE command.  If you
  1934. type a large file and press the activation key during  the  output,  the
  1935. program  will  probably  not  go active and the audible tone will not be
  1936. generated.  However, when the command ends,  either  normally  or  by  a
  1937. CTRL-BREAK  interrupt,  SDR  will  activate.    Some TSR programs simply
  1938. refuse to activate in this situation.
  1939.  
  1940. Another similar situation can occur when  one  TSR  program  is  already
  1941. active  and refuses to allow a second TSR program to even "see" its hot-
  1942. key sequence.  This is a characteristic of  "ill-behaved"  TSR  programs
  1943. which  are  all too common.  Yet another scenario occurs when SDR "pops-
  1944. up" over another TSR program but appears to be "dead".  Sometimes simply
  1945. pressing  a  few  keys  will cause the "deadly embrace" to end, although
  1946. these keys may be passed back to the previously invoked program.
  1947.  
  1948. Since SDR dynamically determines  the  video  configuration, this  means
  1949. that  you can install it using one kind of video monitor and activate it
  1950. from another kind.  You can switch between MDA,  CGA,  and  EGA  or  VGA
  1951. monitors at will and SDR will adapt its operation to the monitor in use.
  1952.  
  1953. SD V6.2 User's Guide                                             Page 35
  1954.  
  1955. 7.4  Execution
  1956.  
  1957. After the activation key is accepted, the program "goes active" or "pops
  1958. up".    At this point, the top few lines of the screen are cleared and a
  1959. box with several lines of information is displayed.  A prompt appears on
  1960. the screen line below the box.  Once you are familiar with the operation
  1961. of the program, you may wish to use the SDR DOS command line  /y  switch
  1962. to eliminate the box in  order  to  save  screen  space.  The  following
  1963. options are now available:
  1964.  
  1965. 1) Enter a valid command line.  See below for details.
  1966.  
  1967. 2) Press the RETURN key to display the current directory.
  1968.  
  1969. 3) Enter /? to display command help information.
  1970.  
  1971. 4) Press ESC or CTRL-C to return to the suspended program.
  1972.  
  1973. The complete form of the command line is:
  1974.  
  1975. D:\path> [/switches] [drive][path][filespec] [/switches]
  1976.  
  1977. The prompt string consists of the current drive letter, followed by  the
  1978. current  directory  path for the drive, followed by the prompt character
  1979. (which may be configured).  The SDR prompt may appear alarmingly similar
  1980. to  your  DOS  system prompt; the DOS command: PROMPT $P$G generates the
  1981. same type of prompt string.  To avoid confusion, SDR allows  the  prompt
  1982. character  to  be  changed,  and  the  default  is  a graphics character
  1983. different from the usual (>) character.
  1984.  
  1985. The rest of the command line  parameters  (drive,  path,  filespec,  and
  1986. switches)  are  just  like those accepted by the SD.COM program.  Please
  1987. refer to the documentation for SD for details.
  1988.  
  1989. The command line must be terminated by the  RETURN  or  ENTER  key.  The
  1990. Backspace key may be  used  to remove previously typed characters on the
  1991. command line.  Since SDR must avoid the use of DOS console  services  in
  1992. resident code, utilities like CED and PCED which allow editing  the  DOS
  1993. command line will unfortunately not function inside SDR.
  1994.  
  1995. After the output of the current command is displayed, the prompt  string
  1996. is  redisplayed.   This allows you to enter as many commands as  desired
  1997. before returning to the  suspended  program.   Keep  in  mind  that  the
  1998. program which was in control when the activation key was pressed is in a
  1999. suspended state; this implies that you will not  wish  to  activate  SDR
  2000. (even  though  it is allowed) when executing a time-critical program.  A
  2001. good example of this is a modem communication program which  is  in  the
  2002. middle of a file transfer with a remote system.
  2003.  
  2004. SD V6.2 User's Guide                                             Page 36
  2005.  
  2006. To see SDR in operation, try the following example:
  2007.  
  2008. 1) Execute the BASIC language interpreter with the command: BASICA
  2009.  
  2010. 2) Enter the following BASIC command: FOR I=1 TO 999 : ? I,SQR(I) : NEXT
  2011.  
  2012. 3) Press RETURN and wait until the screen fills
  2013.  
  2014. 4) Press the SDR activation keys: CTRL-ESC
  2015.  
  2016. 5) Press RETURN several times to display the directory
  2017.  
  2018. 6) Press ESC to return to the BASIC program
  2019.  
  2020. 7) Notice that the program picks up where it left off
  2021.  
  2022. 8) Press CTRL-BREAK to terminate the BASIC program
  2023.  
  2024. Unlike most programs, you can't type ahead while the program is running.
  2025. This is due to the need to monitor the keyboard in order  to  pause  the
  2026. screen output.  If you wish to begin typing a new command, simply  press
  2027. ESCAPE or CTRL-C to terminate the output, and then  type  the  next  SDR
  2028. command.  ESCAPE causes the program to  terminate  immediately,  whereas
  2029. CTRL-C closes the file box and displays the disk space totals line.
  2030.  
  2031. Console output may be paused by  pressing  any  other  key  and  may  be
  2032. restarted in two different ways.  If the  RETURN  or  PAGE-DOWN  key  is
  2033. pressed, screen output resumes until the either the screen fills or  the
  2034. output finishes.  If any other key is pressed, only  a  single  line  of
  2035. additional screen  output  is  displayed.  This  allows  you  to  easily
  2036. control the displayed output so as to  minimize  the  loss  of  existing
  2037. screen data by scrolling.  The  Space  Bar  or  the  DOWN-ARROW  key  is
  2038. recommended for use in single line scrolling mode.
  2039.  
  2040. 7.5  Termination
  2041.  
  2042. The only way to exit from SDR to the suspended program  is  by  pressing
  2043. the  ESC or CTRL-C key from the SDR command prompt.  Pressing CTRL-BREAK
  2044. will not exit from SDR and will appear to be ignored, but the  interrupt
  2045. may be seen by the suspended program when SDR is exited normally.
  2046.  
  2047. If the ESC key is used to exit from SDR, the console screen is  restored
  2048. to  its original state, and the cursor position and size are restored to
  2049. their original state when the original program was suspended.
  2050.  
  2051. If the CTRL-C key is used to exit from SDR and the original screen  line
  2052. containing  the  cursor  before  SDR was activated is still visible, the
  2053. cursor is restored  to  its  original  state,  but  the  screen  is  NOT
  2054. restored.   A divider line is displayed over the last SDR prompt line to
  2055. clearly separate the original and subsequent screen output.  The  reason
  2056. for  this  behavior is to allow you to retain output generated by SDR in
  2057. order to be able to refer  to  it  when  you  return  to  the  suspended
  2058. program.  Once the original cursor line is overwritten, either by screen
  2059. output, scrolling, or clearing the screen, CTRL-C will cause the  entire
  2060. screen  to  be  restored,  just like ESC.  Therefore, if you plan to use
  2061. this feature, you will want to position  the  cursor  as  close  to  the
  2062. bottom  of  the screen as possible before activating SDR.  Once you have
  2063. referred to the SDR output, you may wish to perform  an  action  in  the
  2064. suspended  program  which  will  cause  the  screen  to be rewritten, in
  2065. order to avoid confusion and to resynchronize the display.
  2066.  
  2067. SD V6.2 User's Guide                                             Page 37
  2068.  
  2069. 7.6  Removal
  2070.  
  2071. SDR prevents the user from loading multiple copies of itself in order to
  2072. avoid wasting memory.  It can be removed from memory by running it again
  2073. with the /r command line switch specified.  This  is  helpful  when  the
  2074. program is being configured for different screen colors, etc.  in  order
  2075. to avoid a system reboot to load a new copy of the program.  It can also
  2076. be useful if the need arises to release as much memory as  possible  for
  2077. some other purpose.
  2078.  
  2079. Although it is rather unlikely, removal of SDR can  be  denied  for  the
  2080. following reasons:
  2081.  
  2082. 1) The program is not already loaded in memory.
  2083.  
  2084. 2) Interrupt vectors previously saved and changed by  the  program  have
  2085.    been subsequently altered by another program.
  2086.  
  2087. 3) The program is unable to release memory it no longer needs.
  2088.  
  2089. SDR will decline to remove itself from  memory  if  it  determines  that
  2090. another TSR program has stolen  one  of  the  interrupt vectors which it
  2091. saves and then changes.  In this case, you must remove the other program
  2092. from memory before you can remove SDR.  A good example is when BORLAND's
  2093. SideKick utility is used with SDR.  In this case, install SDR first  and
  2094. SideKick second.  You must remove SideKick first, and SDR  second.  This
  2095. is necessary since SideKick constantly monitors the interrupt vectors it
  2096. steals and if it detects that another program has stolen them, it steals
  2097. them back again!  If you cannot remove a TSR program  loaded  after  SDR
  2098. (such as the DOS PRINT command) then you will not be able to remove SDR.
  2099.  
  2100. Although a few TSR programs provide a means of  deinstalling  themselves
  2101. from  memory  (such  as  SDR),  most do not.  However, there are several
  2102. utilities available which provide this capability.  MARK and RELEASE  by
  2103. TurboPower  Software  and  INSTALL and REMOVE by PC Magazine are readily
  2104. available on many Bulletin Boards.   These  programs  require  that  you
  2105. execute  a  special program before installing a TSR program, and another
  2106. program when you wish to remove the TSR program.  They  work  by  saving
  2107. information about the state of the Interrupt Vector Table and DOS Memory
  2108. Control Blocks so that this information can  be  subsequently  restored,
  2109. thus effectively removing the TSR program.
  2110.  
  2111. There are also several utility programs available (PMAP or MAPMEM) which
  2112. display all of the currently loaded TSR programs, along with information
  2113. on how much memory they use,  which  interrupts  they  "steal", etc.  By
  2114. observing which interrupts  are  stolen  by  each  TSR  program,  it  is
  2115. possible to determine which programs are likely to  conflict  with  each
  2116. other once they are installed.
  2117.  
  2118. If you use one of these programs to display  the  currently  loaded  TSR
  2119. programs, you may notice that  some  are  identified  by  their  program
  2120. names and some are not.  Starting with  DOS  V3, the  path  and  program
  2121. name used to execute a program are stored  in  the  program  environment
  2122. memory block.  It is  generally  considered  good  practice  for  a  TSR
  2123. program to release this environment block  (usually less than 100 bytes)
  2124. at the time it is installed, and SDR does this.  A side effect  of  this
  2125. action is that  programs  which  scan  the  memory  control  blocks  and
  2126. display information about TSR programs cannot obtain the program name.
  2127.  
  2128. SD V6.2 User's Guide                                             Page 38
  2129.  
  2130. If the TSR memory map program you use  displays  the  text  of  the  DOS
  2131. command line used to install the program, you can place the name of  the
  2132. program on the command line as a parameter (to itself!) so that it  will
  2133. show up on the memory map listing.  For example:
  2134.  
  2135. D>SDR SDR /Q
  2136.  
  2137. When any TSR program is removed from memory  and  it  is  not  the  last
  2138. loaded TSR program, a gap in memory will result  from  the  creation  of
  2139. the resulting free memory block.  DOS  will  not  normally  be  able  to
  2140. use this memory unless all TSR programs  above  it  are  first  removed.
  2141. This implies that TSR programs should always be removed in the  opposite
  2142. order in which they were installed, in order  to  maximize  the  use  of
  2143. available memory for other programs.
  2144.  
  2145. 7.7  Switch Differences
  2146.  
  2147. Although most of the command line switches function the same in  SDR  as
  2148. they do in SD, there are differences due to the operating environment.
  2149.  
  2150. Although the /e switch may still be used to clear the screen before  the
  2151. execution  of an individual command, using the SDC program to turn  this
  2152. switch ON as a default will cause the entire screen to be  cleared  each
  2153. time  SDR  "pops-up", but not automatically for each subsequent command.
  2154.  
  2155. The Environment Size, TSR Memory, and System Memory Used and Free values
  2156. displayed by the /i switch reflect the system memory at  the  time  just
  2157. after SDR was installed and may be incorrect if other TSR programs  have
  2158. been subsequently loaded.
  2159.  
  2160. If SDR is activated from the DOS command prompt (not from inside another
  2161. program), it will not be able to read the  Boot  Sector  for  ANY  drive
  2162. under OS/2, or drives above C: under DOS.  In this  case,  some  of  the
  2163. disk parameter values will appear as NONE or zeros.
  2164.  
  2165. The /q switch requests "quiet" installation of SDR when specified on the
  2166. DOS command line as described above.  When used inside SDR, it functions
  2167. just as it does in SD to generate "quick" output without user prompts.
  2168.  
  2169. The /r switch is normally used in SD to allow the program output  to  be
  2170. redirected to a file or to the printer. Since this function is performed
  2171. by the DOS command interpreter, it is  not  available  inside  a  memory
  2172. resident program.  The /r switch is used to remove SDR from memory (when
  2173. specified on the DOS command line to execute SDR), and is ignored  if it
  2174. is specified on the command line inside SDR.
  2175.  
  2176. The /w switch resets the screen to 25 lines after the execution  of  the
  2177. current command in SDR, NOT when SDR returns to the suspended program.
  2178.  
  2179. The /y switch is normally used in SD to cause the screen to be saved and
  2180. restored.  When specified on the SDR DOS command line, it suppresses the
  2181. activation message box.  If you often use the CTRL-C key  to  exit  from
  2182. SDR, you may wish to specify /y when installing SDR  so  that  you  have
  2183. more room to use on the screen.  The /y  switch  is  ignored  if  it  is
  2184. specified on the command line inside SDR.
  2185.  
  2186. The SD /$ switch, which is designed to facilitate the  operation  of  SD
  2187. when it is executed inside a DOS Batch file, is not implemented in SDR.
  2188.  
  2189. SD V6.2 User's Guide                                             Page 39
  2190.  
  2191. The EGA and VGA switches (/25, /35, /43, /50) should be used cautiously.
  2192. If you use an EGA or VGA video adaptor and wish  to  use  more  than  25
  2193. screen lines, make sure you select screen buffer type 2 (8000 bytes)  in
  2194. the configuration program.  Otherwise, only the first 25  lines  of  the
  2195. original screen will be restored.  Even so, it is recommended  that  you
  2196. reset the screen to its original size before returning to  the suspended
  2197. program, unless it is known to be able to tolerate this kind of  dynamic
  2198. video mode switching.
  2199.  
  2200. It should be kept in mind that SDR has several restrictions placed on it
  2201. which do not apply to the simpler  operating  environment  of  SD.  Even
  2202. though SDR can be activated from the DOS command prompt, you may  prefer
  2203. to use SD in this situation for the following reasons:
  2204.  
  2205. 1) Previous screen output is more readily visible.
  2206.  
  2207. 2) More directories and files can be processed.
  2208.  
  2209. 3) Output may be redirected to a file or device.
  2210.  
  2211. 4) Full disk parameter information is available for
  2212.    all disk drives when requested by the /i switch.
  2213.  
  2214. SDR should therefore not be viewed as a total replacement for SD, but as
  2215. a supplementary program which is available in more environments.
  2216.  
  2217. 7.8  Configuration
  2218.  
  2219. The SDR program may be configured (using SDC) or  patched  (using DEBUG)
  2220. to change the various program defaults to  those  you  prefer.  The  SDC
  2221. program is preferred over DEBUG since it is much easier and safer to use
  2222. and allows you to decide which combination of screen colors you  prefer.
  2223. It also allows you to first configure the SD  program  for  the  default
  2224. switches and screen colors you prefer and to then transfer these  values
  2225. to the SDR program, without having to leave the  configuration  program.
  2226. You will then only have to configure the options  which  are  unique  to
  2227. SDR.  Please run the DEMO2.BAT file to see examples of the SDC program.
  2228.  
  2229. If you are using DEBUG, you will need to refer  to  the  section  titled
  2230. Patch Area Format to obtain the necessary offsets and data values.
  2231.  
  2232. Activation Key Specification
  2233.  
  2234. Great care should be taken  in  selecting  the  activation  or  hot  key
  2235. sequence.  It must be unique enough that it will never be needed for any
  2236. other purpose by any program you normally use.  This usually means  that
  2237. an ALT or CTRL key combination is the best choice.
  2238.  
  2239. For PC-AT style keyboards, the SysReq key cannot be used as  a  hot  key
  2240. since it is processed differently from  the  other  standard  keys.  The
  2241. new keys on enhanced 101 key keyboards such as F11 and F12  also  cannot
  2242. be used since they are processed differently by the ROM BIOS.
  2243.  
  2244. Hot Key Control Codes (select any combination from 0-15)
  2245.  
  2246. 1 = Right Shift Key   4 = Ctrl Key
  2247. 2 = Left Shift Key    8 = Alt Key
  2248.  
  2249. The default hot key control code is 4 (CTRL).
  2250.  
  2251. SD V6.2 User's Guide                                             Page 40
  2252.  
  2253. Hot Key Scan Codes (select any value from 0-255)
  2254.  
  2255. Escape       = 01     Home         = 71  Shift F1-F10     =  84- 93
  2256. 1234567890-= = 02-13  Up Arrow     = 72  Ctrl  F1-F10     =  94-103
  2257. Back Space   = 14     Page Up      = 73  Alt   F1-F10     = 104-113
  2258. Tab          = 15     Left Arrow   = 75  Ctrl PrtSc       = 114
  2259. QWERTYUIOP[] = 16-27  Right Arrow  = 77  Ctrl Left Arrow  = 115
  2260. Enter        = 28     Keypad +     = 78  Ctrl Right Arrow = 116
  2261. ASDFGHJKL;'` = 30-41  End          = 79  Ctrl End         = 117
  2262. \ZXCVBNM,./  = 43-53  Down Arrow   = 80  Ctrl PgDn        = 118
  2263. *            = 55     Page Down    = 81  Ctrl Home        = 119
  2264. Space        = 57     Insert       = 82  Alt 1234567890-= = 120-131
  2265. F1-F10       = 59-68  Delete       = 83  Ctrl Pgup        = 132
  2266.  
  2267. The default hot key scan code is 1 (ESC).
  2268.  
  2269. Hot Key String
  2270.  
  2271. You may enter a character string of from 1 to 16 characters  which  will
  2272. be displayed as part of the program's installation message as a reminder
  2273. of the hot key sequence. The default hot key string is CTRL-ESCAPE Keys.
  2274. If you use DEBUG, make sure that the  string  is  padded  with  trailing
  2275. spaces through the 16th character,  if  necessary,  and  that  the  next
  2276. character is a NULL (hexadecimal 00).
  2277.  
  2278. Prompt Character Specification
  2279.  
  2280. The default prompt character (code 26, a graphics  right  arrow  symbol)
  2281. was chosen to be different from, but similar to the standard DOS command
  2282. line prompt character.  You may change it to any  standard  or  extended
  2283. ASCII character from 0-255.
  2284.  
  2285. SDR Memory Usage
  2286.  
  2287. Dir Buffer      Minimum         Default         Maximum
  2288. ----------      -------         -------         -------
  2289. Bytes               512            1024            4096
  2290. Dirs                 32              64             256
  2291.  
  2292. File Buffer     Minimum         Default         Maximum
  2293. -----------     -------         -------         -------
  2294. Bytes              2560            8192           40960
  2295. Files per Dir       102             327            1638
  2296. ARC/ZIP Files        88             282            1412
  2297.  
  2298. Memory Usage    Minimum         Default         Maximum
  2299. ------------    -------         -------         -------
  2300. Code & Data       18544           18544           18544
  2301. Dir Buffer          512            1024            4096
  2302. File Buffer        2560            8192           40960
  2303. Screen Buffer      4000            4000            8000
  2304. Total             25616           31760           71600
  2305.  
  2306. SD V6.2 User's Guide                                             Page 41
  2307.  
  2308. Buffer Size Specifications
  2309.  
  2310. The choice of the directory and file buffer size values is  based  on  a
  2311. trade-off  between minimizing the amount of memory used and allowing for
  2312. a reasonable number of directories  and  files.  Each  directory  buffer
  2313. entry uses a variable number of bytes from 4 to  70,  depending  on  the
  2314. length of the directory  name.  For  the  purposes  of  performing  some
  2315. calculations, we will assume an average  directory  name  length  of  13
  2316. characters, or 16 bytes per directory buffer  entry.  Each  file  buffer
  2317. entry uses 25 bytes per file or 29 bytes for files in ARC or ZIP files.
  2318.  
  2319. The default buffer sizes are 1024 bytes for about 64  directory  entries
  2320. and 8192 bytes for about 327 files per directory or 282  files  per  ARC
  2321. or ZIP file.  The directory buffer is only used when  processing  global
  2322. directories with the /g switch.  Its size may range  from  512  to  4096
  2323. bytes.  The file buffer is always used and contains all of the file  and
  2324. subdirectory names for an individual directory or  ARC or ZIP file.  Its
  2325. size may range from 2560 to 40960 bytes.  The size of the resident  code
  2326. and data excluding these two buffers is  currently  about  18544  bytes.
  2327. The buffer used to save the screen may be configured for either 4000  or
  2328. 8000 bytes.  You can therefore configure the program to use as little as
  2329. about 25Kb of memory or as much as about 70Kb.
  2330.  
  2331. The total memory used not including the screen buffer must be less  than
  2332. 64Kb.  This limit is strictly enforced; you  will  receive  the  "Memory
  2333. error" message when installing SDR if the total configured  memory  size
  2334. exceeds this.  If you attempt  to  exceed  the  configured  buffer  size
  2335. limits when running the program, you will receive the "Too many dirs" or
  2336. "Too many files" message, and the resulting output will be incomplete.
  2337.  
  2338. The default screen buffer size is 4000 bytes.  This  is  sufficient  for
  2339. either a Monochrome or CGA equipped PC.  However, if you use an  EGA  or
  2340. VGA monitor and sometimes use more than 25 lines on the screen, you  may
  2341. wish to configure an 8000 byte screen buffer to allow for up to 50 lines
  2342. of 80 characters.  Failure to do this will result in only the  first  25
  2343. screen lines being restored.  Use of special video modes  which  support
  2344. more than 80 characters per line (43 rows x 132 columns) may also result
  2345. in only partial screen restoration.
  2346.  
  2347. 7.9  Error Messages
  2348.  
  2349. The following error messages are displayed and system return  codes  set
  2350. for various conditions which may arise.  An audible tone is generated to
  2351. alert the user of severe errors.  The return codes may be  tested  using
  2352. the standard DOS IF ERRORLEVEL statement in a .BAT file.
  2353.  
  2354. No matching files (directory may be empty)
  2355. Bad switch (use /? for help information)
  2356. Bad drive (doesn't exist or syntax error)
  2357. Bad path (doesn't exist or syntax error)
  2358. Bad filespec (syntax error)
  2359. Bad date (too large or syntax error)
  2360. Too many dirs (buffer limit exceeded for /g)
  2361. Too many files (buffer limit exceeded)
  2362. Disk error (floppy disk not in drive or unformatted)
  2363.  
  2364. 0 - Removed (in response to /r switch)
  2365. 1 - Already loaded (can't reload unless removed)
  2366. 2 - Not loaded (can't remove unless loaded)
  2367. 3 - Can't remove (interrupt vectors changed)
  2368. 4 - Memory error (insufficient or (de)allocation problem)
  2369.  
  2370. SD V6.2 User's Guide                                             Page 42
  2371.  
  2372. 8.0  CUSTOMIZATION
  2373.  
  2374. 8.1  Configuring the Program
  2375.  
  2376. The SD program may be configured (using SDC) or patched (using DEBUG) to
  2377. change the various  program  defaults  to  those  you  prefer.  The  SDC
  2378. program is preferred over DEBUG since it is much easier and safer to use
  2379. and allows you to decide which combination of screen colors you  prefer.
  2380. It also allows you to judge the effect of your  changes  by  alternately
  2381. modifying the SD program and executing the modified program, all without
  2382. having to leave the configuration  program.  Please  run  the  DEMO2.BAT
  2383. file to see some examples of SDC program output.
  2384.  
  2385. If you are using DEBUG, you will need to refer  to  the  section  titled
  2386. Patch Area Format to obtain  the  necessary  offsets  and  data  values.
  2387. The following example shows how to use DEBUG to patch the SD program:
  2388.  
  2389. D>DEBUG SD.COM    (Load SD.COM into memory using DEBUG)
  2390. -E107 '4'         (Change the default number of columns to 4)
  2391. -E118 01          (Display the volume label as a default)
  2392. -E11C 1E          (Change directory colors to Yellow on Blue)
  2393. -W                (Write the modified file back to disk)
  2394. -Q                (Exit to DOS from DEBUG)
  2395. D>SD              (Execute the modified version of SD.COM)
  2396.  
  2397. Screen Color Configuration
  2398.  
  2399. Although it is possible to configure the SD program using either a color
  2400. or monochrome monitor, best results will be obtained if  you  are  using
  2401. the target monitor since you will be better able  to  judge  the  effect
  2402. of different screen color  combinations.  If  you  are  using  a  laptop
  2403. computer with a LCD display screen, you may wish to set  all  colors  to
  2404. White on Black for better readability.  You can do this as follows:
  2405.  
  2406. D>DEBUG SD.COM    (Load SD.COM into memory using DEBUG)
  2407. -F11C L 10 7      (Change all screen colors to White on Black)
  2408. -W                (Write the modified file back to disk)
  2409. -Q                (Exit to DOS from DEBUG)
  2410. D>SD              (Execute the modified version of SD.COM)
  2411.  
  2412. SD V6.2 User's Guide                                             Page 43
  2413.  
  2414. The foreground and background colors (screen attributes)  used  for  the
  2415. following screen fields may be configured:
  2416.  
  2417. DIRECTORY COLORS apply to individual subdirectory entries.
  2418.  
  2419. SYSTEM COLORS apply to files with the System attribute.
  2420.  
  2421. HIDDEN COLORS apply to files with the  Hidden  attribute,  but  not  the
  2422. System attribute.
  2423.  
  2424. READ/ONLY COLORS apply  to  files  with  the  Read/Only  attribute,  but
  2425. neither the System nor Hidden attribute.
  2426.  
  2427. ARCHIVE COLORS apply to files with the Archive  attribute,  but  neither
  2428. the System, Hidden, or Read/Only attribute.
  2429.  
  2430. FILE COLORS apply to files with none of the above mentioned  attributes.
  2431.  
  2432. ARC FILE COLORS apply to file entries INSIDE ARC files.
  2433.  
  2434. ZIP FILE COLORS apply to file entries INSIDE ZIP files.
  2435.  
  2436. FILE SIZE COLORS apply to the file size, clusters, and percent of  space
  2437. used fields.
  2438.  
  2439. FILE DATE COLORS apply to the file date and time fields.
  2440.  
  2441. FILE MISC COLORS apply to the file starting cluster and sector and  file
  2442. attribute fields for non-ARC files and file CRC  codes  for  ARC  files.
  2443. These are also used for empty file box entries and (K)ilobyte symbols.
  2444.  
  2445. GRAPHICS COLORS apply to the  graphics  characters  which  are  used  to
  2446. form the border lines of boxes.
  2447.  
  2448. TITLE COLORS apply to the title fields for the various  boxes  displayed
  2449. by the /? and /i switches.
  2450.  
  2451. TEXT COLORS apply to the text strings which precede  numeric  or  string
  2452. values in the leading and trailing text lines and to  the  text  in  the
  2453. boxes displayed for the /? and /i switches.
  2454.  
  2455. INFO COLORS apply to the numeric or string values which follow the  text
  2456. strings in the leading and trailing text lines and to the values in  the
  2457. boxes displayed for the /i switch.
  2458.  
  2459. NORMAL COLORS apply to the trailing characters on each output line,  the
  2460. new output lines created when the screen is scrolled and the SDR  prompt
  2461. line.  These colors should be set to the standard screen colors used  at
  2462. the DOS command prompt.
  2463.  
  2464. The Graphics, Text, Info and Normal Colors should be  selected  so  that
  2465. they all use the same background color (the default is Black), for  best
  2466. results.  The remaining colors should  be  selected  so  that  they  are
  2467. sufficiently different from one another to be individually  recognizable
  2468. and are easily readable on the video monitor being used.  Although there
  2469. are 2048 possible color combinations, only a few are tolerable for long.
  2470.  
  2471. SD V6.2 User's Guide                                             Page 44
  2472.  
  2473. 8.2  SDC Configuration Program
  2474.  
  2475. SDC.EXE is a utility program which  is  used  to  configure  the  Sorted
  2476. Directory  Utility  Program  (SD.COM)  or  the  Memory  Resident  Sorted
  2477. Directory Utility Program (SDR.COM).  It operates on  IBM-PC  compatible
  2478. computer systems using the IBM  PC-DOS  or  Microsoft  MS-DOS  Operating
  2479. System Version 2.0 or higher.
  2480.  
  2481. SDC can be used with either MDA, CGA, MCGA, EGA, or VGA  video  adaptors
  2482. and monitors, but should be used on the target system, for best results.
  2483. The SDC screen displays are normally shown using  various  colors  if  a
  2484. color video adaptor is in use.  Some LCD video screens  used  on  laptop
  2485. computers can make it difficult to see certain  color  combinations.  If
  2486. you prefer to use SDC in Black and White mode, execute the following DOS
  2487. command before running the SDC program:
  2488.  
  2489. D>SET SDCDISP=MONO
  2490.  
  2491. You may wish to initially set all  screen color combinations to White on
  2492. Black if you are using a laptop computer, for the same reason.
  2493.  
  2494. Program Operation
  2495.  
  2496. SDC allows you to configure SD.COM, alternately  changing  one  or  more
  2497. program defaults and then executing SD.COM to observe  the  result,  all
  2498. without having to terminate the SDC  program.  Once  you  are  satisfied
  2499. with the changes made to SD.COM, you can transfer them  to  the  SDR.COM
  2500. file and then adjust the remaining SDR defaults to your preferences.
  2501.  
  2502. Changes made by SDC to the SD.COM or SDR.COM files are effective as soon
  2503. as they are specified, not when the SDC program is terminated.  You  may
  2504. exit from the program at any time by pressing the CTRL-BREAK keys.
  2505.  
  2506. Program Structure
  2507.  
  2508. SDC displays two function selection menus.  The  Main Menu  is  used  to
  2509. specify which program you wish to configure.  The Option Menu is used to
  2510. specify which default  values  you  wish  to  change  for  the  selected
  2511. program.  The Option Menus for SD and SDR are slightly different.
  2512.  
  2513. Main Configuration Menu
  2514.  
  2515. 1 = Configure SD.COM Program
  2516. 2 = Configure SDR.COM Program
  2517. 3 = Exit Configuration Program
  2518.  
  2519. You will be asked which program you wish to configure, and then for  the
  2520. name of the executable file (normally SD.COM or SDR.COM).  Several tests
  2521. are made to insure that the specified file exists, is the proper program
  2522. type, and is the proper version for the configuration program.
  2523.  
  2524. Configuration Option Menu For SD.COM
  2525.  
  2526. 1 = Display or Change Sort Options
  2527. 2 = Display or Change Filename Columns
  2528. 3 = Display or Change Switch Values
  2529. 4 = Display or Change Screen Colors
  2530. 5 = Execute Configured SD Program
  2531. 6 = Transfer SD Program Options to SDR
  2532. 7 = Exit to Main Configuration Menu
  2533.  
  2534. SD V6.2 User's Guide                                             Page 45
  2535.  
  2536. Configuration Option Menu For SDR.COM
  2537.  
  2538. 1 = Display or Change Sort Options
  2539. 2 = Display or Change Filename Columns
  2540. 3 = Display or Change Switch Values
  2541. 4 = Display or Change Screen Colors
  2542. 5 = Display or Change Hot Key or Prompt
  2543. 6 = Display or Change Buffer Sizes
  2544. 7 = Exit to Main Configuration Menu
  2545.  
  2546. Common Options
  2547.  
  2548. 1 = Display or Change Sort Type (/F/X/B/D/C/N)
  2549.     Display or Change Sort Direction (+ OR -)
  2550.  
  2551. This option allows you to change the default  sort  type  and  direction
  2552. which will be used to sort the file entries.
  2553.  
  2554. 2 = Display or Change Filename Columns (/1/2/4/6)
  2555.  
  2556. This option allows you to change the default number of  filename  output
  2557. columns, and inversely, the level of detail for the file information.
  2558.  
  2559. 3 = Display or Change Switch Values (/E/H/K/O/P/Q/S/U/V/W)
  2560.  
  2561. This option allows you to specify the default state of the output toggle
  2562. switches.  Although there are a number of other  output  switches  which
  2563. may be specified on the SD or SDR command  line,  it  is  normally  only
  2564. reasonable to change the default values of the switches listed here.
  2565.  
  2566. 4 = Display or Change Screen Colors or Attributes
  2567.  
  2568. This option allows you to change the colors or monochrome attributes  of
  2569. 16 individual screen fields.  Separate defaults are maintained for color
  2570. and monochrome monitors.  For a  color  monitor,  you  may  specify  the
  2571. foreground  (0-15)  and  background  (0-7)  color  combination.   For  a
  2572. monochrome monitor, you may specify the screen attributes (normal video,
  2573. reverse video, or underlined) each of which may be intensified.
  2574.  
  2575. Options Specific to SD
  2576.  
  2577. 5 = Execute Configured SD Program
  2578.  
  2579. This option allows you to execute the configured SD program  to  observe
  2580. the effect of the changes you have made.  You are prompted for a command
  2581. line and may execute the SD program any number of times with any desired
  2582. command line switches, etc.  SDC  is  a  compiled  Microsoft  QuickBasic
  2583. program.  Since it has been determined that the SHELL function  used  to
  2584. run SD.COM without leaving SDC doesn't work reliably with DOS Version 2,
  2585. you should avoid using this option if you are using DOS Version 2.
  2586.  
  2587. 6 = Transfer SD Program Options to SDR
  2588.  
  2589. This option allows you to  automatically  transfer  all  of  the  common
  2590. option values you have configured in the SD.COM file to the SDR.COM file
  2591. so you don't have to respecify them.
  2592.  
  2593. SD V6.2 User's Guide                                             Page 46
  2594.  
  2595. Options Specific to SDR
  2596.  
  2597. 5 = Display or Change Hot Key or Prompt
  2598.  
  2599. This option allows you to specify the Activation (Hot) Key  and  command
  2600. line prompt character used by SDR.  The Hot Key Control Code can be  any
  2601. combination of the ALT, CTRL, LEFT-SHIFT, and/or RIGHT-SHIFT  keys.  The
  2602. Hot Key Scan Code can be any value selected from the displayed list. The
  2603. Hot Key String can be up to 16 characters long and should be selected to
  2604. describe the configured Hot Key since it will be displayed at  the  time
  2605. SDR is installed in memory, as a reminder.  The Prompt Character can  be
  2606. any regular or extended ASCII character from 0 to 255.
  2607.  
  2608. 6 = Display or Change Buffer Sizes
  2609.  
  2610. This option allows you to specify the size of the SDR  Directory,  File,
  2611. and Screen Buffers.  The values should be carefully selected to be  just
  2612. large enough to handle the maximum number of directories and files in  a
  2613. single directory that you are likely to  encounter.  The  screen  buffer
  2614. size should be selected based on the video display adaptor you  normally
  2615. use.  Please refer to the section on SDR for additional information.
  2616.  
  2617. 8.3  Patch Area Format
  2618.  
  2619. The following information is only provided as a reference for those  who
  2620. need to use DEBUG to change the program defaults; it is  not  needed  to
  2621. run the SDC configuration program.
  2622.  
  2623. The following data area at the beginning  of  the  SD.COM  file  may  be
  2624. modified using the standard DOS  DEBUG  program.  Only the  data  values
  2625. beginning with the Sort Type field should be modified.  Only the  toggle
  2626. switches marked (SDC) should normally be turned ON as a default.
  2627.  
  2628. SD V6.2 User's Guide                                             Page 47
  2629.  
  2630. SDC     DEBUG   Field                  Default   Possible
  2631. Offset  Offset  Description            Value     Values
  2632. ------  ------  -----------            -------   --------
  2633.   01     0100   Jump Instruction          -      ?? ?? ??
  2634.   04     0103   Program Type              -      1=SD.COM, 2=SDR.COM
  2635.   05     0104   Program Version           -      62H = Version 6.2
  2636.  
  2637.   06     0105   Sort Type                'X'     'B','C','D','F','X','N'
  2638.   07     0106   Sort Direction           '+'     '+','-'
  2639.   08     0107   Filename Columns         '2'     '1','2','4','6'
  2640.  
  2641.   09     0108   Process ARC Files         0      /A = 0,1
  2642.   10     0109   Erase Console Screen      0      /E = 0,1         (SDC)
  2643.   11     010A   Process Global Dirs       0      /G = 0,1
  2644.   12     010B   Horizontal Sequence       0      /H = 0,1         (SDC)
  2645.   13     010C   System Information        0      /I = 0,1
  2646.   14     010D   Just Display Colors       0      /J = 0,1
  2647.   15     010E   Space in Kilobytes        0      /K = 0,1         (SDC)
  2648.   16     010F   List File Names           0      /L = 0,1
  2649.   17     0110   Display Directory Map     0      /M = 0,1         (SDC)
  2650.   18     0111   Date/Time Format          0      /O = 0,1         (SDC)
  2651.   19     0112   Measure CPU Performance   0      /P = 0,1
  2652.   20     0113   Quick Output              0      /Q = 0,1         (SDC)
  2653.   21     0114   Redirected Output         0      /R = 0,1         (SD)
  2654.   22     0115   System & Hidden Files     1      /S = 0,1         (SDC)
  2655.   23     0116   Totals Lines Only         0      /T = 0,1
  2656.   24     0117   Upper/Lower Case          0      /U = 0,1         (SDC)
  2657.   25     0118   Display Volume Label      0      /V = 0,1         (SDC)
  2658.   26     0119   Reset to 25 Screen Rows   0      /W = 0,1         (SDC)
  2659.   27     011A   Restore Original Screen   0      /Y = 0,1         (SD)
  2660.                 Suppress Activation Msg   0      /Y = 0,1         (SDR)
  2661.   28     011B   Process ZIP Files         0      /Z = 0,1
  2662.  
  2663.   29     011C   Directory FG/BG Colors 11+16*1 I Cyan    on Blue
  2664.   30     011D   System    FG/BG Colors 12+16*0 I Red     on Black
  2665.   31     011E   Hidden    FG/BG Colors 13+16*0 I Magenta on Black
  2666.   32     011F   Read/Only FG/BG Colors  9+16*0 I Blue    on Black
  2667.   33     0120   Archive   FG/BG Colors 14+16*0 I Yellow  on Black
  2668.   34     0121   File      FG/BG Colors 15+16*0 I White   on Black
  2669.   35     0122   ARC File  FG/BG Colors 14+16*1 I Yellow  on Blue
  2670.   36     0123   ZIP File  FG/BG Colors 15+16*1 I White   on Blue
  2671.   37     0124   Size      FG/BG Colors 11+16*0 I Cyan    on Black
  2672.   38     0125   Date      FG/BG Colors 10+16*0 I Green   on Black
  2673.   39     0126   Misc      FG/BG Colors  9+16*0 I Blue    on Black
  2674.   40     0127   Graphics  FG/BG Colors  4+16*0   Red     on Black
  2675.   41     0128   Title     FG/BG Colors  7+16*1   White   on Blue
  2676.   42     0129   Text      FG/BG Colors  2+16*0   Green   on Black
  2677.   43     012A   Info      FG/BG Colors  3+16*0   Cyan    on Black
  2678.   44     012B   Normal    FG/BG Colors  7+16*0   White   on Black
  2679.  
  2680. SD V6.2 User's Guide                                             Page 48
  2681.  
  2682.   45     012C   Directory Mono Attrs    0+16*7   Reverse Video
  2683.   46     012D   System    Mono Attrs    9+16*0 I Underlined
  2684.   47     012E   Hidden    Mono Attrs    1+16*0   Underlined
  2685.   48     012F   Read/Only Mono Attrs    1+16*0   Underlined
  2686.   49     0130   Archive   Mono Attrs   15+16*0 I Intensified
  2687.   50     0131   File      Mono Attrs    7+16*0   Normal Video
  2688.   51     0132   ARC File  Mono Attrs   15+16*0 I Intensified
  2689.   52     0133   ZIP File  Mono Attrs   15+16*0 I Intensified
  2690.   53     0134   Size      Mono Attrs    7+16*0   Normal Video
  2691.   54     0135   Date      Mono Attrs    7+16*0   Normal Video
  2692.   55     0136   Misc      Mono Attrs    7+16*0   Normal Video
  2693.   56     0137   Graphics  Mono Attrs    7+16*0   Normal Video
  2694.   57     0138   Title     Mono Attrs    0+16*7   Reverse Video
  2695.   58     0139   Text      Mono Attrs    7+16*0   Normal Video
  2696.   59     013A   Info      Mono Attrs   15+16*0 I Intensified
  2697.   60     013B   Normal    Mono Attrs    7+16*0   Normal Video
  2698.  
  2699.   61     013C   Hot Key Control Code      4      0-15             (SDR)
  2700.   62     013D   Hot Key Scan Code         1      0-255            (SDR)
  2701.   63     013E   Hot Key String  CTRL-ESCAPE Keys 16 chars,NULL    (SDR)
  2702.   80     014F   Prompt Character          26     0-255            (SDR)
  2703.   81     0150   Dir Buffer Length        1024    512-4096         (SDR)
  2704.   83     0152   File Buffer Length       8192    2560-40960       (SDR)
  2705.   85     0154   Screen Buffer Type        1      1/2=4000/8000    (SDR)
  2706.  
  2707.                           Color Codes
  2708.  
  2709.       0 = Black       1 = Blue        2 = Green       3 = Cyan
  2710.       4 = Red         5 = Magenta     6 = Brown       7 = White
  2711.  
  2712. SD  dynamically  selects  either  the  color  or  monochrome  attributes
  2713. specified  at  the  offsets  in  the  table  above, based on the type of
  2714. video display adaptor being used.
  2715.  
  2716. Once the desired foreground and background colors (attributes) have been
  2717. selected for a screen field, compute the field attribute byte using  the
  2718. formula: ATTRIBUTE = FCOLOR+16*BCOLOR, where FCOLOR and BCOLOR  are  the
  2719. foreground and background colors (attributes), respectively.
  2720.  
  2721. Intensified foreground colors corresponding to the 8 standard colors may
  2722. be  selected  by  adding 8 to the foreground color number.  For example,
  2723. specify foreground color (6+8)=14  to  get  a  foreground  Yellow  color
  2724. instead  of  the  unintensified  Brown.    The blinking  attribute  (for
  2725. foreground characters) may be selected by adding  8  to  the  background
  2726. color number.  However, use of this attribute  is not recommended, since
  2727. it may be distracting.  For a  monochrome  monitor,  selecting  Blue  on
  2728. Black (1+16*0) will cause the screen field to be underlined.
  2729.  
  2730. SD V6.2 User's Guide                                             Page 49
  2731.  
  2732. 9.0  APPENDICES
  2733.  
  2734. 9.1  Error Messages and Return Codes
  2735.  
  2736. The following error messages are displayed and system return  codes  set
  2737. for various conditions which may arise.  An audible tone is generated to
  2738. alert the user of the error (for code 2 and above) in case the output is
  2739. being redirected.  The return codes may be tested using the standard DOS
  2740. IF ERRORLEVEL statement in a .BAT file.
  2741.  
  2742. 0 - One or more matching files were found.
  2743. 1 - No matching files were found.
  2744. 2 - Bad switch or ESCAPE or CTRL-C pressed.
  2745. 3 - Bad drive (doesn't exist or syntax error).
  2746. 4 - Bad path (doesn't exist or syntax error).
  2747. 5 - Bad file specification (syntax error).
  2748. 6 - Bad date (too large or syntax error).
  2749. 7 - Too many directories (when /g is specified).
  2750. 8 - Too many files (partial information displayed).
  2751.  
  2752. If there is insufficient space in the directory and/or file  buffers  to
  2753. hold the specified directories and files, as many entries as will fit in
  2754. the buffers are processed in the order they are selected.
  2755.  
  2756. Other errors which are detected relate to the processing  of  ARC or ZIP
  2757. files.  The first type are standard DOS file I/O error codes  which  can
  2758. occur when opening, reading, or closing files.  The error message is:
  2759.  
  2760. Error <n> on <drive><path><filename>, where <n> is as follows:
  2761.  
  2762. 1 - Invalid function code       5 - Access denied
  2763. 2 - File not found              6 - Invalid handle
  2764. 3 - Path not found             12 - Invalid access value
  2765. 4 - Too many open files
  2766.  
  2767. The only one of these errors which is likely to occur  is  4,  in  which
  2768. case you need to increase the FILES specification in CONFIG.SYS.
  2769.  
  2770. The second type of error is caused by bad data in the header field for a
  2771. file in an ARC or ZIP file, or attempting to process a file with the  /a
  2772. or /z switch which is not an ARC or ZIP file.  The error message is:
  2773.  
  2774. Bad header in <drive><path><filename>
  2775.  
  2776. SD V6.2 User's Guide                                             Page 50
  2777.  
  2778. 9.2  Modification History
  2779.  
  2780. 01-Jun-89 ... V6.2
  2781.  
  2782. Changed /m switch to display graphic directory tree map.
  2783. Changed /p switch to measure CPU performance for /i switch.
  2784. Added /tn switch to request suppression of totals lines.
  2785. Changed EGA Memory to include other types of Video Memory.
  2786. Determine Total Extended RAM from CMOS RAM information and
  2787. display Extended RAM Used, Free, and Total for /i switch.
  2788. Added PC System Type ID to /i for Pre-PS/2 system types.
  2789. Combined Processor Type and Performance on the same line.
  2790. Added display of Screen Size (number of rows and columns).
  2791. Added display of current Video Mode after Adaptor Type.
  2792. Modified to run in a DESQview window without redirection.
  2793. Modified to work correctly with more than 80 screen columns.
  2794. Modified to reset VGA 400 line screen mode if /25 specified.
  2795. Modified to reset video mode 3 if bad video mode is detected.
  2796. Don't display . and .. entries if /l switch is specified.
  2797. Count . and .. entries as files if /sd switch is specified.
  2798. Use character after /r for box border graphics characters.
  2799. Reduced default SDR file buffer size from 10240 to 8192.
  2800.  
  2801. 9.3  Product Support
  2802.  
  2803. This product represents more than a thousand hours of work over  several
  2804. years.  I believe it is a good example of  the  SHAREWARE  concept;  you
  2805. get to try the product without  prior  commitment  and  only  choose  to
  2806. support it if you find it useful.  Many of the  continuing  improvements
  2807. have been implemented in response  to  user  suggestions  and  requests.
  2808. If you find that you continue to use this product once you  have  become
  2809. familiar with it, it is obviously of some value to you;  please  support
  2810. the SHAREWARE concept by registering your copy and sharing the  SD62.ARC
  2811. or SD62.ZIP file with other users.
  2812.  
  2813. The distribution file may be freely copied and distributed  as  long  as
  2814. the only charge is for media  and  reproduction  costs,  etc.  Under  no
  2815. conditions should the program either be sold for a profit or distributed
  2816. in modified  form  without  the  permission  of  the  author.  Site  and
  2817. Corporate licenses are available on request  for  use  in  corporate  or
  2818. government organizations.  The SITE.FRM file  contains  a  Site  License
  2819. Agreement Form.  Special versions are available on request.
  2820.  
  2821. As supplied, the programs in this product are fully functional  with  no
  2822. missing or crippled features.  However, the SHAREWARE concept is  a  two
  2823. way process. The version of the SD program contained in the distribution
  2824. file will display a gentle registration reminder message  after  it  has
  2825. been executed 20 or more times since the operating  system  was  booted.
  2826. Registered users will receive a  version  of  the  program  without  the
  2827. message.  Previously registered users  and  Bulletin  Board  SYSOPs  may
  2828. contact the author for information on removing the  message,  for  their
  2829. private use only.
  2830.  
  2831. SD V6.2 User's Guide                                             Page 51
  2832.  
  2833. In order to keep the size of the distribution file  reasonable,  and  to
  2834. encourage users  to  register  their  copy  of  this  product,  the  SDC
  2835. configuration utility program is only available through  the  mail  when
  2836. you register your copy of SD.  This easy-to-use  program  provides  full
  2837. screen color menus which allow you to change any  of  the  default  sort
  2838. options, screen colors, command line switch  values,  or  other  program
  2839. options in SD or SDR to the defaults you prefer.  Although you can  also
  2840. use the DOS DEBUG program to make these changes by patching  the  SD  or
  2841. SDR files, SDC makes this process much quicker and safer.
  2842.  
  2843. To register your copy of SD, please print and  complete  the  order  and
  2844. registration form contained in the file ORDER.FRM and return it together
  2845. with a contribution of $20.  Use of the order form is  optional;  it  is
  2846. simply included as a convenience to users.  In return, you will  receive
  2847. a disk containing the latest version of all of the SD utility  programs,
  2848. including the SDC configuration program.
  2849.  
  2850. The full Assembly Language source code for the SD, SDR and VSN  programs
  2851. and the BASIC Language source code for the SDC program is available on a
  2852. second disk for an additional  $20.  Obtaining  this  second  disk  will
  2853. enable you to see how the  programs  work,  learn  more  about  assembly
  2854. language programming, or make your own enhancements.
  2855.  
  2856. If you do improve the program, please let me know so  that  the  results
  2857. can be shared with other users.  I prefer to coordinate all  changes  so
  2858. that they are released in  an  orderly  fashion.  Full  source  code  is
  2859. included with all Site Licenses.
  2860.  
  2861. A comprehensive DOS HELP utility is available separately which  provides
  2862. quick, friendly access to complete DOS command reference information for
  2863. DOS 2.0-4.0.  This product eliminates the need to have  several  manuals
  2864. at the computer  when  command  reference  information  is  needed.  The
  2865. data base files are  user  extensible.  The  HELP  programs  and  format
  2866. of  the  data  base  files  were  designed  to be easily updated using a
  2867. standard text editor.  You can even create new HELP data base files  for
  2868. your   favorite   word  processor,  modem  communications   program   or
  2869. programming language.
  2870.  
  2871. The DEMO2.BAT file provides a demonstration of some of the  capabilities
  2872. of  this  product.  The  DOS  HELP  utility  is  also  available  for  a
  2873. contribution of $20.  Please specify whether you want the IBM PC-DOS  or
  2874. ZENITH MS-DOS Version of  the  HELP  Utility.  Site  Licenses  are  also
  2875. available for this product.  This is not a SHAREWARE product and is only
  2876. available through the mail.
  2877.  
  2878. Even if you don't register or formally support  these  products,  please
  2879. share copies of the distribution file with  other  users  and/or  upload
  2880. copies to Computer Bulletin Boards you use.
  2881.  
  2882. Users  who  have  supported   this  product  in  the  past  are  largely
  2883. responsible  for  the  existence  of  the  current  version.  Previously
  2884. registered users can receive the latest version of the SD  Utility  Disk
  2885. or DOS HELP Disk for a $10 contribution, at any time.  I normally supply
  2886. 5.25" 360Kb disks.  If you prefer to receive 3.5"  720Kb  disks,  please
  2887. indicate this on the order form and add $2.50.  If you are ordering 2 or
  2888. more disks and prefer to receive 5.25" 1.2Mb disks, please indicate this
  2889. on the order form (there is no  extra  charge).  I  can  accept  checks,
  2890. money orders and purchase orders.
  2891.  
  2892. SD V6.2 User's Guide                                             Page 52
  2893.  
  2894. You may obtain the latest version of the SD distribution file  from  the
  2895. following Information Services and Bulletin Boards:
  2896.  
  2897. GENIE IBM-PC Software Library
  2898. COMPUSERVE IBM-PC Software Library
  2899. Computer Connections Bulletin Board    (202) 547-2008
  2900.  
  2901. If  you  wish  to  contact  me  with  problem reports,  suggestions  for
  2902. improvements,  and/or  especially  large  financial  donations, I can be
  2903. reached using the information provided below:
  2904.  
  2905. John F. Stetson                 (Home) (301) 946-5615 (8PM-11PM EST)
  2906. 42 Tivoli Lake Court            (Work) (301) 340-4544 (10AM-6PM EST)
  2907. Silver Spring, Md. 20906
  2908.  
  2909. ------------------------------------------------------------------------
  2910.  
  2911. IBM and PC-DOS are trademarks of IBM Corporation.
  2912. MICROSOFT and MS-DOS are trademarks of Microsoft Corporation.
  2913. DESQview is a trademark of Quarterdeck Office Systems.
  2914. SideKick is a trademark of BORLAND International Corporation.
  2915. ARC is a trademark of SEA Corporation.
  2916. PKZIP and PKUNZIP are trademarks of PKWARE Corporation.
  2917. LIST is copyrighted by Vernon D. Buerg.
  2918. CED, PCED and PMAP are copyrighted by C. J. Dunford.
  2919.  
  2920. ------------------------------------------------------------------------
  2921.