home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_ra / rahdr13.arj / RAHDR.DOC next >
Text File  |  1992-05-03  |  28KB  |  892 lines
  1.  
  2.                              ┌────────┐ ┌────────┐
  3.                              │  ┌──┐  │ │  ┌──┐  │
  4.                              │  └──┘ ┌┘ │  └──┘  │
  5.                              │  ┌──┐ └┐ │  ┌──┐  │
  6.                              │  │  │  │ │  │  │  │
  7.                              └──┘  └──┘ └──┘  └──┘
  8.  
  9.         ┌──┐  ┌──┐ ┌───────┐ ┌────────┐ ┌──────┐   ┌───────┐ ┌────────┐
  10.         │  │  │  │ │ ┌─────┘ │  ┌──┐  │ │  ┌─┐ └─┐ │ ┌─────┘ │  ┌──┐  │
  11.         │  └──┘  │ │ └────┐  │  └──┘  │ │  │ └─┐ │ │ └────┐  │  └──┘ ┌┘
  12.         │  ┌──┐  │ │ ┌────┘  │  ┌──┐  │ │  │ ┌─┘ │ │ ┌────┘  │  ┌──┐ └┐
  13.         │  │  │  │ │ └─────┐ │  │  │  │ │  └─┘ ┌─┘ │ └─────┐ │  │  │  │
  14.         └──┘  └──┘ └───────┘ └──┘  └──┘ └──────┘   └───────┘ └──┘  └──┘
  15.  
  16.                                  Version 1.3
  17.  
  18.                      A RemoteAccess utility for file area
  19.                      headers, bulletins, and allfiles list.
  20.  
  21.  
  22.                              (C) Copyright 1992
  23.  
  24.  
  25. ╓────────────────────────────────────────────────────────────────────────────╖
  26. ║ ░░░░░░░ RA HEADER v1.3 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  27. ╙────────────────────────────────────────────────────────────────────────────╜
  28.  
  29.                     Documentation and programming by Dan Roseen
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67. ╓────────────────────────────────────────────────────────────────────────────╖
  68. ║ ░░░░░░░ TABLE OF CONTENTS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  69. ╙────────────────────────────────────────────────────────────────────────────╜
  70.  
  71.  
  72. Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  73.  
  74. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  75.  
  76. Files  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  77.  
  78. Options and Features . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  79.  
  80. Upgrading from RA Header v1.2 to v1.3  . . . . . . . . . . . . . . . . .   5
  81.  
  82. Configuring RA Header  . . . . . . . . . . . . . . . . . . . . . . . . .   6
  83.  
  84. RA Header Operation  . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  85.  
  86. Alternate File List (CD-ROM Support) . . . . . . . . . . . . . . . . . .   9
  87.  
  88. RAHDR.ERR  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  10
  89.  
  90. Errorlevels  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  10
  91.  
  92. Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  93.  
  94. RAHDRDEL.EXE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  95.  
  96. The Future of RA Header  . . . . . . . . . . . . . . . . . . . . . . . .  12
  97.  
  98. Registration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  99.  
  100. Support and Distribution . . . . . . . . . . . . . . . . . . . . . . . .  14
  101.  
  102. Thank You To:  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  103.  
  104. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.                                      Page 2
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. ╓────────────────────────────────────────────────────────────────────────────╖
  130. ║ ░░░░░░░ DISCLAIMER   ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  131. ╙────────────────────────────────────────────────────────────────────────────╜
  132.  
  133. RA Header and it's utilities are provided AS IS.  I give no warranty of any
  134. kind, nor am I responsible for the results of use or misuse of the afore-
  135. mentioned program and utilities.
  136.  
  137.  
  138.  
  139.  
  140. ╓────────────────────────────────────────────────────────────────────────────╖
  141. ║ ░░░░░░░ INTRODUCTION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  142. ╙────────────────────────────────────────────────────────────────────────────╜
  143.  
  144. RA Header is a utility developed for RemoteAccess that will create/modify your
  145. BBS file area listings so they will include a summary of the area's files.
  146. It is very flexible, and can also create a Masterfile (allfiles) list and
  147. File Area Summary bulletins.
  148.  
  149. The headers created are sysop configurable, and act as a guide and summary to
  150. your users.  An example of a FILES.BBS header created by RA Header (extended
  151. ASCII style) is as shown:
  152.  
  153.  ═════════════════════════════════════════════════════════════════════════════
  154.                                  The Night Owl                 Registered
  155.                                 Pictures - GIF                 RA Header v1.3
  156.  ─────────────────────────────────────────────────────────────────────────────
  157.        Number of Files:         133         Last update:   05-03-92  02:05 AM
  158.        Number of Bytes:    13471413         Access level:         5
  159.  ───────────┬───────┬─────────┬───┬───────────────────────────────────────────
  160.   File Name │  Size │  Date   │D/L│ File Description
  161.  ═══════════╧═══════╧═════════╧═══╧═══════════════════════════════════════════
  162.  
  163.  
  164. You will find RA Header very sysop-friendly.  A setup program has been
  165. included that will configure RA Header and show you it's many features.  The
  166. setup program has on-screen help and examples to guide you.
  167.  
  168. RA Header was written using Borland's Turbo C v2.0.  It requires an IBM PC,
  169. AT, or 100% compatible computer.  This version has been tested with
  170. RemoteAccess v1.10, and v1.11, under MS-DOS v5.0, and DESQview v2.26, v2.42,
  171. and QEMM v6.02.  This version of the program is untested with lower versions
  172. of DOS.
  173.  
  174.  
  175.  
  176.                                      Page 3
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186. ╓────────────────────────────────────────────────────────────────────────────╖
  187. ║ ░░░░░░░ FILES        ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  188. ╙────────────────────────────────────────────────────────────────────────────╜
  189.  
  190. RAHDR.DOC . . . . . . . . . . . . .  This documentation text file
  191. RAHDR.EXE . . . . . . . . . . . . .  RA Header program
  192. RAHDR.HIS . . . . . . . . . . . . .  RA Header history of changes text file
  193. RAHDR.REG . . . . . . . . . . . . .  RA Header registration form
  194. RAHDR.TOP . . . . . . . . . . . . .  Example file for top of allfiles list
  195. RAHDRCFG.EXE  . . . . . . . . . . .  RA Header configuration program
  196. RAHDRDEL.EXE  . . . . . . . . . . .  RA Header delete header program
  197.  
  198.  
  199. ╓────────────────────────────────────────────────────────────────────────────╖
  200. ║ ░░░░░░░ OPTIONS AND FEATURES ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  201. ╙────────────────────────────────────────────────────────────────────────────╜
  202.  
  203.   ■ Very fast!  If you want a fast & nice-looking allfiles list ..
  204.  
  205.   ■ Alternate Files List path to support read-only devices (e.g. CD-ROM).
  206.  
  207.   ■ Can reside in any directory, and on any drive.
  208.  
  209.   ■ Specific file areas may be excluded from RA Header.
  210.  
  211.   ■ Creates backups of FILES.BBS that can optionally be kept or deleted.
  212.  
  213.   ■ Supports up to 255 characters per text line in FILES.BBS.
  214.  
  215.   ■ Header format may be hatched, ASCII, or Extended ASCII.
  216.  
  217.   ■ .ASC/.ANS File Areas Summary bulletins can optionally be created.
  218.  
  219.   ■ Bulletin format may be hatched, ASCII, or Extended ASCII.
  220.  
  221.   ■ A Masterfile (allfiles) list can be created when RA Header is run.
  222.  
  223.   ■ New files can be flagged in your masterfile list.  The number of days
  224.     old for new files is configurable from 0 to 99.
  225.  
  226.   ■ A file (example: your advertisement) may be automatically attached to
  227.     the top of your Masterfile list.
  228.  
  229.   ■ Sysop-friendly RA Header setup utility with help and examples.
  230.  
  231.  
  232.  
  233.  
  234.  
  235.                                      Page 4
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246. ╓────────────────────────────────────────────────────────────────────────────╖
  247. ║ ░░░░░░░ OPTIONS AND FEATURES (continued) ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  248. ╙────────────────────────────────────────────────────────────────────────────╜
  249.  
  250.   ■ DESQview-aware.
  251.  
  252.       ■ RA Header setup uses BIOS screen writes and shares CPU time slices.
  253.       ■ RA Header uses BIOS screen writes.
  254.  
  255.   ■ Attaches your RA Header bulletin to the end of your Masterfile list.
  256.  
  257.   ■ Extensive error checking reports warnings and errors (if any) on-screen
  258.     and to an error log.
  259.  
  260.   ■ Sysop's screen during execution features:
  261.  
  262.       ■ Summary of file areas including:
  263.  
  264.           ■ File area number and name.
  265.           ■ Number of bytes and files in each file area.
  266.           ■ Total bytes and files of all file areas.
  267.  
  268.       ■ Number of new files in each file area (if masterfile list is created)
  269.  
  270.       ■ Support for whatever text mode you run your BBS in (25/43/50 line)
  271.         in color without requiring DVANSI (if in DESQview) or ANSI.SYS.
  272.  
  273.   ■ Automatic configuration for those that are new to using RA Header, as
  274.     well as those who are upgrading from the last version of RA Header.
  275.  
  276.   ■ RA Header's errorlevels can inform you of specific system concerns.
  277.  
  278.  
  279.  
  280. ╓────────────────────────────────────────────────────────────────────────────╖
  281. ║ ░░░░░░░ UPGRADING FROM RA HEADER v1.2 TO v1.3 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  282. ╙────────────────────────────────────────────────────────────────────────────╜
  283.  
  284. If you are upgrading RA Header v1.2 to v1.3 you will just have to run v1.3 of
  285. the configuration program RAHDRCFG.EXE to automatically upgrade to v1.3.
  286. Thank you for your support!
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.                                      Page 5
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306. ╓────────────────────────────────────────────────────────────────────────────╖
  307. ║ ░░░░░░░ CONFIGURING RA HEADER ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  308. ╙────────────────────────────────────────────────────────────────────────────╜
  309.  
  310. RAHDRCFG.EXE is included to configure RA Header to your liking.  You will see
  311. online help and examples for each option.
  312.  
  313. A configuration file (RAHDR.CFG) is created or modified in the current
  314. directory when RAHDRCFG is run.  You can use RAHDRCFG.EXE or a text editor to
  315. modify RAHDR.CFG.  For those who wish to use a text editor to edit the
  316. configuration file, the format of RAHDR.CFG must be in the format shown below:
  317.  
  318. (I suggest you run RAHDRCFG.EXE.  It will create a RAHDR.CFG file you can use
  319.  for a template if you still want to use an editor):
  320.  
  321. Line 1:  RA Header version number.
  322. Line 2:  RA Header registration number.
  323. Line 3:  Sysop name.           (0-35 characters)
  324. Line 4:  BBS name.             (0-30 characters)
  325. Line 5:  RA directory.
  326. Line 6:  Alternate files path.
  327. Line 7:  Missing file string.  (0-10 characters)
  328. Line 8:  File areas you wish to exclude.  (Example: 2,5,8)
  329. Line 9:  Keep backups   (1 = keep, 0 = don't keep)
  330. Line 10: Header style   (1 = hatched, 2 = ASCII, 3 = extended ASCII)
  331. Line 11: Bulletin style (1 = hatched, 2 = ASCII, 3 = extended ASCII)
  332. Line 12: ASCII bulletin.
  333.          Note: This file will also automatically get appended to the bottom of
  334.          your masterfiles list.  Leave blank if you don't want this bulletin.
  335. Line 13: ANSI bulletin.
  336.          Note: Leave blank if you don't want this bulletin.
  337. Line 14: Masterfiles (allfiles) list.
  338. Line 15: File for top of masterfiles list.
  339.          Note: This file will automatically be attached to the top of your
  340.          masterfiles list.  Leave blank if you don't want to use this file.
  341. Line 16: Number of days old for new files.  The number of days old can be
  342.          0 to 99.  Files that are this many days old or less will be flagged
  343.          with a '*' character in your masterfiles list.
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.                                      Page 6
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366. ╓────────────────────────────────────────────────────────────────────────────╖
  367. ║ ░░░░░░░ CONFIGURING RA HEADER (continued) ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  368. ╙────────────────────────────────────────────────────────────────────────────╜
  369.  
  370. Example:
  371. ────────
  372. 1.3
  373. 0
  374. Dan Roseen
  375. The Night Owl
  376. C:\RA
  377. C:\RA\CDROMLST
  378. <MISSING>
  379. 2,18
  380. 1
  381. 3
  382. 3
  383. C:\RA\TXTFILES\RAHDR.ASC
  384. C:\RA\TXTFILES\RAHDR.ANS
  385. C:\RA\RAHDR.ALL
  386. C:\RA\RAHDR.TOP
  387. 30
  388.  
  389.  
  390. RAHDR.CFG must be in the same directory that RA Header is run from unless it
  391. is supplied as an argument to RA Header.
  392.  
  393. Examples:
  394. ─────────
  395.  
  396. Loading and running RA Header specifying an RAHDR.CFG path:
  397. C:\RA\RAHDR>rahdr c:\misc\rahdr.cfg
  398.  
  399. Loading and running RA Header without specifying an RAHDR.CFG path:
  400. C:\RA\RAHDR>rahdr
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.                                      Page 7
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428. ╓────────────────────────────────────────────────────────────────────────────╖
  429. ║ ░░░░░░░ RA HEADER OPERATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  430. ╙────────────────────────────────────────────────────────────────────────────╜
  431.  
  432. RA Header will first retrieve the configuration options you selected when
  433. running RAHDRCFG.EXE.  Then it reads RemoteAccess's FILES.RA file to retrieve
  434. the following information:
  435.                             ■ Number of file areas
  436.                             ■ File area names
  437.                             ■ Minimum security for each file area.
  438.                             ■ File area locations
  439.  
  440. It will then proceed to the first file area to build the FILES.BBS file
  441. (keeps a backup FILES.BAK unless asked not to).  If a file area was excluded
  442. using RAHDRCFG, RA Header will simply skip this file area and proceed to the
  443. next.
  444.  
  445. As it processes the file areas, you will see a summary of it's progress on
  446. your local screen.
  447.  
  448. If a file is missing, it will be counted as a file in that area, but with
  449. 0 bytes in length.  If a Masterfiles list is being created, the missing
  450. file will use the Missing File String you specified when you ran RA Header's
  451. configuration program RAHDRCFG.EXE.
  452.  
  453. Bulletins and Masterfiles list (if selected with RAHDRCFG) will be created
  454. at the same time the headers are being created/updated for your different
  455. file areas.
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.                                      Page 8
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487. ╓────────────────────────────────────────────────────────────────────────────╖
  488. ║ ░░░░░░░ ALTERNATE FILE LIST (CD-ROM SUPPORT) ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  489. ╙────────────────────────────────────────────────────────────────────────────╜
  490.  
  491. RemoteAccess supports read-only devices like CD-ROMs by providing an alternate
  492. file list directory for FILES.BBS files (See your RemoteAccess documentation,
  493. earlier versions of RemoteAccess such as v0.04 do not support this).
  494.   
  495. RA Header supports RemoteAccess's alternate file list option and therefore
  496. supports CD-ROMs, and will make the FILES.BBS headers, a Master Filelist,
  497. and bulletins just as it does with any normal file area.
  498.  
  499. Your alternate file list directory must be on your hard-disk for RA Header
  500. to support your CD.
  501.  
  502. If your CD has FILES.BBS files already in it's file areas, you will want to
  503. copy these FILES.BBS files to your hard-disk and name them FILES.n (where 'n'
  504. is the file area number).  Set your alternate file list directory for
  505. RemoteAccess and RA Header to this hard-disk directory by using
  506. RemoteAccess's RACONFIG.EXE and RA Header's RAHDRCFG.EXE.
  507.  
  508. Since CDs are read-only, and are not as fast as hard-disks, you may want to
  509. create a separate RA Header configuration file for a one-time run through
  510. these file areas with RA Header.
  511.  
  512. When you request RA Header to keep backups of FILES.BBS files, the backups
  513. that are in the alternate file list directory will use the following naming
  514. convention:
  515.                     Standard file list:  FILES.n
  516.                       Backup file list:  FILESn.BAK
  517.  
  518.                    (where 'n' is the file area number)
  519.  
  520. The naming convention for the backup file lists was chosen for the following
  521. reasons:
  522.  
  523.    ■ Identifies the file area number for each backup file.
  524.  
  525.    ■ Enables you to easily group the current and backup FILES.BBS files with
  526.      a directory sorter.
  527.  
  528.    ■ Enables you to do a quick deletion of all backup files (*.BAK).
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.                                      Page 9
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543. ╓────────────────────────────────────────────────────────────────────────────╖
  544. ║ ░░░░░░░ RAHDR.ERR    ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  545. ╙────────────────────────────────────────────────────────────────────────────╜
  546.  
  547. RA Header makes extensive error/warning checks during it's operation.  RA
  548. Header will create or append to a file called RAHDR.ERR whenever it encounters
  549. an error or warning.  RAHDR.ERR will be written to the current working
  550. directory.  You may delete this file when you don't want it anymore.  Any
  551. errors/warnings encountered will also be displayed on the sysop's screen
  552. when running RA Header.
  553.  
  554. Errors are problems that are critical to running RA Header (example: RAHDR.CFG
  555. not found).  RA Header will exit when it encounters an error condition.
  556.  
  557. Warnings are problems that will affect the performance of RA Header (example:
  558. insufficient disk space for FILES.BAK).  RA Header will not continue with the
  559. operation that produced the warning but will move on to the next task.
  560.  
  561.  
  562. ╓────────────────────────────────────────────────────────────────────────────╖
  563. ║ ░░░░░░░ ERRORLEVELS  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  564. ╙────────────────────────────────────────────────────────────────────────────╜
  565.  
  566. Programs using errorlevels can be very useful for alarming the sysop of
  567. system problems.  For example, you can use RA Header's errorlevels to write
  568. to a file that can only be seen by you when you log in.  It can then inform
  569. you of many possible system problems on your next login (example: a moved file
  570. area that didn't have the file area path updated with RACONFIG.EXE).
  571.  
  572. RA Header will produce errorlevels depending on the success of it's execution.
  573. One of three different errorlevels will be provided depending on whether an
  574. error, warning, or no problem was encountered (see RAHDR.ERR section for
  575. details).
  576.  
  577. Errorlevels are:   0 = NO PROBLEM, 1 = WARNING, 2 = ERROR
  578.  
  579. An example batch file just for demonstration:
  580.  
  581. rahdr
  582. if errorlevel 2 goto Error
  583. if errorlevel 1 goto Warning
  584. echo No Problem
  585. goto end
  586.  
  587. :Error
  588. echo Error
  589. goto end
  590.  
  591. :Warning
  592. echo Warning
  593.  
  594. :end
  595.                                      Page 10
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604. ╓────────────────────────────────────────────────────────────────────────────╖
  605. ║ ░░░░░░░ SPECIFICATIONS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  606. ╙────────────────────────────────────────────────────────────────────────────╜
  607.  
  608. Every BBS system is different, so some RA Header specifications and limits
  609. are shown to help ensure that RA Header will meet your system requirements.
  610.  
  611. If you are concerned about any of these specifications, or have exceeded
  612. or are approaching these values, please let me know so I can work on a
  613. solution.  Thank you.
  614.  
  615.            Files/Area:         65,535
  616.            Bytes/Area:  4,294,967,295
  617.       Files/All Areas:         65,535
  618.       Bytes/All Areas:  4,294,967,295
  619.        New Files/Area:         32,767
  620.   New Files/All Areas:         32,767
  621.  
  622.      RAHDR.EXE Memory:  39K  (RA Header v1.2 was 38K)
  623.   RAHDRCFG.EXE Memory:  53K  (RA Header v1.2 was 78K)
  624.   RAHDRDEL.EXE Memory:  23K  (RA Header v1.2 was 22K)
  625.  
  626.      RAHDR.EXE Screen:  BIOS output
  627.   RAHDRCFG.EXE Screen:  BIOS output if in DESQview, else console output
  628.   RAHDRDEL.EXE Screen:  BIOS output
  629.  
  630. DESQview CPU Sharing?:  RAHDRCFG.EXE = Yes, RAHDR.EXE = No, RAHDRDEL.EXE = No
  631.  
  632. Note: Speed tests shown here demonstrate the progress made in this version.
  633.       Your system will very likely have far different actual results.
  634.  
  635. CD-ROM SPEED TEST
  636. ─────────────────
  637.  RAHDR.EXE v1.2:  approx. 2.45 files/second (146.97 files/minute)
  638.  RAHDR.EXE v1.3:  9.68 files/second (580.76 files/minute)
  639.   Test Computer:  386/40Mhz, 64K cache, 380ms CD-ROM drive
  640. Test Conditions:  39 file areas,  187,065,046 bytes, 5585 files, updating
  641.                   FILES.BBS headers, creating Allfiles list, and ASC & ANS
  642.                   bulletins.  (approx. 38 minutes    for v1.2)
  643.                               (9 minutes, 37 seconds for v1.3)
  644.                   
  645. HARD-DISK SPEED TEST
  646. ────────────────────
  647.  RAHDR.EXE v1.2:  41.38 files/second (2,482.76 files/minute)
  648.  RAHDR.EXE v1.3:  50.00 files/second (3,000.00 files/minute)
  649.   Test Computer:  386/33Mhz, 64K cache, 15ms hard-drive
  650. Test Conditions:  18 file areas,  102,272,952 bytes, 1200 files, updating
  651.                   FILES.BBS headers, creating Allfiles list, and ASC & ANS
  652.                   bulletins.  (29 seconds for v1.2)
  653.                               (24 seconds for v1.3)
  654.  
  655.                                      Page 11
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665. ╓────────────────────────────────────────────────────────────────────────────╖
  666. ║ ░░░░░░░ RAHDRDEL.EXE ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  667. ╙────────────────────────────────────────────────────────────────────────────╜
  668.  
  669. RAHDRDEL.EXE is a header delete for FILES.BBS files that contain headers
  670. from RA Header v1.0 to v1.3.
  671.  
  672. It's primary purpose at this time is to give those people who are interested
  673. in evaluating RA Header more assurance that they can easily go back to their
  674. old FILES.BBS files if they desire (even though they can optionally keep
  675. backup files).
  676.  
  677. Since (see "THE FUTURE OF RA HEADER" section) sysop-customized headers
  678. are planned, it is also expected that a future version of this program will
  679. aid in the transition to a version of RA Header that will set new header
  680. template standards for fully sysop-customized headers.  It will still be able
  681. to delete headers built by previous versions of RA Header.
  682.  
  683. RAHDRDEL.EXE acts much like the RA Header program itself, in that it reads
  684. RA Header's configuration file and uses that information in determining
  685. what needs to be done (e.g. alternate file list directory, excluded areas,
  686. RA directory, etc.).
  687.  
  688. It also reports with errorlevels in the same fashion as RA Header but does
  689. not produce an error log file.
  690.  
  691.  
  692. ╓────────────────────────────────────────────────────────────────────────────╖
  693. ║ ░░░░░░░ THE FUTURE OF RA HEADER ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  694. ╙────────────────────────────────────────────────────────────────────────────╜
  695.  
  696. In future versions, I hope to:
  697.  
  698.   ■ Provide an option to have fully sysop-customized header styles.
  699.     (A major portion of v1.2 was reconstructed for this v1.3 for two reasons.
  700.      First, to increase RA Header's speed.  Second, to have the program built
  701.      in a manner that will accomodate my plans for sysop-customized headers.)
  702.        ■ Provide a FILES.BBS header editor/viewer/simulator to build
  703.          custom header templates.
  704.   ■ Provide additional options for FILES.BBS files and Masterfiles lists.
  705.   ■ Increase RA Header's speed and efficiency.  This version reduced execution
  706.     time dramatically (depending on media, see SPECIFICATIONS section)
  707.   ■ Change sysop summary during execution.  This will also have an indicator
  708.     of progress (desired for CD-ROM use).
  709.   ■ Incorporate some of your good suggestions!
  710.  
  711.  
  712.  
  713.  
  714.  
  715.                                      Page 12
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727. ╓────────────────────────────────────────────────────────────────────────────╖
  728. ║ ░░░░░░░ REGISTRATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  729. ╙────────────────────────────────────────────────────────────────────────────╜
  730.  
  731. Please support shareware!
  732.  
  733. You are granted permission to evaluate RA Header for a period of 30 days.
  734. After this evaluation period a $10.00 (US funds) registration fee is required.
  735. If you do not plan to register, then remove RA Header and it's associated
  736. files from use.
  737.  
  738. Upon receipt of your registration fee, a registration number will be sent to
  739. you.  Use this registration number to register your copy of RA Header by using
  740. RAHDRCFG.EXE.
  741.  
  742. RA Header, as an unregistered copy, is not crippled in any way.  Registered
  743. owners will receive their registration number that will do the following:
  744.  
  745.   ■ Replace "UNREGISTERED" from the file area headers to "Registered"
  746.  
  747.   ■ Replace the phrase:     "Registered to:  UNREGISTERED"
  748.                   with:     "Registered to:  'your_sysop_name'"
  749.     (in the bulletins)
  750.  
  751.  
  752. Your registration is valid for all future versions of RA Header.
  753.  
  754. Please use the file RAHDR.REG to send in your registration information.  Send
  755. your RAHDR.REG information, plus a $10 check or money order (US funds) to:
  756.  
  757.                               Dan Roseen
  758.                               P.O. Box 5695
  759.                               Kent, WA  98064-5695
  760.  
  761. Please make checks or money order payable to Dan Roseen.
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.                                      Page 13
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783. ╓────────────────────────────────────────────────────────────────────────────╖
  784. ║ ░░░░░░░ SUPPORT AND DISTRIBUTION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  785. ╙────────────────────────────────────────────────────────────────────────────╜
  786.  
  787. Updates and/or new releases of RA Header can be downloaded or file-requested
  788. from my BBS, The Night Owl (shown below).  If you are logging in, you will
  789. have to fill out a newuser questionnaire.  Once you have done this you will
  790. have enough access to download RA Header without complete user verification.
  791. You may leave your comments, questions, and suggestions to Dan Roseen
  792. (or Sysop) if I'm not available for chat.
  793.  
  794. If you are experiencing problems, call The Night Owl BBS or write me and
  795. include the following information:
  796.  
  797.   ■ Explanation of the problem.     ■ RAHDR.CFG and RAHDR.ERR files.
  798.   ■ RA Header registration number.  ■ AUTOEXEC.BAT and CONFIG.SYS files.
  799.  
  800.  
  801. You may contact the following system:
  802.  
  803. Support and Distribution
  804. ────────────────────────
  805. Sysop:       Dan Roseen
  806. BBS:         The Night Owl
  807. Fidonet:     1:343/102
  808.  
  809. Login:       (206)631-4949       24 Hrs.      Kent, WA - USA
  810.              1200/2400
  811.  
  812. Mail/FREQ:   (206)631-1752  1:343/102         (this number is not for login)
  813.              USRobotics DS HST/V.32bis/V.42bis
  814.  
  815. Comment:     For downloading latest version:  Download RAHDR*.ZIP
  816.                         For file-requesting:  Request the magic name "RAHDR"
  817.                                               or request RAHDR*.ZIP
  818.  
  819. Distribution (also Beta-Site)
  820. ─────────────────────────────
  821. Sysop:       Paul Giesenhagen
  822. BBS:         The Goose's Nest
  823. Fidonet:     1:280/46
  824.  
  825. Login/FREQ:  (816)587-0777       24 Hrs.      Kansas City, MO - USA
  826.              9600 V.32bis
  827.  
  828. Login:       (816)587-3373       24 Hrs.
  829.              1200/2400
  830.  
  831. Comment:     For downloading latest version:  Download RAHDR*.ZIP
  832.                         For file-requesting:  Request the magic name "RAHDR"
  833.                                               or request RAHDR*.ZIP
  834.  
  835.                                      Page 14
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848. ╓────────────────────────────────────────────────────────────────────────────╖
  849. ║ ░░░░░░░ THANK YOU TO: ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  850. ╙────────────────────────────────────────────────────────────────────────────╜
  851.  
  852. Denise Roseen, my wife, for her encouragement and for helping me set aside
  853. time to work on this project.
  854.  
  855. David Roseen, my 1-1/2 year old son, for going to bed by 10 PM so I could
  856. do some late-night programming.
  857.  
  858. Paul Giesenhagen, sysop of The Goose's Nest (see distribution), for his
  859. willingness to beta test RA Header v1.3 and for his comments and
  860. suggestions.  I also thank Paul for CD-ROM testing RA Header v1.3.
  861.  
  862. Jim Radford, a long-time friend, for his suggestion to make RA Header a
  863. versatile program that others can use.  Also, for suggesting I build a
  864. configuration setup program to go with it.  I also thank Jim for use of
  865. his BBS system for LANtastic and CD-ROM testing for RA Header v1.2.
  866.  
  867. Richard Merit, for his willingness to beta test RA Header v1.0 and for his
  868. comments and suggestions.
  869.  
  870. Scott Parks, for his willingness to beta test RA Header v1.0 and for his
  871. comments and suggestions.
  872.  
  873. All registered owners of RA Header!
  874.  
  875.  
  876. ╓────────────────────────────────────────────────────────────────────────────╖
  877. ║ ░░░░░░░ ACKNOWLEDGEMENTS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  878. ╙────────────────────────────────────────────────────────────────────────────╜
  879.  
  880. Turbo C v2.0 is a trademark of Borland International, Inc.
  881. RemoteAccess is a trademark of Continental Software.
  882. DESQview is a trademark of Quarterdeck Office Systems.
  883. QEMM is a trademark of Quarterdeck Office Systems.
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.                                      Page 15
  892.