ProfitPress Mega CDROM2 Shareware Freeware (MSDOS)(1992)(Eng)

home *** CD-ROM | disk | FTP | other *** search

/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / BBS / RA / RAHDR10.ZIP / RAHDR.DOC next >

Wrap

Text File | 1991-08-04 | 15.9 KB | 531 lines

┌────────┐ ┌────────┐ │ ┌──┐ │ │ ┌──┐ │ │ └──┘ ┌┘ │ └──┘ │ │ ┌──┐ └┐ │ ┌──┐ │ │ │ │ │ │ │ │ │ └──┘ └──┘ └──┘ └──┘ ┌──┐ ┌──┐ ┌───────┐ ┌────────┐ ┌──────┐ ┌───────┐ ┌────────┐ │ │ │ │ │ ┌─────┘ │ ┌──┐ │ │ ┌─┐ └─┐ │ ┌─────┘ │ ┌──┐ │ │ └──┘ │ │ └────┐ │ └──┘ │ │ │ └─┐ │ │ └────┐ │ └──┘ ┌┘ │ ┌──┐ │ │ ┌────┘ │ ┌──┐ │ │ │ ┌─┘ │ │ ┌────┘ │ ┌──┐ └┐ │ │ │ │ │ └─────┐ │ │ │ │ │ └─┘ ┌─┘ │ └─────┐ │ │ │ │ └──┘ └──┘ └───────┘ └──┘ └──┘ └──────┘ └───────┘ └──┘ └──┘ Version 1.0 A RemoteAccess utility for file area headers, bulletins, and allfiles list. (C) Copyright 1991 ╓─────────────────────────────────────────────────────────────────────────────╖ ║ ░░░░░░░ RA HEADER v1.0 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║ ╙─────────────────────────────────────────────────────────────────────────────╜ Documentation and programming by Dan Roseen ╓─────────────────────────────────────────────────────────────────────────────╖ ║ ░░░░░░░ TABLE OF CONTENTS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║ ╙─────────────────────────────────────────────────────────────────────────────╜ Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Options and Features . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Configuring RA Header . . . . . . . . . . . . . . . . . . . . . . . . . 5 RA Header Operation . . . . . . . . . . . . . . . . . . . . . . . . . . 6 RAHDR.ERR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 Registration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Support and Distribution . . . . . . . . . . . . . . . . . . . . . . . . 8 Thank You To: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 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. 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 and MS-DOS v3.3. This program is untested with lower versions of DOS. ╓─────────────────────────────────────────────────────────────────────────────╖ ║ ░░░░░░░ FILES ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║ ╙─────────────────────────────────────────────────────────────────────────────╜ RAHDR.DOC . . . . . . . . . . . . . This documentation text file RAHDR.EXE . . . . . . . . . . . . . RA Header program RAHDR.REG . . . . . . . . . . . . . RA Header registration form RAHDR.TOP . . . . . . . . . . . . . Example file for top of allfiles list RAHDRCFG.EXE . . . . . . . . . . . Setup utility for RA Header Page 3 ╓─────────────────────────────────────────────────────────────────────────────╖ ║ ░░░░░░░ OPTIONS AND FEATURES ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║ ╙─────────────────────────────────────────────────────────────────────────────╜ ■ Can reside in any directory. ■ Specific file areas may be excluded from RA Header. ■ Creates backups of FILES.BBS. ■ 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. ■ 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. Page 4 ╓─────────────────────────────────────────────────────────────────────────────╖ ║ ░░░░░░░ 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: Your RA Header registration number. Line 2: Your RA directory (include drive letter). Line 3: 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 4: Header style (1 = hatched, 2 = ASCII, 3 = extended ASCII) Line 5: Bulletin style (1 = hatched, 2 = ASCII, 3 = extended ASCII) Line 6: 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 7: ANSI bulletin (include drive letter) Note: Leave blank if you don't want this bulletin. Line 8: Masterfiles (allfiles) list (include drive letter). Line 9: 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. Example: ──────── 0 C:\RA 3 3 C:\RA\RAHDR.ASC C:\RA\RAHDR.ANS C:\RA\RAHDR.ALL C:\RA\RAHDR.TOP 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 5 ╓─────────────────────────────────────────────────────────────────────────────╖ ║ ░░░░░░░ 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). 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. ╓─────────────────────────────────────────────────────────────────────────────╖ ║ ░░░░░░░ 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. 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. Page 6 ╓─────────────────────────────────────────────────────────────────────────────╖ ║ ░░░░░░░ 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 "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. ■ Flag files that are less than X days old in allfiles list. ■ 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 7 ╓─────────────────────────────────────────────────────────────────────────────╖ ║ ░░░░░░░ 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 8 ╓─────────────────────────────────────────────────────────────────────────────╖ ║ ░░░░░░░ 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. ╓─────────────────────────────────────────────────────────────────────────────╖ ║ ░░░░░░░ ACKNOWLEDGEMENTS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║ ╙─────────────────────────────────────────────────────────────────────────────╜ Turbo C v2.0 is a registered trademark of Borland International, Inc. RemoteAccess is a product of Continental Software. Page 9