@L|}6CD l0C)HCC WhL/h `CmCDiD`  R@W1  Y0@R !L` D  C D     )16CS S)  C)D1 p p 0 C9DI pCDL~CiCDiD`Ǫ D  C D     )16CS S)  C)D1 p p }0 C9DI pCDL~CiCDiD` DD˙` d J)L !}D L(( LL()  L| L( S LH 0p n  } CY?  q  L L  ` )}ǝ `A! d߰")-݆ "  $G@LLL&0") $G% }DžH0 3S8`G ȱG ȱG   Gȭ Gȭ GG}GHiH8(()) G$H% `(0 }ǥ)8` d)L ݆ & LGȘ ݆LL d  ! LL d)N>Q  HH) }  hyhyB q L> Lm JJ  Ln*` dB%' }ǰ8  H H` 1 { LL   !L     Hh SY?  q  1L }  !? S   q 1 L   Ll  Lg E`L   !L)  q 1L}) `L0AM݊L݉ ML  N݆LLLNLMLHG!@}1F GȱGLLEEȩÑEȑEEȑE Ed E7EȩE  q} L !,0,0SGɛ L 1 !L EHEh W G gLLSROTCES EERF } G) *Gȩ GȽG GȌd q q G`  8   0G  `D}GCEDC0X:Ȣ Y ȱC* ? 0.. , 0%n ?A[ 0 : L`L  `, 0`Y}`piH n0)բY? 08`0 }  0$L GGȽG L `8L`L}Nj8`  05G)݁,G)ȱGȱGHh0})Hh` B! 8`8iiiLE`}ǠE8FEh( l0`ɃLL L8^~jj8jHi hEEEiEȱEiE` dTE} H8EEȱEEȩEh J E8   . m  i`LI!)E1FR}1LJ舩9GIH`LJJ`HGHh l`} S gL   8 rii `дCDCG W  }#C  Lq` X٨`DOS( ySYS IIIIIIIIIIIIIIIC`0 ߩ0}} ~} e I %|+-3G||DDOS PVDOSDOS[ `SYS sx}~}}}m'},-~} CDOS SYS~}V 0`BDELV !B }`LVUQ   ]   TU J ]L!T  #      TU  } L ? .  t`GBJ V~DEHI B V0dV!}QDEHI VF9 ,0 ,0 s0hhL  L` H hDHEh"}ǢDEL8HI   0 HI,0 0  9 .G VLO#},0 L4*IJ`llD1:AUTORUN.SYSNEED MEM.SAV TO LOAD THIS FILE.D1:MEM.SAV J y08 B|DEHI$}G V0 0`B;DELV䌚 !B y`@ʆ v s? F0Ξ05: [ BDEHI%}% VY8 B V  @  /DE `E:D1:DUP.SYSERROR-SAVING USER MEMORY ON DISKTYPE Y TO &}STILL RUN DOS B;DE J V (` 9 V⪍ ઍ  -'}ǔLLu DEHILV 9 .l 9 .l  `` s$B VBH(}I|DE V BLV nB,DE J V* \*` B V BLVDEHI BLVL)}Ǫ1u H232435; 1 ;  hh@2 e1i1LHҍ 00) 08 109hh@ Ҡ2e*}'1i1232435ޥ<<8tu}} BULLETIN BOARD CONSTRUCTION SET% by Scott BrauseThis documentation may not be copied, photocopied, reproduced, translat,}ed, or telecommunicated in any form, in whole or in part, without the prior written consent of Antic Publishing, Inc.The ac-}companying program material may not be duplicated, in whole or in part, for any purpose. No copies of the floppy disk(s) may.} be sold or given to any person or other entity.Notwithstanding the above, the documentation and accompanying disk(s) may b/}e duplicated for the sole use of the original purchaser.Antic is a trademark of Antic Publishing, Inc.BBCS IIBULLETIN 0}BOARD CONSTRUCTION SET /by Scott Brause4 Version 2.3, for Atari 400/800, 1200XL, 800XL, 130XE computers, 850 or IC1}/D P:R: interface, Hayes and compatible modems4 mProgram concept, design and programming by Scott Brauser Version 2.32}, documentation and editing by Ian Chadwick1 The BBCS II program, including all editors and documentation are Copyright 13}:985, 1986 by ANTIC - THE ATARI RESOURCE and SCOTT BRAUSE? U** GETTING STARTED **Z Zo=BEFORE DOING4} ANYTHING ELSE, BOOT UP YOUR SYSTEM WITH BASIC ENABLED. UNLESS YOU ARE USING SPARTADOS, TYPE POKE 1801,4 AND PRESS RETURN. TH5}IS ESTABLISHES FOUR FILE BUFFERS (SPARTADOS DOES THIS AUTOMATICALLY). NOW TYPE POKE 1802,x WHERE x EQUALS THE NUMBER OF DRIV6}C&ES YOU HAVE ACCORDING TO THIS CHART:+ 0DRIVE: FVALUE FOR XM N1\ ^1e h1,2t v3} 7}71,2,3 7 1,2,3,4& *15/ ALSO, IF YOU HAVE A RAMDISK AS DRIVE 8, ADD 128 TO THE NUMBER. THIS POKE ESTAB8}6LISHES THE NUMBER OF DRIVES YOU HAVE ON YOUR SYSTEM.; TYPE DOS TO RETURN TO THE DOS MENU. FORMAT TWO NEW DISKS AND WRITE9} YOUR DOS FILES TO THEM. MAKE A BACKUP COPY OF EACH SIDE OF YOUR BBCS II MASTER DISK. YOU'LL USE THESE DISKS FOR EXPERIMENTIN:}2G AND EDITING THE SAMPLE BBS AS DESCRIBED BELOW.7 WHEN YOU WANT TO CREATE YOUR OWN BBS, BACKUP SIDE ONE OF THE MASTER DI;}SK AS DESCRIBED ABOVE. ALWAYS WORK WITH A BACKUP, NEVER YOUR MASTER DISK. PUT THE MASTER DISKS AWAY FOR SAFEKEEPING AND TO MA<}KE BACKUPS AS NECESSARY. TURN OFF YOUR SYSTEM AND REBOOT WITH BASIC DISABLED (XL/XE OWNERS HOLD THE OPTION KEY DOWN) AN=}tD YOU CAN START WORKING WITH THE PROGRAM AND ITS EDITORS AS DESCRIBED BELOW. ** CUSTOMER SERVICE FOR BBCS II **x x}=>}=Because of the highly technical nature of BBCS II, we expect users will call us for support. Our?} product specialist can answer your questions and refer you to other BBCS II Sysops who have over 12 months of experience bet@}a-testing the board. We have established a special filing system for BBCS-related questions. To qualify for help, fill A}out your postage-paid warranty card included with this disk according to these instructions and send it to us BEFORE you callB} or write. -WARRANTY CARD INSTRUCTIONS:2 2M-OT 1. On the return address side of the cardC} (the side with the ANTIC logo), print the following IN RED PEN underneath the last line of the address: ATTN: BBCS II TECH SD} UPPORT. 2. On the information (opposite) side, for "Name of Product", print BBCS II -- PACKING SLIP # (your packing sliE}p number) -- TELEPHONE # (your telephone number) -- ORDER DATE (the date you PLACED your order and the method; "check" or "phF}one"). Rexample: BBCS II -- PSL# 14570 -- (415) 957-0886 -- 8/1/85 (check).W USE A RED PEN AND PRINT ALL OF THE ABOG}VE INFORMATION CLEARLY. Do this right away, before you throw out or lose your warranty card. Our product specialist WILH}C[L NOT be able to answer your questions if you don't follow these instructions explicitly.` If you want to leave a messagI}Ie for Scott Brause on his bulletin board, the phone number is (201) 549-7591. If you have a question for Scott, you must leavJ}?e the same warranty information as a header to your question.D d** A NOTE ON COPYING BBCS II **i i}=K} =BBCS II is provided on unprotected disks because the author and Antic both believe that the buyer should be ableL} to make backup copies for his or her use ONLY. Because it is unprotected, we expect you to respect the copyright and NOT givM}e, sell or even lend copies of this program to anyone else. Nor should you accept a copy from anyone; it's the same thing as N}giving one away. The author spent many hours designing, developing, testing and writing this program and continues to wO}ork at enhancing and revising the program from your input and requests. His income depends on its sales - an individual just P}like you who must work for a living. Pirate copies hurt him and make it less than worthwhile to continue to write quality proQ}ducts at such reasonable prices for this market if they are going to be stolen from him. Many other people worked to make thiR}s package what it is; the testers, marketing people, shippers, documentation writers: pirate copies make everyone's efforts lS}kess valuable and discourage quality efforts in the future. Piracy certainly discourages such low pricing.p The term piraT}cy makes it sound like copying programs illegally is exciting, outlaw-ish and brave. It isn't. Piracy is theft. It's as illegU}al as shoplifting or burglary in the eyes of the law. Please help to discourage it so that we may continue to provide you witV})h unprotected software as good as this.. No part of this publication may be reproduced, stored in a retrieval system or W}transmitted in any form or by any means electronic, mechanical, photocopying, recording or otherwise without prior written peX}rmission of the publisher. Antic and the author take no responsibility for any damage resulting from use or misuse of this prY}ogram, nor do we have any liability for any losses, financial or otherwise incurred from the results of using this program.Z}C Even though you can't give out copies of BBCS II, it is alright to give menus and surveys which you have created with BB[}[#CS II to other registered Sysops.( We at ANTIC feel that BBCS II is the ideal BBS program to serve as a standard for all\} Atari boards. Standardization would simplify for everyone the maintenance and support of ANTIC's Worldwide User Network (W.U]}.N.) which would particularly benefit the many Atari user groups across the country. There are many exciting possibilities fo^}r networking BBS's together and BBCS II is the first step towards that. We'll keep you informed (in Antic Magazine or the Cat_}talog) of new products that work with BBCS II as they are released.Antic is a trademark of Antic Publishing Inc.y ** F`} OREWORD ** =A bulletin board system (BBS) is an electronic news, information, message and database systema} set up so one computer (the 'host') can provide all of these service to remote users who call in by phone. The host computerb} is hooked up on the telephone lines by a modem which can answer incoming calls and send out a tone in recognition of the sigc}nal the remote system sends. BBS's differ widely in what they offer and their level of sophistication but they all exist to d}provide the remote caller with a host of services. The person who runs the BBS is called the sysop ('system operator'). They e}oin turn may have co-sysops who help with the task and have access to the editing features in the BBS program.t Most BBS'f}s are small, one micro-computer operations. Some - like Compuserve - are larger, incorporating dozens of mini and mainframe cg}omputers, offering multiple user access to online magazines, games, conferences, special interest groups (SIGS), news, weatheh}Xr, shopping and other features. These are clearly several leagues beyond a simple BBS!] But that doesn't mean you can't i}offer a lot of these features on your BBS; this program is designed to give you the flexibility and power to create and run aj} highly advanced system. This is the Bulletin Board Construction Set; a series of inter-related programs which you use to buik}2ld and edit your own BBS and then run it online.7 BBCS II is a complex program and only experience will reveal all of itl}Gs subtlety and power. In spite of this, BBCS II is remarkably easy to use. Study the preconfigured board; take it apart with m}mthe BBCS II editors and examine how the various menus etc. are assembled. Experiment with all of the options and try as many n}different things as you can. Discuss your board with your users and with other Sysops. It takes a lot of work to be a good Syo}sop as you will discover. That's not to say it isn't fun! It can be very rewarding in many ways. Just as with many other thinp}2gs, what you put in determines what you get out.7 What you do with your board is your decision and responsibility: take q}that responsibility seriously! As a Sysop you will enjoy many hours of interesting entertainment and endure many hours of harr}d work (if you want to be a good Sysop). If you have already been a Sysop, we're sure you will find BBCS II is superior in mas}ny ways to ALL BBS's currently available for the ATARI. If you have suggestions that could improve BBCS II, feel free to sendt} them to ANTIC. We will try to incorporate valid improvements into future versions of the program which will be made availablu}&e according to current ANTIC policy.+ If you are already have some experience with other BBS programs, you may want to gv}o directly to the section for advanced users where all of the menus and sub-menus of BBCS II are described in detail. If you w}7are a novice, please study the section for new users.< A sysop can enable others to help him or her with the workload byx} setting the person's security and privilege levels as well as their sysop flags appropriately. Co-sysops can be given authory}ity on a system from minimal to as much as you care to grant - even equal to your own! But be careful that you don't give thiz}Us ability out to someone you can't trust completely. Dispense such power with care.Z v** ADVICE FOR NEW SYSOPS **{ =={}=Everyone has a different reason for wanting to be a Sysop. Hopefully you decided to become a Sysop|} for a good reason. Please do not turn your BBS into a pirate board (which is mainly used for distributing commercial softwar}}ye). RUNNING A PIRATE BOARD IS A VIOLATION OF CRIMINAL AND CIVIL LAW! Severe penalties can be imposed if you are caught!} ~}G After you've examined the sample BBS, you may want to try to create your own. The steps involved are explained in the sectio}ns which follow. Basically, you start with MEDITE.COM with which you design your BBS's operating parameters. Then you create }your menu structure and any surveys you want to include with with MENUE.COM. You create and edit your message base with MESSA}GEE.COM. Finally, when you have logged some users online, you can edit the user log with USERLOGE.COM. During this process yo}mu will also need to use a word processor to create text files for menus, messages, help files and the like.r When design}ing your board, think of the boards you have called and try to incorporate their best features. If your users give suggestion}s, pay attention to them: they may be able to help make your board better and more enjoyable for all. Be careful of problem u}sers - even the best Sysops get them and they can be quite destructive: leaving obscene messages and uploading pirated progra}ms in order to get you into trouble. Problem users in general should be ignored after their messages and uploads have been er}ased. Many problem users are seeking attention and when they don't get it, they give up. Hopefully, Sysops of other boards wi}ll ignore them as well. Most of all, when running a BBS work hard! BBS's need hard work to run and too many Sysops forget thi}s. ** INTRODUCTION **! !3=BBCS II is a 48k machine language program with which you construct your }own menus, surveys, questionnaires, text files and message bases plus a variety of features found on few Bulletin Board Syste}wms. BBCS II in some ways is like a language: programs written well will work well, those written carelessly will not.| S}ide 2 of your BBCS II disk has a sample bulletin board for you to study. If you feel it meets your needs, go online with it. }This sample board illustrates some basic features of BBCS II. Since it's configured for a single drive, single density, 300 b}aud system, it's a bit limited for long term use. You are encouraged to use it as a starting point on your way to bigger and }better things. BBCS II can be used with most DOS's (Disk Operating Systems) and special support has been included for S}GpartaDOS and other sophisticated DOS's. In general, you will be able to use any DOS that resides below address $2140 hex, inc}luding buffers. The boot for the main program, BBCSBOOT.COM, gives an error message if this memory restriction is violated. F}or some DOS's and system configurations, you may need to change the number of available disk buffers. Disk and file buffers}A are explained in more detail at the end of this documentation.F BBCS II works in most densities and even with relative }sector DOS's. It supports drives 1-8 as RAMDISKS. Full subdirectory support is also provided for SpartaDOS, Mydos 3.18 or gre}ater and Topdos. The versions of DOS recommended for use with BBCS II are as follows, in order of decreasing recommenda}qtion: SpartaDOS 3.x, SpartaDOS 2.x, SpartaDOS 1.x, Smartdos, TopDOS, Atari DOS 2.x (NOT 3.0), DOS XL and MyDOS.v BBCS II} requires a Hayes or compatible modem and either the ATARI 850 or ICD P:R: interface (no other interface is GUARANTEED to wor}k). BBCS II can use the Hayes Chronograph so that the time need not be entered manually each time the system is booted. The R}-Time Cartridge from ICD, Inc., a battery backed up cartridge-based chronograph, can also be used with SpartaDos 3.x or later}, another product of ICD. Under SpartaDos 3.x, the time display list line is disabled automatically when you load BBCSBOOT.CO}?M. BBCS II does NOT require the 850 AUTORUN.SYS file on disk.D BBCS II features password-required logon, time limits and} security levels. Up to 65792 different security levels can be used, including privilege levels and a time limit from 0 minut}es to 255 minutes. The system has a BLACKLIST function for problem users which immediately logs them off as soon as they log }onto the system. Each menu can have as many as 30 entries and each menu entry has its own security and privilege level }(so that an entry can't be seen). The user can select which entry he or she wants while the menu is listing and the listing w}ill stop and execute the command! The only limit to the number of menus you may have is available disk space. Up to 26 separa}te message boards are allowed, each sharing a common file. The message editor has search and replace and a line edit function}C. Xmodem protocol for ATASCII and other file transfers and XON/XOFF for text and other ASCII listings are supported for}x uploads and downloads. Using the BBCS II Menu/Poll editor you can create a miniature election or poll on your system!} }BBCS II runs in ASCII and/or ATASCII, which allows it to support up to 26 different terminal types! This means you can run an} Apple or any other kind of board on your Atari! BBCS II supports text file transfers for other terminals as long as they con}tain only legal ASCII characters. Other types of files (including ATASCII) can be transferred using Xmodem protocols. You hav}^e your choice of XON/XOFF text file transfers, regular XMODEM or AMODEM type file transfers.c In order to offer a BBS wh}ich supports the new generation of computers such as the Atari ST, you will probably want to use ASCII terminal definitions. } Computers other than the XL/XE series are not ATASCII compatible: ATASCII terminals can ONLY support other Atari eight bit u}sers (400/800, 1200XL, 800XL and 130XE). If you plan on supporting every computer, use ASCII -- that's really what a BBS is a}** HARDWARE SETUP ** 0=If you have a Hayes 300 or 1200 baud modem there are 8 configuration switch}es hidden inside. To set the switches, gently pry off the front cover. You should configure your modem so that the switches l}ook like this: :-;@ K| 1 2 3O P4T ]5 6 7a g8 |l | UP UP DOWN DOW}N DOWN UP DOWN DOWN | @-BG Note: Switch 7 depends on your phone configuration, it}! makes no difference to BBCS II& If you have a non-Hayes modem with a different switch configuration, you may not know w}7hat this means. Here is how your modem should be set.< 1) Data Terminal Ready (DTR) must be under control of the compute}r. ;2) The modem should not be set to echo characters.@ u3) The carrier detect lead should not be held true.z If }you own an Anchor Mark XII 300/1200 baud modem, refer to the addendum at the end of this manual for information specific to y} our modem. Your modem must be plugged into port #1 of your 850 interface. If you have a Hayes or compatible chronograph}G, plug it into port #2. The time separator should be entered as a ':' and the date separator should be entered as a '/'. } The MINIMUM computer requirements are as follows: an ATARI computer with at least 48K of RAM and one 5 1/4" 40 track disk d}2rive. Additional disk drives can be added later.7 Your BBCS II disks come on two SINGLE DENSITY DOS 2.0 formatted disks,} WITHOUT DOS. Follow the backup instructions described earlier to transfer the program files onto disks with DOS on them. DOS}'s you can use include Spartados, Smartdos, Topdos, Atari DOS 2.x, DOS XL and Mydos. In general, any DOS residing below $2140}O, including buffers, may be used. You may also use BBCS II in double density.T In using this manual, you are encouraged }Mto refer back and forth between sample BBS and the BBCS II Editor section.R q** THE SAMPLE BBCS II BOARD **v v}=}=The second side of the program disk contains the sample BBS created with the BBCS II editors. All of} the files on this side are required to run the sample board. Two special files - BBCSBOOT.COM and BBCS.COM - along with the} editors on the reverse are REQUIRED to create and run your own BBS. The rest of the files are system files for this sample b} oard only. AThe following files are to be found on side 2:F SBBCSBOOT.COMX \BBCS` e.COMj wCONFIGUR.SYS| M} ENUMAIN.SYS MENUGBYE.SYS# 0MENUSYOP.SYS5 BMENUBORD.SYSG TMENUDOWN.SYSY fATARINEW.TXTk xSAMPLE .DNL} } MESSAGE .DAT MESSAGE .ISM$ 1USERLOG .SYS6 CSTATUS .SYSH ULOGON .SYSZ gNEWUSER .TXTl ySYSBULL1.SYS} } SURVEY .SYS /** EXPLANATION OF FILES **4 4N=PV BBCSBOOT.COM - This is the boot loader }for BBCS II and all editors. BBCS.COM must be on drive one. Binary load BBCSBOOT.COM and it in turn will boot BBCS.COM. This }5is the only file that can be loaded using BBCSBOOT.; BBCS.COM - This is the actual bulletin board program, loaded by BB}E&CSBOOT.COM. It MUST be on drive one!+ @THE BBCS II EDITORS:D DU-W\ MEDITE.COM - This is the configur}aation editor which is used to define BBCS II functions, message bases and terminal definitions.f MENUE.COM - This is the}N menu and survey editor you use to create menus and surveys for your system.S MESSAGEE.COM - This is the message base ed}Citor, used to compact the message base and delete message boards.H USERLOGE.COM - This is the userlog editor which allow}Hs you to edit userlog entries, compact the userlog and validate users.M gTHE BBCS II SYSTEM FILES:k k}-} -  FILE24.TXT - If the proper options are set in 'MEDITE.COM' this file is created at 1:00 am every day. It cont}ains a list of callers while the BBS was online. This file is not on your sample board. It may be created by selecting the pr}oper option in MEDITE.COM. It must initially be created with a word processor (Atari DOS compatible) and named FILE24.TXT. } LOGON.SYS - This text file, if on drive 1, is shown before asking any caller information. It is shown on each call and is}! abortable by typing control-C.& SYSBULLN.SYS - These text files, if on drive 1, is shown to each user that logs onto yo}ur BBS. They are only shown once if you have a PASSWORD system and are not abortable. N is a number from 1 to 5: up to 5 of t}hese files may be online at any time. In each userlog file, the log on message flags indicate if a text file has been read. T}1hese flags are numbered 1-8 from RIGHT to LEFT.6 MFLAGS: - - - - - - - -Z k8 7 6 5 4 3 2 1p Flags one thr}ough five indicate which system bulletin message(s) have been read. Flags six and seven are currently unused. Flag 8 indicate}1s whether or not the user has read NEWUSER.TXT.6 NEWUSER.TXT - This text file if on drive 1, is shown to all users once.}A This file usually contains critical information for new users.F CONFIGUR.SYS - This data file should be created by MEDI}T.COM. It contains options, message base definitions and terminal definitions. If not on drive 1, your BBS will not function!}C STATUS.SYS - This file, created by the initialization portion of MEDIT, contains pointers into the data bases and stat}Kistical information. For your BBS to work properly it must be on drive 1.P USERLOG.SYS - This file contains USERLOG entr}ies. Even if your system is set up to be used without passwords, this file contains YOUR Sysop password. It must be on the dr}Iive that you selected for it to be on in MEDIT.COM to operate properly.N MESSAGE.ISM - This data file contains pointers }to the message base file ('MESSAGE.DAT'). This file and 'MESSAGE.DAT' are important: if either one of these files are damaged} or destroyed, your message base is as good as gone. This file must be on the same drive that you selected it to be on in MED}IT.COM to operate properly." MESSAGE.DAT - This data file contains text and other information related to messages. It mu}Yst be on the same drive that you selected it to be on in MEDIT.COM to operate properly.^ MENUMAIN.SYS - Upon completing }logon, the system looks for this file. It is your main menu and is be created with MENUE.COM. MENUMAIN.SYS and ALL files with}j the form 'MENU1234.SYS', where 1234 stands for a four letter menu name, are your additional menu files.o ATARINEW.TXT -} This is a sample text file created with a word processor, called option 'A' on your sample board. You may change the content}s of this and any of the supplied text files but they may NOT contain any control characters! If you use a word processor to }lcreate text files and most of us do, REMOVE any control characters before putting this file on your board.q SURVEY.SYS -}= This contains your online survey, created by MESSAGEE.COM.B pSAMPLE.DNL - This is a sample download file.v Turn yo}ur modem and interface on, insert a copy of the sample board disk with DOS on it into your drive and boot the disk. If you ha}ve an Atari 800, make sure the BASIC cartridge has been removed. If you have an 800XL or a 130XE, BBCSBOOT.COM will automatic}ally disable BASIC. From your DOS menu enter the appropriate choice to binary load of the file BBCSBOOT.COM (ie: 'L' with DOS} . 2.0). In a few seconds, the interface boots and the board comes up. You are prompted to manually enter the date and }Gtime (enter all three fields for each). If you select manual time entry when designing your BBS with the configuration editor} (MEDITE.COM), you are prompted to enter the time and date. After about 1 minute, if you make no entry, the system defaults t}o a date of 00/00/00 and a time of 00:00.You are now at the status screen of BBCS II. The top portion of the screen shows on }Kthe host system (yours if you're the sysop) but not on the user's screen:P TNME:e jFIL:o sLOC:} } TAL: PSS: "RW:& +SC:0 This tells you the name (NME), location (LOC), time allowance (TAL) and passw}ord of the current user (PSS), their privilege level (RW) and both security codes (SC). This permits you to monitor the users} as they call your BBS. These items are all explained later in the editor sections. Below that your screen has the following:} Current date ':mm/dd/yy, 8Current timeB L:hh/mm/ssQ ^LAST CALLER #g h:mnns MESSAGES D}ELETED :n (NUM. OF MESSAGES. /:4n5: ENEW UPLOADSP Q:VnW\ jCHAT CONDITIONr u:z Fre}e sectors Drives 1 -n 5Drive 1: xxx FREE SECTORS: UDrive n: xxx FREE SECTORSZ This is for a one drive system. If }additional drives are online, their free sectors would also be indicated. If you ever see at the bottom of the status screen:} !COMPACT USERLOG! - your userlog is full and requires compacting with the program USERLOGE.COM. If you see !COMPACT MESSAGE }BASE! - your message base is full and requires compacting with the program MESSAGEE.COM. The chat condition is as defined in } the configuration editor also.& Now press the SELECT key to log on as a new user (IMPORTANT: use the name 'SYSOP' when }you create your own system; for now you can use any name) to view your board on your screen exactly as a caller would view it} on his screen. After you've logged on as a user, log on as the sysop by pressing START and see what the difference is. You s}ee: *ASCII OR ATASCII PRESS RETURN:/ If your BBS is set up for both ASCII and ATASCII input and you have separate f}iles for each, this enables the system to determine which mode the caller is using automatically. Pressing RETURN on your At}Gari will always log you on in ATASCII. If you want to log on in ASCII press CONTROL M. After pressing the RETURN key or CON}TROL M, you see: >BBCS - COPYRIGHT (C) 1985 SCOTT BRAUSEC cfrom ANTIC - The Atari Resourceh h}=}= $Welcome to) NThe Bulletin Board Construction SetS hfrom ANTIC MAGAZINEm ENTER YOUR FIRST} AND LAST NAME >(--<==2 When you use the user log editor, you'll see that user 1 - you - are define}d as 'SYSOP' (in the sample BBS, the first user is already set up; you'll be told 'name already logged on'; so enter another }name). You'll also see how your flags are set for access. Later, when you initialize and create your own board, you'll be abl}Ye to set your own password. After entering 'SYSOP' you are asked if you are a new user:^ yAre you a new user (Y/N)?} } Enter 'Y'. You are prompted for your CITY and STATE and if you would like a password. You have the option of NOT requiring }a password on your own board when you create it. Next, answer with your current time zone. The information will be shown to y }Uou again and you'll be asked to confirm it all. If correct, you are logged to disk.Z After you are logged on, you see an } information screen stating which user you are, the time and the state of the message board. New users also see the new user }bulletin. A user is also told if he or she has mail waiting or not. Follow the prompts with the appropriate responses until t }'he main menu of your board comes up:, ;BBCS MAIN MENU@ @N=PU ]tari e.yAtari news and info} } oards.'Access message boards, 2hat<.LChat with sysopQ rown/Upload...Program transferw ile } .List log of users! *oodbye1.BLog off the BBCSG Pang upW.hQuick disconnectm nformation... }System information ist(.ystemQ.gTime at this locationl rime|.Y }our local time tilities$.3User utilities8 >iewH.\Show survey resultsa gingq.Take a surve }y +-,0 V- NEXT CLUB MEETING IS THE MM/DD/YY -Z Z}- }C-- COMMAND> As a sysop, you'll see another menu option: perator; the system control section which leads into a }  menu only you or those co-sysops you've authorized can get to. When you log off, you get another report on your status as a } caller. The process of creating and linking menus is explained in the section on the menu editor. Each line in the menu }r above is governed by a menu option which tells the system what type of action to perform when a key is pressed.w Explor }e each of the commands and menus thoroughly: it is important for you to understand exactly how these menu selections function } on this sample board. Using the BBCS II editors, you can 'take apart' each functioning unit of the board and examine how it }%was constructed by the programmer.* @INSIDE THE SAMPLE BBSE E]-_d Reboot your system with t }he disk containing the BBCS II editors and binary load the file 'MEDITE.COM', the Configuration Editor. We will examine this }and the three other editors in detail later. After loading, re-insert the sample board disk. From the menu, enter option 'H', } load configuration files. After the file loads into memory, enter option 'C', edit options. You'll see some of the parameter }us set up by the programmer to establish this board. These options are completely modifiable to suit your own needs.z Typ }e 'E' to return to the menu and then type 'D', edit message board. The preset options of the main board are displayed. Type ' }N' to see the options for the next board (SYSOP). There are 5 pre-defined boards on the sample disk to examine. If this seem }cs a bit confusing now, it will all become much clearer when you read the sections on the editors.h Creating a BBS is don }e through the editors. You can start from scratch or modify this sample board. Begin with MEDITE.COM to define the way the sy }stem will operate and then go on to MENUE.COM to create your menus and define their functions and responses. To prepare messa } &** THE CONFIGURATION EDITOR **+ +I=MEDITE.COM is the main editor, used to define from } 1 to 26 online message bases, set various bulletin board options, define up to 26 different terminals for your users and ini }Gtialize message bases and userlog areas, all in a single BBS. All of the editors automatically recognize if they are being us }Ved from DOS or BBCS II using the external load option described in the menu editor).[ Use your DOS binary load function }Eto load MEDITE.COM. You are presented with the following main menu:J hCONFIGURATION EDITOR VER. 1.0m FROM ANTIC - THE } ATARI RESOURCE 6COPYRIGHT (C) 1985 SCOTT BRAUSE; XA) Initialize bulletin board] yB) Create new configuration} !} C) Edit options -D) Edit message boards2 OE) Edit terminal definitionsT lF) Add message board(s)q G) Add Termi "}nal Definitions 1H) Load configuration files6 RI) Save configuration filesW iJ) Return to DOSn If using the on #}=line version, the following additional menu options appear:B dJ) Load config. files from memoryi K) Save config. file $} s to memory $L) Return to BBCS) 9ENTER COMMAND>> [A: INITIALIZE BULLETIN BOARD` `|- %}ǛThis is the main menu selection that initializes your BBS. After entering 'A' the following sub-menu will be displayed: &} 1) Complete initialization" =2) Initialize userlog onlyB b3) Initialize message base onlyg 4) Change number of ca '}llers ,5) Increase size of message base1 M6) Increase size of userlogR h7) Exit to main menum ENTER COMMAND> (} 1) COMPLETE INITIALIZATION. Option '1' initializes your message areas, userlog area and status file. Your screen clears )}and you are asked if you want to initialize the bulletin board. Type 'Y'. Now enter the drive numbers (from 1-8) for the MESS *}AGE.DAT and MESSAGE.ISM files. Enter the drive number alone, without any 'D:'. Next, the system prompts you for the number of +} sectors (in DOUBLE DENSITY) for the MESSAGE.DAT file. This does NOT mean that double density sectors will be written out! I ,}t just means that if you are using a single density drive, twice as many sectors will be written out as the number specified: -}7 single density drives are quite limiting to a Sysop.< The file MESSAGE.DAT holds messages and some message header infor .}mation. Choosing the number of sectors for this file is very important. The maximum size each message can take up is 1940 byt /}Ges (about 15 single density sectors). However, on the average, a message is no longer then about 477 bytes (4 single density 0}0sectors). So, when trying to decide how many sectors to allocate, you should figure that each message takes about four sector 1}s. If you decide later that your MESSAGE.DAT file size is too small, use option '5' to increase its size. Remember that the M 2}IAXIMUM number of messages you can have online at any given time is 257.N After you chose the number of sectors for the M 3}ESSAGE.DAT file, do the same for the USERLOG.SYS file. USERLOG.SYS is the where all userlog entries are stored. Choosing the 4}number of sectors for the USERLOG.SYS file is much easier then choosing for MESSAGE.DAT: each userlog entry occupies 122 byte 5}s (about 1 single density sector). Unless you are configuring a name-only system (no passwords) you should assume at least 50 6} users as a minimum. mThe system will now create 4 files on your diskette. You will see the following:r Writing MES 7} SAGE.DAT... (Writing MESSAGE.ISM...- DWriting USERLOG.SYS...I _Writing STATUS.SYS...d ej That's it: your mes 8}+sage and userlog areas are now installed.0 2) INITIALIZE USERLOG ONLY. This option initializes your USERLOG only. It sho 9}uld ONLY be used if your bulletin board has already been initialized using option 1. When using this, you must have STATUS.SY :}S on the SAME DISK you boot with or the USERLOG.SYS file will not be properly initialized. There are two main reasons for usi ;}ng this option: f1) If you want to keep all your current messages but want to delete all users.k 2) If your USERLOG <}H.SYS file was destroyed or damaged and you do not have a backup of it.M To initialize your userlog only, follow the inst =}7ructions under option 1 for initializing the userlog.< 3) INITIALIZE MESSAGE BASE ONLY. This option initializes your MES >}SAGE base only. It should ONLY be used if your bulletin board has already been initialized using option 1. When using it, you ?} must have the STATUS.SYS file on the SAME DISK you boot up with or the MESSAGE base files will not be properly initialized. @}3There are two main reasons for using this option:8 1) If you want to keep all userlog entries, but erase all messages. A}C d2) If your MESSAGE base files were destroyed or damaged and you do not have a backup of them.i To initialize your m B}B^essage base areas, follow the instructions under option 1 for initializing the message base.c 4) CHANGE NUMBER OF CALLER C}S. This option changes the record of the number of callers to your BBS. The number is displayed on both the STATUS screen (wh D}Uich you'll learn about later) and when each user calls. The following is displayed:Z uEnter number of callers :z Whe E}n you type in the number of callers you wish to have displayed (5-65536), the STATUS.SYS file is updated to show this new num F}ber. 5) INCREASE THE SIZE OF THE MESSAGE BASE. Option '5' increases the size of the message base. This is useful if you G} did not choose enough sectors for your message base with option 1. The message base MUST have been initialized with option 1 H} previously or you will not be able to increase the message base size. The file STATUS.SYS MUST BE ON DRIVE #1 and the file M I}JESSAGE.DAT must be available on drive 1-8. The following prompts appear:O xEnter the drive number for MESSAGE.DAT:} J}Input # of sectors to add: DOk to add sectors to MESSAGE.DAT ?I Input the drive number which contains the MESSAGE.DA K}T file, then the number of sectors (>= 5) you wish to add. Press "Y" and the message base size will be increased.ESSAGE.DA t 6) INCREASE SIZE OF USERLOG. Option '6' increases the size of the userlog to allow more userlog entries. This is usefulM} if you did not choose enough sectors for your userlog with option 1. The userlog must already have been initialized with optN}ion 1 or you will not be able to increase the userlog size. STATUS.SYS and USERLOG.SYS files must be on drive one. The followO}ing questions are asked: :Input # of sectors to add:? cOk to add sectors to USERLOG.SYS ?h Input the number of sP}Tectors (>= 5) you wish to add. Press 'Y' and the size of the USERLOG is increased.Y 7) EXIT TO MAIN MENU. This returns yQ}ou to the main menu. 7B: CREATE NEW CONFIGURATION< he number of rings the modem will wait for before answering.C LOGON TRANSLATIONS: This determines which character type i]}2s supported by the system; ASCII and/or ATASCII:7 0 - ASCII/ATASCII operation. This allows BOTH forms to be used but it ^}also requires that you have additional files to support the two modes. You specify whether or not you want to have separate f_}Uiles for the two when you initially create a board configuration (described later).Z u1 - ASCII only operation.z 2 -`} ATASCII only operation. oLOG ON OPTIONS (0-4): This controls what type of log on entry your system has:t 0 - Asks a}tfor the name and location of the person logging on. No password is asked for and no userlog entry created on disk.y 1 - b}First ask the user for their name, then ask if they are a new user. If they aren't a new user, they are asked to enter their c}password and a search is made for their userlog entry. If they respond with an 'N' at the new user prompt, they are prompted d}?for all information (including. password) in order to log on.D 2 - Works in much the same way as option 1. The main diffe}Gerence is that instead of asking for the user name first, the password is requested first. If the user does not have a passwof}fCrd they will have to press return in order to register a new one.H 3 - Password only is requested. If a remote user doesg}n't have a password, it won't let them on. If you log on in local mode (through BBCS II), press RETURN to enter the BBS. Thisq} bdB'DOS SYSB+DOC (000BrDOC- 8001B1DOC= H002BILDOCM X003BWDOC] h004B0DOCm x005B-$DOC} 006CBQDOC 007BhDOC 9008B-AUTORUN SYSB FONT= @SETqL allows the sysop to set the BBS up in advance and enable passwords later.Q 4 - Exactly like option 1 except it doesn't r}Aask the user for a password and doesn't log their name to disk.F SYSOPS PASSWORD (1-8 Char): This asks for the sysops pas}ssword. Please do not enter 'SYSOP' here as you did to log on to the new board!. This password can be any combination of 1 tot} 8 characters (upper case only). It allows the sysop to log on from a remote location (explained in BBCS II logon section) anu}1d is needed for the online format disk command.6 TYPE OF SYSOP LOG (0-3): This controls whether or not the sysop is counv}vted as a user when adding up the number of callers, or when logging to the 24 hour file. The options are as follows:{ 0 w}C_- Count the sysop as a user when totaling the number of callers and log name to 24 hour file.d 1 - Log SYSOP to 24 hour x}xfile and count as caller. J2 - Log SYSOP name to 24 hour file only.O 3 - Don't log to disk or count as caller. y} CALCULATE SEND TIME (Y or N): Determines whether or not the BBS will figure and display the length of time required to sendz}1 a file to the user at their current baud rate.6 DESTROY INFO FILE (Y or N): If you answer yes, the user information fil{}Qe (USERINFO.SYS) is destroyed every time you log on AND every day at 12:00 A.M.V 24 HOUR FILE OPTIONS (0-2): This defin|}es how the 24 hour file list of users (USERINFO.SYS) is reported. A 24 hour file is automatically updated at 12:00 A.M. every}} morning. >0 - Do not create a 24 hour file in any way.C r1 - Log 24 hour file to disk as USERINFO.SYS.w 2 - Lo~}g 24 hour file to printer.! USER LOGON INFORMATION LOG: This controls the information that will be logged into USERINFO.}ZSYS, above. You must enter either a '+' or '-' in each of the 15 flag spaces as follows:h hn1ot 123456789}012345 ." 61: Log user's name.; S2: Log user's location.X m3: Translation type.r 4: Baud rat}e. 5: Log on time. -6: Log off time2 X7: Messages read (reports message #).] 8: Messages left (reports messag}e #). 19: Files uploaded (reports filename).5 ^10: Files downloaded (reports filename).b 11: Warnings given (see bel}ow). "12: External load files.& ?13: Illegal disconnects.C U14: Surveys read.Y m15: Surveys taken.r Warnings ar}e given by the system when a user has 5, then 1 then no time left online or they 'time-out' as an idle user (no activity for }_a specified length of time). The length of time they have is also set by you in this section.d ALLOW ATTRACT MODE (Y OR }N): This determines whether the ATARI attract mode is entered when there is no one on the system. The attract mode rotates sc}ereen colors after 9 minutes of inactivity. Answer 'Y' for attract mode and 'N' for no attract mode.j ECHO PASSWORD (0-2)}K: This controls how passwords will be echoed back to the caller at logon:P r0 - Do not echo password at all.w 1 - Su}C(bstitute asterisks for password typed.- Z2 - Echo password exactly as typed by user._ DUPLICATE LOG NAMES (Y OR N): }If your system is configured as a name-only system, this is not applicable (answer 'N'). If you are using a userlog type syst}Dem this determines if two users are allowed on with the same name.I u'Y' - Allow to users on with the same namez 'N'}4 - Don't allow multiple users using the same name.9 USERLOG DRIVE NUMBER (1-8): This determines the drive that the USERL}OG.SYS file will be on. IDLE USER TIMEOUT (0-255): This determines the amount of time (in minutes) before an idle user }Eois logged off. A value of three minutes is a reasonable choice. Any value less then three will not work well.t NEW USER }uCALL TIME (0-255): The amount of time (in minutes) a new user is allowed on the system before being autologged off.z NEW} USER SECURITY: SEC1: This determines ALL NEW user's (ie first time online) access security to your BBS. A user's security ca}n be changed BY YOU ONLY later through the user log editor (USERLOGEE.COM). SEC1 and SEC2 are used in menus and on message ba}ses to decide whether or not a user can access them. Security is not expressed in numbers; it is expressed in a system of eig}ht combinations (for EACH security level for a total of 16) of plus or minus signs where the plus sign ('+') allows access. S}Lecurity levels are hard to understand so an example best illustrates them.Q WEX. 1\ Missing plus sign in position 6 (} no access) Position:* 4:123456789 UUSERS SECURITY 1 LEVEL. :-+[-\a SECURITY 1 OF MENU ENTRY :-+}---+-- Here the user would not have access to the menu entry since they do not have a plus sign in position six and the} security level shown below demands a plus in BOTH positions 2 and 6 before access is allowed. In security levels, the '+' si}gns are what matters not the '-' signs. The plus signs for this example did not match. In order for the user to have access t}Zo the menu entry in this particular case, SEC 1 of the user would have to be as follows._ jExample #2o Plus signs now} match (access) Position:/ 9:12345678> aUSERS SECURITY 1 LEVEL. :-+---+--f SECURITY 1 OF MENU ENTR} Y :-+---+-- In this example, the user would have access to the menu entry. For each '+' sign in the menu security there} is a corresponding '+' sign in the user's security level. The user's security level does not have to match character for cha} Example #3 3The '+' signs match (access)8 APosition:Q [:12345678` USERS SECURITY 1 LEVEL :-++}+-+-- /SECURITY 1 OF MENU ENTRY :--+--+--4 In example 3 the user would still have access to the menu entry. The '+' }Gsigns match in position 3 and 6. The '+' signs in user security position 2 and 4 don't matter since positions 2 and 4 in the}" menu security are minus signs.' NEW USER SECURITY: SEC2: New user SEC2 is used in exactly the same way as SEC1. It sim}ply acts as an extension of SEC1 in order to give you more security levels so instead of having only 8 spaces you have 16. Th}bis gives you a total of (2^16)+256 (256 privilege levels) or 65792 security levels! For example:g qPositions:w :12345}678 :12345678# ,USER SEC13 F:-+-+-+-- USER SEC2M N:S-W+--\ MENU ENTRY SEC1 :-+-+-+-- MENU EN} TRY SEC2 :-+-- Here the '+' signs in SEC1 and in SEC2 match, so the user is allowed to access this particular menu }mentry. However, had EITHER one of the two levels not matched correctly, the user would NOT have had access.r NEW USER PR}IVILEGES (0-255): In addition to the security levels, you have another user-screening function: the new user privilege option}, similar to an extension of security. However, privileges work in a slightly different way. The privilege level of a user de}termines whether or not a user is allowed to see a menu entry or message in an area of the board where the user has access. } For example, a user may have the correct security to access a particular menu but not have the privilege to see some of} the menu options. If the user's privilege level is less than the menu or message privilege level, then the menu or message i}s not displayed. If the user's privilege level is greater than or equal to (>=) the menu or message privilege level, then the} menu or message is displayed. Enter a number between 0 and 255 for the user at the prompt. The greater the number, the great}er the access he or she has.# BAUD RATE (0,1,2): BBCS II supports 300, 1200 and 2400 baud rates. Enter '0' for 300 baud }>only, "1" for 300/1200 baud and '2' for 300/1200/2400 baud.C SHOW NEW USER TEXT (Y OR N): If you type 'Y', the text fil}e NEWUSER.TXT on drive one is shown to all new users the first time they log on. If you type 'N' the file is not displayed. T}ihe NEWUSER.TXT file should be created with a word processor and must be on drive one if you answer 'Y'.n MESSAGE BASE DR}GIVE (1-8): Enter the drive number for the file MESSAGE.DAT created with option '1' of the sub menu (no need for the 'D' ident} ifier). MESSAGE POINTERS DRIVE (1-8): Enter the drive number for the file MESSAGE.ISM created with option '1' of the su} b menu. CHAT BELL RINGS (0-255): This limits the number of times a user can try and chat with you. After this number of}G calls, BBCS II tells the user that the sysop has already been paged.L SCREEN HUE (0-16): This sets the background HUE (}jcolor). The value used in the Atari screen editor is '9'. Experimentation will determine the best value.o SCREEN LUMINAN}CE (0-16): This sets the background luminance (brightness). The value used in the Atari screen editor is '4'. Again, experime}(ntation will determine the best value.- CHARACTER HUE (0-16): This sets the character hue for BBCS II. The value used in} the Atari screen editor is '12'. Make sure both character hue and character luminance are not the same as screen hue and scr}een luminance. CHARACTER LUMINANCE (0-16): This sets the character luminance for BBCS II. The value used in the Atari s}creen editor is '10'. DOWNLOAD LIMIT (0-255): This limits the number of downloaded files for a user on each log on. }g EXTERNAL TIME CLOCK (0,1,2): This establishes the use of an external clock to set the system time.l 0 - Manual time e}^ntry method. On booting the main board you are prompted to manually enter the date and time.c 1 - Hayes chronograph hook}ied into 850 port #2. The time separators must be set as ':' and the date separators must be set as '/'.n 2 - R-time cart}Lridge from ICD. This cartridge MUST be used in conjunction with Spartados.Q TIME ZONE FOR SYSTEM (0-8): This enables the}i time zone conversion which translates the time seen on messages and otherwise to the user's time zone:n 0: Disables tim}e zone translation. 41: Atlantic Standard Time.9 I2: Eastern S.T.N ^3: Central S.T.c t4: Mountain S.T.y 5: P} acific S.T. 6: Yukon S.T.$ :7: Alaska-Hawaii S.T.? O8: Bering S.T.T ALLOW BELL CHARACTER (Y OR N): This filte}rs out the ASCII bell character (CONTROL-G, ASCII 7) when a user types it, useful when they type too many bells in messages.}C MAIN MENU DRIVE NUMBER (1-8): This locates the main system menu on any drive number, from 1 to 8, of special importance} to users of various Ramdisks. Please refer to the addendum on the use of the Axlon Ramdisk and the Atari 130 XE Ramdisk. } WRITE BACK .ISM DRIVE (0-8): This forces BBCS II to write MESSAGE.ISM files to an additional disk drive (0 disables), usef}ul to copy files to floppies as well as RAMdisks so no additional back up is required later. This should be enabled together }with .DAT file write back.! dWRITE BACK .DAT DRIVE (0-8): Same as above for MESSAGE.DAT files.i WRITE BACK .SYS DRIV}/E (0-8): Same as above for USERLOG.SYS files.4 WRITE BACK STATUS DRIVE (0-8): Same as above for STATUS.SYS files. Should}? be enabled if any of the other write backs are also enabled.D SEPARATE ASCII/ATASCII (Y/N): This defines whether or not} you'll have separate files for ATASCII and ASCII callers.If you do, you'll need two of each of these files: menus, newuser t}Vext, system bulletins and logon text. For ASCII users the names will be as follows: [ _MENUcXh.SYSm yNEWUSER.TXT} } SYSBULLN.SYS OLOGON.SYSFor ATASCII users the names must be as follows:T XMENU\xa.ATAf sNEWUSERA.TXTx SYSAT}N.SYS LOGONAT.SYS BBCS II automatically selects the correct file and in the case of menus, adjusts the extender to} and from the .ATA. ATASCII users can take advantage of Atari graphics which would appear to ASCII users as 'garbage' charact}5ers in a file (one good reason to separate files!).: After completing the above, you will automatically enter the next s} ection. CONFIGURE BOARDS$ $4-This section defines from 1 to 26 totally separate message boards. You }6first see a prompt for the name of the message base:; ZENTER A 1 TO 16 CHARACTER NAME_ mFOR BBS #01:r Enter the n}ame for your board; it can be edited later, so don't worry if an error is made. After entering the board name, the type of bo}ard is asked for: 1TYPE OF BOARD (R or P):6 Type 'R' if you want this BBS to be a regular board (messages are reada}ble by all) or 'P' if you want the BBS to be a private board (messages are only readable by the person to whom they are addre}CSECURITY 2 FOR BOARD :C These options are related to the previous security levels }which you already entered. They are compared to the user's security levels and if the '+' characters match, then he or she wi}ll be allowed to read the message. Enter the 8 character combination of '+' and '-' characters for each security level you wa}nt. 4The next prompt is for privilege access.9 SPRIVILEGE ACCESS (0-255)X The privilege access for messages is }used exactly like security for messages. The user privilege is compared with the message board privilege level. If the user's} privilege is less than the message board privilege, the messages on that board are not displayed nor is the user allowed to }!enter the message read section.& After entering the privilege access, the screen clears and the BBS name question appear}s. A minimum of one message board is required, so when you have the number of message boards that you want, press return and }nthe create terminal definitions section is displayed. Remember: as many as 26 message boards may be defined.s CREATE TER}MINAL DEFINITIONS 2-This section defines from 1 to 26 terminal definitions for users which in}Gclude important information to configure your system to act like a certain terminal. Users can be given the option of selecti}Hng from any of your terminal definitions when they sign onto your BBS.M The first prompt asks for the terminal (or compu}ter) name, up to 16 characters in length (ex. ATARI). Next, enter the length of the screen in columns or characters (ex. 40).} Then answer whether or not the terminal can handle lowercase; Y or N. Enter the number of nulls (nulls are 0's sent at the e}nd of each line for computers that require them) from 0-255. Nulls give the system time to move from displaying the end of a }>line to the beginning of the next without losing characters.C If line feeds are needed, enter Y. Line feeds are CONTROL-}J characters (ASCII 10). A LOT of terminals need line feeds. Next enter the three-sequence clear-screen codes (ASCII values) }for the terminal. Some terminals need more then 3 sequences; in that case enter 000:000:013 which puts in a return character }(ASCII 13) instead of clearing the screen. The clear screen code must be in the format NNN:NNN:NNN and all numbers (including} 0's) must be included. The terminal name prompt appears again after the screen clears. If you wish to add more termina}ls type in the terminal name. If not, press return and the main menu is redisplayed. Up to 26 terminals may be defined for a }single BBS. Here are 6 terminals/computers and their configurations (codes for other computers can be obtained from their own}ers manual). In the menu editor, option 22 offers the user their choice of terminals.puters can be obtained from their ownX TERMINAL =LENGTH L-CASE NULLS LINE FEEDS CLEAR SCREENx=ATA}RI 6502 40 YES 0! #NO, H125:013:000APPLE II,II+ 40L NNOT U0\ _YESg 000:000:013APPLE IIE,}IIC 40 YES 0 YES% A000:000:013APPLE 80 COL 80E HYESM N0U WNO` r000:000:013TRS-80z 64 } YES 0 YES 2031:028:013ATARI ST8 :80> AYESF G0N QYESY h000:013:013l C: EDIT OPTIONS } -NOTE: Options 'C' through 'G' require that you have previously configured and saved a board. You MUST us}Ge option 'H'- Load Configuration files BEFORE you use these options! This feature edits the 39 configuration options; the fir}6st 18 options are shown with a prompt at the bottom:; P01: Type of chat modeW Y:^ u02: Type of chat devicez : } 03: Rings to answer ":' ?04: Logon translation(s)C E:J \05: Log-on optionsf h:m 06: SYSOPS passw}ord : (07: Type of SYSOP log/ 1:6 M08: Calculate send timeR T:Y n09: Destroy info fileu w:| 1}0: 24 hour file options :" :11: User information log> @:E [12: Allow attract modea c:h y13: Echo password} } : %14: Duplicate log names* ,:1 F15: USERLOG.SYS driveM O:T i16: Idle user timeoutp r:w 17: Ne}w user call time : <18: New user security: SEC1 :A \EXT, ODIFY, XIT:a After the colons, your previ}(ously selected values are displayed.- To modify an option, type 'M'. You can modify individual options by entering the}v number of the option and answering the prompt. 'E' exits back to the main menu. 'N' displays the remaining options:{ 19}: New user security: SEC2 :! 820: New user privileges= ?:D Q21: Baud rate` b:g 22: Show newuser text } : #23: Message base drive) +:0 N24: Message pointers drive :S f25: Chat bell ringso q:v 26: Scr}een hue : 027: Screen luminance8 ::? P28: Character hue[ ]:b y29: Character luminance} } : 30: Download limit$ &:+ B31: External time clockG I:N f32: Time zone for systemj l:q 33: Allow be} ll character : 534: Main menu drive number :: X35: Write back .ISM drive :] 36: Write back .DAT drive : }! 37: Write back .SYS drive :& D38: Write back status drive :I g39: Separate ASCII/ATASCII :l mr ext }odify xit  3D - EDIT MESSAGE BOARDS8 8O-This is similar to option 'C' in that it is  }lused to selectively modify one or all options of previously defined message boards. You see the following:q Entry number }: 0: Name of board ":' 71: Type of board? A:F V2: Multiple read^ `:e t3: Private save}  }C: !4: Sender info on scan :& @5: Receiver info on scan:E Y6: Date info on scan] _:d 7: SECURITY 1 FOR BOARD : }  8: SECURITY 2 FOR BOARD :% 89: PRIVILEGE ACCESS= @:E mod, xt,

rev, xt, elete:r To modify a }ny entry, type 'M'. To edit the options of the next defined board, type 'N'. To view the options of the previous board, type }'P'. To exit back to the main Configuration Editor, type 'E'. To delete a board completely, type 'D'. Since you must have at }Tleast one message board, option 'D' doesn't function if only one board is defined.Y vE- EDIT TERMINAL DEFINITIONS{ --}-TThis edits previously-defined terminal types. You see:Y hEntry number:m 0: Terminal name} : #1: Terminal length :( 52: Lower case= ?:D [3: Number of nulls :` w4: Line feeds needed :| 5}: Clear screen code : Cod, xt,

