The Magic City Micro BBS, version 4.1 Shareware $39.95 Copyright 1984 - David M. Alden GO AHEAD, COPY THE DISK ----------------------- Make a BACKUP copy of the MCM BBS disk. We'll be making changes as we go, so plan to work on only a backup copy. Store the original somewhere safe. INTRODUCTION ------------ Thank you for your interest in the MCM BBS, a shareware BBS that is user supported at $39.95. This documentation is intended to get you started. Additional documentation (along with on-line support) is available for registered MCM SYSOPs. This system was written for people who are somewhat interested in how their Apple works - people who know how to use ProDOS and who have an introductory knowledge of Applesoft BASIC. It's a very flexible BBS because you can customize it to meet your requirements by making simple changes to the program code. If you've ever considered writing your own BBS from scratch, this is a much easier way to go! By way of reference material, I recommend Osborne/McGraw Hill's APPLE II USER'S GUIDE and Addison-Wesley's BASIC PROGRAMMING WITH PRODOS. Neither of these books is overly technical; yet they can answer 99% of the Applesoft programming questions one could run into. EQUIPMENT & SOFTWARE -------------------- To begin running a Magic City Micro BBS, you'll need the following: o An Apple ][+ //e or //gs o An Apple Cat modem, or o A super serial card and Hayes-type external modem, or o An external modem connected to the //gs modem port o A ProDOS clock card unless using a //gs o And at least 1 disk drive DISK ORGANIZATION ----------------- The key to the MCM BBS is ProDOS' tree structured directory. Your system comes configured for use on an Apple with 2 5.25" floppy disk drives. All system files, mail, and downloads reside on disk 1. Disk #2 is reserved for your bulletin board(s). You have the flexibility of moving sections of the board to different disks to gain maximum use of your hardware. A complete directory of all files on the disk (even those hidden away in sub-directories) is as follows: Volume: MCM 3 Sep 87 Filename Blocks Type Modified Created Length PRODOS________________________ 32 SYS 30-MAR-87 26-FEB-86 $3C7D BASIC.SYSTEM__________________ 21 SYS 10-DEC-86 26-FEB-86 $2800 BDS___________________________ 1 DIR 29-AUG-87 18-JUN-87 $200 CNV_________________________ 1 DIR 29-AUG-87 22-JUN-87 $200 C.SUBJECTS________________ 1 TXT 21-JUN-87 22-JUN-87 $DE C.0615114926______________ 8 TXT 22-JUN-87 26-JUN-87 $D36 C.0615115104______________ 7 TXT 22-JUN-87 26-JUN-87 $BE9 MKT_________________________ 1 DIR 29-AUG-87 22-JUN-87 $200 M.SUBJECTS________________ 1 TXT 24-JUN-87 26-JUN-87 $2E M.0624094841______________ 8 TXT 29-AUG-87 26-JUN-87 $DDA APL_________________________ 1 DIR 29-AUG-87 22-JUN-87 $200 A.SUBJECTS________________ 1 TXT 26-JUN-87 26-JUN-87 $2 B.MENU______________________ 1 TXT 29-JUN-87 29-JUN-87 $106 LIB___________________________ 1 DIR 29-AUG-87 18-JUN-87 $200 UL__________________________ 1 DIR 29-AUG-87 26-JUN-87 $200 DES_______________________ 1 DIR 31-JUL-87 31-JUL-87 $200 DES_________________________ 1 DIR 29-AUG-87 31-JUL-87 $200 POST.OFC______________________ 1 DIR 26-JUN-87 18-JUN-87 $200 UTILS_________________________ 1 DIR 29-AUG-87 26-JUN-87 $200 SETUP_______________________ 1 BAS 26-JUN-87 26-JUN-87 $174 TOOLKIT_____________________ 9 BAS 12-JUN-87 26-JUN-87 $EE1 FREEWRITER__________________ 23 SYS 17-NOV-84 26-JUN-87 $2AF8 FW.INSTRUCTIONS_____________ 5 BAS 20-JUN-87 26-JUN-87 $7C5 PRINTER_____________________ 8 BAS 20-JUN-87 26-JUN-87 $D8F BBS___________________________ 36 BAS 2-SEP-87 29-AUG-87 $4572 STATS_________________________ 1 TXT 26-JUN-87 26-JUN-87 $6 USERS_________________________ 1 TXT 26-JUN-87 26-JUN-87 $75 MCM.DOCS______________________ 27 TXT 31-JUL-87 31-JUL-87 $332C KALLERS_______________________ 3 TXT 26-JUN-87 18-JUN-87 $26B NEW1__________________________ 3 TXT 11-JUN-87 18-JUN-87 $304 NEW2__________________________ 3 TXT 24-JUN-87 18-JUN-87 $25C MAIN.MENU_____________________ 1 TXT 12-JUN-87 18-JUN-87 $14E STARTUP_______________________ 4 BAS 2-SEP-87 2-JUL-87 $5D7 Blocks free: 58 Blocks used: 222 Total blocks: 280 Number of standard files: 23 Number of subdirectories: 10 ----------------- : NOTE: : RE: MODEMWORKS STARTUP ----------------- The MCM BBS uses a specialized extension to BASIC that is called ModemWorks. ModemWorks adds modem-specific commands to Applesoft BASIC, and is ideal for this system. All the ModemWorks files that you'll need are in a subdirectory named /MW. The STARTUP program on this disk selects that directory, and runs the ModemWorks INSTALL program. You'll be prompted for your modem and slot. Then type: ]PREFIX /MCM and start the MCM BBS by typing: ]-BBS For more information about ModemWorks contact: Living Legends Software P.O. Box 4313 La Mesa, Ca. 92044 (ModemWorks version 2.0 sells for $59.95). PROGRAM SETUP ------------- The file "BBS" is the bulletin board program. You can make one change now if you'd like to call your BBS something other than "The Magic City Micro!" Go ahead, be creative! To accomplish this change, boot up your computer with your regular ProDOS disk and exit to Applesoft (] prompt). Then remove that disk and put your MCM BBS disk in the drive. Now, reset the prefix. Type: ]PREFIX /MCM Next, load the BBS into RAM. Type: ]LOAD BBS And, list line 30 by typing: ]LIST 30 You'll see: 30 NA$ = "the Magic City Micro!" You may now re-type the name to be anything you want, for example: 30 NA$ = "MY BBS - KEEP AWAY!" Now, save the program back to disk by typing: ]SAVE BBS MAKING THE ONLINE DISKS ----------------------- These are the 2 disks that you'll use to run the BBS. Using a ProDOS formatting program, FORMAT a disk named /BDS for drive 2. Your drive 1 disk should be named /MCM. Use a program that copies ProDOS files and COPY all the files under the BDS subdirectory to your /BDS disk. This will set up the disk for your bulletin boards. Note that there are 3 subdirectories (/CNV, /MKT, & /APL) contained within /BDS -- make sure that your copy program copies each of these subdirectories and each of the files contained within them. You should see 6 files and 3 subdirectories copied. Check your disk against the list of files above. The remaining files are those required on the /MCM disk. To conserve disk space, you can delete PRODOS and BASIC.SYSTEM since you'll probably boot your system from the Modemworks disk. You may also delete the /BDS directory (and the 3 subdirectories and 6 files contained within) from /MCM now. ---------------- : NOTE : ---------------- In running a BBS, you'll do lots of copying and backing up of files. If you don't already have a good utility program that will batch copy (ie. use wildcards; copy all the files within a subdirectory; etc.), plan to get one. Recommended choices include Glen Bredon's Prosel; ECP by Don Elton; and Copy II Plus by Central Point. CREATING BULLETIN BOARDS ------------------------ Program lines 800-899 allow callers to select the board that they wish to view. The code is commented to give you a model to work from in setting up your own boards. Here's how it works ... Line 815 contains BD$ -- "OQCMAS". You might recognize these as bulletin board selections: LogOff; Quit; Convention; Market; Apple; & Sysop's. Let's say you'd like to add a board called "Finance" -- just insert an "F" after the last letter in the command string: "S" (Put the "F" inside the closing quote). Now, BD$ will equal "OQCMASF". ----------------- : HARDWARE NOTE : DISK DRIVES ----------------- For those who'd like to relocate the disk that will store the bulletins, note PR$(2) -- it sets the root directory of the /BDS disk. If running on a hard disk, PR$(2) might be equal to "/HARD1/MCM/BDS/". Note the preceeding and trailing slashes (/). Line 820 directs the program to the correct line for the board selected. Our new Finance board adds a 7th character to the command string (BD$), so we'll have to add a 7th line number to the GOTO list. If we skip 5 line numbers between each board setup, line 861 will be next. Put a comma (,) 861 to the end of the line numbers on line 820. Now, type in a REMark line identifying the new board: ]860 REM ** Finance Board ** (you can put Control-J's before & after the astericks to create blank lines for spacing) Then, type in line 861: ]861 BP$ = "Finance" : B$ = "F." : PR$(1) = PR$(2) + "FIN/" : GOTO 930 And, save the BBS to disk -- that's all the programming it takes to open a new board! CREATING THE BOARD subdirectory -------------------------------- If your boards are all on a floppy in disk 2, the Finance board will need a subdirectory called: /FIN/. Use your copy program to create the new subdirectory. You'll need one file in it to begin operating the new board, it'll be called "F.SUBJECTS". You can create this file with a word-processor because it's simply a zero (0) followed by a carriage return. Then, save the zero as a file named /BDS/FIN/F.SUBJECTS to disk. One last step while you have the word-processor running: load in /BDS/B.MENU and add the new Finance board to the list of system boards. You can alter the appearance of this menu to your liking! ----------------- : NOTE : ----------------- For your convenience, a public domain word processor is included on the MCM disk. You can find Freewriter in the UTILS directory. Written by the author of Applewriter, it's a very useful program for maintaining the small text files of your MCM BBS. UTILS ----- Two other programs reside in the Utilities subdirectory. SETUP writes a new USERS file and STATS file -- useful if want to set up a new, empty list of calls and callers. TOOLKIT is a very basic database program that allows you to access user records to change security levels, etc. You can also add new users and print a list of users with this program. If you want to delete a user, just change his first name to EMPTY. You might also want to change the password and delete any mail addressed to that PO Box in the POST.OFC subdirectory. ------------- : NOTES : ------------- 1. SETUP will overwrite your existing USERS and STATS files. 2. Set the prefix to /MCM prior to running SETUP or TOOLKIT CHAT ---- The chat mode is controlled by (of all things) your joystick! Center for "armed". Left to disable chat. Right to force chat. The joystick position is read everytime the main command prompt is encountered. To force the chat mode, or respond to a callers chat request, time your positioning of the joystick to "be ready" just before the main command prompt comes up. (Note that a more elegant chat control is being written by an MCM Sysop. It will be available for downloading from the "home board" by registered Sysops). TO QUIT THE BBS --------------- Do a Control-Reset, then type: ]FRE ]&FRE YOUR TURN! ---------- This concludes the initial MCM BBS documentation. Additional information is available to registered users in the form of Tech Notes and on-line bulletins. If you haven't done so already, I urge you to register as an MCM SYSOP by mailing the shareware fee, $39.95*, to: SofTools, Inc. 1550 South Dixie Hwy; Suite 208 Coral Gables, Florida 33146 | *If you are registered with Living Legends Software as being an owner | of ModemWorks, your cost for the MCM BBS is only $20. The disk that | you receive will _not_ contain any ModemWorks files if you request | this pricing. Upon hearing from you, I'll mail you a disk which contains the latest version of the MCM BBS. And, your access level at the MCM - SofTools, Inc. BBS will be adjusted to provide you with access to the "MCM Sysops Assn". You'll find bulletins, program code, a directory of MCM systems, and a discussion forum where you can get your questions answered. It's a great place for MCM Sysops! Sincerely, Dave Alden, author The Magic City Micro BBS (305) 661-3802 300/1200 data