home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Black Box 4
/
BlackBox.cdr
/
bbs_ra
/
rahdr11.arj
/
RAHDR.DOC
next >
Wrap
Text File
|
1991-11-02
|
20KB
|
653 lines
┌────────┐ ┌────────┐
│ ┌──┐ │ │ ┌──┐ │
│ └──┘ ┌┘ │ └──┘ │
│ ┌──┐ └┐ │ ┌──┐ │
│ │ │ │ │ │ │ │
└──┘ └──┘ └──┘ └──┘
┌──┐ ┌──┐ ┌───────┐ ┌────────┐ ┌──────┐ ┌───────┐ ┌────────┐
│ │ │ │ │ ┌─────┘ │ ┌──┐ │ │ ┌─┐ └─┐ │ ┌─────┘ │ ┌──┐ │
│ └──┘ │ │ └────┐ │ └──┘ │ │ │ └─┐ │ │ └────┐ │ └──┘ ┌┘
│ ┌──┐ │ │ ┌────┘ │ ┌──┐ │ │ │ ┌─┘ │ │ ┌────┘ │ ┌──┐ └┐
│ │ │ │ │ └─────┐ │ │ │ │ │ └─┘ ┌─┘ │ └─────┐ │ │ │ │
└──┘ └──┘ └───────┘ └──┘ └──┘ └──────┘ └───────┘ └──┘ └──┘
Version 1.1
A RemoteAccess utility for file area
headers, bulletins, and allfiles list.
(C) Copyright 1991
╓────────────────────────────────────────────────────────────────────────────╖
║ ░░░░░░░ RA HEADER v1.1 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
╙────────────────────────────────────────────────────────────────────────────╜
Documentation and programming by Dan Roseen
╓────────────────────────────────────────────────────────────────────────────╖
║ ░░░░░░░ TABLE OF CONTENTS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
╙────────────────────────────────────────────────────────────────────────────╜
Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Options and Features . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Upgrading from RA Header v1.0 to v1.1 . . . . . . . . . . . . . . . . . 5
Configuring RA Header . . . . . . . . . . . . . . . . . . . . . . . . . 5
RA Header Operation . . . . . . . . . . . . . . . . . . . . . . . . . . 7
RAHDR.ERR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Errorlevels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Registration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Support and Distribution . . . . . . . . . . . . . . . . . . . . . . . . 10
Thank You To: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Page 2
╓────────────────────────────────────────────────────────────────────────────╖
║ ░░░░░░░ DISCLAIMER ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
╙────────────────────────────────────────────────────────────────────────────╜
RA Header and it's utilities are provided AS IS. I give no warranty of any
kind, nor am I responsible for the results of use or misuse of the afore-
mentioned program and utilities.
╓────────────────────────────────────────────────────────────────────────────╖
║ ░░░░░░░ INTRODUCTION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
╙────────────────────────────────────────────────────────────────────────────╜
RA Header is a utility developed for RemoteAccess that will create/modify your
BBS file area listings so they will include a summary of the area's files.
The headers created are sysop configurable and act as a guide and summary to
your users. An example of a FILES.BBS header created by RA Header (extended
ASCII style) is as shown:
═════════════════════════════════════════════════════════════════════════════
The Night Owl
Pictures - GIF RA Header v1.1
─────────────────────────────────────────────────────────────────────────────
Number of Files: 133 Last update: 11-02-91 02:05 AM
Number of Bytes: 13471413 Access level: 5
───────────┬───────┬─────────┬───┬───────────────────────────────────────────
File Name │ Size │ Date │D/L│ File Description
═══════════╧═══════╧═════════╧═══╧═══════════════════════════════════════════
RA Header is very flexible and has options for creating a Masterfile
(allfiles) list and File Area Summary bulletins.
You will find RA Header very sysop friendly. A setup program has been
included that will configure RA Header and show you it's many features. The
setup program has on-screen help and examples to guide you.
RA Header was written using Borland's Turbo C v2.0. It requires an IBM PC,
AT, or 100% compatible computer. It has been tested with RemoteAccess v1.01,
MS-DOS v5.0, and DESQview v2.26. This version of the program is untested with
lower versions of DOS.
Page 3
╓────────────────────────────────────────────────────────────────────────────╖
║ ░░░░░░░ FILES ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
╙────────────────────────────────────────────────────────────────────────────╜
RAHDR.DOC . . . . . . . . . . . . . This documentation text file
RAHDR.EXE . . . . . . . . . . . . . RA Header program
RAHDR.HIS . . . . . . . . . . . . . RA Header history of changes text file
RAHDR.REG . . . . . . . . . . . . . RA Header registration form
RAHDR.TOP . . . . . . . . . . . . . Example file for top of allfiles list
RAHDRCFG.EXE . . . . . . . . . . . Setup utility for RA Header
╓────────────────────────────────────────────────────────────────────────────╖
║ ░░░░░░░ OPTIONS AND FEATURES ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
╙────────────────────────────────────────────────────────────────────────────╜
■ Can reside in any directory.
■ Specific file areas may be excluded from RA Header.
■ Creates backups of FILES.BBS that can optionally be kept or deleted.
■ Supports up to 256 characters per text line in FILES.BBS.
■ Header format may be hatched, ASCII, or Extended ASCII.
■ A file areas summary bulletin can be created when RA Header is run.
■ Bulletin format may be hatched, ASCII, or Extended ASCII.
■ A Masterfile (allfiles) list can be created when RA Header is run.
■ New files can be flagged in your masterfile list. The number of days old
for new files is selectable from 0 to 99.
■ A file (example: your advertisement) may be automatically attached to the
top of your Masterfile list.
■ Your RA Header bulletin will be automatically attached to the end of your
Masterfile list.
■ Sysop friendly RA Header setup utility with help and examples.
■ RA Header setup utility is DESQview-aware.
■ Extensive error checking reports warnings and errors (if any) on-screen
and to an error log.
■ Reads RemoteAccess configuration files to retrieve necessary information.
■ Sysop's screen during execution features:
■ Summary of file areas including:
■ File area number and name.
■ Number of bytes and files in each file area.
■ Total bytes and files of all file areas.
■ Support for whatever text mode you run your BBS in (25/43/50 line)
in color without requiring DVANSI (if in DESQview) or ANSI.SYS.
■ Automatic upgrade from previous RA Header version by running the RA Header
configuration program.
■ RA Header's errorlevels can inform you of specific system concerns.
Page 4
╓────────────────────────────────────────────────────────────────────────────╖
║ ░░░░░░░ UPGRADING FROM RA HEADER v1.0 TO v1.1 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
╙────────────────────────────────────────────────────────────────────────────╜
If you are upgrading RA Header v1.0 to v1.1 you will just have to run v1.1 of
the configuration program RAHDRCFG.EXE and 'Save' to complete the upgrade.
Thank you for your support!
╓────────────────────────────────────────────────────────────────────────────╖
║ ░░░░░░░ CONFIGURING RA HEADER ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
╙────────────────────────────────────────────────────────────────────────────╜
RAHDRCFG.EXE is included to configure RA Header to your liking. You will see
online help and examples for each option.
A configuration file (RAHDR.CFG) is created or modified in the current
directory when RAHDRCFG is run. You can use RAHDRCFG.EXE or a text editor to
modify RAHDR.CFG. For those who wish to use a text editor to edit the
configuration file, the format of RAHDR.CFG must be in the following format
(I suggest you run RAHDRCFG.EXE at least once to try it. It will create a
RAHDR.CFG file you can use for a template if you still want to use an editor):
Line 1: RA Header version number.
Line 2: Your RA Header registration number.
Line 3: Your RA directory (include drive letter).
Line 4: File areas you wish to exclude. (Example: 2,5,8)
Note: You can exclude more file areas than RAHDRCFG.EXE permits
by using a text editor (I'm not trying to encourage using an editor)
Line 5: Keep backups (1 = keep, 0 = don't keep)
Line 6: Header style (1 = hatched, 2 = ASCII, 3 = extended ASCII)
Line 7: Bulletin style (1 = hatched, 2 = ASCII, 3 = extended ASCII)
Line 8: ASCII bulletin (include drive letter).
Note: This file will also automatically get appended to the bottom of
your masterfiles list. Leave blank if you don't want this bulletin.
Line 9: ANSI bulletin (include drive letter)
Note: Leave blank if you don't want this bulletin.
Line 10: Masterfiles (allfiles) list (include drive letter).
Line 11: File for top of masterfiles list.
Note: This file will automatically be attached to the top of your
masterfiles list. Leave blank if you don't want to use this file.
Line 12: Number of days old for new files. The number of days old can be
0 to 99. Files that are this many days old or less will be flagged
with a '*' character in your masterfiles list.
Page 5
Example:
────────
1.1
0
C:\RA
1
3
3
C:\RA\RAHDR.ASC
C:\RA\RAHDR.ANS
C:\RA\RAHDR.ALL
C:\RA\RAHDR.TOP
30
RAHDR.CFG must be in the same directory that RA Header is run from unless it
is supplied as an argument to RA Header.
Examples:
─────────
Loading and running RA Header specifying an RAHDR.CFG path:
C:\RA\RAHDR>rahdr c:\misc\rahdr.cfg
Loading and running RA Header without specifying an RAHDR.CFG path:
C:\RA\RAHDR>rahdr
Page 6
╓────────────────────────────────────────────────────────────────────────────╖
║ ░░░░░░░ RA HEADER OPERATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
╙────────────────────────────────────────────────────────────────────────────╜
RA Header will read your CONFIG.RA and FILES.RA files to retrieve the
following information:
■ Sysop name (when RA Header is registered)
■ BBS name
■ Missing files string
■ Number of file areas
■ File area names
■ Minimum security for each file area.
■ File area locations
It will then retrieve the configuration options you selected when running
RAHDRCFG.EXE and proceed to the first file area to build the FILES.BBS file
(makes a backup FILES.BAK first unless asked not to). If a file area was
excluded using RAHDRCFG, RA Header will simply skip this file area and proceed
to the next.
If a file is missing, it will be counted as a file in that area, but with
0 kilobytes in length. If a Masterfiles list is being created, the missing
file will use the missing file string you have chosen while running
RACONFIG.EXE.
Bulletins and Masterfiles list (if selected with RAHDRCFG) will be created
at the same time the headers are being created/updated for your different
file areas.
Page 7
╓────────────────────────────────────────────────────────────────────────────╖
║ ░░░░░░░ RAHDR.ERR ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
╙────────────────────────────────────────────────────────────────────────────╜
RA Header makes extensive error/warning checks during it's operation. RA
Header will create or append to a file called RAHDR.ERR whenever it encounters
an error or warning. RAHDR.ERR will be written to the current working
directory. You may delete this file when you don't want it anymore. Any
errors/warnings encountered will also be displayed on the sysop's screen
when running RA Header.
Errors are problems that are critical to running RA Header (example: RAHDR.CFG
not found). RA Header will exit when it encounters an error condition.
Warnings are problems that will affect the performance of RA Header (example:
insufficient disk space for FILES.BAK). RA Header will not continue with the
operation that produced the warning but will move on to the next task.
╓────────────────────────────────────────────────────────────────────────────╖
║ ░░░░░░░ ERRORLEVELS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
╙────────────────────────────────────────────────────────────────────────────╜
Chances are that you will not use the errolevels produced by RA Header.
Nevertheless, I use errorlevels to write to a file that can only be seen by
the sysop when I log in to give me instant status on some issues.
RA Header will produce errorlevels depending on the success of it's execution.
Three different errorlevels may be provided depending on whether an error,
warning, or no problem was encountered (see RAHDR.ERR section for details).
Errorlevels are as follows: 0 = NO PROBLEM, 1 = WARNING, 2 = ERROR
An example batch file just for demonstration:
rahdr
if errorlevel 2 goto Error
if errorlevel 1 goto Warning
echo No Problem
goto end
:Error
echo Error
goto end
:Warning
echo Warning
:end
Page 8
╓────────────────────────────────────────────────────────────────────────────╖
║ ░░░░░░░ REGISTRATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
╙────────────────────────────────────────────────────────────────────────────╜
Please support shareware!
You are granted permission to evaluate RA Header for a period of 30 days.
After this evaluation period a $10.00 (US funds) registration fee is required.
If you do not plan to register, then remove RA Header and it's associated
files from use.
Upon receipt of your registration fee, a registration number will be sent to
you. Use this registration number to register your copy of RA Header by using
RAHDRCFG.EXE.
RA Header, as an unregistered copy, is not crippled in any way. Registered
owners will receive their registration number that will do the following:
■ Remove "UNREGISTERED" from the file area headers.
■ Replace the phrase: "Registered to: UNREGISTERED"
with: "Registered to: 'your_sysop_name'"
in the bulletins.
Your registration is valid for future versions of RA Header.
In future versions, I hope to:
■ Optionally include the file area's most
downloaded file in the header.
■ Optionally include the file area's newest
file in the header.
■ Provide an option to have a fully
sysop customized header style. Possibly
an editor built into RAHDRCFG.EXE for this.
■ Increase RA Header's speed and efficiency.
■ Provide support for CD-ROMs.
■ Incorporate some of your good suggestions!
Please use the file RAHDR.REG to send in your registration information. Send
your RAHDR.REG information, plus a $10 check or money order (US funds) to:
Dan Roseen
P.O. Box 5695
Kent, WA 98064-5695
Please make checks or money order payable to Dan Roseen.
Page 9
╓────────────────────────────────────────────────────────────────────────────╖
║ ░░░░░░░ SUPPORT AND DISTRIBUTION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
╙────────────────────────────────────────────────────────────────────────────╜
Updates and/or new releases of RA Header can be downloaded from my BBS,
The Night Owl (shown below). You will have to fill out a newuser
questionnaire. Once you have done this you will have enough access to
download RA Header without complete user verification. You may leave your
comments, questions, and suggestions to Dan Roseen if I am not available for
chat.
If you are experiencing problems, call The Night Owl BBS or write me and
include the following information:
■ As much detail as possible explaining the problem.
■ Your full registration number.
■ Your RAHDR.CFG and RAHDR.ERR (if this exists) files.
■ Your AUTOEXEC.BAT and CONFIG.SYS files.
You may contact the following systems:
Support and Distribution
────────────────────────
Sysop: Dan Roseen
BBS: The Night Owl - A RemoteAccess system.
Number: (206)631-4949 23 Hrs. Kent, WA - USA
USRobotics HST DS
Comment: For downloading latest version: Do a [T]ext Search for "RAHDR".
Distribution ONLY
─────────────────
Sysop: Jim Radford
BBS: Northwest PC Link - A PCBoard system.
Fidonet: 1:343/600
Main access: (206)852-4364 23 Hrs. Kent, WA - USA
1200/2400 MNP5
Alt. access: (206)854-5646 23 Hrs.
USRobotics HST DS
Comment: For downloading latest version: Do a [Z]ippy directory scan
for "RAHDR".
Page 10
╓────────────────────────────────────────────────────────────────────────────╖
║ ░░░░░░░ THANK YOU TO: ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
╙────────────────────────────────────────────────────────────────────────────╜
Denise Roseen, my wife, for her encouragement and for helping me set aside
time to work on this project.
Jim Radford, a long-time friend, for his suggestion to make RA Header a
versatile program that others can use. Also, for suggesting I build a
configuration setup program to go with it.
Richard Merit, for his willingness to beta test RA Header v1.0 and for his
comments and suggestions.
Scott Parks, sysop of The Helix BBS, for his willingness to beta test RA
Header v1.0 and for his comments and suggestions.
All registered owners of RA Header.
╓────────────────────────────────────────────────────────────────────────────╖
║ ░░░░░░░ ACKNOWLEDGEMENTS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
╙────────────────────────────────────────────────────────────────────────────╜
Turbo C v2.0 is a registered trademark of Borland International, Inc.
RemoteAccess is a product of Continental Software.
DESQview is a registered trademark of Quarterdeck Office Systems.
Page 11