revious, xit :U These commands edit any or all options o&j}Yf any menu entry previously defined. Option 'E' returns you to the main MENU EDIT menu.^ The other options available fro&k}m the main MENUEDIT menu are:$ yIEW: view the entire menu on screen or have it sent to the printer for hardcopy.} &l}2 DD: add entries to previously defined menus.7 AVE: save a new menu to disk. You should save each menu before work&m}ing on another one. KAIN: returns you to the main MENU/POLL menu.P RIVE NUMBER (1): specify on which drive th&n}e MAIN system menu will be located. Select from drives 1-8 (of use to those Sysops with RAMDISKs). The default drive is #1.&o} KURVEY EDITOR: from the main MENU/POLL takes you to the following:P `**SURVEY MENU**e et=v{ reate survey dit survey% 4dd to survey9 Goad surveyL Yave survey` main menur INPUT ONE C&q}HOICE: 'C': creates your own online, multiple choice surveys. You can have 25 surveys on line, numbered 0 - 24. If numb&r}ered between 1 and 24, then the caller can only take a survey once. If numbered zero, a caller can take that survey any numbe&s}8r of times. Surveys taken are flagged in the user log.= Your users will be able to respond with up to 5 response choices&t}9 for each survey. Type 'C', you will be prompted with: > VEnter survey filespec:[ Enter Dn:PATH>FILENAME.EXT, where &u}Dn is a drive number from 1 to 8 and FILENAME.EXT is any filename you want, and path is optional if your DOS supports it. You&v} then see: 'Enter question line:, Enter your first question, up to 132 characters in length. You can continue addin&w}CHg up to 9 questions to your survey until you choose option S for save.M Next enter up to 5 possible responses to your qu&x}x estion: Enter choice #1# 3Enter choice #28 HEnter choice #3M ]Enter choice #4b sEnter choice #5x After&y} entering your responses (you may choose to have fewer than 5 by pressing RETURN alone for the choice), editing commands for &z}0the survey appear at the bottom of the screen:5 Xext, eenter, xit, ave] These commands should be self-ex&{}planatory by this time. dd to survey: adds additional questions and responses to the same survey. A total of 9 quest&|}ions per survey are allowed.# ave survey: saves your survey to the drive # and name you select. Each survey occupies &}}25 single density sectors.! oad survey: loads into memory the survey file you specify. You must load a file into memo&~}ry before using option 'E'." cdit survey: edit a survey which has been loaded into memory.h ain menu returns y&}"ou to the main menu editor menu.' Surveys and survey results are set up on the appropriate menu, with the desired securi&}ty and privilege, using menu options 25 and 26 along with the correct filespec. Refer to the MENU OPTION TYPE list above.&}ll about.One nice feature is that each editor can be used from DOS (locally) or from the BBS (anywhere) so you can use the }5editors to modify the board from a remote location!: None of the BBCS II programs need BASIC: they are all binary load f}racter though. For example:n the user's security level. The user's security level does not have to match character for cha Dn:MENU xB.SYS. However, the system changes the filespec to NAMEFXp.ATA when an ATASCII file is used and NAMEtx.SYS for "} (note: The documentation disk must now be turned over and rebooted to access the rest of the documentation files on sid&}??U (c)1983 Action Computer Services C B JKIHiDiELV`L@*}dž @ BLV`Ll@h@l Li@ &` Fj`8冨凪` @EӅӥ*} @`ʆǪƩ Ɛee` @ƦʆǢ &Ɛeǐ @ @L@ @'&&&8儨児*}G祂*L@&&*ń8&&L@ .A`hihiHHȱȱLv@c !#3`*}Li@J`H v@h`Hȩh E@LA N@LA ?LA @LA @H8*})`HhHh 2BLA- BHI V䅠LA LiB @LAԆ ؠPIPP`*} BP @LA BLB BLB BLBH- B8塪墨hLB BLB BLB BȹP`*}텠8堨塪 B芨Oȩ-`PP aBP棩 Ѥģ0-ģ6000:,80H *}& &ehe&eģ0ʥ 8堅塅`$ B&*i0:0i BƦ`¢ 护*}\°ڱ%ȱ%E BL3D担CS %BL3DI BL3DH CL3D BL3D` &B V ANLMȑ*}` MLN%B VLAS:DE:DH B DD A Bh)0IDDLA[\ZUVT` EDD*}-` ELB ELgB ELB)1 j` ELB @` 0d i@ҥn `2)2*};ҩ`҅`0)9E`@0)ӈ?J)`Ѕ`ȱ`` Fȥ`Hh*}ǤƣĢ`ƥĤ`Ѣ F`ȱѢĦ`膡`*}y`ťƤe8夰LF Ƥ8`ŦeѠe桊LF$}*}}*}MN}*}}*}12(YZ(}*}(+LFIBIBI G`LVIj E8GGGG @GG BLI D:FONT.SE*}mTI AQIPIPIQILI gBRILI B`GmPIGmQIRI FPIйQILI B`rL JJJ*}GȌJ0JuJL[JJȌJJDJDJJJLPJJJL4JJJLJ`LaJ ELxJ ˠҢJm B J`ULJ*}JJJLJ D:DOC.000J mJ*(mJLJ D:DOC.001JȑȈ mJ*(mJLJ D:DOC.002Jȑ򈑮 m*}džJ*(mJL&K D:DOC.003Kȑ mJ*(mJLPK D:DOC.004KȑF mJ*(mJLzK D:DOC.005Kȑp *}mJ*(mJLK D:DOC.006Kȑ mJ*(mJLK D:DOC.007KȑĈ mJ*(mJLK D:DOC.008Kȑ *}mJ*(mJL"L D:DOC.009Lȑ mJ*(mJLLL D:DOC.010LȑBJ mJ*(mJȱH F`LL*}~L G~L J BH A G`LLHʩ MBH MBLHLLͬLLMLHI L MHLHʢI FI*}ǣH FLMLLLLH)M)MͬLLdMLHI L^MHLHI FIH FLdMLLM`LiM D1H0H*}HiHiGHiHiHi HiHi HieMeMLMHmeMHieMLM`LM *}fMGG .A FL;NN: %B ELTNANTICNN %B ELpNSOFTWARENg %B*}  ELN -N %B ELN N %B  EH %B  EH %B *}ELO %N %B ELOO"Press for Screen, for PrinterO, %B BLaOK:O^ *}3A@ gBMMIP MISLrO ELO$W O %B BM`LOOOISLO*}Dž` ELPPRESS FOR CONTINOUS FEEDO %B ELDPPRESS FOR SINGLE SHEETP+ %B BLVPK:PS A*}.@ gBOOIS OICLgP ELPK _P %B ELP| *}P %B BO`LPPPP#GICLQPP ELDQàQ' %B BLVQK:QS *}0A gBPPILQ BP`PP ELQM ^Q %B B`bLQ ȢG !F$GG*}$GGLQG$ B`Q8GRRQLR8GQQQ$GQQI LRQGGRGRQLbRQmQ$GQGQ*}LRRILRL SLRRILRL SRR$GRLR8R$GR`DL#SSSS LSSILDSS`SL/TS R*}ǍS QS"GSILS"GS8!GSSSLS BSLSSi"G7"GLSS SLS BSLS"G  PS*}SILS BS`L,T"GL,T!GIL,T"G PS} BSIL,T BS`LIS BS`L?T EL]T*}ӠԠ΢TK B J`LsTk@kTj@jTEIk@DIj@ SI LlT LmT"G MoToT OnTnT#G BoTIPLU*}ǩ8!GPG G BLTP:T Ad GLU B 6xo~{A_>>888>|||f<f<<cckwff<<~fff~~~~ 8`~@`0 xxx>.}c 6>$T8pp8?XX\dhhllpptv}.} w>6<~~~<;;??GLRW_||`x`~<~~<.}0~0 ~ <~~<~~f~``~~f~~~``~~~f~~f~`~~~~f~~``~~ff8888<>>``f||f88<<w.}uwk~~fff~~ff~~~f~``~~f~~~```~`~~~~fff~~ff~<ckwf~<~fff~~~~~0~<~~<}.}~x|ngT<fff~~`~~fl0fF>6xo~{A_>>888>|||f<

