home *** CD-ROM | disk | FTP | other *** search
/ norge.freeshell.org (192.94.73.8) / 192.94.73.8.tar / 192.94.73.8 / pub / sdf / historical / mcm.txt < prev    next >
Text File  |  1987-06-15  |  13KB  |  277 lines
  1.  The Magic City Micro BBS, version 4.1
  2.           Shareware  $39.95
  3.    Copyright 1984 - David M. Alden
  4.  
  5.  
  6.  GO AHEAD, COPY THE DISK
  7.  -----------------------
  8.      Make a BACKUP copy of the MCM BBS disk.  We'll be making changes
  9.  as we go, so plan to work on only a backup copy.  Store the original
  10.  somewhere safe.
  11.  
  12.  INTRODUCTION
  13.  ------------
  14.      Thank you for your interest in the MCM BBS, a shareware BBS that
  15.  is user supported at $39.95.   This documentation is intended to get
  16.  you started.  Additional documentation (along with on-line support) is
  17.  available for registered MCM SYSOPs.
  18.      This system was written for people who are somewhat interested in
  19.  how their Apple works - people who know how to use ProDOS and who have
  20.  an introductory knowledge of Applesoft BASIC.  It's a very flexible
  21.  BBS because you can customize it to meet your requirements by making
  22.  simple changes to the program code.  If you've ever considered writing
  23.  your own BBS from scratch, this is a much easier way to go!
  24.      By way of reference material, I recommend Osborne/McGraw Hill's
  25.  APPLE II USER'S GUIDE and Addison-Wesley's BASIC PROGRAMMING WITH
  26.  PRODOS.  Neither of these books is overly technical; yet they can
  27.  answer 99% of the Applesoft programming questions one could run into.
  28.  
  29.  EQUIPMENT & SOFTWARE
  30.  --------------------
  31.  To begin running a Magic City Micro BBS, you'll need the following:
  32.   o  An Apple ][+  //e  or  //gs
  33.   o  An Apple Cat modem, or
  34.   o  A super serial card and Hayes-type external modem, or
  35.   o  An external modem connected to the //gs modem port
  36.   o  A ProDOS clock card unless using a //gs
  37.   o  And at least 1 disk drive
  38.  
  39.  DISK ORGANIZATION
  40.  -----------------
  41.      The key to the MCM BBS is ProDOS' tree structured directory. Your
  42.  system comes configured for use on an Apple with 2 5.25" floppy disk
  43.  drives.  All system files, mail, and downloads reside on disk 1. Disk
  44.  #2 is reserved for your bulletin board(s).  You have the flexibility
  45.  of moving sections of the board to different disks to gain maximum use
  46.  of your hardware.
  47.      A complete directory of all files on the disk (even those hidden
  48.  away in sub-directories) is as follows:
  49.  
  50.  Volume: MCM                                                    3 Sep 87
  51.  Filename                     Blocks Type   Modified    Created   Length
  52.  
  53.  PRODOS________________________   32  SYS  30-MAR-87  26-FEB-86    $3C7D
  54.  BASIC.SYSTEM__________________   21  SYS  10-DEC-86  26-FEB-86    $2800
  55.  BDS___________________________    1  DIR  29-AUG-87  18-JUN-87     $200
  56.    CNV_________________________    1  DIR  29-AUG-87  22-JUN-87     $200
  57.      C.SUBJECTS________________    1  TXT  21-JUN-87  22-JUN-87      $DE
  58.      C.0615114926______________    8  TXT  22-JUN-87  26-JUN-87     $D36
  59.      C.0615115104______________    7  TXT  22-JUN-87  26-JUN-87     $BE9
  60.    MKT_________________________    1  DIR  29-AUG-87  22-JUN-87     $200
  61.      M.SUBJECTS________________    1  TXT  24-JUN-87  26-JUN-87      $2E
  62.      M.0624094841______________    8  TXT  29-AUG-87  26-JUN-87     $DDA
  63.    APL_________________________    1  DIR  29-AUG-87  22-JUN-87     $200
  64.      A.SUBJECTS________________    1  TXT  26-JUN-87  26-JUN-87       $2
  65.    B.MENU______________________    1  TXT  29-JUN-87  29-JUN-87     $106
  66.  LIB___________________________    1  DIR  29-AUG-87  18-JUN-87     $200
  67.    UL__________________________    1  DIR  29-AUG-87  26-JUN-87     $200
  68.      DES_______________________    1  DIR  31-JUL-87  31-JUL-87     $200
  69.    DES_________________________    1  DIR  29-AUG-87  31-JUL-87     $200
  70.  POST.OFC______________________    1  DIR  26-JUN-87  18-JUN-87     $200
  71.  UTILS_________________________    1  DIR  29-AUG-87  26-JUN-87     $200
  72.    SETUP_______________________    1  BAS  26-JUN-87  26-JUN-87     $174
  73.    TOOLKIT_____________________    9  BAS  12-JUN-87  26-JUN-87     $EE1
  74.    FREEWRITER__________________   23  SYS  17-NOV-84  26-JUN-87    $2AF8
  75.    FW.INSTRUCTIONS_____________    5  BAS  20-JUN-87  26-JUN-87     $7C5
  76.    PRINTER_____________________    8  BAS  20-JUN-87  26-JUN-87     $D8F
  77.  BBS___________________________   36  BAS   2-SEP-87  29-AUG-87    $4572
  78.  STATS_________________________    1  TXT  26-JUN-87  26-JUN-87       $6
  79.  USERS_________________________    1  TXT  26-JUN-87  26-JUN-87      $75
  80.  MCM.DOCS______________________   27  TXT  31-JUL-87  31-JUL-87    $332C
  81.  KALLERS_______________________    3  TXT  26-JUN-87  18-JUN-87     $26B
  82.  NEW1__________________________    3  TXT  11-JUN-87  18-JUN-87     $304
  83.  NEW2__________________________    3  TXT  24-JUN-87  18-JUN-87     $25C
  84.  MAIN.MENU_____________________    1  TXT  12-JUN-87  18-JUN-87     $14E
  85.  STARTUP_______________________    4  BAS   2-SEP-87   2-JUL-87     $5D7
  86.  
  87.  Blocks free:   58         Blocks used:  222         Total blocks:  280
  88.  Number of standard files:   23          Number of subdirectories:   10
  89.  
  90.  -----------------
  91.  :     NOTE:      :  RE: MODEMWORKS STARTUP
  92.  -----------------
  93.      The MCM BBS uses a specialized extension to BASIC that is called
  94.  ModemWorks.  ModemWorks adds modem-specific commands to Applesoft BASIC, and
  95.  is ideal for this system.  All the ModemWorks files that you'll need are in
  96.  a subdirectory named /MW.  The STARTUP program on this disk selects that
  97.  directory, and runs the ModemWorks INSTALL program.  You'll be prompted for
  98.  your modem and slot.  Then type:
  99.  ]PREFIX /MCM
  100.      and start the MCM BBS by typing:
  101.  ]-BBS
  102.      For more information about ModemWorks contact:
  103.          Living Legends Software
  104.          P.O. Box 4313
  105.          La Mesa, Ca.  92044
  106.      (ModemWorks version 2.0 sells for $59.95).
  107.  
  108.  PROGRAM SETUP
  109.  -------------
  110.      The file "BBS" is the bulletin board program. You can make one change now
  111.  if you'd like to call your BBS something other than "The Magic City Micro!"
  112.  Go ahead, be creative! To accomplish this change, boot up your computer with
  113.  your regular ProDOS disk and exit to Applesoft (] prompt).  Then remove that
  114.  disk and put your MCM BBS disk in the drive.  Now, reset the prefix.  Type:
  115.  ]PREFIX /MCM <RETURN>
  116.  
  117.  Next, load the BBS into RAM.  Type:
  118.  ]LOAD BBS
  119.  
  120.  And, list line 30 by typing:
  121.  ]LIST 30
  122.  
  123.  You'll see: 30 NA$ = "the Magic City Micro!"
  124.  You may now re-type the name to be anything you want, for example:
  125.              30 NA$ = "MY BBS - KEEP AWAY!"
  126.  
  127.  Now, save the program back to disk by typing:
  128.  ]SAVE BBS
  129.  
  130.  MAKING THE ONLINE DISKS
  131.  -----------------------
  132.      These are the 2 disks that you'll use to run the BBS. Using a ProDOS
  133.  formatting program, FORMAT a disk named /BDS for drive 2. Your drive 1 disk
  134.  should be named /MCM.
  135.      Use a program that copies ProDOS files and COPY all the files under the
  136.  BDS subdirectory to your /BDS disk. This will set up the disk for your
  137.  bulletin boards.  Note that there are 3 subdirectories (/CNV, /MKT, & /APL)
  138.  contained within /BDS -- make sure that your copy program copies each of
  139.  these subdirectories and each of the files contained within them. You should
  140.  see 6 files and 3 subdirectories copied.  Check your disk against the list
  141.  of files above.
  142.      The remaining files are those required on the /MCM disk. To conserve disk
  143.  space, you can delete PRODOS and BASIC.SYSTEM since you'll probably boot your
  144.  system from the Modemworks disk.  You may also delete the /BDS directory (and
  145.  the 3 subdirectories and 6 files contained within) from /MCM now.
  146.  
  147.  ----------------
  148.  :     NOTE     :
  149.  ----------------
  150.      In running a BBS, you'll do lots of copying and backing up of files.  If
  151.  you don't already have a good utility program that will batch copy (ie. use
  152.  wildcards; copy all the files within a subdirectory; etc.), plan to get one.
  153.  Recommended choices include Glen Bredon's Prosel; ECP by Don Elton; and Copy
  154.  II Plus by Central Point.
  155.  
  156.  CREATING BULLETIN BOARDS
  157.  ------------------------
  158.      Program lines 800-899 allow callers to select the board that they wish to
  159.  view.  The code is commented to give you a model to work from in setting up
  160.  your own boards.  Here's how it works ...
  161.      Line 815 contains BD$ -- "OQCMAS".  You might recognize these as bulletin
  162.  board selections: LogOff; Quit; Convention; Market; Apple; & Sysop's.  Let's
  163.  say you'd like to add a board called "Finance" -- just insert an "F" after
  164.  the last letter in the command string: "S" (Put the "F" inside the closing
  165.  quote).  Now, BD$ will equal "OQCMASF".
  166.  
  167.  -----------------
  168.  : HARDWARE NOTE :  DISK DRIVES
  169.  -----------------
  170.      For those who'd like to relocate the disk that will store the bulletins,
  171.  note PR$(2) -- it sets the root directory of the /BDS disk.  If running on a
  172.  hard disk, PR$(2) might be equal to "/HARD1/MCM/BDS/".  Note the preceeding
  173.  and trailing slashes (/).
  174.  
  175.      Line 820 directs the program to the correct line for the board selected.
  176.  Our new Finance board adds a 7th character to the command string (BD$), so
  177.  we'll have to add a 7th line number to the GOTO list.  If we skip 5 line
  178.  numbers between each board setup, line 861 will be next. Put a comma (,) 861
  179.  to the end of the line numbers on line 820.
  180.  
  181.  Now, type in a REMark line identifying the new board:
  182.  ]860 REM  ** Finance Board **
  183.        (you can put Control-J's before & after the
  184.        astericks to create blank lines for spacing)
  185.  
  186.  Then, type in line 861:
  187.  ]861 BP$ = "Finance" : B$ = "F." : PR$(1) = PR$(2) + "FIN/" : GOTO 930
  188.  
  189.      And, save the BBS to disk -- that's all the programming it takes to open
  190.  a new board!
  191.  
  192.  CREATING THE BOARD subdirectory
  193.  --------------------------------
  194.      If your boards are all on a floppy in disk 2, the Finance board will need
  195.  a subdirectory called: /FIN/.  Use your copy program to create the new
  196.  subdirectory.
  197.      You'll need one file in it to begin operating the new board, it'll be
  198.  called "F.SUBJECTS".  You can create this file with a word-processor because
  199.  it's simply a zero (0) followed by a carriage return.  Then, save the zero as
  200.  a file named /BDS/FIN/F.SUBJECTS to disk.
  201.      One last step while you have the word-processor running:  load in
  202.  /BDS/B.MENU and add the new Finance board to the list of system boards. You
  203.  can alter the appearance of this menu to your liking!
  204.  
  205.  -----------------
  206.  :     NOTE      :
  207.  -----------------
  208.      For your convenience, a public domain word processor is included on the
  209.  MCM disk.  You can find Freewriter in the UTILS directory.  Written by the
  210.  author of Applewriter, it's a very useful program for maintaining the small
  211.  text files of your MCM BBS.
  212.  
  213.  UTILS
  214.  -----
  215.      Two other programs reside in the Utilities subdirectory.  SETUP writes a
  216.  new USERS file and STATS file -- useful if want to set up a new, empty list
  217.  of calls and callers.
  218.      TOOLKIT is a very basic database program that allows you to access user
  219.  records to change security levels, etc. You can also add new users and print
  220.  a list of users with this program.  If you want to delete a user, just change
  221.  his first name to EMPTY.  You might also want to change the password and
  222.  delete any mail addressed to that PO Box in the POST.OFC subdirectory.
  223.  
  224.  -------------
  225.  :   NOTES   :
  226.  -------------
  227.  1. SETUP will overwrite your existing USERS and STATS files.
  228.  2. Set the prefix to /MCM prior to running SETUP or TOOLKIT
  229.  
  230.  CHAT
  231.  ----
  232.      The chat mode is controlled by (of all things) your joystick!  Center
  233.  for "armed".  Left to disable chat.  Right to force chat.  The joystick
  234.  position is read everytime the main command prompt is encountered.  To
  235.  force the chat mode, or respond to a callers chat request, time your
  236.  positioning of the joystick to "be ready" just before the main command
  237.  prompt comes up.
  238.      (Note that a more elegant chat control is being written by an MCM
  239.  Sysop.  It will be available for downloading from the "home board" by
  240.  registered Sysops).
  241.  
  242.  TO QUIT THE BBS
  243.  ---------------
  244.      Do a Control-Reset, then type:
  245.  ]FRE
  246.  ]&FRE
  247.  
  248.  YOUR TURN!
  249.  ----------
  250.     This concludes the initial MCM BBS documentation.  Additional information
  251.  is available to registered users in the form of Tech Notes and on-line
  252.  bulletins.  If you haven't done so already, I urge you to register as an
  253.  MCM SYSOP by mailing the shareware fee, $39.95*, to:
  254.  
  255.         SofTools, Inc.
  256.         1550 South Dixie Hwy; Suite 208
  257.         Coral Gables, Florida  33146
  258.  
  259.  | *If you are registered with Living Legends Software as being an owner
  260.  |  of ModemWorks, your cost for the MCM BBS is only $20.  The disk that
  261.  |  you receive will _not_ contain any ModemWorks files if you request
  262.  |  this pricing.
  263.  
  264.      Upon hearing from you, I'll mail you a disk which contains the latest
  265.  version of the MCM BBS.  And, your access level at the MCM - SofTools, Inc.
  266.  BBS will be adjusted to provide you with access to the "MCM Sysops Assn".
  267.  You'll find bulletins, program code, a directory of MCM systems, and a
  268.  discussion forum where you can get your questions answered.  It's a great
  269.  place for MCM Sysops!
  270.  
  271.  Sincerely,
  272.  Dave Alden, author
  273.  
  274.  The Magic City Micro BBS
  275.      (305) 661-3802
  276.          300/1200 data
  277.