home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The World of Computer Software
/
World_Of_Computer_Software-02-385-Vol-1of3.iso
/
m
/
macfile2.zip
/
MACFILE.DOC
< prev
next >
Wrap
Text File
|
1993-01-24
|
23KB
|
513 lines
╔═══════════════════════════╗
║ A MÄC's Place BBS Release ║
╚═══════════════════════════╝
MACFILE: Roll Your Own File Listing Door
~~~~~~~ ~~~~ ~~~~ ~~~ ~~~~ ~~~~~~~ ~~~~
Version 2.0
Copyright (c) 1993 John W. McNamara
All rights Reserved
Written By: John McNamara
MÄC's Place BBS
Dunn, NC
(919) 891-1111 [16.8 DS]
Release Date: 22 Jan 1993
Files Listing................................................ Page 1
Introduction................................................. Page 2
Operation.................................................... Page 3
Installation................................................. Page 4
History/Whats New/Future plans............................... Page 6
Disclaimer................................................... Page 7
License (What is freeware)................................... Page 8
Other Products by MÄC's This year............................ Page 9
MACFILES - Version 2.0 Page - 1
┌────────────────────────────────┐
│ Files included in this Zip: │
└────────────────────────────────┘
MACFILE.EXE - Main File MACFILE Executable File, Version 2.0
MACFILE.CNF - MACFILE Sample Configuration File
MACFILE - MACFILE Sample PCBoard Door File
MACFILE.DOC - Information on File MACFILEs Door
MACFILE.TXT - MACFILE sample description file
MACFILE - Version 2.0 Page - 2
╔══════════════╗
║ Introduction ║
╚══════════════╝
Welcome to File MACFILE, Version 2.0 "Roll Your Own File Listings DOOR".
Basically there was a need (as explained to me by my users) to have a
"simple" door in which a user could go into and select file listings
that interested them for later download. I know there are other door
programs that do this and even more extensively than MACFILE however
spending all your time in a door going through menus and having to
remember what dir is what takes time, and time is what this DOOR was
designed to save. If you wanted to spend alot of time in a door
selecting directory listings then you might as well grab the ALLFILES
list that most BBS's provide. Anyway, I hope you enjoy the MACFILE
door as much as my users have. It quickly became the 2nd most used
door on my bulletin board next to MACSEC (MAC's on-line security update
door allowing users to upgrade themselves based on sysop parameters).
MACFILE - Version 2.0 Page - 3
╔═══════════════════════════════╗
║ File MACFILE Door Operation: ║
╚═══════════════════════════════╝
The operation of the File MACFILE Door is straight forward. The programme
presents the welcome screen and then displays the main menu.
File MACFILE/DESTINATION Door
For a 2 file system:
[S] Select / Deselect file listings
[H] Help
[A] Select All File Listings
[D] DeSelect All File Listings
[C] Create Download File listing and quit to BBS
[Q] Quit to BBS
[G] Log off BBS
┌────────┐
│ Select │
└────────┘
By choosing this option, you will be presented with a full file
listing of the BBS. Simply choose the number of the directories you
want and the "-" will be replaced with an "+" All files marked with
a "+" will be added to the .ZIP file created by the BBS. By choosing
a "0" (zero) if there are more than 60 listings it will display the
next screen of directories. After the second screen and after the
first screen the "0" will take you back to the main menu.
┌──────┐
│ Help │
└──────┘
Brings up a full screen help. The help is slightly differnent depending
on how many directories are listed.
┌────────┐
│ Create │
└────────┘
By choosing this option a file is created using a list formed by
the choices selected. If no directories where flagged then it
doesn't create anything and exits to the BBS. If there are flagged
files a .ZIP file is created for user download. The next version
will auto-flag the file for download in the main BBS as soon as I
figure out how to accomplish this task.
The file created by the door is in the form of YRLSTx.ZIP where "x"
is the node number of the BBS. YRLST0.ZIP will be the file if the
BBS is not running a multi-node system.
┌──────┐
│ QUIT │
└──────┘
The user can return to PCBoard after they have finished using the
MACFILE Door. No file will be created even if some are selected.
┌─────────┐
│ GOODBYE │
└─────────┘
Finally, the user can exit the BBS from the DOOR.
MACFILE Version 2.0 Page - 4
╔══════════════╗
║ INSTALLATION ║
╚══════════════╝
Requirements:
- Dos 2.1 or higher
- 80286 intel based machine or higher
(Special requests for pre-80286 machines can be found at the authors BBS)
- PKZIP MUST be in DOS path or local directory where MACFILE is installed
- Enough memory for PKZIP to work (see PKZIP manual),macfile doesn't use much.
- PCBoard 14.x (any version)
1. Configure PCBoard for MACFILE door:
Using PCBoard's PCBsetup program, add the door to your list of doors.
Fields:
Filename - SYSOPs Choice (must match startup file)
Password - SYSOPs Choice
Sec - SYSOPs Choice
Login - SYSOPs Choice (Not recommended)
User Sys - Yes
Door Sys - No
Shell - No
Path to Files - Not Needed
2. Make directory for MACFILE door
- Make a directory to hold the MACFILE door files.
- i.e. mkdir \doors\MACFILE
3. Create the start up file i.e. MACFILE
- a sample is listed below
-------------- cut here ----------------
@echo off
c:
cd \doors\macfile
macfile macfile.cnf
cd \pcb
board
-------------- cut here ----------------
4. Copy files to appropriate places
- copy macfile door files to the MACFILE door directory.
- copy the startup file into the default PCBoard directory i.e. \pcb
5. Create the configuration file i.e. MACFILE.CNF
#######################################################################
Sample macfile.cnf file
Line 1: Location of file containing descriptions
Line 2: Root name of Directory listings
(i.e. It would be "DIR" for DIR1, DIR2, DIR3, etc)
Line 3: Location to put the created ZIP FILE. (normally a "free" dir)
Filename is YRLSTx.ZIP where "x" is node number. (so there
is no conflict on a network)
Line 4: Location where the ACTUAL DIRxx text files are located files
are located.
-------------- cut here ----------------
d:\doors\macfile\macfile.txt
dir
d:\pcb\free
d:\pcb\gen
-------------- cut here ----------------
MACFILE Version 2.0 Page - 5
6. Create the description file.
##########################################################################
Sample macfile.txt File
Line 1: Number of descriptions following Line 1: (min 1, max 120)
Line 2 - number in Line 1: descriptions of each directory.
(max 20 chars in length) (it really doesn't matter if you put 50
only 20 wil be printed in the file listing) All chars allowed
spaces, slashes, numbers etc........
This description will also handle PCBoards @variables@
-------------- cut here ----------------
52
Archivers
Communications
BBS
PCboard
Virus/Security
Professional
Paradox
R:base
Database(s)
Benchmarks
Clipper
Education
Finance/Business
Health/Medical
FREEDownloads
TextFiles
Spreadsheet
Disk Utils
File/DirUitls
Shells/Menus
Periodical/src
MailReaders
Words/Editors
Batch Utils
Keyboard Utils
Memory Utils
Screen Utils
Misc Utils
Reserved
DOSSystem
MSWindows
OS/2
Multitasking
Lan/Networks
Science/Engineer
DTP/Clippart
Legal
CAD
Geoworks
GraphicsApp/Viewer
Games
Fonts
Reserved
Language: C/DOS
Language: C/UNIX/GNU
Language: C++
Language: ASM
Language: Pascal
Language: Basic
Language: Other
Programmers Tools
@X8F RECENT UPLOADS
-------------- cut here ----------------
MACFILE Version 2.0 Page - 6
╔═════════════════════════════╗
║ A MÄC's Place BBS Release ║
╚═════════════════════════════╝
History of the File MACFILE Door Changes [in reverse order]
═════════════════════════════════════════
MACFILE 2.0: 22 Jan 1993
o Went to version 2 because I wanted to keep the naming convention
the same and DOS only allows 8 chars.
o Added "Select All" menu item
o Added "DeSelect All" menu Item
o Added the "auto flag" feature.
o Supports 120 file dirs.
o Added BBS name to the opening screen.
o Tidied up some of the string handers
o Fixed a couple of Small bugs
o Added better error reporting, (writes to callers log)
o Now you can "flag" file listing even if they are not on the
screen your looking at. As each line is viewed as an
Object
MACFILE 1.0: 15 Jan 1993
o Initial Public Release
MACFILE 0.8ß: 5 Jan 1993
o Initial BETA release to a small group of BBS's.
I want to thank these folks for their help.
Normally MÄC's Place has a group of 19 BETA sites
we use regularly, but this one went real clean.
Channel One BBS 919-354-3137
SySops - Brian Miller/ Tess Heder
FreeWare Hall Of Fame BBS 804-293-4710
SySop - Rey Barry
Poor Boy's BBS 615-239-3073
SySop - Ron Herring
╔═══════════════╗
║ Future Plans ║
╚═══════════════╝
- Limit lists to take only "new since last" files if user desires
- Try and think of something else that might help out PCB users
Starting to run out of ideas. Anyone ? (no NOT a mail door!)
- Win the MegaBucks lottery in Mass. and retire.
MACFILE Version 2.0 Page - 7
These files are distributed under the FreeWare concept - freely
available to PCBoard SysOps. Please Do Not distribute modified
versions without permission of the author.
Do Not remove this notice or any other copyright notice.
╔══════════════════╗
║══════════════════║
║ DISCLAIMER ║
║══════════════════║
╚══════════════════╝
THIS PRODUCT IS LICENSED "AS IS" WITHOUT ANY WARRANTY OF MERCHANTABILITY
OR FITNESS FOR A PARTICULAR PURPOSE, PERFORMANCE, OR OTHERWISE. ALL
WARRANTIES ARE EXPRESSLY DISCLAIMED. BY USING THE FILE MACFILE DOOR
PROGRAM YOU AGREE THAT JOHN MCNAMARA WILL NOT BE LIABLE TO YOU OR ANY
THIRD PARTY FOR ANY USE OF (OR INABILITY TO USE) OR PERFORMANCE OF THIS
PROGRAMME, OR FOR ANY DAMAGES WHATSOEVER WHETHER BASED ON CONTRACT, TORT
OR OTHERWISE. EVEN IF WE ARE NOTIFIED OF SUCH POSSIBILITY IN ADVANCE.
You may not reverse-engineer, disassemble, modify, decompile or create
derivative works of this programme. Piracy has been investigated by the
FBI and prosecuted under federal statutes. Applicable law provides for
damages and recovery of attorney's fees. Distribution of any MAC's
Place BBS Release program's in any medium without its accompanying
documentation is an unauthorized modification. That is a theft of
intellectual property.
----------------
PCBoard (C) is a registered trademark of Clark Development Company.
PKZip (C) is a register trademark of Phil Katz and PKWare, Inc.
MACFILE Version 2.0 Page - 8
LICENSE
=======
The MACFILE PCBoard Door programme can be freely distributed so
long as it is not modified or sold for profit. If you find that the
programme is valuable, you can send a donation for what you think it is
worth. A donation of $5 is suggested.
Please Send your contributions to:
MAC's Place BBS
ATTN:John McNamara
P.O. Box 911
Dunn, NC 28335
If you have any questions, bugs, or suggestions, please contact:
John McNamara - SysOp
Mäc's Place BBS
(919) 891-1111 16.8K Dual Std
The latest version is always available for downloading.
╔══════════════════════════╗
║ File MACFILE Background: ║
╚══════════════════════════╝
John McNamara wrote all the code for File MACFILE in approximately 5 Hours.
The File MACFILE door programme is written in C++ and was compiled with
Borland C++ 3.1 The MACFILE C LIBrary The MACFILE source code LIBrary
was modified and recompiled with our specific improvements. The C++
language was choosen for writing several of the MÄC's Place BBS PCBoard
utilities such as File MACFILE Door because of its speed and
flexibility. The C++ source is available upon request and for small fee.
Author:
John McNamara - SysOp
MÄC's Place BBS
(919) 891-1111 [16.8 DS]
MACFILE Version 2.0 Page - 9
╔═══════════════════════════════════╗
║ Other FreeWare By MAC's Place BBS ║
╚═══════════════════════════════════╝
ZAP1.ZIP 1185 01-01-92 Interactive process killer for UNIX
| SYSTEMS "C" source
XCHANGE.ZIP 35061 01-01-92 Find out where your calling in Mass
YATSCOR1.ZIP 11000 01-01-92 Bulletin generator for EX-10 Yahtzee Door
SOLSCOR1.ZIP 11000 01-01-92 Bulletin generator for EX-10 Solitairre Door
AREA21.ZIP 21761 01-01-92 Areacode Identifier for the U.S.
UPCASE.ZIP 15963 01-01-92 Convert Turbo Pascal key words to Upper Case
MACGREP1.ZIP 11348 01-01-92 UNIX-Like Grep for DOS
MACKILL2.ZIP 19856 05-30-90 Search & Destroy ! A "whereis" type Program
| that prompts you to delete the file. Scans
| entire default drive, wildcards etc. Brought
| to you by MÄC's Place BBS. FREE From Door 2
MACOPY1.ZIP 14966 03-31-92 MACOPY V2.0 Search all drives and
| directories for a file(s) and copy
| it over to a different location.
| Great for BBS's or large networks,
| save all those "whereis" commands
| prior to copy a file somehwere
MACWHERE.ZIP 15050 03-31-92 MacWhere V2.0 extreamly fast Whereis
| program, Search all drives and dirs.
| Wildcards, pause mode, very fast.
| Don't just search current drive, search
| them ALL in the same amount of time
MACWHICH.ZIP 8282 01-15-92 UNIX like "WHICH" for DOS. V2.0
| Now find out what your about to run
| BEFORE you run it. Helpful on networks
| to avoid running others creations.
| Brought to you buy MÄC's Place
| BBS and free from door 2
MACWIN1.ZIP 3712 12-27-91 MAC WIN 2.0 for MS Windows 3.0 Increase
| windows performance 5-10 times, by making
| your windows screen writes fly. Transparent
| uses no memory, not a TSR. It makes you
| think you have a new computer. Must have.
| Works with all the favorites, Corel Draw, all
| the games, WinWord, etc. FREE from MAIN BOARD
| A MÄC's Place BBS release.
KILLBAK4.ZIP 8196 01-15-92 Announcing!! Kill Bak V4.0 file Killer
| Searches All drives/directories for files
| ending in .BAK by default. Now it takes
| Arguments so it will hunt down ANY file
| you want, wildcards accepted. VERY fast
| Works across Novell, 3-Comm, Lantasic &
| many other networks including PC-NFS so
| now you can even search UNIX drives.
| Brought to you buy MÄC's Place
| BBS and free from door 2
HOTDOG31.ZIP 60024 01-01-92 PCB 11,12,14 User Base Management utility
HOWLONG.ZIP 21760 05-31-90 Time the execution of any program.. Great
| for bench marking your programs. Yet another
| MÄC's Place utility. Free from door 2
HSTUFF41.ZIP 63303 08-30-90 HOTSTUFF V4.1 Popular file & Statistics
| report for PCBoard. A must for PCBoard
| SYSOPS. Brought to you by MÄC's Place
| Removed Co-Processor specific switch,
| Sorry about that folks
HCOMP40.ZIP 12266 08-30-90 HOTSTUFF Companion V4.0 Strips unwanted lines
| from Files. A MUST for HOTSTUFF or ProWho
| Now strips up to 3 patterns at a time
| Brought to you by MÄC's Place
EDITPTH3.ZIP 11734 05-30-90 Edit your DOS PATH without rebooting your
| computer. Version 3.0 Brought to you by
| MÄC's Place. Its freeware
DATEKILL.ZIP 8000 01-01-92 Deletes PCBOARD caller log/any file when it
| gets to be a certain day of the month
CHKTXT.ZIP 33550 01-01-92 Determines Readability of Text files
BOPDIR2.ZIP 18970 01-15-92 he ultimate recursive directory deleter,
| Fast, delete's a directory, any sub-dirs
| and files found in the dirs. Brought to
| from MAIN BOARD. Used to be KILLDIR
BUDMAN30.ZIP 12151 08-30-90 BUDMAN V3.0 DOWNLOAD.TXT file splitter for
| PCBoard twice as fast as prev vers. **vg**
| Brought to you by MÄC's Place
CALLKILL.ZIP 11000 01-01-92 Deletes caller log or any file when it
| gets to big
MACORG31.ZIP 75606 01-24-93 ORIGIN DOOR V3.1 for PCBoard 14.x
| File history tracing. A who UL/DL that
| file Door, faster than all existing doors
| of similar type. Now scans 1 or 2 files !
| Full screen help, 4% faster, files report.
| New presentation layout, easy to install.
| Nothing is faster. FreeWare from MÄC's
| Place BBS
MACRM11.ZIP 22357 01-21-93 MACRM V1.1 for PCBoard 14.x - 15.x
| Removes files & descriptions from PCBoard
| directory listings. Handles unlimited
| number of files and dirs. Runs from
| constructed lists of files and dir
| locations. Very fast and safe. Saves tons
| of time when processing large amount of
| data. FREEWARE from MÄC's Place
EZCOMP20.ZIP 99098 01-24-93 EZComp Version 2.0
| Unix compatible compress/uncompress
| for DOS. Extreamly Fast, true 32bit,
| runs in 386 protected mode, (386+
| required), full 12 - 16 bit support.
| Uses extended/expanded/Xms/Disk for
| extra mem if needed. Supports older
| unix compress, stdin etc..Rel:7/12/92
| FreeWare from MÄC's Place BBS.
MACSEC11.ZIP 79465 01-24-93 MAC SEC V1.1 for PCBoard 14.x is an ON-LINE
| Security Upgrade Door for your users. Lets
| your users upgrade themselves, without
| waiting for an event to occur. Protect up
| to 50 levels, File or Byte ratio, allow
| 50 levels to be altered. Very fast and
| safe. A MAC's Place BBS release.
| BUG FIX, now reads correct .cfg FreeWare..
MACUP1.ZIP 6800 01-24-93 MACUP V2.0 PCBoard Local File Uploader
| Allows local uploads, handles wildcards,
| appends any dir file as well as moves
| actual file to proper directory. Handles
| multiple description lines also. -VG-
| Another Freeware program from MAC's Place
| BBS
KEEPCALL.ZIP 11000 01-01-92 Keeps PCBoards Caller logs a a user defined
| Size. Designed to run in an event, you tell
| it what size you want and it will trim your
| callers log to the appropriate size.
| Maintains 64 column integrity