rev, xt, eleteH Terminal parameters for different computers can be ob}otained from many sources; friends, owner's manuals, user groups or from machine specific SIG'S on CompuServe.t F- ADD ME} SSAGE BOARDS '-This adds new message boards to your existing board in the same manner as you create}d the first board except that it adds a new board after any already created. You must have created one board first before add}ing any new boards. 7G - ADD TERMINAL DEFINITIONS< IMAIN MENUN [enu editor_ ourvey editort elete ,}file ile list& Keturn to DOS (If loaded from DOS)] eturn to BBCS (If loaded from-} BBCS) INPUT ONE CHOICE:% This main menu offers a variety of options. Pressing 'D' deletes a disk file (enter the .}full drive id, path if applicable and filename; you'll be asked to confirm your choice), 'F' gives you a disk directory of se/}Glected files (enter the drive id and a name or wildcard like :D:MENU*.*). If this editor was booted from DOS then 'R' returns0}0O you there, otherwise it returns to BBCS II. Pressing 'M' presents this menu:` oMENUEDIT MENUt reate 1}menu dit menu 2dd to menu oad menu7 Bave menuF Rain menuW biew menuf rive number (1) 2} INPUT ONE CHOICE: 'C' creates a new menu with up to 21 selections each. You are asked for the full menu filename and 3}drive ID (including pathname if supported by your DOS). However, the MAIN MENU of your BBS must be called MENUMAIN.SYS! Any o4}ther menu may be called whatever you like. After entering the name, you are asked to enter two text lines, used as a title fo5}r each menu or other things (i.e. directions, such as on your disk MENUGBYE.SYS). These lines can be up to 132 characters lon6}g and may also be left blank.$ After entering them, you are asked to enter the information line which gives information 7}to a user regarding an option on the board. In the example below this line tells the user that if he/she types 'A' then a tex8}ut file with ATARI computer news will be shown. This is any text line and can be information or a link to a command.z The9} next three questions deal with security/privilege levels. If a user has a read/write privilege greater than or equal to the :}read/write privilege of a LINE in a menu, the user is shown the text. If less then the read/write privilege, the user is not ;} shown it. Whether the user will be allowed or denied access to the command will depend on whether or not they have the <}correct security, assigned by the Sysop. The security in this section works exactly the same way as it does in the configurat=} ion editor. If the user has the appropriate security, when they type the key, the command (defined below) is executed. >}`If not and they have read-access, a message is displayed telling them they need authorization.e Next, you enter the comm?}and key: the letter the user types to execute a function. After the command key, the reaction to the key is asked for: this i@}s the text (or letter) that is echoed to the user when the command key is entered. The 'reaction' text is limited to 10 charaA}Ccters. Next, enter the entry option (1-47) to tell BBCS II what to do when the command key is typed. These options defiB}Bne what action the BBS will take when a user enters the command key, explained in the table below. These entry options are viC}tal; they are the keys to how your system responds to users. You can set some options to do certain file-oriented functions fD}mor you or your co-sysops, others to move the user to and from menus, request chats, read messages and more.r For exampleE}, an entry option of 2 lists a text file as explained below. The optional filespec is used for certain commands that require F}filenames or board names. When dealing with disk files, the FULL file name must be entered. You cannot enter 'D:EXAMPLE.TXT' G}Eyou MUST enter 'D1:EXAMPLE.TXT' (include a pathname if supported).J xHere is an example of what could be entered:} H}ENTER MENU FILE NAME :MAIN! 3Enter text line #18 ::? SBBCS TOP LEVEL MENUX jEnter text line #2o q:v v}=I} = ,Enter information line :1 9tari @.V Atari computer news[ oEnter read privilegeu x:0} J}Enter security level 1 :#-$) ?Enter security level 2C D:L-MR cEnter command keyl o:At Enter reaK} ction to key :Atari :Enter entry option (1-47) :2? jENTER optional filespec : D1:ATNEWS.TXTo ontinue, ave, eenter,xit: While in MENU EDIT, it may be useful to load in the MAIN menu from the pre-configured board by M}typing 'L' from the sub-menu, respond to the prompt by typing 'D:MENUMAIN.SYS'. Type 'E' for edit menu. You can now examine eN};xactly how each selection in this menu was put together.@ For each line you want on the menu, you must enter an informaO}tion line using C to continue. When you've finished building this menu, use S to save it. You can add items to an existing meP}nu later with the Add to menu command and edit your menu as well with the edit command. You can add items to an existing meY MENU ENTRY OPTION CODES$ $;-HOPTION USERL WDESCRIPTIONf uFILESPEC FIELD{- "R}- -" "0-4 19 XCALLER Request chat with sysop\ eBLANK 2j CALLER List text f"S}Cile Dn:FILENAME 3, 8RESERVED 4= YCALLER Selective board read` iBLANK 5v RESERVE"T}EETD 6 CALLER Enter message- ;BOARD NAME 7@ UCALLER Read messagesc qBOARD NAME 8v CALLER "U} Scan messages *BOARD NAME 9/ NCALLER Pop Stack and GOTO menuR YDn:MENU]Xb.SYSr Like Option"V} 24 but clears Return Stack.- VUse to exit a GOSUB without a RETURN 10[ rCALLER GOSUB TO A MENU} "W} Dn:MENU X.SYS 11 7CALLER Return to calling menu< EBLANK 12J bCALLER Download sectionm yDn:*.EXT 13} "X} CALLER Upload a file$ 3Dn:FILENAME 148 ]CALLER Change menu listing level 15b CALLER Show time and time "Y} on system 16 ,CALLER Log off system 171 DCALLER MENU/CHOICET [Dn:MENU_xg.SYS 18l CALLER Deselect "Z}message boards 19 6CALLER Combined board read 20; VSYSOP Local external load^ nDn:FILENAME) 21s CALLER Ch"[}ange password 22 ?CALLER Change terminal configuration 23D wCALLER Toggle translation mode (ATASCII/ASCII) 24| C"\}ALLER GOTO Menu" )Dn:MENU-x5.SYS 25: NCALLER POLL SECTION] lDn:FILENAME 26q CALLER POLL"]} RESULTS &Dn:FILENAME 27+ \CALLER CHANGE TIME ZONE FROM CURRENT SETTING 28a CALLER SHOW SYSTEM TIME (NO"^}T TIME ZONE TIME) 29 &RESERVED 30+ FThis command does nothing:N ufor use when no action is required. 31z RES"_} ERVED 32 (SYSOP DISK DIRECTORY 33- ESYSOP DELETE FILES 34J ]SYSOP FORMAT DISKm FORMAT PASSWORD"`} 35 1CALLER LEAVE SYSOP MESSAGE & LOG OFF 366 NSYSOP PROTECT FILE 37S hSYSOP UNPROTECT 38m SYSOP RENAME FI"a}LE 39 &SYSOP FILE COPY FUNCTION6 H(NEEDS 2+ BUFFERS)Q `Dn:FILENAME 40e SYSOP EXTERNAL LOAD BB"b}CS EDITORS Dn:FILENAME.COM 41# CSYSOP CHANGE DATE AND TIME 42H ^SYSOP LIST TEXT FILEk Dn:FILENAME 43 "c}! CALLER Combined scan board 44& HCALLER MULTIPLE POST MESSAGES 45M oCALLER MULTIPLE SCAN MESSAGES 46t SYSOP S"d}YSTEM SHUTDOWN 47 9CALLER SPECIAL MESSAGE TO SYSOP> The filename can be up to 29 characters long, which includes pa"e}CNthnames if supported by your DOS. An example of this for Spartados might be:S D1:ATARI>NEWS>JANUARY.RPTWhere a filenam"f}fe must be specified, the ENTIRE name must be used. Pathnames are optional. Wildcards are mandatory in downloads where the for"g} mat is: !Dn:PATHNAME>*.EXT& When the user has the BBS set up for ASCII/ATASCII, the filespec for menus must also be"}2.2 From the EDIT MENU mode you'll see that the screen looks just like the create menu screen. The difference lies in th&i}Pe prompts at the bottom of the screen:odify, ext,