Crawly Crypt Collection 1

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

/ Crawly Crypt Collection 1 / crawlyvol1.bin / bbs / q_doc110 / quickbbs.doc < prev

Wrap

Text File | 1993-06-10 | 289KB | 5,815 lines

066010303030000132002006006006000 1 QuickBBS STPage #0 2 QuickBBS STPage #0 F0110030001 R [.◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆...]0110 9 [....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆]0110 ü  ---- -- --- ------ ------ ----  -- -- -- -- -- -- -- -- --  -- -- -- -- --- ---- -- -- -- -- -- -- ---  -- -- -- -- -- -- -- -- -- ----- ----- --- -- -- -- -- -- -- ---- -- -- -- -- ---  -- --- -- -- -- -- -- -- -- -- -- -- -- -- --  ---- --- -- ---- ---- --- -- ------ ------ ----  -   ------------   --------    --- --   -----     -----    -----   ------  -------- version1.10 Ç TheQuickBulletinBoardSystem forAtariSTcomputers by JonWebbandTheoRunia  TheQuickBBSSTpackageisCopyright(c)1990-93byJonWebband TheoRunia.ItisinnowayconnectedtotheQuickBBSPC version.Readthelicenseagreementforcopyrightinformationand distributionrules. 9 [.◆..◆....◆...◆◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....]0110 ÇëTABLEOFCONTENTSÇ êSection1:IntroductionÇêPageÇ LicenseAgreement.........................5 BugReports,Questions,Ideas............. 8 Notices................................... 8 ThankYou................................. 9 Features.................................. 9 Overview.................................. 10 QuickStart................................ 10 Documentation.............................10 RequiredHardware.........................11 RequiredSoftware......................... 11 RequiredSoftwareforFidoNet............. 11 RecommendedSetup......................... 12 FirstTimeSysOps......................... 12  êSection2:InstallationÇêPageÇ UnpackingtheArchives.................... 13 DirectoryStructure.......................14 CreatingtheSystemFiles................. 15 CreatingtheUserBase.................... 15 CreatingaConfigurationFile............. 16 Installing 4KBUF .......................... 17 RequestingaKey.......................... 18 RunningtheBBS........................... 18 êSection3:Configuration/OperationÇêPage Ç MoreaboutQConfig........................ 20 FunctionKeys............................. 26 SysOpKeys................................ 27 Chatting&YellTunes..................... 28 TheStatusBar............................ 29 êSection4:UsersÇêPageÇ UserInformation.......................... 30 PackingtheUserBase.....................32 TheLimitsFile........................... 32 TheTrashCanFile......................... 32 TheAccounting system..................... 33 êSection5:Text&GraphicsÇêPageÇ TextFiles&GraphicsModes...............34 SystemTextFiles......................... 35 TextFileControlCodes................... 37 ÇêSection6:MenusÇêPageÇ TheMenuSystem...........................40 MenuText................................. 41 MenuStructure............................ 41 TheMenuEditor........................... 42 MenuOptionTypes......................... 43 MenuParameters........................... 48 AutomaticMenuExecution.................. 49 TheMenuOptimiser........................ 49 êSection7:MessagesÇêPageÇ TheMessageSystem........................ 50 MessageAreaAccess....................... 51 TheLanguageCheckFile................... 51 TheUpperCaseCheck....................... 51 Allow use of an alias..................... 52 Allow 8 bit characters.................... 52 File attached messages.................... 52 Group number.............................. 52 LastReadPointers......................... 53 PackingtheMessageBase.................. 53 The Mail Area Lister...................... 54 êSection8:FilesÇêPageÇ FileAreas................................ 56 TheFileSearchFile...................... 57 TheFileArea Lister...................... 57 TransferProtocols........................ 59 Uploads&Downloads....................... 59 TransferDrivers.......................... 61 External Protocols........................ 61 TheOnlineArchiver....................... 62 TheFileBrowser.......................... 62 Mark File Menu............................ 63 êSection9:DoorsÇêPageÇ ExternalPrograms......................... 64 DORFiles................................. 66 ExitWithErrorLevel...................... 71 ÇêSection10:FidoNetÇêPageÇ WhatisFidoNet?.......................... 72 Practical,please......................... 73 FidoNetOrganisation...................... 73 NetWorkAddresses......................... 74 Points.................................... 75 What'saMailer?.......................... 75 ImportandExport......................... 75 InstallingtheMailer.....................76 CompilingtheNodeList.................... 77 WritingNetMail........................... 78 ReadingandWritingEchoMail.............. 78 GeneratingEchoMail....................... 79 EventsandRouting........................ 79 ExportingMail............................ 80 ImportingMail............................ 80 ArchivedMail............................. 80 BatchFilesandsuch...................... 81 êSection11:AppendicesÇêPageÇ A-JargonGuide.......................... 83 B-SysOpKeys............................ 96 C-MenuOptions.......................... 97 D-SystemTextFiles..................... 98 E-TextFileControlCodes............... 100 F-.DORFileCommands.................... 103 G-VT-52EscapeCodes....................104 H-Ansi-BBSEscapeCodes................. 105 I-RS-232Pins........................... 110 J-FSEInterface......................... 111 K-ExternalChatInterface............... 113 L-AvailableUtilities................... 114 M-Errorlevels&Parameters..............116 N-ExampleBatchFiles................... 117 O-BugReportForm....................... 123 ü================================================================= ===================Section1:Introduction==================== ================================================================= Ç üëLICENSEAGREEMENT ü ÇQuickBBSSTusesakeywhichcanberequestedfromtheSupport BBS.Therearetwosortsofkeysavailable: »AêDemokeyÇwilloperateforaperiodof60days.Nomorethan4 demokeyswillbeprovided,andtheremustbeatleastonemonth betweenthedateonwhichonedemokeyexpiresandthedateon whichthenextdemokeyisrequested. »AêFullkeyÇcanbeboughtfromTheoRunia.Onceyouhaveboughta fullkeyyouarearegisteredownerofQuickBBSäÇSTandhave unlimiteduseoftheprogram.Afullkeycosts150Dutch Guilders(approx.$80/£50)andcanbeorderedbysendinga chequeorpostalorderfortheaboveamount,ümadepayableto TheoRuniato: Ç üTheoRunia P.O.Box1183 8900CDLeeuwarden TheNetherlandsÇ Pleaseincludeanotewithyourname,phonenumberandkey number(whichisdisplayedbyQuickBBSwhenitchecksyourdemo key).  Now for the different methods of payment, in order of preference: » By International Postal MoneyOrder is quickest on our end.  Ijust have to go to the post office to cash them. A postal moneyorder can be sent from your local post office. This is  fast as I get them within a week, and a full key will be  ready at that day. » By EuroCheque is also fairly quick. Because EuroCheques are guaranteed by the bank, your full key will be available as soon as the cheque arrives here. Most banks charge very little for EuroCheques. » If you live in Europe and have access to a giro account, you can transfer the money directly to mine. My giro bank is called Postbank N.V. in Arnhem and my account number is 2740040. » You can also transfer money via the SWIFT system. This is an international money transfer system. Almost all banks should have access to this. You should show the following to your bank: Ç Transfer 150 dutch guilders via the SWIFT transfer system to my bank, my bank is: Friesland bank Zaailand 110 Leeuwarden The Netherlands My account number there is 29.63.18.418 on the name of: Theo Runia in Leeuwarden. The swiftcode for the Friesland bank is FRBKNL2L With this code it should be easy for a bank to transfer the money. But please mention your keynumber, it make's live easier for me and you. » A bank cheque of your bank is possible too. It should be drawn on a Dutch bank. But normally this is the case with bank cheques. The disadvantage is that I get the cheques fast enough but I will have to wait 1-2 weeks before it's cleared by the bank. But generally it's quite a good system. If you have sent a cheque or postal order etc. and your demo key runs out, just post a message on the Support BBS or send a netmail. In general we will make an extended demo key available. We wil send a netmail via Fidonet if the key is ready, so do supply your nodenumber. If you want the key on disc please say so. This will however take longer. Any invalid cheques and postal orders will be returned to you, with a description of what was wrong. And please don't forget to mention your keynumber, the number of users is so big that it is sometimes diffecult to find out who send the money. If you have experience with international money transfers which you think would be of use to others, let me know and I'll include it in this file. Wereservetherighttorefuseanykeyrequest.Wealsoreserve therighttowithdrawyourkey,êevenafullkeyÇ,ifyouviolate thedistributionrules. TheQuickBBSSTpackagemaybemadeavailablefordownloadaslong asyousticktothefollowingrules: Ç»Youmaynotdistributemodifiedprogramsordocumentation, »Youmaytranslatethedocumentation,buttheoriginalEnglish versionmustbeinthedocumentationarchive, »Youmaynotdistributeincompletearchives, »Youmaynotdistributethekey, »Youmaynotchargeanythingforthepackageotherthannominal copyingcostoron-linefees. Violationoftheseruleswillleadtothewithdrawalofyourkey! Youcanalsosend2formatteddiscstogetherwith2international replycoupons.YouwillbesendthelatestversionofQuickBBSST andsomeniceutils.Youcanalsorequestademokeythisway.Make verysureyouputonthediscafileorsendaletterwithyour nameandaddressonitandincludethefollowing: SysopName BBSName Nodenumber ThiswaywecangenerateademokeysoyoucanstarttheBBSthe momentyourecievethediscsback. üëBUGREPORTS,QUESTIONS,IDEAS,ETC. Ç ThebestwaytocontactusisviatheQuickBBSSTäÇSupportBBS: üQuickBBSSTLeeuwarden FidoNet2:282/301,NeST90:5/0 Holland+31-(0)58-153849 300-14400Bps,HST/V32bis 24hoursperdayÇ TheSysOp-TheoRunia-hasbeenrunningQuickBBSSTeversince thefirstversionwastested,andcananswerjustaboutany questionsyoucaretoask.Butêdon'tÇforgethe'sdoingallthisin hissparetime,andmightbeverybusydoingsomethingelse. AnotherwayofgettingintouchisintheQUICKBBS.STechomail area.ThisareaiscurrentlyalsolinkedintotheNeSTarea N.GATE.QBBS.STandmightbelinkedtootherareasinthefuture.  ëNOTICESü Ç WecanênotÇbeheldresponsibleforanydamageswhichmayoccurdue totheuseofäÇQuickBBSSTand/orassociatedprogramsand/or documentation.Ifyouusethesystem,youdosoatyourownrisk. QuickBBSSTissuppliedas-is.Ifitdoesn'tsuiteyourneedsI'm sorry.  WeaminnowayconnectedtoAdamHudson,theoriginalauthorof thePCversion,otherthathegaveJonwebbthe'goaheadandtry' signal.QuickBBSSTwasnotported,itwasrewrittenfromscratch inGfA3.0andTurbo-C/ST. WehaveheardthatAdamHudsonisnolongerdevelopingthePC version,andhassoldthesource.Wehopethiswillspeedup implementationofnewfeaturesinthePCversion.Infactwethink thenewdevelopershave'borrowed'afewofourideas,whichis finebyus. WhenthenameQuickBBSisusedinthisdocumentation,itrelates ofcoursetotheSTversion,notthePCversion.QuickBBSisoften called'QBBS'or'Quick'. üëTHANKYOU Ç Alotofpeoplehaveassistedinthedevelopmentofthispackage, anditisimpossibletolistthemallhere.However,I'dliketo expressspecialthanksto... »üTheoRuniaÇ,theveryfirstQuickBBSSTboardandSysOpofour SupportBBS.Theohasbeenveryhelpful,comingupwithideas, (lotsof)bugreportsanddoinganenormousamountoflistening. Fromversion1.06onwardsTheotookoverdevelopment. »üJacKersingÇ,authorofThe-BoxandPandora,hasspentmanyhours onthephonewithme,atfirstwhentestingThe-BoxandPandora, afterwardswhentechnicalproblemsaroseduringthedevelopment ofQuick. »üIainSummersÇ,forhishelpwithallsortsofbits-and-pieces, especiallytheinternalZmodemdrivers,andforputtingupwith meforafewdayswhenIwasoverintheUK8-). »alltheSysOpsofour'other'mainübetasitesÇ,LasseEriksson, JensFischer,JoopKoopman,KajLehtinenandErnoMeffertand WilcoRoos. üëFEATURESü ÇQuickBBSisaverypowerfulandflexibleBBSsystem.Afewofthe featureswhichareimplementedinthecurrentversion: »Thecompletemenusystem,themenutextêandÇthemenustructure areSysOp-configurable, »MostoftheothertexttheuserseesisSysOp-configurable, »NearlyallkeysintheBBSareHotKeys,thatmeanstheuser doesn'thavetowaitforthemenuortobecompleted,hejust pressesthekeyhewants, »Upto200messageareas,andanunlimitednumberoffileareas, »FullyFidoNetcompatible,linkingyourBBSto20000others worldwide, »UploadsanddownloadswithXmodem,Xmodem1K,Ymodem,Windowed XmodemandZmodem,andapowerfullexternalprotocolinterface, »VT-52Standard,Monochrome,ColourandAnsigraphicsmodes, »NewMailpointersforeachuserineacharea, »OnlineArchiverwithsupportfor.ARCand.LZHarchives, »Languagecheck,uppercasecheckandquotinginthelineeditor, »Separatefront-endforStandAlonemodeincludesterminalwith dialer,VT-52andAnsigraphics,FileTransfersetc. »ExternalprogramscanbestartedfromwithintheBBS,providing accesstodoorgames,utilitiesandsuch.MostFoReMandPandora doorgamescanberun, »Freeupdates, »Lots,lotsmore... ÇAsyoucansee,nootherBBSpackageontheSTofferssomuchfor solittlemoney.Andbestofall:QuickBBSisveryfast,otherwise itwouldn'tbecalledthat,wouldit? üëOVERVIEW Ç QuickBBSSTiscloselyrelatedtotheThe-Boxsystemwhichwas writtenbyJacKersingandJan-PaulMiddelink.Itdoesnotuse The-Boxitself,butitusesthesamemailutilities,duetothe factthatthemessagebaseisofidenticalformat.Nowadays BinkleySTisusedmoreandmore.MostmailutilitiesontheAtari nowusethismessagebase,it'softenreferredtoasthe'QBBS format'. TheQuickBBSpackageconsistsofthefollowingfiles: »üQINSTALL.PRGÇInstallationprogram »üQKEY.PRGÇKeyRequester »üQUICKBBS.PRGÇThemainprogram »üQSTART.PRGÇQuickStart,forStandAloneuse »üQSTART.OVLÇOverlayforQuickStart »üUSEREDIT.PRGÇTheusereditor »üMCONFIG.PRGÇThemessagebaseconfigurationprogram »üQCONFIG.PRGÇThegeneralconfigurationprogram »üMENUEDIT.PRGÇThemenueditor,writtenbyTheoRunia »üFASTPACK.PRGÇThemessagebasepacker »ü4KBUF.PRGÇCommunicationsbufferprogram »üXFER.00?ÇYmodem/WindowedXmodem/Zmodemmodules Theseandotherfileshavebeenplacedinanumberofarchives, readytobeextractedbytheinstallationprogram. ëQUICKSTARTÇ QuickStartisaprogramwhichisrun'infront'ofQuickBBS.It initialisesthemodem,answersthephonewhenausercallsetc.It alsohasaterminalwithfiletransfercapabilities,Ansigraphics etc.WhenausercallsQuickStartwillstartupQuickBBS. QuickStarthasitsowndocumentationfile. üëDOCUMENTATION Ç ThisdocumentationisavailableinASCIIorinFirstWordPlus format.TheFirstWordPlusfilehasextensionü.DOCÇ(withü.GEMÇ illustrations),theASCIIfilehasextensionü.TXTÇanddoesnot containanyillustrations.Aspecialprintprogramisbeing developedtoprintouttheFirstWordPlusdocumentand illustrations.TheprogramcaneitherprintaplainASCIIversion or-ifyouhaveGDOS(orG+Plus),aprinterdriverandaprinter font-aversionwithpictures,stylesetc.Ofcourseyoucan printouttheü.DOCÇandü.IMGÇfileswithFirstWordPlus. If,afterreadingthisdocumentation,somethingisstillunclear youcouldhavealookattheQuickBBSPCdocumentation.Morehelp withFidoNetcanbefoundintheBinkleySTmanuals. ÇëREQUIREDHARDWAREü Ç QuickBBSiscurrentlybeingdevelopedonanAtari520STwith2.5 MborramandaSM-124monomonitor,andlotsofHDspace(+/-500 Mb).ItworksonTOS1.04,butshouldworkokeonmostTOS versions.ItalsoworkswithalmostallHDdrivers,atleastall theoneswetested.Wedorecommendthatyouinstallacache programtospeedupHDacces,themailscanreallybenefitsfrom this. Youneedatleast1megabyteofmemorytorunQuickBBS. ItmightalsobepossibletorunQuickBBSonasingleordouble drivesystem,butIdoubtwhetheryou'llhaveanicetimedoing so.Aharddiskshouldbeused,butthereisnotechnicalreason whyitcouldn'tbedonewithless. Asforamodem,youwillneedafairlyHayes-compatibleone which iscapableofansweringthephone,monitoringthecarrier, respondingtoDTRandswitchingtothecorrectbaudrate.Thereare somanymodemsouttherethatitisimpossibletotestandlist themall.Theconnectioncablebetweenthecomputerandthemodem isveryimportant.ItmusthaveêatleastÇtheGround,RX,TX,DTR andCDpinswiredthrough.Completepinoutinformationcanbe foundintheappendixsection.Onhighspeedmodems(9600andover) youêmustÇusetheCTSandRTSlines.ForthistoworkonyourAtari youmustinstallaCTSfixprograminyourautofolder,e.g. HS_FIX,TurboCts,Serialfixetc.FromTOS2.06onwardsitshould workwithout.ButdoenableRTS/CTSinyourmodemcontrolpanel. üëREQUIREDSOFTWAREü Ç YouwillneedatexteditorsuchasMicroEmacsorTempus.First WordinASCIImode(WPModeOFF)willdo,butIcan'trecommend it.ForcreatingscreensaVT-52andAnsieditorcouldcomein handy. TheQuickBBSSTisin.ZIPformat,youneedSTZiptounpackit, STzipismadebyVincentPomey(hayvincent!).Butyoumighthave tousesomearchiverslikeLHarc,Arc,Unarj,Zoo,etc.tounpack allkindsofthirdpartyutilities. ëREQUIREDSOFTWAREFORFIDONETÇ IfyouwanttorunQuickBBSasaäÇFidoNetnode,youwillneeda êmailerÇinadditiontothesoftwarementionedabove.Atthemoment therearetwomailersavailablefortheST:The-Boxand Binkley/ST.BothcanbedownloadedorrequestedfromourSupport BBS.YouwillalsoneedaêshellÇ(oftencalledaCommandLine Interpreter,orCLIforshort).PCommandisagoodchoice,butit doesn'tsupportcommandlineparameters.PCommandisshareware. AnotherpossibilityisGulam.ThisisaUnix-likeshell,itshould bepossibletousethat.Acommerciallyavailableshellcalled Craftmightworktoo.Whateveryouchoose,theshellmust: Ç»Supportbatchfiles »Supportenvironmentvariables »Supporterrorlevels »Ifpossible,acceptabatchfiletoexecutionpassedonthe commandline. Trytogetonethatdoesn'ttakeuptoomuchmemory.Theexamples givenhereareforPCommand. Youwilalsoneedamailtosser,softwaretoprocestheincoming andoutgoingmailpackets.Therearequitealot,butwewill mentionsometogiveanidea: Bermuda, Jetmail, Marsmail, IOS,  ëRECOMMENDEDSETUPÇ TheusualandrecommendedsetupforareasonableQuickBBSST systemis »Atari1040STfwitheitherTOS1.04orhigher »MonochromeorColormonitor, »Harddisk,werecommendtostartatleastat30Mb »2400Bpsorbettera14.400Bpsmodem »Battery-backedclock!Don'tforget:-) 20or30Mbofharddiskspaceisenoughtostartwith,buta majorBBSoftenhas60or100Mbormore.AsecondSTwouldalso comeinhandytobeabletodosomeworkwithouttakingtheBBS offline,thoughitcertainlyisn'tessential.Youcouldconnect thatupviaoneofthecheapMidinetworks,soyoucanpreform sometasksandstillkeepthesystemonline üëFIRSTTIMESYSOPSü Ç Thisisnotacommunicationstutorial.IassumeyouknowhowaBBS worksfromtheuserspointofview,andhaveareasonableidea whataSysOpsjobis.Ifyouhaven'thadmuchexperiencewith usingaBBS,spendsometimecallingother(Quick)BBS'sfirst. Althoughyouwon'tneedtodoanyprogrammingyourself,Iwill alsoassumeyouknowafairabitaboutyourcomputer.Explaining everythingfromscratchwouldmakethismanualafewMegaBytes larger.Again,ifyoudon'tknowmuchabouthowyourSTworks, waitafewmonths. ü================================================================== ====================Section2:Installation==================== ================================================================== Ç üëUNPACKINGTHEARCHIVESÇ Theveryfirstthingyoumustdoischeckyoursystemdateand time(ifyoudon'thaveabuilt-inclock,thatis).Thedateand timemustêalwaysÇbecorrectwhenyourunyourBBS.Strangethings willhappeniftheyareincorrect. QuickBBSisdistributedasasetofthreearchives: »üQ_DOC.ZIPÇcontainstheFirstWordPlusversionofthe documentation, »üQ_ASC.ZIPÇcontainstheno-frillsASCIIversionofthe documentation, »üQUICKBBS.ZIPÇcontainstheBBSsystemitself. ToinstallQuickBBSyoumusthaveSTZip2.0orhighertobeable tounpackQuickBBSandit'sdocs.STZipiscopyrightbyVincent PomeyandisavailableatmostAtariBBS's,ifneedbeyoucanget itatoursupportBBS. êIfyouhaveonediskdriveÇ: »PlaceüQUICKBBS.ZIPÇonadiskette, »Createaramdisklargeenoughtoholdthefilesin üQUICKBBS.ZIPÇ,plusüSTZIP.PRGÇ, »PlaceüSTZIP.PRGÇontheramdisk, »ExtractüQUICKBBS.ZIPÇtotheramdisk, »Insertablank,formatteddisketteinyourdiskdrive, »Startupü4KBUF.PRGÇfromtheramdisk, »StartupüQINSTALL.PRGÇfromtheramdisk, »ChooseüSelectDriveÇandenterdriveA. êIfyouhavetwodiskdrivesÇ: Eitherfollowtheinstructionsforsinglediskdrivesystems, or... »PlaceüQUICKBBS.ZIPÇonadisketteindriveA, »PlaceüSTZIP.PRGÇonadisketteindriveB, »ExtractüQUICKBBS.ZIPÇtodriveB, »Insertablank,formatteddisketteindriveA, »Startupü4KBUF.PRGÇfromdriveB, »StartupüQINSTALL.PRGÇfromdriveB, »ChooseüSelectDriveÇandenterdriveA. ÇêIfyouhaveaharddiskÇ: »Createatemporarydirectory, »PlaceüSTZIP.PRGÇandüQUICKBBS.ZIPÇinthatdirectory, »ExtractüQUICKBBS.ZIPÇ(afterextractingthisarchiveyouno longerneedit), »Startupü4KBUF.PRGÇ, »StartupüQINSTALL.PRGÇ, »Ifyoudon'twanttoinstalltheBBSonthecurrent partition,chooseüSelectDriveÇandenterthepartitionon whichtheBBSistobeinstalled. Oneofthefilesyoujustextractedandexecutedwasü4KBUF.PRGÇ.It mustbeplacedintheüAUTOÇfolderofyourbootdisk,andmust êalwaysÇbeinstalledwhenQuickBBSorQuickStartisrun. ëDIRECTORYSTRUCTUREÇ TheQInstallprogramcanbeusedtocreatearunabledemonstration systemwhichshouldhelpyougetstarted.Itsetsupadirectory structureonthedriveofyourchoiceandunpacksallthearchives intothecorrectdirectories. Thefirstthingyoushoulddo,ifyouhaven'tdoneitalready,is todefineonwhichdriveorpartitionyouwanttoinstalltheBBS. UsetheüSelectDriveÇoptionforthis.Thisdoesn'tmeanyoumust alwaysruntheBBSonthisdrive,youcanalwayschangeitlater ifyouchangeyourmind. Nowyoumustcreateadirectorystructure,usingtheüCreate DirectoriesÇoption.YoushouldnotattempttorunQuickBBSfrom therootdirectory,becauserootdirectoriescan'tcontainmore than112files.Youwon'tnoticethisatfirst,butitmightcause problemslater. ThedirectorystructureQInstallcreateslookslikethis: ü\QBBSÇhomedirectory ü\QBBS\CONFÇconfigurationdirectory ü\QBBS\TEXTÇtextfiledirectory ü\QBBS\MENUSÇmenufiledirectory ü\QBBS\MSGSÇmessagebasedirectory ü\QBBS\OARCÇonlinearchiverdirectory ü\QBBS\TUNESÇyelltunedirectory ü\QBBS\DOWNLOADÇdownloads: ü\QBBS\DOWNLOAD\GENERALÇgeneraldownloadarea ü\QBBS\DOWNLOAD\UTILSÇutilitydownloadarea ü\QBBS\DOWNLOAD\COMMSÇcommunicationsdownloadarea ü\QBBS\UPLOADÇuploads: ü\QBBS\UPLOAD\GENERALÇgeneraluploadarea ü\QBBS\UPLOAD\UTILSÇutilityuploadarea ü\QBBS\UPLOAD\COMMSÇcommunicationsuploadarea ÇI'veusedsomejargonhere,butdonotfear,allwillbeexplained whenthetimeisright.Ifyoucan'twait,havealookinthe JargonGuideintheappendixsection. üëCREATINGTHESYSTEMFILES Ç Sowe'vecreatedthedirectorystructure,buteverythingisstill empty.Nowwemustfillthemup.Rememberyouunpackedthe distributionarchiveüQUICKBBS.ZIPÇ?Well,youshouldnowhavethe followingfiles: »üQ_PRG.ZIPÇprogramfiles, »üQ_CFG.ZIPÇconfigurationfiles, »üQ_MNU.ZIPÇmenufiles, »üQ_TXT.ZIPÇtextfiles, »üQ_MUS.ZIPÇyelltunefiles. ThesearchivesareunpackedbyQInstall.SelecttheüWriteFilesÇ optionfromthemainmenu. QInstallwillnowunpackallthesearchivesusingSTZipandplace theextractedfilesinthecorrectdirectories.Whentheunpacking iscompletedreturntothemainmenu. ëCREATINGAUSERBASEÇ ThenextoptionyouneedtoselectisüRunUserEditÇ.Thisoption startsuptheusereditprogram.TheuserfileiscalledüUSERS.BBSÇ andislocatedinthehomedirectory.Itcontainsimportant informationabouteachuser.UserEditwilltellyouitcan'tfind anyLastReadpointers,andaskyouwhethertheyshouldbecreated. JustsayYesfornow. Theveryfirstuserintheuserbasemustalwaysbeyou-the SysOp.Tochangethisuserrecord: »PressüReturnÇandtypeinyourname.Ifyournameconsistsof morethantwowordsyoushoulduseadottoseparatethewords (e.g.AlexisCarrington.Colby.Dexter).QuickBBSonlyacceptsone spaceinausersname, »UseüCursorUpÇandüCursorDownÇtomovethehighlightedbartothe passwordfield,pressüReturnÇandenterapasswordofyour choice, »MovethebartotheSecurityLevelfield,pressüReturnÇandenter 500. »PressüEscapeÇtosaveandexit. üëCREATINGACONFIGURATIONFILE Ç QuickBBSgetsmostofitsconfigurationfromafilecalled üQCONFIG.BBSÇ,locatedinthehomedirectory.Thisfilecanbe createdandeditedwiththeconfigurationprogramüQConfigÇ.Select theüRunQConfigÇoptionfromthemainmenu.Youwillsee... 1...ModemParameters. 2...SystemPaths,GeneralInfo. 3...Restrictions. 4...Newuserparameters 5...NetMailInformation,ScreenSettings 6...Toggles. 7...Terminal,StandAloneMode. 8...ExternalProtocolinterface 9...Accountingsystem ThisistheQConfigmainmenu.Forthemomentthereareonlyafew settingswhichareofgreatimportance. Chooseoption1,üModemParametersÇ.Inthisscreenyoucandefine whatcommandsQuickBBSshouldsendtoyourmodem,whatspeedyour modemworksatetc. ThefirstimportantsettingisüMaxBaudrateÇ.Hereyoushouldfill inthehighestspeedatwhichyourmodemcanwork.Ifyouhavea highspeedmodem(9600andhigher)youneedtolockthemodemata certainspeed.TheüLockedBaudrateÇisthebaudratetheRS-232will alwaysstayat.Mostlythevaluewillbe19200. Thenmovethehighlightedbar(withthecursorkeys)toüInit StringÇ.ThisisthecommandwhichQuickStartwillsendtothe modemwhenitstartsup.ItshouldputthemodeminAuto-Answer mode,whichcanusuallybedonewiththecommandüATS0=1Ç.Itshould alsomakesurethemodemtellsusatwhatbaudratetheconnection is.MostmodemsacceptüATX1Çtodothis. Allmodemcommandstringscancontainanumberofspecial characters.SeethechapteronconfiguringQuickBBSformoreinfo. Agoodinitstringwhichworkswithmostmodemsis... ATZ|~ATX1S0=1| SomemodemsneedtobetoldthatthecarrierandDTRmustbeused. Thiscanoftenbeaccomplishedwith... AT&D1&C1| ÇTheüResetStringÇisthecommandwhichissenttothemodembefore QuickStartexits.Agoodresetstringis ATZ|~ATH1S0=0| üInitResponseÇandüResetResponseÇarethestringswhichyourmodem sendsbackwhenithassuccessfullyexecutedtheinitandreset strings.AsimpleüOKÇisgenerallyenough. NowpressüEscapeÇtoreturntotheQConfigmainmenuandselect option2,üSystemPaths,GeneralInfoÇ.Anotherscreenwillbe displayed,andatthebottomyouwillseethetwolinesweneedto edit... üSysOpNameÇ.......... üSystemNameÇ......... UsethecursorkeystomovethehighlightedbartoüSysOpNameÇand typeinthenameyoujustenteredintheusereditor.Thename enteredheremustbeêexactlyÇthesameasenteredintheuser editor,otherwiseQuickBBSwillnotrun. NowmovethebartoüSystemNameÇandtypethenameofyourBBS. ThenpressüEscapeÇtoreturntoQConfigsmainmenu. Selectoption5,üNetMailInformation,ScreenSettingsÇ.Atthetop ofthescreenyouwillsee... üZoneNumber........... NetNumber............ NodeNumber........... Ç IfyourBBSisaStand-AloneBBS,enterzeroesasZone,Netand Nodenumbers.IfyoualreadyhaveaFidoNetorother(NeST, AtariNetetc.)address,enterithere.Ifyoudon'tknowwhata FidoNetaddressis,justenterzeroes.PressüEscapeÇtoreturnto QConfigsmainmenuandüEscapeÇagaintosavetheconfigurationand returntoQInstall.Ifyouhaveseveralnodenumbersthenonlyuse themainnumber,inmostcasesyourFidoNetnumber. ü ëINSTALLING4KBUFÇ Youmustmakesurethatü4KBUF.PRGÇisinyourautofolder,resetthe systemfirstsothisisactive.BoththekeysystemêandÇQuickBBSST needthislittlebuffertobeactive üëREQUESTINGAKEY Ç YoucantestandrunQuickBBSlocallyêwithoutÇtheneedofakey, ifyouwanttoallowuserstologinyoumusthaveakey,eithera demoorfullkey. Togeta(demo)keyselectüRunQKeyÇfromtheQInstallmenu.QKey istheprogramwhichcanbeusedtorequestakeyfromourSupport BBS.Thekeyisasmallfilewhichmustbeplacedinthehome directory. ForpeoplewholiveoutsideHolland:requestingakeyfromthe SupportBBSshouldonlytakeaboutaminute,soitdoesn'tcost much.Butyoucanalsorequestakeyviathemail,readthepart aboutpayingforthekey. QKeywillaskyouafewquestions.Wewouldliketoknowsome thingslikeyourvoice&BBSphonenumbers,postaladdressetc.so wecancontactyouifneeded.Pleasefillinthisinformation truthfully.Itwill-ofcourse-bekeptsecret. Atthispointyoumustalsoconfirmthattheinformationentered inQConfigandUserEditiscorrect.Thekeywillcontainthis information.Iftheinformationinthekeydoesn'tmatchthe configuration,QuickBBSwillnotrun.Thismeansthatifyou change-say-yourBBSnameyouwillhavetorequestanew key. QKeyhasalittleterminalbuiltin.Setthecorrectbaudrate(the SupportBBSrunsatallspeeds),anddialthenumber.Assoonas QKeydetectsacarrieritwilltakeover.Ifyouuseahighspeed modem(9600andhigher)setthebaudratetothelockedbaudrate, mostly19200.Otherwiseitwon'twork.  Ifyoucan'tgetagoodconnecttrytodisableHST,useV32bis,or disableMNP-5.AndêveryÇsurethatü4KBUF.PRGÇisactive! Sonowyoushouldhaveyourown,personaldemokey.Itshouldbe calledüQUICKBBS.KEYÇandplacedinthehomedirectory(QKeywilldo thisforyou). ëRUNNINGTHEBBSê Ç It'sabouttimewehadalookinsidetheBBSbynow!Quittothe DeskTopandstartupüQSTART.PRGÇ.Whenit'sfinishedloadingyou willseetheQuickStartscreen.Yourmodemwillbeinitialisedand QuickStartwillwaitforthefirstcaller.PressüLÇ(Local)to startuptheBBS.QuickStartwillresetyourmodemandexecute üQUICKBBS.PRGÇ,theactualBBSprogram. YoucanalsostartQuickBBSviaacommandlineinterpreter(like Pcommand).Tologginlocallyyoumustenter:quickbbs-l ÇQuickwillreadtheconfigurationfilesandcheckyourkey.And thenyoucanfinallytypeinyourname!Playaroundwiththedemo systemforabittofindoutwhatitlookslikefromtheusers pointofview. Whenyou'vehadenough,logoffandhavealookatthefile üSYSTEM.LOGÇinthehomedirectory.Thisfilecontainsallmajor actions,possibleerrormessagesandbitsofinteresting information.Itwillgrowandgrowuntilyoudeleteit.Anynew usersthatloginwillberecordedinthefileüNEWUSER.LOGÇ. ü================================================================= ===========Section3:Configuration/Operation=============== ================================================================= Ç ëMOREABOUTQCONFIGü ÇWell,whatdoyouthinkofthedemonstrationsystem?Pleasekeep inmindthatitispreciselythat.Itdoesn'tmakeuseofmany advancedfeaturesofQuickBBS.Ofcourseyouwillwantto customiseyourBBS,developyourown'look&feel'.Todothat we'llhavetoexplainsomemoreabouttheconfigurationprogram QConfigfirst. »TheüModemParametersÇscreencontainsmostofthemodemcontrol informationasusedbyQuickStart. »»üMaxBaudrateÇisthemaximumspeedatwhichyourmodemworks. QuickStartcanonlyoperateatspeedsofupto2400bps.If yourmodemisfasterthan2400bpsyouwillhavetousea mailerasfront-end. »»üLockedBaudrateÇisthebaudrateatwichtheserialportis locked.Youneedthiswithmodemsthatare9600Bpsor higher.NormallyYousetthisto19200.Andalwaysusea CTS/RTSfixinyourautofolderasTOS<2.06doesn'tsupport CTS/RTS.YoucoulduseTurboCTS,HS-Fix,Serialfixetc. forthistask. »»üMaxInitTriesÇisthemaximumnumberoftimesQuickStartmay trytoinitialise/resetyourmodem.Ifthemodemdoesn't respondcorrectlyafterthemaximumnumberofretries QuickStartwillabort. »»üConnectDelay(Seconds)Çisthemaximumtimebetweendetection ofaringandreceivingaConnect.Usedinmanualanswer mode. »»üAnswerDelay(Seconds)Çisthedelaybetweendetectingaring andsendingtheanswerstring.Usedinmanualanswermode. »»üInitStringÇisacommandwhichissenttothemodemwhen QuickStartstartsup.Ifyouarenotusingmanualanswermode itshouldmakethemodemauto-answer.Allcommandstringscan containthesespecialcharacters: |Sendsacarriagereturn, ~Waitshalfasecondbeforesendingthenext characterofthecommand, !Sendsacarriagereturnandwaitsforaresponse fromthemodem, ^RaisesDTR, vLowersDTR. Ç»»üResetStringÇissenttothemodemwhentheBBSgoesoff-line (e.g.whenQuickStartexitsorstartsautility). »»üAnswerStringÇisusedinmanualanswermode.QuickStartwill lookfortheüRingDetectionÇstringandchecktheüRINGpinÇon theRS-232interface.Whenitnoticesthephoneisringingit willsendtheAnswerStringtothemodemandwaitfora Connectstring.Tousethemanualanswermodeyoumustalso changeasettinginthe'Toggles'screenofQConfig. »»üRingDetectionÇisthestringyourmodemsendswhenthephone isringing,usedinmanualanswermode. »»üInitResponseÇisthestringyourmodemsendswhenit successfullyreceivedtheInitString.Ifthisstringisnot receivedfromthemodemQuickStartwilltrytoinitialisethe modemagain. »»üResetResponseÇisthesameastheInitResponse,butnowfor theResetString. »üSystemPaths,GeneralInfoÇiswhereyoudefinewhatdirectories shouldbeusedbyQuickBBStoaccessthesystemfiles. »»üMenuPathÇisthepathleadingtoyourMenufiles, »»üTextfilePathÇisthepathleadingtoyourTextfiles, »»üMessagePathÇisthepathleadingtoyourMessageBasefiles, »»üOARCPathÇshouldpointtoascratchdirectorywhichthe OnlineArchivercanuse.Thisdirectoryshouldbereserved fortheOnlineArchiverêonlyÇ. »»üShellProgramÇistheprogramwhichisstartedwhenyouuse theAlt-Jkey(JumptoDOS)inQuickStartandQuickBBS.This canbeanyprogramyoulike,butacommandlineinterpreter wouldbeanobviouschoice.Ifyouwantyoucouldput somethinglikeNeoDeskinhere. »»üExternalChatÇcanpointtoachatprogramwhichisexecuted byQuickBBSwhenauseryellsforyou.Ifthisprogram doesn'texist,orifthisfieldisleftblank,theinternal chatisused. »»üFSEProgramÇpointstoaFullScreenEditorwhichisexecuted byQuickBBSwhenauserwritesamessage.Atthemomentthere isnosuchprogram,soleavethisblank. »»üNodelistPathÇisforFidoNetnodes.Itshouldpointtothe directorywhichcontainsyournodelist,translatedwith XLTLST,ParslSTorBTNC. Ç»»üSysOpNameÇisyourname.IfauserwritesamessagetoSysOp thisnamewillautomaticallybesubstituted.Itshould correspondêexactlyÇtothenameofthefirstuserinthe userbase,andtothenamecontainedinthekey. »»üSystemNameÇisthenamewhichyouhavegivenyourBBS.This can'tbechangedwithoutrequestinganewkey. »» üLeavemessageinchatonboardÇistheboardnumberinmconfig  thatausercanleaveamessageinafteranunsuccesfull yell. »TheüRestrictions,Çscreenletsyoudefinecertainrestrictions. »»üStart300BaudAccess(HH:MM)ÇandüEnd300BaudAccessÇ:You candefineacertainperiodoftimeinwhich300Baudusers areallowedonyourBBS.Ifa300Baudusercallsoutside thisperiodhewillnotbeallowedin.Ifyoudon'twantsuch arestriction,enter00:00asstarttimeand24:00asend time. »»üStartDownloadHoursÇandüEndDownloadHoursÇ:Usersareonly allowedtodownloadbetweenthesetimes.Enter00:00and 24:00toallowuserstodownloadatanytimeofday. »»üStartPagingHoursÇandüEndPagingHoursÇ:Usersareonly allowedtoyellforyoubetweenthesetimes.Enter00:00and 24:00toenableyellingatalltimes. »»üMinimumBaudratetoLogonÇ:ifausertriestologintothe BBSataslowerbaudratethanthissettinghewillbe refused. »»üMinimumBaudrateforGraphicsÇ:userswithslowerbaudrates thanthissettingwillnotbeallowedtochooseagraphics modeotherthanASCII. »»üMinimumBaudrateforXferÇ:userswithslowerbaudratesthan thissettingwillnotbeallowedtouploadand/ordownload files. »»üMaxOARCSize(Kb)ÇisthemaximumsizeanOnlineArchivemay be.Thisisthesizeofthearchive,notofthefiles containedinthearchive,inKiloBytes.Enterzeroifyou wantQuickBBStouseallavailablediskspaceminusasmall safetybuffer. »»üTimeOut(seconds)Çdefineshowlongtheusermayremainidle (i.e.nottypeanything)beforeQuickBBSdecideshe'sfallen asleepandlogshimoff.ThisshouldbeêatleastÇ30seconds, becauseQuickBBSsendsamessagewarningtheuser30seconds beforethistimelimitexpires. »»üDefaultLogonTime(minutes)Çdefineshowmanyminutesperday ausermayusetheBBS.ThefileüLIMITS.CTLÇoverridesthis setting,butitcanbeusedtosetthenumberofminutes availablefornewusersbeforetheyhavecompletedthe registrationsequence. »»üPasswordTriesÇ:ifausertypeshispasswordwrongmoretimes thanthisvaluehewillbedisconnected. »»üMaximumPagesÇdefinesthemaximumnumberoftimesausermay yellforyoupercall. »»üPageTuneLength(seconds)Çisthelengthoftheyelltuneor beep. Ç»TheüNewusersettings,Çscreenletsyoudefimewhatleveland flagsanewusergets. »»üNewUserSecurityÇ:Thesecuritylevelwhichisgiventonew users.Mustbebetween1and32000.SeethesectiononUsers formoreinformation. »»üNewUserFlagsÇ:Flagswhicharegiventonewusers.Seethe sectiononUsersformoreinformation. »»üNewUserCredit(cents)ÇisusedforFidoNetnodes,and defineshowmuchNetMailcreditanewusergets.Seethe sectiononFidoNetformoreinformation. »InüNetMailInformation,ScreenSettingsÇyoudefineyourFidoNet address,screencoloursetc. »»WithüZoneNumberÇ,üNetNumberÇandüNodeNumberÇyoutell QuickBBSwhatyourFidoNetaddressis.Refertothesection onFidoNetformoreinformation.üPointNumberÇisnotyet supported.  »» üFakeNetNumberÇ,someoldermailersoftwarestillusesaFake  Netforit'spoints.QuickBBScanreadressmailinthe  netmailareasoitdoesn'tshowthisFakeNetandusesafull  4Dpointaddress. »»üAllowReplytoUnlistedNodesÇWillallowuserstoreplyto messagesoriginatingfromanodewhichisnotinour NodeList. »»üUsenetmailCreditsÇallowsyoutochargeauserfortheuse ofnetmail.ThiswillonlyworkwiththeTheBoxandVersion 6BinkleySTnodelist.Itdoesn'tworkwiththenewBTNC nodelistformat. »»üStatusLineCharacterColourÇisthecolourofthetextinthe statusbaratthebottomofthescreen.ForcolourmonitorsI recommend3,formonochromesystemstry0. »»üStatusLineBackgroundColourÇisthecolourofthestatusbar itself.Ifyouuseacolourmonitortry2,foramonochrome monitortry1. »»üColour0Ç,ü1Ç,ü2Çandü3ÇaretheRGBcoloursonacolourmonitor andallowyoutoreversethe'colours'onamonochrome monitor.Try000,700,007and777. »»üScreenSaverDelay(seconds)Çisthelengthofthedelay beforeQuickStart'sscreensaverblanksthescreen.Assoon asanyactivityisdetectedQuickStartwillrestorethe screen. »IntheüTogglesÇscreenyoucanswitchallsortsofthingsonand off... »»ü^EatLogonÇ:Quiteafewcommunicationsprogramscan automaticallysendanameandapasswordwhena^E(Control- E,ASCII5)characterisreceived.Whenthisoptionis switchedonQuickBBSwillsenda^Ewhenitasksforthe usersname. »»üFastLogonLocallyÇ:ifthisoptionisswitchedonQuickwon't askforausernamewhenyouloginlocally.Insteaditwill justtakethefirstuserintheuserbase,whichshouldof coursebeyou. Ç»»üAskforPwdLocallyÇ:whenthisisonyoumustentera passwordwhenyouloginlocally,evenifFastLogonis switchedon. »»üUseLastReadPointersÇ:currentlyunused.Alwaysused »»üExitforNet/EchoÇ:QuickBBSexistwithanerrorlevelafter mailhasbeenentered »»üCheckforMailÇ:byswitchingonthistoggleyouactivatethe MailScanwhenauserlogsin.QuickBBSwilllookinthe messagebasetoseewhetherthereisanymailwaitingfor thisuser.TheMailScancanbeabortedbypressingüSpaceÇ. »»üAskVoicePhoneÇandüAskDataPhoneÇwillmakeQuickasknew usersfortheirvoiceanddataphonenumbers. »»WhenüAskNewUsersGraphicsÇisswitchedonnewuserswillbe askedwhichGraphicsModetheywouldliketouse.Ifthisis switchedofftheywillgetplainASCIItext. »»ByswitchingoffüUseXmodemÇ,üXmodem-1KÇ,üYmodemÇ,üWXmodemÇ,and üZmodemÇyoucandisallowtheuseofanyoftheinternal protocols,bothforUploadingandforDownloading. »»üAllowBatchUploadsÇcanbeusedtodisallowUploading multiplefilesatoncewithYmodemandZmodem. »»WithüTouchUploadsÇyoucanchoosewhetheryouwanttosetthe dateandtimestampofuploadedfilestothecurrentdateand time.Filesuploadedwithnon-batchprotocolsalwayshavethe currentdateandtime. »»üUseDownloadCountersÇwillletQuickBBSupdatethenumberof timesafileisdownload.Itwillputa[xx]atthebeginning ofthefiledescriptionintheFILES.BBS. »»üEnforceLanguageÇcanbeusedtostopuserswritingmessages inyourlocallanguageininternationalEchoMailareas(where messagesshouldbeinEnglish).SeethesectiononMessages formoreinfo. »»WhenüEnforceLowerCaseÇisswitchedoneachmessageentered ischeckedforlowercasecharacters.Ifthemessageis entirelyinuppercasetheuserwillnotbeallowedtosave it. »»ByswitchingüAllowQuotingÇonyouallowuserstousethe reply-quotingfeatureofthemessageeditor. »»üSaveCombinedBoardsÇisnotimplemented. »»WhenüUseManualAnswerÇisswitchedonQuickStartwillwait forthephonetoringandthensendtheAnswerString.When thisoptionisswitchedoffQuickStartwillassumethemodem answersthephonebyitself,andjustwaitsforaConnect string. »»üUseYelltunesÇswitchestheyelltunesonandoff.Depending onausersnameorsecuritylevelyoucangetQuicktosound adifferenttunewhentheuseryellsforyou.Whenthisis switchedoffyouwilljusthearabeep.Seethesectionon Chattingformoreinformation. »»üUseExternalXmodemÇ:QuickBBShastwoversionsofXmodem available.Oneisbuilt-in,theotherisaseparatedriver, üXFER.000Ç.Whenthisoptionisswitchedofftheinternal Xmodemisused.Tryitout,andifyouhaveproblemsusethe externalone.NOTE:üXFER.000ÇisstillneededforYmodemand WindowedXmodemtransfers! »»üAllowVT-52MonochromeÇ:Switchthisoffifyoudon'twant yourusersinVT-52Monographicsmode. Ç»»üAllowVT-52ColourÇ:Sameasabove,butforVT-52Colour. »»üAllowVT-52StandardÇ:Sameasabove,nowfortheno-frills StandardVT-52mode. »»üAllowAnsiÇ:Again,forAnsigraphicsmode. »»üUsePCfontforAnsiÇ:byswitchingthisonQuickBBSwilluse aPC-stylefontwhenAnsiGraphicsareactive,soyoucanuse theniceboxcharactersetc.Thisfontdoesn'tshowifyou haveanold(pre-1.6)versionofTurboSTinstalled. »»üAllowOptimiserÇ:ifyouwanttoallowyouruserstousethe MenuOptimiser,switchthison.SeethesectiononMenusfor moreinfo. »»üTranslate[x]to<x>Ç:InsomeScandinaviancountriesthe squarebracketsareusedfortheirlocalcharacterset.When thisoptionisswitchedonthesystemmenuswilluseangled bracketsinsteadofsquareones. »»üFunmodeinchatÇ,ifswitchedonyourchatscanbecomevery exiting.Justhaveatry. »»üLogoffaftertransfers,Çwillaskauserbeforeadownloadif hewantstobeloggedoffdirectlyafterthetransfer. »»üAllowmessageuploads,Çausercannowuploadaprepared messagetext.Sohehasn'ttypeitallinonline. »WithüTerminal,Stand-AlonemodeÇyoucancontrolsomeofthe featuresanddefaultsinQuickStart.Thesesettingsare describedintheQuickStartdocumentation. »IntheüExternalProtocolsÇscreenyoucanprogramQuickBBSonhow tousetheexternalprotocols.Formoreinforeadthesectionon externalprotocols. »»üNumberon/offÇswitchestheprotocolonoroff.Becarefull thatifyouuseaprotocolthatalreadyisusedinQuickBBS youdisablethisinthetogglescreen. »»üName,Çisthenameoftheprotocol,thisisusedwhenasking theuserwhichprotocoltouse. »»üKey,Çisthekeyauserhastopresstoselectthisprotocol. »»üFullDuplex,Çenablethisforprotocolsthatcanup-êandÇ downloadatthesametime.CurrentlyonlyJekyll(great)can dothis.WithJekyllyoucanup-êandÇdownloadêandÇchatatthe sametime.ThisoptionmakessurethatQuickBBSalwaysscans foruploadedfilesafteratransfer. »»üDoorfile,Çeveryexternalprotocolmusthaveaü.DORÇfilein wherepath'sandcommandlineetc.areprogrammed.Seethe sectionaboutExternalprotocolsforthis.Forexampleyou canusesomethinglikeJEKYLL,QuickBBSthenusesJEKYLL.DOR forJekyll. »»üLogfileIDÇ,isusedtoidentifyaprotocolintheupload-or download.log.Itmustbe2characters.ForexampleZ-Modemis ZM,JekyllJKetc.etc. »»üBatchfilesÇ,enablethisforprotocolsthatcantransfermore thenonefileatatime,likeZ-Modem/Y-Modem/Jekylletc.Do ênotÇenablethisforX-Modem/X-Modem1k.ê Ç»»üF-PathÇ,Fullpath,enableifaprotocolalwaysneedsafull path.Mostlyyoucanspecifyapathandfilenameseperately, soinmostcasesit'soff. Ç»WithüTerminal,Stand-AlonemodeÇyoucancontrolsomeofthe featuresanddefaultsinQuickStart.Thesesettingsare describedintheQuickStartdocumentation. »üAccountingsystem,Çhereyoucandefineonhowtousethe accountingsystem.Seetheaccountingsectionformroeinfo. »»üDownload-perKb,Çdetermineshowmanypointsareaddedor subtractedforeverydownloadKiloByte.Thenumberofpoints canbenegativeorpositive. »»üDownload-perfile,Çdetermineshowmanypointsareaddedor subtractedforeveryfiledownload.SameasperKb »»üUpload-perKb,Çsameasdownloadexceptit'sforuploads. »»üUpload-perfile,Çsameasdownloadexceptit'sforuploads. »»üConnect-percall,Çnumberofpointsgiveneachtimeauser calls. »»üConnect-perminute,Çnumberofpointsgivenforeachminute auserhasbeenonline. »»üRead-permessage,Çnumberofpointsgivenforeachmessage auserhasread. »»üPost-permessage,Çnumberofpointsgivenforeachmessage auserhasposted(entered). »»üMaximumpoints,Çisthemaximumnumberofpointsausercan get,theabslutemaximumis+32767 »»üMinimumpoints,Çisthelowestnumberofpointsausercan get,theabsluteminimumis-32767 »»üNewuserpoints,Çisthenumberofpointsanewusergets.  ëFUNCTIONKEYSÇ YoucancreateanumberoffilesinyourCONF\configuration directorywhichassignstringstotheüfunctionkeysÇ.QuickBBSwill loaddifferentfunctionkeyfilesindifferentpartsoftheBBS. Therearefilesforchatmode,themessageeditoretc. Eachlineinthefunctionkeyfilesshouldstartwithanumber between1and20,followedbyacolumn(:)andthestringyouwish toassign.Averticalbar(|)willbereplacedbyaCarriage ReturnandaLineFeed.Thefilesare... »üFUNCKEYS.BBSÇloadedwhenauserison-lineü, Ç»üLOCLKEYS.BBSÇloadedinlocalmode, »üCHATKEYS.BBSÇloadedinchatmode, »üEDITKEYS.BBSÇloadedinthemessageeditor, üÇ»üDOSKEYS.BBSÇloadedwhenyoujumptoDOS,ü Ç»üTERMKEYS.BBSÇloadedinterminalmodeinQuickStart, »üWAITKEYS.BBSÇloadedinunattendedmodeinQuickStart. ÇTheWaitKeysfiledoesn'tassignastringtothefunctionkeys. Insteaditdefinesprogramstostartupwhenthekeyispressed. SeetheQuickStartdocumentation.AChatKeysfilemightlook somethinglike... 1:Justasec...| 2:Youcalled?| Whenyoupressüf1Çthetext"Justasec..."issenttotheuser, followedbyaCarriageReturnandLineFeed(CRLF).Eachstring maybeupto30characterslong.Itmayincludetabcharacters. ëSYSOPKEYSÇ WhileauserisonlineQuickBBSallowsyoutomodifysomeofhis parametersanddosomeothernicethingsbypressingoneofthe üSysopKeysÇ. »üHelpÇshowsyouabrieflistoftheavailableSysOpkeys inthestatusbar.Theuserdoesn'tnotice anything. »üClr/HomeÇupdatesthestatusbarand/orrestoresittonormal afterpressingüHelpÇ.Theuserdoesn'tnotice anything. »üCursorUpÇincreasestheuserstimelimitby5minutes.The userdoesn'tnoticeanythingexceptthathehas5 minutesmore. »üCursorDownÇdecreasestheuserstimelimitby5minutes.The userdoesn'tnoticeanythingexceptthathehas5 minutesless. »üAlt-AÇchangestheusersgraphicsmodetoASCII. »üAlt-CÇenterschatmode.Seebelow. »üAlt-DÇcyclesDisplayMode:switchesthestatusbaroff, thenthescreendisplayifyoupressthiskey again.UseüShift-Shift-Alt-DÇtoswitchstatusbar andscreendisplaybackon. »üAlt-FÇallowsyoutoedittheusersflags.Theuseris toldtowait. »üAlt-HÇhangup:disconnectstheuserdirectly. »üAlt-IÇgivessomeextrainfoabouttheuserlike: Phonenumbers,lattimehe/shecalled,up/download files,accountetc. toldtowait. »üAlt-JÇjumptoDOS:startstheprogramdefinedinQConfig. Theuseristoldtowait. »üAlt-LÇlockout:disconnectstheuser,asksfor confirmationandzeroestheuserssecuritylevel, lockinghimoutoftheBBS. »üAlt-OÇallowsyoutoedittheusersaccount.Theuseris toldtowait. »üAlt-PÇswitchesprinterloggingonandoff.Iftheprinter doesn'trespondprinterloggingisswitchedoff. »üAlt-SÇallowsyoutoedittheuserssecuritylevel.The useristoldtowait. »üUndoÇclearsthedailydownloadcounterandasksyoufor anewdownloadlimitforthiscallonly. Ç ëCHATTING&YELLTUNESÇ AfewextrakeyscanbeusedinüchatmodeÇ: »üControl-CÇclearthescreen »üControl-FÇswitchFunmodemonoroff »üControl-GÇsoundabell,beeportune »üControl-LÇswitchthechatlogonandoff »üControl-UÇswitchtheusersCapsLockonandoff »üControl-VÇviewafile »üEscapeÇexitchatmode ThechatlogiscalledüCHATLOG.TXTÇandcanbefoundinthehome directory.Itcontainseverythingyoutypeandeverythingtheuser types. üControl-UÇcomesinhandywhenusersdon'tknowwhattheCapsLock keyisfor.Ifausertypeseverythinginuppercase,press Control-U.Quickwilltransformwhatevertheusertypesto lowercase.Theuserwillseethistoo,andhopefullyswitchhis CapsLockoff.Assoonashetypesalowercasecharacter,oryou pressControl-Uagain,thetransformationisdisabled. üControl-VÇwillpromptyouforafiletodisplay(andsendtothe user).Thiscanbeatextorgraphicsfile,allcontrolcodeswill betranslated.SeethesectiononTextFilesandMenus.Thiskey isidenticaltoexecutingamenuoptiontype5. üControl-GÇsendsabellsignaltotheuser.IftheuserisinAnsi graphicsmodehe'llevenhearatune!Whentheuserpressesit he'sêsureÇtogetyourattention. üControl-FÇwillswitchtheFunmodeonoroff.Ifyouusethe Funmodesomeverystrangethingscanhappen.QuickBBSwillstart tobehaveverystrange.Tryit,itwillsurpriseyou... Ifausertriedtopageyouandyoudidn'tanswerheisaskedto leaveamessage.Youmustentertheareanumberwherethismessage mustendupinQconfig. Quickcansoundadifferenttunedependingonausersnameor securitylevel.TousethisfeatureyoumustcreateanASCIIfile calledüYELLTUNE.BBSÇinyourCONF\directory.Eachlinecaneither startwiththeusersname(withspacesreplacedbyunderscores)or asecuritylevel.Thisshouldbefollowedbyafilepath+name whichcontainstheXBios32(DoSound)instructions.Suchafile canbecreatedbyprogramslikeComposer(downloadablefromthe SupportBBS)orMusix32.Anexample:  Robert_Redford\QBBS\TUNES\MICHELLE.MUS 200 \QBBS\TUNES\PRELUD.MUS 10 \QBBS\TUNES\STUPID.MUS ÇIfauserwithlevel200yellsthefileüPRELUD.MUSÇisplayed.If RobertRedfordyellsyou'llhearthetuneinüMICHELLE.MUSÇ. ëTHESTATUSBARÇ Astatusbarisdisplayedatthebottomofthescreen.Itcontains someinformationaboutthecurrentuser.Thetoplineshowsthe usersnameandcity,inthebottomlineyou'llseehissecurity level,whenheloggedin,howmuchtimehehasleft,howmany timeshe'scalledandwhathisgraphicsmodeis(AforAscii, MforVT-52Monochrome,CforVT-52Colour,SforVT-52Standard andIfor(IBM)Ansi). InLocalmodetheamountoffreeRAMisdisplayedinthemiddleof thebar.Ifauseryellsforyouitwillbeshownthereinstead. IfyoupressüAlt-IÇyouwillgetsomemoreinfoaboutthecurrent user.Maybyyouwanttocheckhisphonenumber! Thestatusbarandthelocaldisplaycanbeswitchedonandoff withtheüAlt-DÇkey.Thisisforusewithmulti-taskingpackages liketheMTC-shellandMX2.PressüAlt-DÇoncetoswitchoffthe statusbar.PressüAlt-DÇagaintoswitchoffthedisplay.Toswitch thembothbackonagainyoumustpressüShift-Shift-Alt-DÇ.Youcan alsoswitchitoffifyouput-nonthecommandline,themouse willbeswitchedontoothen. ü================================================================= ========================Section4:Users====================== ================================================================= Ç ëUSERINFORMATIONÇ QuickBBSknowsquitealotabouttheuser.Thetwomostimportant itemsofinformationarethehisüSecurityLevelÇandhisüFlagsÇ.The SecurityLevel,sometimescalledUserLevelorPrivilege,isa valuebetween0and32000.Dependingonthislevelhemayormay nothaveaccesstocertainoptionsintheBBS.Auserwith securitylevelzerowillnotevenbeallowedintotheBBS.Nice wayoflockingoutyourmother-in-law! TheuserhasfoursetsofFlags.Eachsetcontains8flagswhich canbeeitheronoroff.Thesetsare'numbered'AtoD,theflags arenumbered1to8,sooneflagcanbeidentifiedas,for instance,A1orC6.AflagwhichisonismarkedwithanX,aflag whichisoffismarkedwithaminus(-).Boththesecuritylevel andtheflagscanbechangedintheusereditor. EachoptioninamenuintheBBShasasecuritylevelandasetof flagstoo.Theseitemsarecomparedtotheuserssettings. Dependingontheresult,theusermayormaynothaveaccessto thatoption.Anexample: Amenuoptionhasthefollowingsettings: SecurityLevel:50 A-Flags:--X---X- B-Flags:-------X C-Flags:-------- D-Flags:-------- Auserlogsinwiththefollowingsettings: SecurityLevel:100 A-Flags:XXX---XX B-Flags:-------- C-Flags:--X----- D-Flags:-------- QuickBBSwillfirstlookattherequiredSecurityLevel(50)and compareittotheusersSecurityLevel(100).Theuserslevelis higher.Ifitwaslowertheuserwouldn'thaveaccessto,oreven see(!)themenuoption. BasedontheSecurityLevelstheuserhasaccess,butQuickwill nowcomparetherequiredFlagsandtheusersFlags: RequiredA-Flags:--X---X- UsersA-Flags:XXX---XX BinaryAND Result:--X---X- ÇIfarequiredflagison,thentheusersflagmustalsobeonif heisallowedtousethemenuoption.Thisoperationcanbe comparedtoabinaryAND.Noticethattheresultisequaltothe requiredflags. BasedontheA-flagstheuseralsohasaccess,sowecontinuewith theBflags... RequiredB-Flags:-------X UsersB-Flags:-------- BinaryAND Result:-------- ThemenuoptionrequiresflagB8tobeon,buttheuserdoesn't haveflagB8!ThismeanshedoesênotÇhaveaccesstothemenu option,anditwillbeinvisibletohim.Thismightbeabit difficulttograspatfirst,andmightrequirealittle experimenting.Noticetheresultisn'tequaltotherequired flags. Themenusaren'ttheonlypartoftheBBSwhichhaveflags.Each messageboardhassecuritylevelandflagprotectionforread access,writeaccessandSysOpaccess.Moreonthatlater. WhatelsedoesQuickBBSknowabouttheuser?Well,let'ssee... »üCallsÇThenumberoftimestheuserhascalledyourBBS, »üCityÇWheretheusersayshelives, »üHomePhoneÇHisvoicephonenumber, »üDataPhoneÇanddataphonenumber, »üLastDateÇThelastdatetheuserloggedin,MM/DD/YY format, »üLastTimeÇThelasttimetheuserloggedin,HH:MMformat, »üUsedTodayÇHowlonghehasbeenonlinetoday, »üCreditÇHisNetMailcredit, »üDownloadedÇHowmanyfiles&Kbhehasdownloaded, »üUploadedÇHowmanyfiles&Kbhehasuploaded, »üDLTodayÇHowmanyKbhehasdownloadedtoday, »üPostedÇHowmanymessageshehaswritten, »üDeletedÇIsthisusertobedeletednexttimeUserPackis run? »üClearScreenÇDoesthisuserwanthisscreenclearedbetween menus? »üMorePromptÇDoeshewantthe'More [Y/n] ?'prompttobe displayedatthebottomofeveryscreen? »üScreenLengthÇIfso,howmanylinescanhisscreendisplay? »üIgnoreDLHrsÇMaythisuserdownloadoutsidethedownload periodasspecifiedinQConfig? »üGraphicsModeÇWhatistheusersgraphicsmode? »üAccount ÇWhatishisnumberofaccountpoints? Quickalsokeepstrackofwhichmessagestheuserhasreadinthe messagebase,ifthefileüLASTREAD.BBSÇexists.Thisfilecanbe createdwithUserEdit. ÇëPACKINGTHEUSERBASEÇ WhenyoudeleteauserinUserEditheisnotactuallyremovedfrom theuserbase.He'sjustmarkedasdeleted.YoumustruntheüPACK Çoptionintheusereditortoreallydeletetheuserandupdatethe lastreadpointers.Hereyoucanalsodeleteusersthathaven't loggedinforawhile.Itasksafterhowmanydaysausermustbe deleted. ëTHELIMITSFILEÇ QConfigallowsyoutodefineadefaultütimelimitÇforeachuser. Butyoumightlikesomeusersmorethanothers,andwanttogive themmoretimeintheBBS.I'dgiveKellyLeBrock(rememberThe WomaninRed?)alldayifshewantedit8-).Itwouldmakemuch moresensetohaveatimelimitwhichdependsontheusers SecurityLevel.Well,that'spossibleofcourse.Withthe üÇoptionalüLIMITS.CTLÇfile. TheLimitsfileisaplainASCIIonewhichshouldbeplacedinthe homedirectory.Itcontainsoneormorelines,eachterminated withaCRLF(CarriageReturnandLineFeed,ASCII13andASCII 10).Eachlinecontainsthreenumbers.Thefirstnumberisthe securitylevel.ThesecondisthemaximumtimeintheBBS,in minutes,perday.Thethirdvalueisthemaximumamountuserswith thatSecurityLevelmaydownload,inKb,perday.ThefileêmustÇbe sortedonSecurityLevel. QuickwillsearchthroughthefilelookingfortheusersSecurity Level.Ifitdoesn'tfindtheexactlevelitwillusetheclosest lowerlevel. Anexample:KellyLeBrockhaslevel200.OurüLIMITS.CTLÇfilelooks likethis: 11020 102050 5030100 10045200 50060250 Level200isn'tintheLimitsfile,soQuickwillusethevalues definedforSecurityLevel100instead:45minutesperdayinthe BBSand200Kbofdownloadperday. ëTHETRASHCANFILEÇ TheTrashCanfileisalsolocatedinthehomedirectory.Another optionalASCIIfile.EachlineinüTRASHCAN.CTLÇcancontainawhole nameorpartofanamewhichisnotallowedtobeusedontheBBS. Youmightwanttoputsomedirtywordsintheretoo(anold favouriteofVIC-20users).  ÇAnexample:anewusercalledDouglasDucklogsin.YourTrashCan filecontains... HITLER REAGAN DONALDDUCK MICKEYMOUSE DouglasDuckwouldbeallowedontotheBBS,becausenoline containsêonlyÇthewords'DouglasDuck','Douglas'or'Duck'. However,ifanewusercalledRobinReaganloggedinhewouldênotÇ beallowedon,becauseoneofthelinesistheword'Reagan'. üëTHEACCOUNTINGSYSTEMê ÇThisisaverypowerfullpartofQuickBBS.Youcanrewardor punishauserdependingonhisactions.Havealookatthe accountingsectioninQconfig.Youcandeterminetherewhatthe 'reward'willbeforseveralactions. Theaccountcanrunfrom-32767to+32767.Butyoucansetalower max.orhighermin.too. QuickBBSêonlyÇregisterstheaccount,itdoesn'tdoanythingwith ititself.Thatisuptoyou.Togiveyouanideayoucouldusea ü.DORÇfileinthedownloadsectionoftheBBSthatisrunaftera fileisdownloaded.Youcanusetheaccountas*Ointheü.DORÇ file,withtheIF...THEN..statementsyoucouldchangethe usersleveland/ordownloadlimitdependingonhisaccount. Soletthemgraycellswork,thisisreallyveryniceêifÇyoumake gooduseofit. ü================================================================= ==================Section5:Text&Graphics================== ================================================================= Ç ëTEXTFILES&GRAPHICSMODESÇ YourüTextFileDirectoryÇcontainsawholelotoftextfiles.You caneditanyofthesefilestocustomiseyourBBS,addnewones etc. QuickBBSsupportsfiveüGraphicsModesÇ.Byselectingagraphics modetheusercangetQuickBBStomakebetteruseofhisterminal, byusingEscapeSequencestocontrolthingslikecolours,cursor positionetc. Thetextfilescomeinfiveflavours,oneforeachGraphicsMode. QuickBBSselectsthefiletodisplaybylookingatthefile extension.Thetextfileswhichcontainescapecodesaresometimes calledGraphicsFiles. ThesimplestGraphicsModeisplainüASCIIÇ.Noescapecodesare sentinthismode.Thetextfilesforthismodeendinü.ASCÇ. ThenwehavethreeVT-52modes.üVT-52ÇüMonochromeÇandüVT-52ColourÇ areforuseonAtariST'sêonlyÇ.Theyusesomeescapecodeswhich areAtari-privateandmightdostrangethingsonothermachines. TheMonochromeflavourhasextensionü.VTMÇandshouldnotcontain anycolourescapes.TheColourflavouriscalledü.VTCÇ.Ifauser isrunningsoftwareonadifferentcomputerwithVT-52emulation hecanselectüVT-52StandardÇ.InthismodetheBBSwillnotsend anyoftheAtari-privateescapes.Thefileextensionhereisü.VTSÇ. ThemostfancymodeisüAnsiÇ.Thisisn'têrealÇAnsi,buttheIBM version,asimplementedinmanycommspackagesonthePC.Itis oftencalledAnsi-BBS.WhenoperatinginthismodeQuickBBScan useaPC-stylefontsothatyoucanseetheIBMcharactersetwith boxgraphicsetc.Theextensionisü.ANSÇ.Thoughthemostused escapescanbeinterpretedbyQuickBBS,theimplementationofAnsi isnotcomplete.IfQuickBBSseesanescapeitdoesn'tknowit willignorethatescape.TheescapeêwillÇbesenttotheuser. PleaserefertotheappendixsectionforVT-52andAnsiescape sequences.Andremember:youcandoahellofalotwiththese escapes,butyourusersdon'tcallyourBBStolookatthepretty pictures.I'veseenanumberofboardsusingAnsitoimplement DropDownmenus.Looksgreat,butisêveryÇêveryÇslow. Thedifferenttext/graphicsfilescancontainnon-standard escapes,ifyouwant.InAnsimodeQuickwillonlyuseAnsi escapesinthesystemmenus,butyouarefreetoputanythingyou likeinthegraphicsfiles(notthatitwouldmakemuchsense). ÇëSYSTEMTEXTFILESÇ Thereareanumberofsystemtextfileswhichyoucaneditand/or create.Someofthefilescanonlyhaveanü.ASCÇversionbecause theyaredisplayedbeforetheusersGraphicsModeisknown. »üBANNERÇdisplayedbyQuickStartwhiletheBBSisbeing loaded.ASCIIonly,andmaynotcontainanycontrol codes. »üBROWSERÇdisplayedwhentheuserselects[H]elpfromthe FileBrowser. »üDNLDHRSÇdisplayediftheuserattemptstodownloadoutside downloadhours. »üEDITHELPÇdisplayedwhentheuserselects[H]elpfromthe MessageEditor. » üFILEMENUÇ displayedwhentheuserselects[H]elpfromthe  FileMenu. »üGOODBYEÇdisplayedjustbeforeQuickBBSdisconnects. »üGRAPHELPÇdisplayedwhentheuserselects[H]elpfromthe GraphicsModemenu.Tobeonthesafesideuseü.ASCÇ only. » üHOTNEWSÇdisplayedafterlogin,andonlyifthefiledateis  newerthenthelasttimetheusercalled. »üLANGUAGEÇdisplayedwhentheusertriestosaveamessage whichdoesn'tpassthelanguagetest. »üLOGOÇtheveryfirstfileQuickBBSdisplays(afterthe bannerfile,displayedbyQuickStart).Becausethe graphicsmodeisnotyetdetermined,thefilehas ASCIIonlyflavour. »üMAXPAGEÇdisplayediftheuserattemptstopageyoumore timesthanallowed,asspecifiedinQConfig. »üNEWSÇdisplayedjustbeforethesystemchecksfornew mail. »üNEWUSER1Çdisplayedtoanewuserafterhehasverifiedhis name,butbeforeanyquestionsareasked.ASCII only. »üNEWUSER2Çdisplayedafterthenewuserhasselecteda password. »üNEWUSER3Çdisplayedwhenthenewuserhasfilledinallthe questions. »üNO300Çdisplayedwhenacallcomesinat300Bpsoutside the300Bpshours. »üNODELISTÇdisplayedwhenauserselects[H]elpfromthe NodeListmenu. »üNOTAVAILÇdisplayedwhenauserpagesyououtsidethepaging hoursdefinedinQConfig. »üNOTFOUNDÇdisplayedifthesystemcan'tfindtheuserinthe UserBase,butbeforeheisaskedwhetherhisname iscorrect.YoushouldexplaintheFidoNetnaming convention(AlexisCarrington.Colby.Dexter)etc. »üOARCHELPÇdisplayedwhentheuserselects[H]elpfromthe OnlineArchivermainmenu. »üOARCTYPEÇdisplayedwhentheuserselects[H]elpfromthe OnlineArchivertypeselectionmenu(whenhe choosesbetweenü.ARCÇandü.LZHÇarchives). Ç»üOPTIMISEÇdisplayedwhentheuserselects[H]elpfromthe MenuOptimisermenu. »üPAGEABRTÇdisplayediftheSysOpabortsapage. »üPAGEDÇdisplayedwhenyoudon'trespondtoapage.It shouldinformtheuserthattheSysOphasbeen paged. »üPASSWORDÇdisplayedbeforeanewuserisaskedfora password,andwhentheuserchangeshispassword. » üPOSTCHATÇ displayedafterachat » üPRECHATÇ displayedbeforeachat » üPRE-UPLDÇdisplayedbeforeuploading »üREADHELPÇdisplayedwhentheuserselects[H]elpfromthe ReadMessagesmenu. » üSCANHELPÇ displayedwhentheuserselects[H]elpfromthe  ScanMessagesmenu. » üSECxxxÇdisplayedafterloginifuserwithlevelxxxcalls. »üTOOSLOWÇdisplayedifausercallswithabaudratelower thanthe"MinimumBaudratetoLogon"asdefinedin QConfig. »üTRASHCANÇdisplayedifthenametypedinbythenewuser conflictswiththeüTRASHCAN.CTLÇfile.ASCIIonly. » üUP-DESCÇ displayedafteruploadbutbeforeaskingtheuser  forthedescriptionoftheuploadedfile(s) »üUPPERÇdisplayedwhenausertriestosaveamessagewhich doesn'tpasstheUpperCasecheck. » üUSERxxxÇdisplayedafterlogintotheuserwithrecord  numberxxx.Example:USER006.ASCisshowntouser number6. »üWELCOMEÇdisplayedaftertheuserhasenteredhisnameand password.Thisiswhereyoumightliketoget elaborate.It'sASCIIonly. »üXFERHELPÇdisplayedwhenauserselects[H]elpfromtheFile TransferProtocolmenu.Itshouldexplainwhateach protocoldoes,andwhichisbest. Yourmenuscancontaincommandstodisplaytextfiles.Unless otherwisestatedthesefilesshouldbelocatedintheTextfile Directory.Donotincludeanextensioninthenameofthefileto display,QuickwilladditdependingonthecurrentGraphicsMode. IfthereisnographicsfileforthecurrentGraphicsMode, QuickBBSwilldowngrade,e.g.ifthereisnoüWELCOME.ANSÇthefile üWELCOME.ASCÇisused.WhenlookingforafileQuickwillfollowü Çthischart... êGraphicsModeÇêSearchorderë üÇASCII*.ASC ANSI*.ANS*.ASC VT-52Standard*.VTS*.ASC VT-52Mono*.VTM*.VTS*.ASC VT-52Colour*.VTC*.VTM*.VTS*.ASC ÇëTEXTFILECONTROLCODESÇ EachtextfileotherthanüBANNER.ASCÇcancontaincontrolcodes. ThesecodesarereplacedwhenQuickBBSdisplaysthefile,or causeQuickBBStotakeacertainaction.Mosteditorscaninsert suchcodesintoatextfile.FirstWordPlusêcan'tÇ,infactit willoftenrefusetoloadafilewithsuchcontrolcodes.Try Tempus,MicroEmacsorthecapturebufferinFlash. Inthis(andmostother)documentationacontrolcodeisshownas a^signfollowedbyacharacter.Forexample,^A(Control-A)has ASCIIcode1,^Biscode2etc. InTempusyoucanusethecharactertabletoenterthecodes,or keeptheAlternatekeypressedwhileyoutypetheASCIIvalueon thenumerickeypad,e.g.totypecontrol-Cyouwouldholddown Alternate,press3andreleaseAlternate.InmostMicroEmacs versionsyoucanpresscontrol-Qfollowedbythecharacteryou want,e.g.control-Qfollowedbycontrol-C. ThecontrolcodesknowntoQuickBBScanbesplitupintothree groups:üSystemControlÇ,üUserInformationÇandüSystemInformationÇ. TheUserInfoandSystemInfoaretwo-charactercodes.Theystart witheithera^For^K,followedbyanothercharacter.Thissecond characterisênotÇacontrolcode! Thecodesare... üSystemControl ë üÇêCodeÇêASCIIÇêFunction Ç ^A001PauseandwaitfortheusertopressReturn. ^B002Turn[S]topabortingoff.Theusercan normallyabortêanyÇtextfilewiththeüSÇkey, andpausewiththeüPÇkey. ^C003Turn[S]topabortingon. ^D004TurntheMore[Y/n]promptsoff. ^E005TurntheMore[Y/n]promptson. ^F006UserInformationcode. ^G007Soundbell/beep. ^H008BackSpace. ^I009Tab. ^J010LineFeed. ^K011SystemInformationcode. ^L012FormFeed(clearscreen). ^M013CarriageReturn  ÇüUserInformationÇ êCodeÇêASCIIÇêFunctionÇ  ^FA006065Usersfullname. ^FB006066City. ^FC006067Password(usewithcare!). ^FD006068Dataphone. ^FE006069Voicephone. ^FF006070Lastdateusercalled. ^FG006071Lasttimeusercalled. ^FH006072UsersA-Flags. ^FI006073UsersB-Flags. ^FJ006074UsersC-Flags. ^FK006075UsersD-Flags. ^FL006076NetMailCreditincents. ^FM006077Numberofmessagestheuserhasposted. ^FO006079UsersSecurityLevel. ^FP006080Numberoftimestheuserhascalled. ^FQ006081Numberoffilestheuserhasuploaded. ^FR006082NumberofKiloBytestheuserhasuploaded. ^FS006083Numberoffilestheuserhasdownloaded. ^FT006084NumberofKiloBytestheuserhasdownloaded. ^FU006085Numberofminutesuserhasbeenonlinetoday. ^FV006086Lengthoftheusersscreen. ^FW006087Usersfirstname. ^FX006088UsersGraphicsMode. ^FY006089Moreprompt:ONorOFF. ^FZ006090ScreenClear:ONorOFF. ^F0006048Optimiser:ONorOFF. ^F1006049KiloBytestheuserhasdownloadedtoday.  ^F2n006050FlagAn:ONorOFF.  ^F3n006051FlagBn:ONorOFF.  ^F4n006052FlagCn:ONorOFF.  ^F5n006053FlagDn:ONorOFF.  ^F6006054CurrentAccount  ^F7006055FullScreenEditor:ONorOFF. ÇüSystemInformationÇ êCodeÇêASCIIÇêFunctionÇ ^KA011065NumberofcallstotheBBS. ^KB011066Nameofthelastcaller. ^KF011070Numberoftimesyou'vebeenpaged. ^KG011071Dayoftheweek(i.e.Monday,Tuesdayetc.). ^KH011072NumberofusersintheUserBase. ^KI011073Currenttimein24hourformat(HH:MM) ^KJ011074Currentdate,formatDDMMMYY(04Nov89). ^KK011075Timeconnected-minutes. ^KL011076Timeconnected-seconds. ^KM011077Timeused-minutes. ^KN011078Timeused-seconds. ^KO011079Timeremaining-minutes. ^KP011080Timeremaining-seconds. ^KQ011081Timelimitinminutes. ^KR011082Baudrate. ^KS011083Abbreviateddayofweek(i.e.Mon,Tueetc.). ^KT011084DownloadlimitinKb. ^KWx011087Amountoffreespaceondrive'x'. ^KX011088AmountoffreeRAM. You'dlikeanexample?Okay.ThefileüPAGED.ASCÇcontainsthe followingtextandcontrolcodes... Hello ^FW,theSysOpdoesn'tseemtobearoundatthe moment.Youhave^KOminutesand^KPsecondsleftfortoday, sowhydon'tyouwritehimamessage? Press[Return]tocontinue...^A Whenthisfileisdisplayeditmightlooksomethinglikethis... HelloDave,theSysOpdoesn'tseemtobearoundatthe moment.Youhave 24minutesand 18secondsleftfortoday, sowhydon'tyouwritehimamessage? Press[Return]tocontinue... atwhichpointQuickwouldwaitforDavetopresstheReturn. ü================================================================== =======================Section6:Menus======================== ================================================================== Ç ëTHEMENUSYSTEMÇ EachmenuonaboardrunningQuickBBSis100%SysOp-configurable. NotonlythemenuêtextÇandmenuêkeysÇ,butalsothemenuêstructureÇ. Eachmenuhasamenufilewhichcanbecreatedwiththemenu editor(üMENUEDIT.PRGÇ).ThisprogramwaswrittenbyTheoRunia.The menufilesarelocatedintheüMenuFileDirectoryÇandhave extensionü.MNUÇ. Whenausercalls,thefirstmenuhewillgetisüTOP.MNUÇ.This menumustalwaysbepresent.Fromthispointonwardyouare completelyfreetochooseyourownmenunames. AmenucontainsoneormoreümenuoptionsÇ.Eachoptionconsists of... »üTextLineÇwhattheuserseesonthescreen. »üDataLineÇdependsontheOptionType. »üOptionTypeÇwhattheoptiondoes. »üOptionKeyÇkeywhichactivatestheoption. »üRequiredSecurityÇSecurityLevelneeded. »üRequiredFlagsÇFlagsneeded. »üForeGroundColourÇforegroundcolourinVTC/ANSmode. »üBackGroundColourÇbackgroundcolourinVTC/ANSmode. TheüTextLineÇwillonlybedisplayedêifÇtheuserhasaccessto theoption.ThisdependsontheüRequiredSecurityÇandüRequired FlagsÇ,andtheusersSecurityLevelandFlags. Therearethreespecialcharacterswhichcanbeusedinatext line.Theyare: ^Toggleshighlighton/offinVT-52Mono/ColourandAnsimodes, ~Isreplacedbythenumberofminutesleft, ;Ifthetextlineendswithasemi-columnnoCRLFisadded,so youcanputtwoormoreoptionsnexttoeachother. TheüOptionKeyÇisthekeytheusermustpresstoactivatethe option.OfcoursethisisaHotKey. TheüForegroundÇandüBackgroundÇüColourÇitemsarenotimplementedin thecurrentversionofQuickBBS. TheüOptionTypeÇisthemostimportantofthewholelot.Itdefines whattheoptionactuallydoes.Thereareoptiontypestoread mail,toviewfiles,toyellfortheSysOpetc.etc. TheüDataLineÇcancontainparametersdependingonwhichOption Typeyouhavechosen.SomepeoplecallittheCommandLinefor somereasonorother. ÇëMENUTEXTÇ WhattheuserseeswhenyourmenuisdisplayedistheTextLineof eachmenuoptionhehasaccessto.TheTextLineshouldindicate whatkeytheusermustpresstoactivatetheoption.Youcanuse the^charactertohighlightpartsofyourTextLine.Ifyou definethelineas ^[F]^FileMenu thenthe[F]willeitherbereversed(inVT-52Monomode)orhave adifferentcolour(inAnsiandVT-52Colourmode).InASCIIand VT-52StandardmodesQuickBBScan'tchangeanycoloursor attributes.Thesquarebracketsmakesurethatthekeyisclearin thosemodestoo. ëMENUSTRUCTUREÇ AnybodywhohaseverprogrammedinBASICwillknowthecommands üGoToÇ,üGoSubÇandüReturnÇtobranchtoacertainsectionofthecode. Youuseasimilarmethodtodescribethestructureofyourmenus. OptionType1istheüGoToÇoption.ItmakesQuickBBSforgetthe currentmenuandloadanewone.Optiontype2istheüGoSubÇ option.Italsoloadsanewmenu,butremembersfromwhichmenuit wasloadedfrom.Withoptiontype3youcanüReturnÇtothatmenu. Thismaysoundrathercomplicatedbutinfactitisveryeasy. Thinkofthemenustructureasahierarchy.Thehighestlevelis theüTOPÇmenu,eachbranchisasub-menu,calledwithoptiontype 2.TogobacktotheüTOPÇmenuyouuseoptiontype3.Asub-menu canalsohavebranches,upto20levelsdeep. Timeforanexample.Wewanttocreateamenustructurewhich lookssomethinglikethis... +-------+ |TOP| +-------+ /\ /\ /\ +----------+ +----------+ |FILE||MAIL| +----------++----------+ |||| +----++----++----++----+ |F1||F2||M1||M2| +----++----++----++----+ ...whereüTOPÇisthemainmenu,üFILEÇisamenuwhereyouselecta fileareamenu(üF1ÇorüF2Ç)andüMAILÇletsyouselectamailarea menu(üM1Ç orü M2)Ç. ÇWe'dhavesevenmenufiles:üTOP.MNUÇ,üFILE.MNUÇ,üMAIL.MNUÇ,ü F1.MNUÇ,üF2.MNUÇ,üM1.MNUÇandüM2.MNUÇ.It'saquiteeasytodoitwith less,butI'llsavethatforlater. üTOPÇwouldcontaintwoüGoSubÇmenuoptions.OnetoloadüFILEÇandone toloadüMAILÇ.Iassumeyouwanttobeabletogetbacktothetop menufromwithinoneofthesub-menus,soüFILEÇandüMAILÇwillboth containaüReturnÇoption.Theywouldalsoallowaselectionbetween eitherüF1ÇandüF2ÇorüM1ÇandüM2Ç,withüGoSubÇoptions. Thelowestlevelmenuscouldcontainanoptiontoeithergoback totheselectionmenu(withüReturnÇ),orstraightbacktoüTOPÇ.To accomodateforthissortofconstructionQuickknowsafourthmenu structureoption,calledüClearStackandGoToNewMenuÇ(gotit?). Whatitdoesisthis:firstitforgetshowitgottothecurrent menu(itclearsthemenustack).Thenitjustloadsthenewmenu liketheüGoToÇoptiondoes.You'dusethisoptiontogostraightto üTOPÇ. Alltheseoptions-exeptforüReturnÇ-expectthenameofthemenu tobeonthedataline.Ifamenuisn'tfoundQuickwillwarnthe user(andtheSysOp,inthelogfile)andreturntotheüTOPÇmenu. ëTHEMENUEDITORÇ iscalledüMENUEDIT.PRGÇ.Whenexecuteditwilldisplayalistof existingmenus.Withthefunctionkeysyoucancopy,deleteand renameexistingmenus.Tocreateanewmenuoreditanexistingone justtypeinthename. YouwillthenseethemainmenuofMenuEdit.FromhereyoucanAdd newoptionstothe'end'ofthemenu,Insertanewoptionbetween twoexistingoptions,Change(edit)orDeleteoptions. WithSimulateyoucanseewhatyourmenulookslikewhenitis displayedtotheuser.You'llhavetoenteraSecurityLevelto determinewhichmenuoptionsareused,butallflagsareassumed on.TheListcommandshowsalistofalltheoptionsinyourmenu. WhenyouAdd,InsertorChangeanoptiontheeditscreenis displayed.Allthefieldsofthemenucanbechangedhere. ThemenuüPromptÇisreallyjustanothermenuoptionrightdownat thebottomofthescreen(theverylastoption).Thedifferenceis thatitisonlyaüTextLineÇanddoesn'tactuallydoanything.The üHighLightÇcoloursaren'timplementedinthecurrentversion. ÇëMENUOPTIONTYPESÇ Thereareabout40differentoptiontypesinthecurrentversion ofQuickBBS.Theyare... êTypeÇêDescriptionÇ 0üTextLineÇ,notconsideredacommand.Usethistoaddextra linesoftexttoyourmenu,suchastitlesandemptylines. 1üGoToNewMenuÇ.Themenunameandanymenuparametersshould beplacedontheDataLine. 2üGoSubNewMenuÇ.TheDataLineshouldcontainthemenuname andanymenuparameters. 3üReturnfromPreviousGosubÇreturnstothemenuwhichloaded thecurrentmenu. 4üClearStack&GoToNewMenuÇ.DataLine:menunameandmenu parameters. 5üDisplayTextFileÇ.TheDataLinecontainsthenameofthe file,withoutextensionandwithoutpath.Thefileshould belocatedintheTextFileDirectory. 7üExecuteProgramÇ.Startsupanexternalprogram,seethe sectiononDoors. 8üVersionInformationÇ.DisplaystheversionofQuickBBS,the copyrightinformationetc.NoDataLine. 9üLogoffÇ.Terminatestheconnection.NoDataLine. 10üDisplaySystemUsageGraphÇ.Thisdisplaysagraphofthe usageofyourBBSperhour.NoDataLine. 11üYellforSysOpÇwilleitherexecutetheexternalchat programorpageyouusingtheinternalchatroutines. 13üList/SearchUserBaseÇ.Thisallowstheusertoenterpart ofanametosearchtheUserBasewith,orjustpress ReturntoviewthewholeUserBase.Thename,cityand date-of-last-callofeachuseraredisplayed.NoDataLine. 14üDisplayTime/DownloadStatisticsÇshowstheusersome informationabouthowlonghehasbeenintheBBS,howmuch timehehasleft,howmuchhecandownloadetc. 15üExitwithErrorLevelÇterminatesQuickBBSwithanerrorlevel specifiedintheDataLine.Theconnectionisnot terminated.SeethesectiononDoors. 16üChangeCityÇallowstheusertomodifythe'City'fieldhe filledinasanewuser.NoDataLine. Ç17üChangePasswordÇwilldisplaythetextfileüPASSWORDÇinthe TextFileDirectoryandwillthenasktheuserforanew password.NoDataLine. 18üChangeScreenLengthÇallowstheusertochangehisscreen length(usedfortheMore[Y/n]prompt).NoDataLine. 19üToggleClearScreenÇwillswitchthescreen-clearcodessent betweenmenusonandoff.NoDataLine. 20üToggleMore[Y/n]PromptÇswitchesthepromptonandoff whichisdisplayedattheendofeachpagewhenreading textfiles,messagesetc.NoDataLine. 21üChangeGraphicsModeÇallowstheusertoselectadifferent GraphicsMode.NoDataLine. 22üCheckforPersonalMailÇwillscanthemessagebaseformail tothisuserwhichhehasnotyetread.Youcanspecifythe areanumbertoscanontheDataLine.IftheDataLineis emptyallareastowhichtheuserhasaccessarescanned. YoucanalsospecifyALL,inthiscasesmessageTo:ALLare scanned. 23üReadMessagesÇallowstheusertoreadmessagesinthearea numbersuppliedontheDataLine,aslonghashehasread- accesstothatarea.SeethesectiononMessages.  24 üScanMessagesÇdisplaystheheadersofthemessagesinthe  areanumbersuppliedontheDataLineiftheuserhasread-  access.TheuserisaskedifhewantstoMarkamessage, thiscanbereadwithReadMessages(Marked)later.Refer tothesectiononMessages. 25üQuickScanMessagesÇdisplaysalistofthemessagesinthe areanumbersuppliedontheDataLineiftheuserhasread- access.RefertothesectiononMessages. 27üWriteaNewMessageÇisusedtowritemessagesinthearea suppliedontheDataLine.TheDataLinecanalsocontain the/Tand/Lmodifiers./T=First_Lastforcesthemessage toacertainname,the/Lmodifierlogstheuseroffafter themessagehasbeencompleted. 30üRawDirectoryÇdisplaysalistoffilesinthedirectory specifiedintheDataLine.Thefilenames,sizes,times anddatesaredisplayed.Thefilesdon'tneedtobein üFILES.BBSÇ(seethesectionaboutFileAreas). 31üDisplayFileListÇshowstheusertheformattedüFILES.BBSÇ file,withfilenames,sizes,datesanddescriptions.Refer tothesectionaboutFileAreas.TheDataLineshould containthedirectoryofthefilearea. Ç32üDownloadaFileÇallowstheusertodownloadoneormore filesfromthedirectoryspecifiedintheDataLine.See thesectiononFileAreas.TheDataLinecanalsocontain thenameofthefiletodownload. 33üUploadaFileÇletstheuseruploadoneormorefilestothe directoryspecifiedintheDataLine.Seethesectionon FileAreasformoreinformation. 34üShowContentsofArchiveÇpromptstheuserforthenameof anü.ARC,.LZH,.ZIP,.ZOOor.ZIPÇarchiveorü.GIFÇpicture fileinthedirectoryspecifiedintheDataLine,then displaysthecontentsofthatarchiveorpicture.Witha ü.GIFÇfile(picture)itcanalsotesttheintegrityofthe ü.GIFÇfil. 35üSearchforaFilebyKeywordÇsearchesallareasspecified inüFLSEARCH.CTLÇforawordsuppliedbytheuser.Seethe sectiononFileAreas. 37üListNewFilesÇdisplaysalistofnewfilessincetheuser lastcalled.TheDataLinecancontainthedirectoryto search.IftheDataLineisemptyallareasspecifiedin üFLSEARCH.CTLÇareused.Theuserispromptedforadateto startthescanfrom,defaultstothelasttimetheuser called. 38üViewTextFileÇaskstheuserforthenameofatextfilein thedirectoryspecifiedintheDataLine,thendisplaysthe file. 39üDisplayTextFileÇletstheuserreadatextfilewhichyou specifyintheDataLine.Withthisoptionyoumustspecify thefullpath,nameandextensionofthefiletodisplay. 40üReplaceMenuTextÇisusedwithAutomaticMenuExecutionand allowsyoutoreplacethemenuTextLinewiththecontents ofagraphicsfile.AutomaticExecutionisexplainedbelow. TheDataLineisthesameasintype5. 41üToggleFullScreenEditorÇswitchestheFullScreenEditor onandoff.NoDataLine.Theusercan'tswitchontheFSE inASCIImode. 45üDisplayTextFilewithReturnÇisthesameasoptiontype5, butdisplaysthe'PressReturn'promptwhendoneandwaits fortheusertopressReturn.  57 üChangeVoicePhoneÇofthecurrentuser,ifnothingis  enteredthenitwon'tbechanged.Thephonenumberisonly changedinUSERS.BBSandnotinNEWUSER.LOG.  58 üChangeDataPhoneÇisthesameas57,exceptthatitchanges  theDataphonenumber. Ç80üOnlineArchiverÇisusedtoextractpartsofarchivesto download.SeethesectiononOnlineArchivesformore information.TheDataLinespecifiesthedirectorywhich containsthearchivetoextractfrom. 81üPumpFileÇwillsendafiletotheuserwithoutinterpreting anycontrolcodes.ThiscanbeusedforthingslikeVidTex graphics.TheDataLineshouldcontainthefullpath,name andextensionofthefiletodisplay,precededbya+ora -modifier.Ifthemodifierisa-thefileisnot displayedlocally. 82üSelectMenuOptimiserÇwilldisplaytheMenuOptimiser selectionmenu,whichisexplainedbelow.NoDataLine. 83üFileBrowserÇstartstheFileBrowser,explainedlater.The DataLinecontainsthefullpath,nameandextensionofthe filetoview.  84üFileMarkMenuÇisasortofbrowserforyourdownload.The  optionaldatalinetakesapathtothedownloadarea.A Usercansteptroughafiles.bbslistinghere,jumppages aheadetc.Hecanalsomarkfilefordownload.Inthe currentversionofQuickBBSitonlyremembersthemarked filesforthecurrentarea.Morinfocanbefoundinthe SectionaboutFileAreas. Ç 85 üMailAreaListerÇgeneratesalistofmailareasfortheuser  tochoosefrom.ThisisnotfortheNovicesysopthough. TheoptionalDatalinetakesasfirstparametertheüGroup numberÇoftheareastolist,thisnumberisenterin Mconfig.Thesecondoptionisoptional,ifusedyoumust puttherethenameofthemenuthatithastoJumptoafter theuserhasmadeaselection.Ifyouomitthistheuser willbereturnedtothecurrentmenu.TheMailAreaLister willputontheoptionaldatalineofthemenu:  AreanumberAreaname  Youcanuse&1inthemenufortheareanumberand&2for  thenameofthearea. FormoreinforeadtheSectionaboutMailAreas.  86 üFileAreaListerÇdoesthesamejobasoption85butinthis  caseit'sforthefileareas.Itworksthesameonlyinthe the firstoptionontheoptionaldatalineisa stringthatmustbe availableinthedescriptionofan areainüFLSEARCH.CTLÇ.This stringisthendeleted.Sofor exampleput(ATARI)aftertheatari areas,useasstring (ATARI).Thenallareaswiththisstringare displayed minusthisstring.  Thisoptionalsoreturns2itemsontheoptionaldataline ofthemenuitwillreturnto:  PathDescription(fromüFLSEARCH.CTL)  ÇSoyoucanuse&1aspathinfoand&2asareanameinyour  menu.  FormoreinforeadtheSectionaboutFileAreas. ÇQuitealotofdifferentcommandsaren'tthere?Ashorterlistof thesecommandscanbefoundintheappendixsection. Themenufiles(ü.MNUÇ)arecompatibletotheonesusedbythePC versionofQuickBBS.Thatversionsupportsalltypesuptoand includingtype57,thoughtherearesomeminordifferencesinthe DataLines.TheoptiontypessupportedbyQuickBBSSTonlyare numbered80upwards,toavoidproblems. ëMENUPARAMETERSÇ Ifyouhavealotofdifferentfileormailareasyouwould normallyneedonemenuforeacharea.WiththePCversionof QuickBBSsomeSysOpshaveover500differentmenufiles!Ithink thatisabsolutelyridiculous,soQuickBBSSTcanpassparameters fromonemenutoanother. WhenyoucallamenuusingüGoToÇ(type1),üGoSubÇ(type2)orüClear StackandGotoÇ(type4)youcanpassupto10parameterstothe menuyouarecalling.TheseparametersareplacedintheData Line,afterthenameofthenewmenu.Theymustbeseparatedby spaces. Theseparameterscanbeusedinthenewmenubyplacinga& characterinthetextordataline,followedbyanumber.That numberselectstheparametertoinsertintothetextordataline. Anexample:youcallamenucalledüUPDOWNÇwithaüGoSubÇcommand. Thedatalineusedtocallitis... UPDOWNCommunications_programs\QBBS\DOWNLOAD\COMMS\ thenewmenuisloadedanddisplayed.ThefirstoptioninüUPDOWNÇ isaTextLine(type0).Itdisplaysthenameofthefilearea whichthismenuisusedfor.SotheTextLineofthefirstoption wouldbesomethinglike... CurrentArea:&1. ...Quickwouldtranslatethatto... CurrentArea:Communicationsprograms. (NotethatQuickreplacestheunderscoreswithaspaceinthe TextLineêonlyÇ) Thenyoucouldhaveanoptionto-say-downloadafile.That mighthaveaDataLinewhichcontainsonly&2.Quickwouldreplace that'&2'withthesecondparameterpassedtoüUPDOWNÇ,the directory\QBBS\DOWNLOAD\COMMS\.Thefilewouldbedownloadedfrom thatdirectory. ÇOnmostboardseachfileormailareamenulooksexactlythesame, exceptthenameoftheareaandthedirectoryofthatareaare different.WithQuickBBSSTyoucancreateoneuniformmenuand callitwithdifferentparameters,savingyoulotsandlotsof work! ëAUTOMATICMENUEXECUTIONÇ üNOTEÇ:Thistopicisn'tsuitablefornoviceSysOps.Ifyou'veonly juststartedusingQuickBBS,skipthispart. üAutomaticMenuExecutionÇ,sometimescalledüAutoExecÇforshort, makesQuickexecutetheoptionwhilethemenufileisbeing loaded.YoucandefineanAutoExecoptionbygivingita^Akey. Thisisalittledifficultinthecurrentversionofthemenu editor,butneverthelesspossible.Movethehighlighttothekey fieldandpressControl-A.Thentype1andpressReturn.You shouldseeanarrowpointingupwards.Thisisaraw^Acharacter. AutoExecoptionsarequitepowerful.Oneoptiontypeisspecially madeforAutoExec-ing.It'stype40,andcanbeusedtoreplacethe TextLineoftheAutoExecoptionwiththecontentsofafileinthe TextFileDirectory.Thatfilecancontainalltheusualcontrol andescapecodes,exceptfortheüPressReturnÇandüEnterLineÇcodes. ThiswayyoucancreatecustomisedVT-52andAnsimenus!Type40 canêonlyÇbeusedasanAutoExecoption.Itwillbeignoredifit isn'tautomaticallyexecuted. UsingAutoExecyoucangetQuicktoexecuteêanyÇoptiontype automatically.Theonly'but'isthis:whentheoptionhasbeen executedtherestofthemenuishandled,êexceptÇwhentheAutoExec optionloadedanewmenu.Inthatcasethemenuisre-loadedafter aüReturnÇ,andtheAutoExecoptionisexecutedagain. Onewaytogetroundthisproblemistoworkwithflags.Bygiving theAutoExecoptiona'requiredflag',andclearingthatflagin thesub-menu(usingaü.DORÇfile).ThentheAutoExecoptionisn't executedonreturn,becausetherequiredflagisn'tset. ëTHEMENUOPTIMISERÇ Fornon-ASCIIusersQuickprovidesaüMenuOptimiserÇ.Itreplaces multiplespaces,carriagereturnsandlinefeedsbyVT-52orAnsi escapecodestopositionthecursor,butonlyiftheescapecode isshorterthantheoriginal.At300and1200baudthismakes quitealotofdifference!TheMenuOptimisercanswitchedonand offwithoptiontype82. InsomecasesitisundesirabletohavetheMenuOptimiser switchedon.Forinstance,ifyouwanttosendcolouredspaces (spaceswithabackgroundcolourgreaterthan0),theoptimiser mightjumpoversome'coloured'backgroundwithanescapecode. ThereisaspecialcontrolcodewhichyoucanputinyourAutoExec graphicfiles.It's^O,andittemporarilytogglestheoptimiser onandoff. ü================================================================== ========================Section7:Messages==================== ================================================================== Ç ëTHEMESSAGESYSTEMÇ QuickBBScanhandleupto200differentüMessageAreasÇ(sometimes calledüBoardsÇ).Eachareahasanumberrangingfrom1to200.All messagesinoneareaarestoredintwofiles,locatedinyour üMessageFileDirectoryÇ.ü ÇThesefilesarecalledünnnn.HDRÇandünnnn.MSGÇ,where'nnnn'isthe numberofthearea(decimal).Theü.HDRÇfilescontainthemessage headers(from,to,subjectetc).Theactualmessagetextisstored intheü.MSGÇfiles. YoucanassigntheareanumberswiththeprogramüMConfigÇ.The messagebaseconfigurationisreadfromüBOARDS.BBSÇwhichshouldbe inyourCONF\directory. EachareahasanüareanameÇ,whichisdisplayedtotheuser.If thisareanameisblankthemessageareadoesn'texistasfaras Quickisconcerned.TheareasmustalsohaveaspecificüareatypeÇ. Thiscanbeoneofthefollowingtypes... »üLocalÇmessagesarenotsenttoanyothernodesin FidoNet. »üEchoMailÇmessagesaresenttoallFidoNetnodesconnectedto thisEchoMailarea. »üNetMailÇmessagesaresenttotheFidoNetnodetheuser specified. IfyouarerunningaStand-AloneBBSallareasshouldbeLocal areas.RefertothesectiononFidoNetforinformationabout EchoMailandNetMail. YoucanspecifywhatükindofmessagesÇyouwanttoallowinthis area... »üPublicÇmeansthemessageswritteninthisareamayonlybe public(i.e.anyonewhohasaccesstotheareacan readthem). »üPrivateÇmeansthemessagesinthisareamustbeprivate, onlytheSysOp,thewriterandthereceivercan readthem(iftheyhaveaccesstothearea). »üBothÇmeansthemessagescanbeeitherpublicorprivate. Theuserisaskedwhichkindofmessagehewantsto write. IfyouhavespecifiedtheareaasEchoMailyouwillhavetoenter anOriginLine.RefertotheFidoNetsection. ÇëMESSAGEAREAACCESSÇ EachmessageareahasthreesetsofSecurityLevelsandFlags.The usercanaccesstheareainthreedifferentways,ifhehasthe requiredSecurityLevelandFlags... »üReadAccessÇallowshimtoreadmessagesinthisarea, »üWriteAccessÇallowshimtoreplytomessagesinthisarea,and topostnewmessages, »üSysOpAccessÇallowshimtoreadallprivatemailanddeleteany messages. Iftheusertriestoreadmessagesinanareahedoesn'thaveread accesstoQuickwilltellhimsoandreturntothemenu.Samewith Write.IftheuserhasSysopAccesstheReadMessagesmenuwill justcontainsomeextraoptions(todeletethemessage,senditto theprinter,forwarditetc). ëTHELANGUAGECHECKFILEÇ AlotofEchoMailareasareinternational.Insuchareasall messagesshouldbewritteninEnglish.Therearethousandsofdim- wittedusersouttherewhoeitherdon'tcareordon'tknow,and writetheirmessagesinGerman,French,Dutchorwhateverother languagetheyfancy. QuickBBScanputanendtoallthatwiththeüLanguageCheckÇ.If youswitchthisoninMConfigallmessagestheuserswriteinthat areaarecheckedbeforetheyaresaved.Toenablethischecking youmustalsoswitchitoninQConfig. OfcourseyouhavetotellQuickhowtocheckthemessage.That canbedonewiththeüLANGUAGE.BBSÇfile,aplainASCIIonelocated intheCONF\directory.Itcontainsonewordperline.Thesewords mayênotÇappearinthemessage.Eachlanguagehassomewordsthat can'tbeusedinEnglish,butareoftenusedinmessages.That's thekindofwordsyouwant.Youmightliketoputsomedirtyones intheretoo... IfthemessagecontainsillegalwordsthefileüLANGUAGEÇinthe textfiledirectoryisdisplayed.Theuseristhenreturnedtothe messageeditortocorrecthismistake. ëTHEUPPERCASECHECKÇ AnotheroldfavouriteofdumbusersisanUPPERCASEmessage.Some peoplejustdon'tknowwhatthattheCapsLockkeyisfor.Youcan getQuicktocheckforthistoobyswitchingontheüUpperCase CheckÇoptionsinMConfigandQConfig. WhentheusertriestosaveamessageQuickwilltesteachline forlowercasecharacters.Ifalowercasecharacterisfoundinany line,themessageissaved.Ifnolowercasecharactersarefound thefileüUPPERÇisdisplayedandtheisuserreturnedtothe messageeditor. üëALLOWTHEUSEOFANALIASÇ OnmostBulletinBoardsyoumustuseyourrealname.Thesame appliestomostmailnetworks.Butsometimesyourareallowedto useanalias(Fakenameetc.).ForexampleinRolePlaying Adventureseveryeveroneasthereownfanatsiename. Sothisoptionsallowstheusertouseadifferentnameforthis areaonly.TheAliasisonlyrememberedforthecurrentsession. üëALLOW8BITCHARACTERSÇ InmostnetworksyouareonlyallowtouseASCIIcharacters, mainlybecausethecharactersabove127arenotstandarized.But insomecountry'syouneedthose(mostlyscandinavian).Soyoucan allowtheusefor8bitcharactersperarea.Domakesureyouask ifthisisallowed! üëFILEATTACHEDMESSAGESÇ Withthisflagyoucanletuserattachafiletoamessage.The userwillbeaskedifhewantstoattachafiletothemessage. Thefilecanthenbedownloadedbytheonethemessageis addressedto.ThefilecanêonlyÇbedownloadbytheuserintheTo: field,theonlyexceptionisifthemessageisaddressedtoALL, inthatcaseeveryonecandownloadthefile. Themessagewilfirstbeshown,afterthattheuserisaskedifhe wantstodownloadafile.Mindyoucanrecievefileattachmessage fromallareas,youmustonlyallowitforthemtobeposted. Thefileisputinto\QBBS\PVT_FILE\andthefilename/pathis storedinthesubjectfield,whichcan'tbeeditedanymorefor safetyreasons.TheWithfileflagisalsoset.Thissystemis compatiblewithFidonet,soyoucanalsosendfileattached messagefromsayüLEDÇ. Onthingthough,youcanalsomakethenetmailareafileattach buttakeinaccountthatyougenerallyarenotallowedtoroute fileattachedmessageover/viaothersystems,youshouldbring thembycrashmail. üëGROUPNUMBERÇ Thisisanumberfrom0to255where0disablesthegroupnumber. Currentlythisisonlyusedinmenuoption85(MailAreaLister). Youcandividedyourmessageareasintogroups,forexample: Groupnr1:Localareas Groupnr2:Nationalechomailareas Groupnr3:Internationalechomailareas Groupnr4:Atariareas etc.etc. WithMenutype85youcanusethisgrouptomakeseverallistsof areas.Thiswillmakelifeveryeasyforthesysop.Henowonly needstoaddanewareainmconfigandprontoitappearsinthe arealistintheBBS... Ç ëLASTREADPOINTERSÇ QuickBBSkeepstrackofwhichmessagestheuserhasreadinevery area.ThesepointersarestoredinthefileüLASTREAD.BBSÇinthe homedirectory.Theyareusedintwoways: »IntheMailScanthemessageareasarescannedstartingwiththe firstunreadmessage. »Whenauserselectsthe[N]ewoptionfromthereadmessagesmenu thefirstunreadmessageisdisplayed. ëPACKINGTHEMESSAGEBASEÇ OnceyouarerunningyourBBSthemessagebasewillgetlargerand largerunlessyoudosomethingaboutit.Thisiswherethe üFastPackÇprogramcomesin.ItüpacksÇyourmessagebase,which means... »Deletedmessagesarealwaysremoved. »Youcandefinehowoldamessagemaybebeforeitisremoved. »Youcandefineaminimumnumberofmessageswhichmustalways remaininacertainarea. It'sagoodideatopackyourmessagebaseonceadayifyouhave abusysystem.TheFastPackprogramhasitsowndocumentation files. Thereareotherprogramsthatcanpackandupdatethelastread pointerstoo,somenames: Bermuda Jetmail IOS etc. Mindyoubecarefullwiththose,alwayscheckiftheyupdatethe pointerstherightway.Ifyouhaveproblemswithwrongpointers thenlettheprogrammerofthepackercontactus,sowecantell himtheexactformatofthepointersandhowtoworkwiththem. üëTHEMAILAREALISTERÇ Thisismenutype85.Withthisoptionyoucangeneratealistof MailAreasfortheusertochoosefrom.Youcanchoosewhatareas tolistbyusingathegroupnumber.Theareasarealsosorted alfabeticlytomakeiteasiertoread. TheOptionalDataLine looks like:  <groupnumber> (up/download menuname)  1 readmail Now only mail areas that have groupnumber1areshown. Thegroupnumberisenteredinmconfig,seeabove, The second parameter is the menu it will jump to. You can also leavethisout, itwill return youthento the current menu, for example if you use a Change Area option in your readmailmenu. After the use made a choice the menu readmail (in this example) will be run. On the optional data line it will put: <areanumber> <description> 20From/To_the_sysop Inthemenureadmailyoucanuse&1asareanumberand&2as description. Hereisanotherexample.Youhaveamailmenuinwheretheuser canchoosebetweenNational,Internationalandlocalareas.Ifhe doesitwillrunamailarealistmenuthatwillrunthereadmail menu: Mail->Mailarealist->Readmail Mail:  [N]Nationalareas  [I]Internationalareas [L]Localareas Readmailmenu: [R]Readmessages  [W]Writemessages Themailarealistmenuwillhavetooptions: 1:Type85,Optionaldata:1readmail 2:Type3,Returnfromgosub. ÇBothlineshave^Aaskey.Thiswaytheyarerundirectlywhenthe menuiscalled.SoifyouchooseNfornationalyouwillgeta listwithnationalareas.Afteryoumakeyourchoicethemenu readmailisrun.Whenyoureturnfromthismenuyouwillbe presentedwiththelistagain. ThisoptionisênotÇforthenovicesysop,butitwillmakemuch easierfortheexperiencedsysopasnowyouonlyneedtoenternew areasintoüMCONFIGÇandyoudon'thavetobebotherwith havingtoadaptallthosemenu's. Çü================================================================== =======================Section8:Files======================== =================================================================Ç= ëFILEAREASÇ Thenumberoffileareasyouhaveisonlylimitedtotheamountof freediskspace.Eachfileareamusthaveitsowndirectory.That directorymustbespecifiedontheDataLineinsomemenuoptions. EachdirectoryshouldcontainaüFILES.BBSÇfile.ThisisanASCII filewithadescriptionofeachfileinthearea(=directory). Onedirectorymightcontainthefollowingfiles: FILES.BBS TCARC.TTP TCARC.DOC LHARC.PRG LHARC.DOC TheüFILES.BBSÇfileshoulddescribetheotherfourfiles,perhaps likethis: +--------------------------------------------------------+ |Archiveprograms| +--------------------------------------------------------+ TCARC.TTP[10]ARCcompatiblearchiver,50-80%faster. TCARC.DOC[1]DocumentationforTCARC. LHARC.PRGv201ofLHarc-ST,forusing.LZHarchives. LHARC.DOCDocumentationforLHarc-ST. STZIP.TOSSTZIP2.2,forusing.ZIParchives(withdocs) WhenQuickBBSdisplaysthislistitwillinsertthesizeanddate ofthefilebetweenthenameandthedescription.Ifthefile isn'tfoundthetext'---MISSING---'isinsertedinstead. üFILES.BBSÇcancontaincommentslines.Anycharacterwhichisnot usuallypartofafilenamecanbeusedtoindicateacomment line.Emptylinesarealsoallowed,asaremultiplespacesbetween thefilenameandthedescription. IfadescriptionistoolongtofitontoonelineQuickwillword- wrapandindentitonthenextline.YourASCIIeditormustbe abletohandlelonglinestousethisfeature.Tempuscan,andso canFirstWord.SomeversionsofMicroEmacscan'thandlelong lines. Thenumberbetweenbrackets([])isthenumberoftimesafileis downloaded.QuickBBSupdatesthisnumberafteradownload,youcan en/disablethisoptioninqconfigundertoggles. ÇëTHEFILESEARCHFILEÇ ...iscalledüFLSEARCH.CTLÇandcanbefoundinthehomedirectory. It'sanASCIIlistofallfileareasinyourBBS.Eachlinehas thefollowinglayout: <path><security><description> where<path>isthedirectory,<security>isthesecuritylevel neededtosearchtheareaand<description>isthenameofthe area.Anexample: \QBBS\DOWNLOAD\GENERAL10GeneralArea \QBBS\DOWNLOAD\COMMS10CommunicationsPrograms \QBBS\DOWNLOAD\UTILS20Utilities \QBBS\UPLOAD\GENERAL50UploadedGeneralFiles \QBBS\UPLOAD\COMMS50UploadedCommsPrograms \QBBS\UPlOAD\UTILS50UploadedUtilities ThemenuoptionsüNewFilesÇandüSearchforFileÇusethisfile.Each lineischeckedforavalidSecurityLeveland(ifvalid) searched.PleasenotethattheSecurityLevelsinthisfiledoênotÇ affectuploading,downloading,filelistsetc.TheyareêonlyÇused inthetwooptiontypesabove. üëTHEFILEAREALISTERÇ Thisismenutype86.Withthisoptionyoucangeneratealistof FileAreasfortheusertochoosefrom.Youcanchoosewhatareas tolistbyusingasearchstring.Theareasarealsosorted alfabeticlytomakeiteasiertoread. TheOptionalDataLine looks like:  <searchstring> (up/download menuname)  atari updown Now only file areas that have ATARI in the description are shown. This description is taken from the flsearch.ctl file. This way youcan make several list for different computers. The searchstring is case sensitive!! Mind you on the first20 characters of the description are shown. The word ATARI will be taken out of the list though! The second parameter is the menu it will jump to. You can also leavethisout, itwill return youthento the current menu, for example if you use a Change Area option in your up/download menu. Ç After the use made a choice the menu updown (in this example) will be run. On the optional data line it will put: <path> <description> c:\atari\falcon\ Falcon_files In the up/down menu you can then use &1 as path and &2 as the description. Hereisanotherexample.Youhaveafilesmenuinwheretheuser canchoosebetweenAtari,MS-DOS,Amigaareas.IFhedoesitwill runafilelistmenuthatwillruntheup/downloadmenu: Files->Filelist->Up/download Files:  [A]Atariareas  [M]MS-DOS Up/downloadmenu: [D]Download  [U]Upload Thefilelistmenuwillhavetooptions: 1:Type86,Optionaldata:ATARIUPDOWN 2:Type3,Returnfromgosub. Bothlineshave^Aaskey.Thiswaytheyarerundirectlywhenthe menuiscalled.SoifyouchooseAforatariyouwillgetalist withareasthathaveATARIindedescription.Afteryoumakeyour choicethemenuup/downisrun.Whenyoureturnfromthismenuyou willbepresentedwiththelistagain. ThisoptionisênotÇforthenovicesysop,butitwillmakemuch easierfortheexperiencedsysopasnowyouonlyneedtoenternew areasintotheüFLSEARCH.CTLÇandyoudon'thavetobebotherwith havingtoadaptallthosemenu's. ÇëTRANSFERPROTOCOLSÇ Whenauserwantstouploadordownloadafilethefirstthinghe seesistheüprotocolÇmenu.Ifyouhaven'tswitchedoffany protocolsinQConfigtheusercanchooseoneofthefollowing transfermethods: »üXmodemÇistheoldestandslowest.WhendownloadingQuickBBS willdetectthreeflavoursofXmodemautomatically:Xmodem Checksum,XmodemCRCandXmodem1K.Thefirsttwoareveryslow (about50%efficiency).Xmodem1Kisslightlyfasterifthe connectionisgood(about60%),butsloweronbadlines. »üYmodemÇisderivedfromXmodem.Forsomestupidreasonsome communicationsandBBSprogramsthinkXmodem1KisYmodem.This isênotÇtrue.Ymodemusesmixed128and1024byteblocks,andis êalwaysÇabatchprotocol(morethanonefilecanbesentat once).YmodemisnofasterthanXmodem1K. »üWindowedXmodemÇisanotherXmodemflavour.Itdoesn'twaitfor thereceivertoacknowledgetheblock,butassumesthatnonews isgoodnews.WindowedXmodemismuchfasterthanthenormal Xmodem.Insomewaysit'sratherlikeSEAlink,butitdoesn't supportbatchtransfers.Efficiencyisabout75%. »üZmodemÇisthebestofall.Itsupportsbatchtransfers,andis êveryÇfast(90%to98%efficiency).Italsouses32bitCRC insteadof16bit,makingitmuchmorereliable.Ifthetransfer failsduringaZmodemupload/download(carrierlostoranyother cause)youdon'thavetostartalloveragain,Zmodemwill continuewhereitleftoff! Theefficiencyistheratiobetweentheactualnumberofbytes transferredpersecondandthetheoreticallypossiblenumberof bytespersecond. AlwaysuseZmodemifatallpossible.It'sêmuchÇfaster,êmuchÇ easierandêmuchÇmorereliable. ëUPLOADS&DOWNLOADSÇ WhenüdownloadingÇQuickwillaskforthefilestotransfer.If YmodemorZmodemareselectedtheusercantypeinmorethanone filename,separatedbyspaces.Quickwillcheckthedownload limit,timelimitandstartthedownload.Ifthedownloadis succesfullQuickBBSwilladdanumbertothefiledescriptionlike this:  QUICKBBS.ZIP[100]TheêBESTÇAtariST(E)/TT/FalconBBS Thenumberbetweenbrackets[]isthenumberoftimesafileis download. üNOTEÇ:TheusercandownloadêanyÇfilefromthedirectoryyou specify.Afiledoesn'thavetobedescribedin üFILES.BBSÇfortheusertodownloadit. Ç WhenüuploadingÇfileswithanon-batchprotocoltheusermusttype thefilename.Thefilemaynotyetexistinthedirectoryto whichtheuserisuploading.WithabatchprotocolQuickwillnot allowexistingfilestobeoverwritten.Afterthetransferthe usermusttypeinadescriptionforeachfileheuploaded.This descriptionwillbeaddedtotheendofüFILES.BBSÇ.Thetimeused duringanuploadisaddedtotheuserstimelimit. ThelogfileüSYSTEM.LOGÇwillshowyouwhattheuserhasuploaded ordownloaded.Twoadditionallogfilesareupdated,called üUPLOAD.LOGÇandüDOWNLOAD.LOGÇ.ü Ç Bothlogfilescontain1fileperline.Linesstartingwithan asterisk(*)shouldbeignored.EachlineinüUPLOAD.LOGÇhasthe followingformat: TPUser_NameFILESPECDescription andüDOWNLOAD.LOGÇjustcontains: TPUser_NameFILESPEC where... »üTPÇisthetransferprotocol: »»XM:XmodemChecksumorCRC »»XK:Xmodem1K »»YM:Ymodem »»WX:WindowedXmodem »»ZM:Zmodem »üUser_NameÇisthenameoftheuser,withanunderscoretomark spaces, »üFILESPECÇisthepath+nameofthefile, »üDescriptionÇisthefiledescriptionenteredbytheuser. Example:JamesBonduploadsafilecalledPACMAN.LZHtothe GeneralArea.HeusesZmodemtouploadthefile.Thelineaddedto üUPLOAD.LOGÇwouldbesomethinglike... ZMJames_Bond\QBBS\UPLOAD\GENERAL\PACMAN.LZHVeryoldgame.ü Ç Thelineisonlyaddedifthetransferwassuccessful,ofcourse, andüONLINE.ARCÇandüONLINE.LZHÇ(seeOnlineArchiver)arealso added,whentheyaredownloaded. ÇëTRANSFERDRIVERSÇ AtthemomentQuickusesanumberofdifferentdriverprogramsto uploadanddownloadfiles.Someareinternal,othersareexternal. InQConfigyoucanselectwhetheryouwishtousetheinternalor theexternaldrivers.ThisiswhatQuickuses: »üXFER.000ÇisalwaysusedforYmodemandWindowedXmodem.In QConfigyoucangetQuicktousethisforthe 'normal'Xmodemtransferstoo. Thedrivermustbeinthehomedirectory.Trytheinternal driversfirst.Iftheycauseproblemsswitchtotheexternalone, andpleaseletusknowwhat'sgoingwrong! üëEXTERNALPROTOCOLSÇ TotopitalloffyoucanhangvirtualeveryprotocolonQuickBBS usingtheexternalprotocolinterface.YoumustConfigurea protocolfirstlyinQconfigundertheexternalprotocolsection. ReadthatsectionofthedocumentêfirstÇ!Youmustalsomakeakind ofscriptfileforeachprotocol.Weusethedoorfileinterface forthis.Asexampletherearesomeü.DORÇfilesincluded.For exampleZMODEM.DORforXYZ.TTP,itmightlooklike: uploadpathD:\ATARI\UPLOADS\ uploadC:\QBBS\XYZ.TTP-cD:\ATARI\UPLOADS\ downloadC:\QBBS\XYZ.TTP-U-c*PATH*FILES *PATHisreplacedbythecurrentpath,and*FILESbythefilesthe userwantstodownload. Uploaddefinesthefilenameoftheuploadprotocolandit's commandline. Downloaddoesthesameforthedownloadprotocol. Uploadpathisspecialandonlyneedifyouhave1special uploadpath.NormallyQuickBBSscansthe*PATH(currentpath)for newuploadedfiles.IfUploadpathisspecifiedthenthatdirectory isscannedinstead. Youcanusealmostallü.DORÇfilecommandsinthisfiletoo,mayby youneedittogenerateacommandline.ButtheêcompleteÇü.DORÇis read.AfterthatisdoneQuickBBSwillstarttheprotocol. ÇëTHEONLINEARCHIVERÇ Everwantedtodownloadthedocumentationfilesfroma200Kb archivebeforeyoudownloadedtherest,justtomakesureyou reallywantit?Orperhapsyou'velostthatonelittle configurationfilefromalargearchive?InthatcasetheüOnline ArchiverÇwouldcomeinveryhandy. TheOnlineArchiverletsyouextractfilesfromoneormoreü.ARCÇ orü.LZHÇarchivesandputthemintoatemporaryarchivecalled üONLINE.ARCÇorüONLINE.LZHÇ,readyfordownloading. TheseOnlineArchivesareplacedinadirectoryyouspecifiedin QConfig.TheycanbedownloadedfromtheOnlineArchivermenu,and aredeletedwhenQuickexits.InQConfigyoucanspecifythe maximumsizeofthesearchivesinKb,or(byentering0)letQuick useallavailablediskspace,minusasmallsafetybuffer. IfnoOnlineArchiveexiststheuserisrequiredtoselectan archivetype-ArcorLHarc.Becausedifferentcompressionmethods areusedthesetwocan'tbemixed.Theusercanthenaddfilesto theOnlineArchive,removefiles,clearthewholearchive(and selectanewtype)ordownloadit. QuickBBSdoesn'tneedARCorLHarctocreatethearchives.The archivingroutinesareinternal. Ifanerroroccursduringanarchiveoperation(perhapsbecause ofadamagedarchive)thelogfilewillcontainawarning,soyou candosomethingaboutit.TheOnlineArchivewillbecleared. TheOnlineArchivermenuseachhaveahelpoptionwhichdisplay theüOARCTYPEÇandüOARCHELPÇfiles.Youwillhavetopromotethe OnlineArchiverabit.Mostusershaven'ttheslightestideawhat itis,anddon'tgotothe'trouble'offindingouthowitworks iftheydoknowwhatitis...Justsayitsavesmoney,andthey'll comearoundsoonerorlater8-) ëTHEFILEBROWSERÇ ismenuoptiontype83.Atextfileissplitupintopagesand displayedpagebypage,withamenuinbetweeneachpageallowing theusertomoveforward,backwardetc.aswellassearchthetext forastringorjumptoacertainpage.Youcouldputatableof contentsonpage1,andlettheuserusethe'Goto'optiontojump tothepageofhischoice. üëMARKFILEMENUÇ Ismenutype84.Itlooksabitlikethebrowser.Ausercanlist thefilesinanarea.hecanalsojumptoacertainpage.Jumping tothelastpagewillshowhimthenewestfiles. Hecanmarkfilestodownload.WithMofMarkyouwillgetinto theMarkfilesmenu.Hereyoucanmarkafilefordownload,just enterit'snumber.Theusercanalsolistwhatfilesarealready markedendeletesomeofthemforthelist.Ifhedecidesto downloadhecanchooseDownloadfromthemainmenu.Allfileswill besend(ifhehislevelscheckout!).Themarkedfilesareonly rememberiftheuserstaysintheMarkFilemenu.Inafuture versionyoucanexpectglobaldownloads. ü================================================================== =======================Section9:Doors======================== ================================================================== Ç üëEXTERNALPROGRAMS Ç Quickcanstartupexternalprograms,alsoknownasüDoorsÇ.Alot ofboardsrunüDoorGamesÇ,wheretheusercanplayagameagainst otherusersoftheBBS. Menuoptiontype7(üExecuteProgramÇ)willrunanythingyouspecify ontheDataLine(path+name+extension).Everythingafterthe programnameispassedtothatprogramonthecommandline.The currentdirectoryischangedtothedirectorywheretheprogramis located. ExternalprogramsmayêneverÇmodifytheorderoftheuserbaseor theLastReadpointers.Theprogrammaychangethecurrentuser record,butthatwouldn'tmakemuchsensebecauseQuickwill overwriteitwhentheuserlogsoff. BecauseQuickremainsinmemorywhileanexternalprogramisbeing executedyouwillneedenoughspareRAM.Anyprogramwhichis startedwhiletheuserisonlineshould... »traperrorsandexitifoneoccurs.ItshouldênotÇwaitforinput fromtheSysOp. »monitorthecarrierandexitifthecarrierislost. »keeptrackoftheamountoftimetheuserhasleft,andexit whenthetimeisnearlyup. »exitiftheuserdoesn'ttypeanythingforaminuteortwo(in casehe'sfallenasleep). »handleitsownmodemI/O. MostDoorGameshavesomewayofdoingthis.But,youask,howdoes theprogramknowhowmuchtimetheuserhasleft?Itcanfindout intwoofdifferentway: »Thedatalinecancontainacommandlinetopasstotheprogram. Therearesomespecialcodesthatyoucanputintherewhichare replacedbyQuick: »»*AisreplacedbytheuserscurrentêaliasÇ, »»*Bisreplacedbythecurrentbaudrateor0inlocalmode, »»*Cisreplacedbytheerrorlevelthatisreturnedwhena  programisexecuted »»*Fisreplacedbytheusersfirstname, »»*Gisreplacedbythenumberoftheusersgraphicsmode, »»*Lisreplacedbytheuserslastname, »»*Oisreplacedbytheusersaccount, »»*P(privilege)isreplacedbytheuserssecuritylevel, »»*RisreplacedbytheusersrecordnumberinüUSERS.BBSÇ, »»*T(time)isreplacedbythenumberofminutestheuserhas left. Ç Aspecialcaseis*S,whichmakesQuickleavetheStatusLineat thebottomofthescreenon,handyforprogramswhichdon'tshow youwhoisonline. Anotherspecialcaseisthe*Ecode,whichexecutesthecommands inalittlescriptfile.Itmustbethefirstcodeonthedata line.Moreonthatlater. Example:JamesBondisonlineat2400baudandhas20minutes left.Ifthedatalineis... \QBBS\GAMES\MR\MOONRAKE.TTPbaud*Bname*Ftime*T ...thenQuickwillchangethecurrentdirectoryto \QBBS\GAMES\MR\,startupMOONRAKE.TTPwithcommandline... baud2400nameJamestime20 Refertothedocumentationoftheprogramyouwishtostartto seewhatparametersitneeds. »BeforetheprogramisstartedQuickwillwriteafewfilesfrom whichtheexternalprogramcanreadtheuserinfo.Thefilesare  »»üLASTUSER.LOGÇiscompatibletoPandora.It'splainASCII,and containstheusersnameonline1,hissecuritylevelonline 2,azeroonline3andfinallythenumberofminuteslefton line4. »»üDORINFO1.DEFÇisalsoanASCIIfile,andcontains... »»»theSysOpsfirstname, »»»theSysOpslastname, »»»thecurrentbaudrate(0=Local), »»»theusersfirstname, »»»theuserslastname, »»»wheretheguylives, »»»hisgraphicsmode, »»»thelengthofhisscreen, »»»hissecuritylevel, »»»thenumberofminutesleft, »»»hisrecordnumberintheüUSERS.BBSÇfile. ü Ç»»üFOREM.DATÇiscompatibletotheFoReMBBSprogram.Referto theFoReMdocumentationofinfoaboutthisfile, ü Ç»»üEXITINFO.BBSÇdescribedinthedevelopersguide. ThedocumentationofDoorGameswillusuallysaywhatfilesare used. ÇëDORFILESÇ Thespecial*Ecodecanbeusedtoexecuteaü.DORÇfile.Thedata lineshouldcontainsomethinglike *Egame Youcanalsopassparameterstothedorfilelike:  *Egameparam1param2param3param4 Youcanusetheseparametersintheü.DORÇfilewiththeknown&1, &2etc.parameters. QuickwillexecutethecommandsitfindsinafilecalledüGAME.DORÇ inthehomedirectory.Validcommandsinthatfileare: »üACCOUNTÇü<number>Ç Changestheusersaccount.Numbercan beexpressedinthreeways: +nincreasestheusersaccountbyn. -ndecreasestheusersaccountbyn. nsetstheusersaccountton.  Theaccountcannotgoaboveorbelowthe  maximumorminimumsetinqconfig. ACCOUNT+10 (ACCOUNTup10) ACCOUNT-5 (ACCOUNTdown5) ACCOUNT50 (ACCOUNTsetto50) »üCD<path>ÇChangesthecurrentdirectoryto<path>.Can changetoanotherdrivetoo.Example: CD c:\qbbs\doors\galemp »üCL <command>ÇSetsthecurrentcommandlinewhichwillbe usedwhenaprogramisexecuted(seeEXEC)to <command>,whichmaycontaintheusual codeslike*F,*Betc.butênotÇ*E.Example: cl-N=*F_*L -T=*T »üCLRFLAG<flag>ÇIstheoppositeofSETFLAGandswitchesoneof theusersflagsoff. » üCLSÇ Clearsthescreen »üCOPY <src><dest>ÇCopiesfile<src>to<dest>.Fullpathmaybe specified,butwildcardsarenotallowed. Example: Copylastuser.log\doors\ste\lastuser.log Ç» üCTIME<number> ÇIncreases,decreasesorsetstimelimitfor  theêrestofthecurrentsessionÇ.Workslike ACCOUNT. »üDEL<spec>ÇDeletesallfilematchingthespecification <spec>.Examples: DEL\qbbs\doors\dorinfo1.def Del\qbbs\temp\*.* üÇ»ü DEXIST<path>Ç SameasFEXIST,butforDirectories(folders)ü Ç»ü DLIMIT<number>ÇIncreases,decreasesorsetsthedownload  limitforthecurrentsession.Worksthesame asACCOUNT. ü Ç» üECHOÇ ü<text>Ç SameasSend,seethereforinfo. »üEXEC<program>Çü<cl>ÇExecutes<program>,usingthecommandlineset withCL,or<cl>ifused.QuickBBSchecks whetherthefileexists,releases(nearly)all memorythenexecutes.YouêmustÇspecifythe extension(e.g.STE.PRGorGALEMP.TOS).Ifthe programexitswithanerrorlevel,QuickBBS willputthatinthelogfile.Examples: Exec \doors\galemp\galemp.tos EXEC ste.prg » üEXITÇ Stopexecutingthecurrentü.DORÇfileand  return. » üFEXIST<file>Ç Checksif<file>exist.Theresultisstored  intheparameter*C.(*C=1fileexist) » üGOTO<label>Ç Jumptoalabel.Alabelisprecedbya:and  startsatthebeginningofaline.Exampleof alabel:  :start Ç» üIF<value><operator><value>THEN<command> Ç <operator>canbe:  = equal  ~ equal,caseindependent  <>notequal  >greaterthan  < smallerthan  =>greaterorequal  <= smallerorequal  $ containsthestring  Validparametersfor<value>are:  Allthe*xparameterslistedbeforeand:  *C resultcodeofFEXISTor  DEXIST  *ASCtheASCIIvalueofthe  characterpressed.  *CHR thecharacterpressed.  *TXT stringenteredafteranINPUT  command. &<n>parametern  <command>canbeanyü.DORÇcommand. » üINPUT<type>[<len>][<"str">]  ÇAllowstheusertoenteralineoftext.The   stringenteredwillbestoredinthe*TXT parameter.  <type>canbe?  ANY allcharacters(ASCII32..126)  arevalid  USER toenterausername  PASSWORDtoenterapassword,asterisks  areechoed  FILEtoenterafilename  <len>(optional)isthemaximumlengthofthe  theline(defaultis80)  <"str">(optional)isastringwithvalid  characters.Putthembetween"" » üKEYÇ Waitfortheusertopressakey.  Thecharacterspressedisstoredintwo  parameters:  *CHRthekeypressed *ASC theASCIIvalueofthekey  pressed »üLEVELÇü<number>ÇChangestheuserssecuritylevel.Worksthe sameaswithACCOUNT. » üLOCAL<text>Ç AlmostidenticaltoSENDandECHO,butitonly  displaysitlocally(notviathemodem) » üLOG<option><data>ÇWrites<text>tothesystemlogfile Ç» üMENU<option><data> Ç ExecuteaQuickBBSmenuoption.  <option>canbeêeveryÇmenuoptionexceptfor  thenumbers0to4,7and40.  <data>istheoptionaldatalineyouwould  normallyuse. » üPAUSEÇ Promptandwaitfora[Return] » üPROMT <text> ÇIdenticaltoSENDandECHOcommands,but  leavesthecursoronthesameline.Youcould doandINPUTafterthis. » üREADMARKED ÇThiswilltrytoreadthefileüMARKED.DATÇin  theQBBSdirectory.Thisfilesshouldcontain allmessagethathavetoberead.Afterthis itwillshowallthemarkedmessages.Readthe mailscansectionformoreinfo. »üREN<old><new>ÇRenamesfile<old>to<new>.Thiscanalsobe usedtomoveafile,byusingadifferent path,aslongasitismovedwithinone partition.Wildcardsarenotallowed. Examples: renforem.dat\qbbs\doors\progs\forem.dat REN lastuser.log xyz.log »üSEND<text>ÇSendstheline<text>totheuser,followedby acarriagereturnandlinefeed.Examples: Send Wait a sec, getting D&D for you... SEND Back to QuickBBS! »üSETFLAG<flag>ÇSwitchesoneoftheusersflagson.The<flag> parameteristwocharacterslong.Thefirst canbebetweenAandD,thesecondbetween1 and8,indicatingtheflagtoswitchon. Examples: SETFLAGa1 SetFlagd8 »üSHOW<file>ÇDisplays<file>inexactlythesamewaymenu optiontype5does.Examples: Show DDST1 Show GoodBye êNotÇ valid: Show \wp\manual.doc Show ddst1.asc Show doors\score.vtm Ç»üSTATUS<ON/OFF>ÇSwitchesthestatusbaronoroff.Thestatus barwillremainonthescreenwhilethe programisbeingexecuted.Handyfordoors thatdon'tshowyouwhoisonline. » üSYSTEM<command>Ç Thiscommandcanonlybeusedwiththree  commandlineinterpreters:Craft,Mupfeland Gulam.QuickBBScanaccestheseshells êdirectlyÇ,withoutneedingtoloadtheprogram files,bycallingthemthroughtheêshell_pÇ systemvariable.Thepresenceandtypeofthe shellischecked.Ifanyoneknowsofother shellswhichsupporttheêshell_pÇvariable correctly,pleaseletusknow.Andexample:  SYSTEMls  Willdisplayadirectorylisting("ls"isthe  Unixcommandwhichdoesthis,supportedbyall  threeshells).Programsandscriptfilescan  alsobestartedthroughtheSYSTEMcommandas  longastheyfreememorywhencompleted.Due tothecasesensitivityofUnixshells,the commandisNOTconvertedtouppercase.The returncodeofthecommandcanalsobe accessedwiththe*Cparameter. » üTIMEÇ ü<number>ÇIncrease,decreaseorsettimelimitforthe  êrestofthedayÇ.WorkslikeACCOUNT.ê Ç »üWRITE<type>ÇWillwriteacertainfile(specifiedby <type>)inthecurrentdirectory.Examples: Writelastuser.log writeFOREM.DAT WRITEDorInfo1.Def Ifanerroroccurswhileaü.DORÇfileisbeingexecutedQuickBBS willwriteamessageinthelogfileandreturntothemenuwhich startedthefile.Errorlevelsreturnedbytheexecutedprogramare ênotÇerrors. ÇëEXITWITHERRORLEVELÇ IfyouarerunningQuickBBSusingabatchfileyoucanuseoption type15(üExitwithErrorLevel)Çtorunyourdoors.Quickwillwrite the'doorfiles'andexitwiththeerrorlevelyouspecifiedinthe DataLine.TheconnectionisênotÇterminated. Thebatchfilecandetecttheerrorlevelandstartupanother program. WhentheprogramreturnsthebatchfilecanstartupQuickBBS again.Bypassingthe-RswitchonthecommandlineQuickwon't asktheuserforaname/password,butreadtheüEXITINFO.BBSÇfile instead.Theuserisreturnedtothetopmenu. Thismethodhasthreegoodpointsandthreebadpoints: +YouhavemuchmoreRAMfree,becauseQuickdoesn'tremainin memory. +Theuserrecordcanbechanged.Quickwillre-readtherecord whenitisstartedwiththe-Rswitch. +Youcanuseanybatchfilecommandsandanyutilityprogramyou like, -Theuserisreturnedtothetopmenu,insteadoftothemenu whichcontainedtheexit-with-errorleveloption. -IttakesawhileforQuicktoloadandreaditsconfiguration. -Thismethodcanonlybeusedinconjunctionwithabatchfile, notwhenQuickStartisbeingused. Notethatyoustillcan'trunprogramswhichchangetheêorderÇof theuserbase,becauseQuicksavestheuserrecordnumbertoone ofthedoorfilesandreadsitagainwhenitisrestarted. Asalways,it'suptoyou...  ü================================================================= ======================Section10:FidoNet===================== ================================================================= Ç ëWHATISFIDONET?Ç Farbackinthemistsofancienttime,inthegreatandglorious daysofCP/MandCommodore64's,lifewaswild,richandlargely taxfree.Inthosedaysspiritswerebrave,thestakeswerehigh, menwererealmen,womenwererealwomen,andsmallfurry creaturesfromAlphaCentauriwererealsmallfurrycreaturesfrom AlphaCentauri. ItwasinthosedaysthatabraveyoungpioneercalledTom Jenningsnamedarandomgroupofbytes,whichbyanentirely meaninglesscoincidenceactuallydidsomething,afterhispetdog Fido. Therandomgroupofbytes,wheninsertedintoacertainpieceof machinerycalledaPC,allowedcarbon-basedbipedallife-formswho hadjustdiscoveredthebasicsofdatacommunications(henceforth knownasUsers)tospendhoursandhoursreadingbulletins, postingandreadingmessagesand-bestofall-sendingand receivingotherrandomgroupsofbytestheycalledfiles.The userschosetocallallthisaBulletinBoardSystem. Nowitissuchabizarrelyimprobablecoincidencethatanythingso mindbogglinglyusefulcouldhaveevolvedpurelybychancethat somethinkershavechosentoseeitasafinalandclinchingproof ofthenon-existenceofGod.Theargumentgoessomethinglike this: "IrefusetoprovethatIexist,"saysGod,"forproofdenies faith,andwithoutfaithIamnothing." "But,"saysMan,"theBBSisadeadgiveawayisn'tit?It couldnothaveevolvedbychance.Itprovesyouexist,andso therefore,byyourownarguments,youdon't.QED." "Ohdear,"saysGod,"Ihadn'tthoughtofthat,"andpromptly vanishesintoapuffoflogic. "Oh,thatwaseasy,"saysMan,andforanencoregoesonto provethatblackiswhiteandgetshimselfkilledonthenext zebracrossing. <looselybasedontheBabelFishentryinTheHitchHikersGuide> InthemeantimeFidowasfeelingratherlonely.SoTJthoughtit wouldbeaprettyneatideaifheaddedsomemorerandombytesto hisFidoprogramwhichautomaticallytalkedtootherFido's.And that'showFidoNetwascreated. ÇëPRACTICAL,PLEASE...Ç Oh,youdon'tlikefunmanuals?GuessI'dbetterexplainit differentlythen... FidoNetlinksmorethan20000(!)BulletinBoardsworld-wide.It definesastandardwayoftransferringmessages,filesandother randomgroupsofbytes(oops,sorry)betweentheseboards. MessagesonaBBSwhichisconnectedFidoNetcanbesplitupinto threegroups: »üLocalÇüMailÇ:thesemessagesdon'tgoanywhere. »üNetworkMailÇorüNetMailÇ:thesemessagesaresenttoêoneÇother BBSwhichistheuserspecifies. »üEchoMailÇ:thesemessagesaresenttoallotherboardsinFidoNet whowishtoreceivethem. NetMailisnormallyusedforperson-to-personmail.If-for instance-youhaveafriendontheothersideoftheworldwho callsaFidoNet-BBSthere,youcansendhimmessages.Themessage issenttothatboardonly(althoughitmayberouted,butwe'll keepthatforlater). EchoMailisdividedupintoawholelotofdifferenttopics (areas).ThereareEchoMailareasforanimallovers,cooks,Basic programmersanddentists,tonamebutafew.SomeEchoMailareas arenational(e.g.German),somearecontinental(e.g.European). Therearequiteafewworld-wideareastoo. BypostingamessageinanEchoMailareaitcanbereadoneach andeveryBBSwhichcarriesthatarea.Anyproblemyouwishto poseisusuallyansweredwithindays,ifnothours.You,the SysOp,canchoosefromawideselectionofdifferenttopics. ëFIDONETORGANISATIONÇ InthefollowingsectionIwillexplainhowFidoNetisorganised. Atleast,whattheêtheoryÇbehindtheorganisationis.Inpractice theorganisationdiffersonquiteafewpoints. Ofcourseitwouldbestupid,impossibleinfact,tocalleach connectedBBSwhenoneofyourusershasenteredamessageinan EchoMailarea.Itwouldalsobesillyiftenboardssenttheirown mailtotheothersideoftheworld.Itwouldbemuchcheaperif justoneBBSgatheredthemailandsentitallatonce. TheorganisationofFidoNetcanbeviewedintwodifferentways: theêtopographicÇorganisationandtheêstructuralÇorêhierarchicalÇ organisation. ÇThetopographicorganisationcanbeseeninfigure5.1.Thewhole worldisdividedintoanumberofdifferentüZonesÇ.Zone1is America,zone2isEuropeandzone3isAustralia/Asia.There aren'tmanyconnectionsinAfrica,soitisincludedinzone2. EachzoneissubdividedintoüRegionsÇ.Theregionsdon'thaveany effectonthestructuralorganisation,andareusually disregarded. EachregioncontainsüNetworksÇ.Anetworkisgenerallyagroupof boardslocatedinthesamegeographicarea,tocutdownphone costs.TheactualBulletinBoardsarecalledüNodesÇ. Whenyoulookatthestructuralorganisation(figure5.2)youwill seethateachzonehasasortoftreeshape.Rightupatthetopof thetree(orattheroot,ifyoulike)wehaveaüZoneGateÇ.The ZoneGatetakescareofallinter-zonemail.Itcallsother ZoneGatesinotherzoneswhenmailmustbetransferredfromone zonetoanother.SoyoucouldsaythattheZoneGateisheadofthe zone. AttheheadofeachnetworkwehaveaüHostÇ.Thehosttakescareof inter-networkmail.Ifanodesendsamessagetoanodeina differentnetwork,itgoesviathehost. InsomelargenetworksüHubsÇareused.Somenetworkshavehundreds ofnodes.Onesinglehostcouldn'thandlethatmanycalls,sohubs areintroduced.Theyactasahostforagroupofnodes. Rightdownatthebottomofthetreeyou'llseethenodes themselves.Bytheway,azonegate,hostorhubisanodetoo! Eachnodehasanumber,thehostisusuallyjustnodenumber0. AsIstatedearlier,thisishowitworksêintheoryÇ.Tospeed thingsupabit,somehostscallinter-zonethemselves.Andanode oftensendsmailforanothernetworktothehostofthatother network.  ForEchoMailanüEchoMailBackboneÇisused.Ittransfersthe EchoMailbetweenthehosts(generallyallhostsinoneregion), andtoandfromotherregions. ëNETWORKADDRESSESÇ EveryBBSinthenetworkhasitsownüaddressÇwhichhasthe followingformat: zone:net/node where'zone'isthezonenumber,'net'isthenetworknumberand 'node'isthenodenumber.OurSupportBBS(zone2,network282, node301)hasaddress 2:282/301 ÇHostsarenormallynode0inanetwork.So,thehostofnetwork 282wouldhaveaddress 2:282/0 ThisaddressisuniqueforeachnodeinFidoNet.Notwonodeshave thesameaddress.Ifyoudon'tyethaveanaddressyoushouldask yourRegionalCoordinatororalocalHostforinformationabout gettingone. ëPOINTSÇ AfairlynewpartofFidoNetistheüpointÇ.Apointisonelevel lowerthananode.It'sreallyjustasortofsuper-userwho doesn'tlogintoyourBBStoreadhismail,butusesamailerto collectitandreaditathome,offline.Beforeyoustart promisingpeopleallsortsofthingsyoushouldhaveyourboard runninginFidoNetwithoutmajorproblemsforafewmonths. QuickBBSdoesn'tneedtoknowanythingaboutpoints.Theyarejust extranodes,asfarasQuickisconcerned. Pointshaveadifferentformataddress,withanextranumberat theend.Thefirstthreenumbersaregenerallythesameastheir boss(thenodewhichsendsthemmail).Thelastnumberistheir üpointnumberÇ.SoapointofourSupportBBSmighthaveaddress ü Ç2:282/301.4 ëWHAT'SAMAILER?Ç AümailerÇisaprogramwhichhandlesallthemailtransfersfrom onenodetoanother.Itsits'infront'ofQuickBBSandwaitsfor thephonetoring.Ifthere'sauserattheotherenditstartsup QuickBBS.Iftheotherendisamaileritmaysendorreceivesome mail. AtthemomenttherearetwomailersavailablefortheST:The-Box andBinkley/ST.BotharePD/Shareware,downloadablefromthe SupportBBS. It'snotuptometotellyouwhichmaileryoushoulduse.Both mailershavetheirpositiveandnegativesides.The-Boxisavery reliableandflexiblemailer,buttheuserinterfaceis practicallynon-existent.Binkleyontheotherhandlooksvery pretty,butisn'tasstableoraspowerfulasThe-Box.It'supto youtodecidewhatyouthinkismoreimportant.Example configurationfilesgivenhereareforThe-Box.Binkleyuses similarmethodsthough. ëIMPORTANDEXPORTÇ NeitherThe-BoxnorBinkleyunderstandthewayinwhichQuickBBS storesthemessages.Outgoingmail(fromustosomeoneelse)must beüexportedÇ.AnyincomingmailwillhavetobeüimportedÇbefore QuickBBScanuseit. ÇToexportandimportmailwehavethreeprograms,partofthe Bermudapackage.Theyare »üIMPORT.TTPÇforimportingêNetMailandEchoMailÇfromFidoNet intotheQuickBBSmessagebase. »üPACK.TTPÇ forexportingêNetMailÇfromtheQuickBBSmessage basetoFidoNet. »üSCAN.TTPÇ forcopyingoutgoingêEchoMailÇintotheêNetmailÇ areaordirectlytoFidoNet. »üCRUNCH.TTPÇ fordeletingdeletedmessagesinthemessagebase, itcanalsodeletemailolderthenxxdays. BasiclythesameasoutüFastpackÇ. ThemailersendsandreceivesüpacketsÇ.Thesearefilescontaining oneormoremessages.Importwilltranslatepacketstoü.HDRÇand ü.MSGÇfilesforQuickBBStouse,packwilldothepreciseopposite. ScanonlycopiesEchoMailtotheNetMailordirectlyinpacketsif yuouse-ponthecommandlinearea.Figure5.3showsthisin schematicform.EvenifyouarerunningBinkleyyouwillneed theseprogramsfromtheThe-Boxpackage.Anotherprogramyouwill needisüXLTLSTÇfortranslatingtheNodeList.ForBinkleySTyou shoulduseüPARSELSTÇorüBTNCÇtotranslatethenodelist. ëINSTALLINGTHEMAILERÇ TorunQuickBBSwithamaileryouwillneedaüshellÇ.The environmentvariableMAILERshouldpointtothedirectory containingyourmailerconfigurationfiles(forImport,packand Scan).Mostshellscansetthevariablewitheither SETMAILER=\QBBS\MAILER\ or setenvMAILER=\QBBS\MAILER\ butfillinyourownpathofcourse.Moreonshells,batchfiles andenvironmentvariableslater. Inyourmailerconfigurationfileyouwillneedtodefinetwo specialdirectorieswhichwillcontainyourüInBoundÇandüOutBoundÇ packets.YouwillalsoneedadirectoryforyourNodeListfiles andoneforyourmailerconfigurationfiles. ImportlooksintheInbounddirectorytoseeifthereareany packetswhichneedunpacking.Packplacesoutgoingmailinthe OutBounddirectory. ÇImportandPackuseafilecalledüAREAS.BBSÇtofindoutwhatareas arelinkedtoothernodes.Thefirstlinecontainstheüorigin lineÇ.BecauseQuickBBShasalreadyfilledthisoneinitisn't used.Theformatoftherestofthefileis: <filespec><name>[node][node][node...] where... »üfilespecÇisthepathtothemessagearea,followedbythe4- digitareanumber.DoênotÇaddanextension. »ünameÇcanbe: »»LOCAL:xxxxxtoindicatealocalareawhichshouldnotbe exported, »»MAILtoindicatethatthisareaistheNetMailarea, »»anythingelseshouldbethenameoftheEchoMailarea.Your hostcantellyouwhatthenameofeachareais. »ünodeÇisanaddressintheformatzone:net/node.Theareaissent toandreceivedfromthisnode. TheaddressfollowingtheNetMailareashouldbetheaddressof yourhost.YoucanonlyhaveêoneNetMailareaÇ! Example:YouhavefiveareasinyourBBS:twolocalones(1and 2),aNetMailone(3)andtwoEchoMailareas(4and5)called BASICandCHAT.NetMailissenttoyourhost2:282/0,andsois theBASICecho.TheCHATechoisanareayoushareonlywitha friendlynode,2:282/350.YourüAREAS.BBSÇfilewouldlooklike this: <DummyOriginLine> \QBBS\MSGS\0001 LOCAL:General_Area \QBBS\MSGS\0002LOCAL:From/To_SysOp \QBBS\MSGS\0003MAIL282/0 \QBBS\MSGS\0004BASIC282/0 \QBBS\MSGS\0005CHAT282/350 ThenameofanareawhichyoudefineinMConfighasnothingtodo withthenameoftheEchoMailareainüAREAS.BBSÇ! ëCOMPILINGTHENODELISTÇ BothQuickandthemailerneedtoknowwhatthestructureofthe networkis.ThisstructureisdescribedintheüNodeListÇ.Askyour hostforthemostrecentone.Anewnodelistispublishedeach week. ÇBecausethenodelistisafewhundredKbinsizeitwouldcostfar toomuchtogetawholenodelisteveryweek.Tosolvethatthe FidoNetpeoplehavethoughtupaslightlycheaperway:the NodeDifffile.Thiscontainsallthedifferencesbetweenlast weeksnodelistandthenewone.It'smuchsmallerthanthe completenodelist.Mosthostscanautomaticallysendyouthenew NodeDiffeachweek. ThenodelistandnodedifffilesarecalledüNODELIST.nnnÇand üNODEDIFF.nnnÇ,where'nnn'isthedayonwhichthefilewas published.Thefilesareusuallyarchived.Thearchivesarecalled üNODELIST.AnnÇandüNODEDIFF.AnnÇ.ü Ç BeforeQuickandThe-BoxorBinkleycanusethenodelistand nodedifffiles(whichareinASCIIform,veryslow)theymustbe ücompiledÇ.YoucanuseüXLTLSTÇtodothisforyou.Firstitextracts thefilesfromthearchivesusingARC.Itthentakestheold nodelistandthenewnodediffandgeneratesanewnodelist. FinallyittranslatesthenodelistfilefromASCIItobinary.The outputisplacedintwofiles:üMAILER.NETÇandüMAILER.NODÇ.For BinkleyyoumustuseüPARSELSTÇwhichwilgenerateaüNODELIST.DATÇ andüNODELIST.IDXÇ.YoucouldalsouseüBTNCÇ,inthecurrentversion (before2.0)ituses3files:üDOMAINS.BNLÇ,üINDEX.BNLÇ, üNODEINFO.BNLÇ.UseQConfigtotellQuickBBSwherethesefilesare. Withalittleexperimentationyoushouldbeabletomakethe nodelistcompilationautomatic. ëWRITINGNETMAILÇ WhenyouwriteaNetMailmessageinQuickBBSyouwillhaveto entertheaddressofthenodewherethemessageshouldbesent. ThisisdoneintheüNodeListMenuÇ.Ifyouknowtheaddressyoucan justtypeitin.Ifyoudon't,usethelistorsearchoptionsto findout. TosendNetMailyoumusthaveücreditÇ.Theamountofcreditauser hascanbechangedinUserEdit.Whenamessageissentthecostof themessageissubtractedfromtheuserscredit.IntheXLTLSTor PARSELSTcontrolfileyoucanspecifywhatamessagewillcost, basedonthephonenumber(areacode)ofthedestinationnode. ëREADINGANDWRITINGECHOMAILÇ EchoMailisfairlytransparenttotheuser.WritinganEchoMail messageisthesameaswritingamessageinalocalarea.When readingEchoMailyouwillnoticeafewextralinesatthebottom ofthemessage. Thelinebeginningwith'---'istheüTearLineÇ.Itidentifiesthe programwhichwasusedtowritethemessage.Thelinebeginning with'*Origin'istheüOriginLineÇ.ThisidentifiestheBBSfrom whichthemessagewassent.Itisfollowedbytheaddressofthe node. ÇTheoriginlinewhichisaddedbyQuickBBScanbedefinedin MConfig.Eachareacanhaveadifferentoriginline.Youshould alwaysputatleasttheênameÇofyourBBSintheoriginline.If possible,putthephonenumberintoo.Don'tincludeyouraddress, itwillbeaddedbyQuick. ëGENERATINGECHOMAILÇ TheScanprogram'exports'EchoMail.Itexportsitforeachnode linkedtothearea.Let'swriteanEchoMailmessageusingQuickBBS toseeifeverythingworksokay. MakesureyouhavecorrectüAREAS.BBSÇandüTB.CFGÇ(The-Box Configuration)files,thenstartScan. EachareainüAREAS.BBSÇwillbescannedforoutgoingEchoMail.You shouldput-Ponthecommandline,thenitcreatesdirectly mailpackets. AfterthisyoumustrunPack,itwillarchivethePacketssothey canbesendtothenodes. OneoftheoptionsintheReadmenuistheüKludgeÇcommand.This optionswitchesoffthefilteringofüKludgeLinesÇ(sometimes called^Alines).SomeextralinesareincludedinanEchoMail message.ThesearetheKludgeLines.Normallythemessage containstwosortsofkludges:üPATHÇandüSEEN-BYÇ.Theyhelpthe EchoMailutilitieskeeptrackofwhichnodeshavereceivedthe message(SEEN-BY)andhowthemessagegothere(PATH). üëEVENTSANDROUTING Ç BeforeyoucanexportanymailyouhavetotellPackwhenthemail mustbesent.Thisisdoneintwofiles,calledtheüEventÇand üRouteÇfiles.ThesefilesareüTB.EVTÇandüTB.RTEÇandaredescribed indetailintheExportandThe-Boxdocumentation.Refertothe JargonGuideintheappendixsectiontofindoutwhatallthe technicaltalkmeans. Aneventisa'pieceofday'.Witheventsyoucansplitthedayup intovariousparts,andtellThe-Boxhowitshouldactduringsuch aperiod.Ifyoudon'tunderstandhowtheüTB.EVTÇfileworks,just putthefollowinglinesinit: aALL00:0001:59bct=1,10a=120m=10,10 bALL02:0002:59t=1,10a=120m=10,10 cALL03:0023:59bct=1,10a=120m=10,10 ÇWithroutingyoucansendyourmailviaanothernode(generally yourhost),sothatyoudon'tgosendingmailallovertheworld. Intheroutefileyoualsodefinewhatnodesyouwanttocall, whentocallthem,whetherornotyouwanttopickupanymail theyhavewaitingforyouetc.Ifyoudon'tunderstandhowthe üTB.RTEÇfileworks,usetheaboveeventexampleand... Route-Tozone:net/nodeALL ScheduleB Pollzone:net/node andreplacethe'zone:net/node'withtheaddressofyourhost. Thiswillcausemailtobesenttoyourhostbetween2and3 o'clockatnight(checkwithyourhosttoseewhattimesuitshim best).NouserswillbeallowedintotheBBSduringthisperiod. ëEXPORTINGMAILÇ ThePackprogramtranslatesoutgoingmessagesintheNetMailarea (includingEchoMailcopiedbyScan)intopacketsintheOutBound directory.Thesepacketscanbesentbythemailer. WhenPackhasdoneitsjobcorrectlyyoushouldfindapacketin theoutbounddirectory(calledx.CM,forCrashMail).Nowstartup The-BoxwithcommandlineUNATTENDEDandwatchyourmailbeing sent! ëIMPORTINGMAILÇ Ofcourseit'snotallone-waytraffic:othernodescancallyour mailer.Theymightsendyoumail,whichmustbetranslatedfrom PacketformattotheQuickBBSmessagebase.Thisisdoneby Import.TheInBounddirectoryisscannedforpackets.IfImport findsoneitwillunpackitandplaceitinthecorrectarea, dependingontheAREAkludge.Easyhuh? ëARCHIVEDMAILÇ MostmodernmailersandmailutilitiescanhandleüArcMailÇ.An ArcMailfilejustcontainsallpacketstoonenodeARCedtogether. ArcMailisusedfortworeasons:itsavestime(andmoney),and duetotheCRCcheckinARCitimprovesreliability.  TheARC.TTPprogramshouldbeinthecurrentdirectorytoimport andexportArcMail.YouanspecifywhichnodesaresentArcMailin theroutefile,oronthecommandline(seetheExportdocs). üLZHMailÇisthesameasArcMail,butLHarcisusedinsteadofARC. LHarcismuchbetteratcompressingthanARCis. üZIPMailÇisagainthesamebutforyouneedSTZiptoextract. ZIPMailisthemostcommonlyusedinfidonetnow. ÇëBATCHFILESANDSUCHÇ AsaFidoNetnodeyouuseamailerinsteadofQuickStart.The mailerdoesn'tknowasmuchaboutQuickBBSasQuickStartdoes.So weneedtouseashellandabatchfiletostartupthemailer, themailutilitiesandQuickBBS. It'sallbasedonüErrorLevelsÇ.AnErrorLevelisavaluereturned byaprogram.Itcanbeusedbytheshelltodeterminewhich actiontotake. The-Box,forinstance,exitswithacertainerrorlevelwhenmail isreceived(whichyoudefinedinTB.EVT).Inthebatchfileyou cantelltheshellthatimportshouldbestartedwhenthat errorlevelisreturned. WhenThe-Boxdetectsauserontheotherenditwillexitwithan errorlevelofbaudrate/100(e.g.1200baud=errorlevel12).The batchfiledetectsthis,andstartsupQuickBBS.QuickBBSmustbe toldwhatthecurrentbaudrateis.Thisisdonewiththe-B parameteronthecommandline. WhenyoupressoneofthefunctionkeysinThe-Boxitwillexit withanerrorlevelof10*key(e.g.70forF7).Usethistolog intotheBBSlocally.TostartQuickinlocalmodeyoushouldput the-Lparameteronthecommandline. AêveryÇsimplebatchfileforPCommandmightlooklikethis (commentsinbracketsshouldnotbetypedin)... CD\qbbs(changedirectory) :start("Start"Label) tbunattended(runThe-Box) IFERRORLEVEL100GOTOqlocal(errorlevel100?LocalBBS) IFERRORLEVEL192GOTOqbbs  (errorlevel192?19200bps) IFERRORLEVEL144GOTOqbbs (errorlevel144?14400bps) IFERRORLEVEL96GOTOqbbs (errorlevel96?9600bps) IFERRORLEVEL48GOTOqbbs (errorlevel48?4800bps) IFERRORLEVEL24GOTOqbbs (errorlevel24?2400bps) IFERRORLEVEL12GOTOqbbs  (errorlevel12?1200bps) IFERRORLEVEL3GOTOqbbs  (errorlevel3?300bps) GOTOend (lowerthan3?Exit!) :qlocal ("BBSLocal"label) quickbbs-L (runQuickinlocalmode) GOTOstart (jumpbacktostart) :qbbs  ("BBSonline"label) quickbbs-B%:e00  (runQuickatxx00bps) GOTOstart  (restart) :end (jumptoheretoexit) echoBBSOffline.  (showmessage) ÇAlthoughthisverysimpleitshouldwork.Itdoesn'tprovideany handlingofimportorexportthough.Amorecompleteexamplecan befoundintheappendixsection.Tologinlocallypressf10. üEnvironmentVariablesÇcanbeusedtohelpQuickandThe-Boxfind theirconfigurationfiles.AnEnvironmentVariableisavalue whichtheshellcanpasstoanyprogramitstarts.Theyusually havetheformNAME=VALUE.We'reinterestedintwovariables: MAILERandQBBS.TheMAILERvariableshouldpointtothedirectory containingtheconfigurationfilesforThe-Box(üTB.CFGÇ,üTB.RTEÇ etc).TheQBBSvariableshouldpointtotheQuickBBShome directory(withüUSERS.BBSÇetc). WhenthesevariableshavebeensetyoucanstartThe-Box,Quick andtheutilitiesfromanydirectoryyoulike,forinstanceby typing... \QBBS\QCONFIG whenyou'rein\COMMS\FLASH\.QConfigwillstillfindthe configurationfiles.MostshellsusetheüsetÇorüsetenvÇcommandto defineanenvironmentvariable.Refertoyourshelldocumentation. ü================================================================== ====================Section11:Appendices===================== ================================================================== Ç ëAPPENDIXA-JARGONGUIDEÇ 9 [.◆.................◆..◆.◆....◆....◆....◆....◆....◆....◆....◆....]0110 Ofallareasofcomputerscience,communicationsisprobablyin thetop-5ofthelistwhenitcomestotheamountofjargonwhich isused.TohelpyouunderstandwhateveryoneistalkingaboutI havecompiledalistofthemostfrequentlyusedjargon. êAÇ üAdams,DouglasÇex-script-writerofnumerousTVandradio series(amongwhichDoctorWho),ex-actor,ex- director,ex-barn-builder,ex-chicken-shed- cleaner,ex-lots-of-other-silly-thingsand authorofthebestbookeverwritten:The HitchHikersGuidetotheGalaxy.Livesin IslingtonwithaladybarristerandanApple Macintosh. üAddressÇuniquecodewhichidentifiesaFidoNetnode. Itusuallyhastheformzone:net/nodeor(in pointaddressing)zone:net/node.point. üAnsiÇ1.êAÇmericanêNÇationalêSÇtandardsêIÇnstitute,an organizationwhichdevelopsanddescribes allsortsofstandards. 2.AnsiX3.64isaterminalemulationstandard oftenusedonlargecomputersystems.VT- 100andAnsi-BBSaresubsetsofthis standard. 3.Ansi-BBSisasubsetofAnsiX3.64,with someadditionalescapes,andisusedbyIBM andcompatiblecomputers.Itisimplemented inadevicedrivercalledANSI.SYS,and oftenusedincommunicationspackages. üARCÇ1.archiverdevelopedbySystemEnhancement Associates(SEA). 2.anARC:archivecreatedbyanarchiver. 3.toARC:toaddfilestoanarchiveor createanewarchive. üArchiveÇ1.oneormorefilescombinedintoonefileby anarchiver.Thefilesareusually compressed. 2.toarchive:toaddfilestoanarchiveor tocreateanewarchive. üArchiverÇprogramwhichcancreateandextractarchives. üArcMailÇoneormorepacketstoasinglenodeplacedin anarchive. üAreaÇpartofthemessagebaseofaBBSwhich containsmessageswhichhavethesameor similartopic.OftencalledBoard. üArrrggghhh!ÇsoundmadebyaSysopwhenauseruploadsthe samefilefortheone-hundred-and-twenty- secondtime. üASCIIfileÇatextfileconsistingofanycodesbetween32 and127.Eachline(includingthelastline!) shouldbeterminatedwithaCRLFsequence (CarriageReturnfollowedbyaLineFeed, codes13and10). üAsynchronousÇinanAsynchronousconnectionthetransmitting sidesendsastartbit,then8databitsand oneortwostopbits.Nosynchronisationlines areneeded(weonlyhaveone:thephoneline). AllBBSsystemsuseAsynchronousconnections. üAutoDLÇshortforAutoDownLoad.Thisisasequenceof characterswhichtriggersafiletransferwith Zmodem. üAutoExecuteÇmenuoptionwhichisexecutedwhilethemenu isbeingloaded.Optionswhichhavea^Aas keyareAutoExecuted.OftencalledAutoExec. êBÇ üBatchFileÇfilecontaininginstructionsforashell, whicharesequentiallyexecuted. üBatchProtocolÇfiletransferprotocolwhichcansend/receive morethanonefileinonego.Thefilenames, sizesanddatesareusuallysent. üBaudRateÇspeedatwhichamodemcanwork.Thisisnot reallythesameasBPS,butnobodyseemsto care. üBBSÇshortforêBÇulletinêBÇoardêSÇystem(orêSÇervice). Ifyoudidn'tknowthisoneyouwon'tbe needingQuickBBS! üBiModemÇfairlynewtransferprotocolwhichallowsdata transferintwodirectionssimultaneously, e.g.usercanuploadanddownloadatthesame time.Writtenin8088assembler,sonochance ofeverhavingthatinQuickBBSSTI'mafraid. üBinkleyÇmailerprogramdevelopedonMS-DOSsystemsand portedtotheST. üBoardÇseeArea.ü BossÇanodeinFidoNetwhichhaspoints.ü BPSÇêBÇitsêPÇerêSÇecond,thenumberofbitswhichare sentthroughtheRS-232interfaceeachsecond. üBulletinÇatextfiledisplayedtotheuserwhich containsnews,ideas,tips&tricksorother moreorlessinterestinginformation.Insome BBSsystemsthefirstmenuyouseeisthe Bulletinmenu. üBullShitÇcontentsofmostmessagesfoundinthe INTERNATEchoMailarea. ëêCÇ üCarrierÇtotransmitandreceivedataamodemsends soundsoverthephoneline.TheCarrierisa soundofaconstantfrequency,whichtellsthe modemontheotherendthattheconnection exists. üCCITTÇshortforêCÇomitéêCÇonsultatifêIÇnternational êTÇélégraphiqueetêTÇéléphoniquequequeque,an institutewhichdefinestheV-standards. üCDÇêCÇarrierêDÇetect,pinnumber8onanRS-232 interface.Alogicalhighsignalfromthe modemmeansacarrierispresent.Oftencalled DCD(êDÇataêCÇarrierêDÇetect). üChat,to-Çtotalkwithsomebodythroughkeyboardand screen.NormallyyoupressReturntwicewhen youhavesaidwhatyouwanttosaytoletthe personontheothersideknowthatit'stheir turn. üCheckSumÇthelowerbyteofthetotalofallbytesina block,usedtocheckthatthosebytesare correct.ThiscanbeusedbytheXmodem protocolandisnotasreliableasCRC checking. üCLIÇêCÇommandêLÇineêIÇnterface,seeShell. üCrashMailÇOneormoremessageswhichhaveCrash priority,i.e.shouldbesentrightaway,and straighttothedestinationnode(theyarenot routed). üCRCÇêCÇyclicêRÇedundancyêCÇheck,verycomplicated calculationperformedonablockofdata.If theCRCofoneblockisthesameasthatof anotherblock,itisprettylikelytheblocks arethesametoo.Usedbymosttransfer protocols,andismuchmorereliablethanthe Checksummethod. êDÇ üDent,ArthurÇaratherstupidearthlingwhosehousewas knockeddowntomakewayforabypass. üDLÇSeeêDÇownêLÇoadü. DoorÇaprogramexecutedbytheBBSwhileauseris online. üDoorGameÇagameprogramexecutedbytheBBSwhilea userisonline.OftentheusersoftheBBScan playgamesagainsteachother. üDownloadÇ1.toDownload:totransferafilefromthe BBStotheuser. 2.aDownload:oneormorefileswhichhave beendownloaded. 3.theDownload:allfilesinaBBSwhichthe userscandownload. üDTRêDÇataêTÇerminalêRÇeady,pin20onanRS-232 interface.Byloweringthispinthecomputer cantellthemodemtodisconnect.WhenDTRis lowmostmodemdon'tanswerincomingcalls. üDuplexÇfull-duplexmeanstwoconnectedcomputerscan senddataatthesametime,butinhalf-duplex onlyoneofthecomputerscansendatanyone time.BBSsystemsalwaysworkinfull-duplex. üDupKillerÇprogramwhichremovesduplicatemessagesfrom yourmessagebase. üDuplicateÇanEchoMailmessagewhichhasbeenreceived morethanonce.Thisoftenoccurswhenthea nodegetsanareafromtwodifferentsources. Youshouldtakethegreatestcarenottocause duplicatemessages,anduseaDupKillerto removesuchmessagesiftheyexist. êEÇ üEchoÇanEchoMailarea. üEchoMailÇmessagesinFidoNetthatcanbereadoneach nodewhowishestoreceivetheareainwhich themessagewaswritten(i.e.isconnectedto theecho). üEchoMailBackboneÇFidoNetnodewhohandlessomeinter-netand inter-regionEchoMailtransfers. üEarthÇmostlyharmless. üElectronicMailÇmessagesstoredbyanelectronicmediumlikea BBS.Deviceslikeafaxdon'tstorethe messages,sotheyaren'tElectronicMail handlers. üEmailÇseeêEÇlectronicêMailÇ. üErrorLevelÇisavaluereturnedbyaprogramtowhatever executedit.Someshellscanexaminethis valuetodeterminewhattodonext. üEscapeÇ1.ASCIIcharacter27. 2.Akeyonthekeyboard,usuallymarkedEsc. 3.Asequenceofbytes,startingwithan Escapecharacter,whichcontrolstheusers terminal. üEventÇaperiodoftimewhichhascertainflagsto influencetheoperationofaprogramlikea mailer.Reallyjustsomethingthathappens. êFÇ üFidoÇBulletinBoardSystemwhichwasthefirstto domailtransfersfromoneBBStoanother. üFidoNetÇaworld-widenetworkofBBSsystemswhich allowsmailtobetransferredfromoneBBSto another,offromoneBBStolotsofothers. üFileRequestÇtouseyourmailertoaskanothermailerto sendoneormorespecifiedfiles.Thefile namesaregiventoyourmailer.Canbe comparedtodownloadingafilewithouthaving toentertheBBS. üFileTransferÇsendingafilefromonecomputertoanother, usingafiletransferprotocol. üFlagÇaswitcheachuser,eachmenuoptionandeach messageareahas.Theswitchcanbeon(X)or off(-).Iftheflagisoninthemenuoption ormessageareaitmustalsobeoninthe usersrecord.Thereare4setsofflags(A-D), witheach8flags(1-8). üFlashÇthebestcommunicationsprogramavailablefor theAtariST.DistributedbyAntic,current versionis1.6. üFmailÇamessagewhichhasafilebelongingtoit. Canbeusedtosendamessageandafileto oneormorespecifiedusersatonce. üFull-duplexÇseeDuplex. êGÇ üGfAÇGermancompanywhichproducesalanguage calledGfA-Basic.Itisn'treallybasic,buta mixturebetweenBasic,PascalandalittleC. Veryfast,verystructuredandveryeasy.GfA nevermeetdead-lines. üGraphicsModeÇoneoffivedifferentterminalemulations whichtheuserselectsinQuickBBS.Tousea GraphicsModethecommunicationsprogramthe userisrunningmustalsosupporttheterminal emulation. üGreatÇwordoftenusedwhenspeakingaboutproducts fromTheoRuniaandJonWebb. üGROUNDÇpinnumbers1and7onanRS-232interface. Pinnumber1isPG(êPÇrotectiveêGÇround)and ensuresbothdeviceshavethesamevoltage levels.Number7isSG(êSÇignalêGÇround).Ithas alogicallylowsignal.Allothersignal levelsdependonthispin. êHÇ üHalf-duplexÇSeeDuplex. üHayesÇCompanywhichproducemodems.Quitealong timeagotheydevelopedamodemwhichhada smallinstructionset(calledtheATset) builtin.Mostmodernmodemsalsohavethis instructionsetandareHayesCompatible. üHayes,MaddieÇphotomodel,privatedetectiveandverygood- looking.CanbeadmiredintheTV-series Moonlighting. üHeadCrashÇwhatalwaysseemstohappentoyourharddisk whenyouhaven'tmadeabackupforsixmonths. üHFLÇdutchcurrency,pleasesendlots. üHomeDirectoryÇthedirectorycontainingtheQuickBBSsystem files(e.g.USERS.BBS).Youmusteitherstart QuickBBSfromthisdirectoryorpointtoit withtheenvironmentvariableQBBS. üHostÇanodeinFidoNetwhichis'head'ofa network.Itcollectsmailfromallthenodes inthenetworkandsendsittothehostsof othernetworks. üHSTêHÇighêSÇpeedêTÇransfer,amethodusedbysome modernmodemstotransferinformationathigh speed(upto14400bps).OldHSTmodemswere notreliable,newonesarebetter.Not compatiblewiththeV.32(bis)standard. üHubÇanodeinFidoNetwhichisusedinlarge networkstotakesomeoftheloadoffthe hostsshoulders.Itactsasahostforagroup ofnodeswithinthenetwork. êIÇ üIFNAÇêIÇnternationalêFÇidoêNÇetêAÇssociation.Liketo thinkofthemselvesasthegoverningbodyof FidoNet(andare,inaway).Thoughnotmany peopleinFidoNetareactuallyIFNAmembers, theirtechnicalstandardsandpolicyaffect eachnodeintheIFNAnodelist. üInfocomÇCompanythatmakesthebesteveradventure gamesforallsortsofcomputers.Theyare verywellknownfortheirhigh-tech programming,goodplotsandextremelygood atmosphere. üInterlinkÇCommunicationsprogramfortheAtariSTwhich issecondinmytop-5ofcommspackages.Very goodAnsigraphics,nicebells&whistles,but tooslowandtoobuggy.Currentversion1.89, availablefromInterSect. êJÇ ü JEKYLLÇatransferprotocolwhichenablesyoutodown êandÇuploadêandÇchat!attheêsameÇtime.It's writtenbyVincentPartingtonfortheAtari. ü JmodemÇatransferprotocolwhichissometimes slightlyfasterthanZmodem.Writtenin8088 assembler,soit'sverydifficulttoimplement onanST. üJonÇme. êKÇ üKermitÇ1.littlegreenfrogwhichattractsfemale, fatpigs, 2.old-fashionedfiletransferprotocoloften usedbystupidpeopleandUnixmachines. üKludgeÇoneormorelinesinanEchoMailmessageused bymailutilities.Somekludgelinesstart witha^Acode.Well-knownonesareAREAwhich definestheEchoMailareatowhichthemessage belongs,SEEN-BYtokeeptrackofwhichnodes havereceivedthemessageandPATHtofindout howthemessagegothere. êLÇ üLastReadPointersÇsetofnumbersQuickusestokeeptrackof whatthelastmessagewasauserreadina certainarea.StoredinthefileLASTREAD.BBS. üLHarcÇarchiverdevelopedbyYoshiandportedtothe STbyyourstruly.It'sabitslowerthanARC, butachievesmuchbettercompressionresults. üLogin,to-Ç1.tocallaBBS. 2.totypeintheusernameandpassword. üLogoff,to-ÇtotelltheBBSyouwantittohangupthe phone. üLZHÇarchivecreatedbytheLHarcarchiver. êMÇ üMailÇoneormoremessages. üMailerÇaprogramwhichsendsmailtoothernodes, receivesmailfromothernodesandwaitsfor userstocalltheBBS. üMenuÇascreenintheBBSfromwhichuserscan chooseanoption. üMenuOptimiserÇafeatureofQuickBBSwhichcanreplace spaces,carriagereturnsandlinefeedswith VT-52orAnsiescapesequencestopositionthe cursor.Speedsupthemenusquiteabitat300 and1200baud. üMessageÇatextwrittenbyoneuserandsenttoanother user,ortoALLotherusers. üMessageBaseÇallmessagesonaBBS.Themessagesarestored inthe.HDRand.MSGfilesintheMessage Directory. üMNPÇasystemusedbysomemodemstoeliminateline noise,checkdataintegrityandsometimes compressthedata.Therearedifferent generationsofMNPmodems.Theneweronesdo datacompression.Allmodemsaredownward compatible(orshouldbe,atleast).MostMNP modemscancommunicatewithnon-MNPmodems. êNÇ üNetMailÇoneormoremessageswhicheachhavea destinationnodedefinedbytheuser.A NetMailmessageissenttoonlyoneother node.Theusermusthaveenoughcredittosend NetMailmessages. üNetWorkÇ1.theorganisationofawholelotofBulletin Boardstoenablemailtransfer. 2.agroupofBulletinBoards(nodes) geographicallyclosetogether.Ahostis theheadofthenetwork. üNetÇSeeNetWork. üNMHÇêNÇationalêMÇailêHÇour,atimeatwhichallnodes mustbeavailableforreceivingmail.In Zone2thisisoftendisregarded,becauseeach nodecanagreeonatimewiththehost.I thinkZone1stillusesthis. üNodeÇaBulletinBoardwhichispartofFidoNet. NodesaregroupedtogetherintoNetWorks. üNodeDiffÇafilewhichcontainsthedifferencesbetween lastweeksandthisweeksNodeList.Ifyou havelastweeksNodeListandthisweeks NodeDiffyoucancreateanewNodeList. üNodeListÇfilecontainingadescriptionofthecurrent structureofFidoNet.Anewoneispublished everyweek,butbecauseitissobigmost peopleprefertoreceiveaNodeDifffileevery week. üNodeNumberÇSeeAddress. êOÇ üOfflineÇ1.auserisoffline:NotconnectedtoaBBS atthemoment. 2.aBBSisoffline:theBBSiscurrentlynot availabletousers.ü Ç3.aprinterisoffline:cannotreceiveany characterstoprintbecausetheoperatoris muckingaroundwiththeswitches. üOnlineÇtheoppositeofOffline. üOnlineArchiverÇfeatureofQuickBBSwhichallowsusersto extractfilesfromoneormorearchivesand placetheminatemporaryonewhichcanbe downloaded.Handyifyouonlywantpartofan archive. üOpusÇaFidoNetcompatibleBBSprogramwhichrunson anMS-DOSPC.ThisBBSiscommandline orientedandhardlyconfigurable. üOriginLineÇAlineaddedtoanEchoMailmessage.Itstarts with'*Origin:'andendswiththeFidoNet addressofthenodeinbrackets.Whateveris inbetweencanbespecifiedbytheSysOp. êPÇ üPacketÇoneormoreFidoNetmessagesreadytobesent toanothernode,orjustreceivedfromanother node. üPandoraÇ1.AdrianMole'sgirlfriend. 1.Fido-ishBBSprogramwrittenbyJac Kersing.QuickBBSusesthesamemessage baseformat.Pandoraiscommandline orientedandslightlyconfigurable. üParityÇabitaddedtoeachbytetransferredoveran RS-232connection(possiblywithmodems inbetween).YoucanhaveEvenParity,Odd ParityorNoParity.WithEvenParitythebyte plusextrabitmustformanevennumber.With OddParitytheymustformanoddnumber.If theparityisincorrectanerrorisreported. AllBBSprogramsworkwithNoParity,whereno paritybitissent/received. üPathÇ1.directoryspecification. 2.routeofamessagebeforeitgottousi.e. nodesthroughwhichthemessagepassed. üPointÇauserofaBBSwhousesamailertoreceive andsendmailinsteadofloggingintotheBBS. Apointhasanaddresswithanextranumber added,thepointnumber.Theformatis zone:net/node.point.Thefirstthreenumbers arethesameasintheaddressoftheBBS(the boss).Thisformatiscalled4Daddressing. üPoll,to-ÇTocallanotherFidoNetnodetoseeifthere isanymailwaiting.Callinganothernodeto sendmailisoftenalsocalledpolling. üPrivateÇaprivatemessagecannotbereadbyanyonebut thewriter,thereceiverandtheSysOp.Some programscannothandleprivateEchoMail. üPrivilegeÇSeeSecurityLevel.ü ProtocolÇamethodoftransferringoneormorefiles.By agreeingonaprotocolthetransmittingand receivingprogramscanmakesurethatthefile istransferredcorrectlyandsometimessend informationaboutthefilename,size,date etc.too.Normallythetransmitterand receivermustuseexactlythesameprotocol. üPsychiatristÇthepersonyouaregoingtomeetonceyouhave beenrunningyourBBSforayearorso. üPublicÇapublicmessagecanbereadbyanyonewhohas accesstothemessagearea. êQÇ üQBBSÇshortforêQÇuickêBBSÇ. üQuickBBSÇunknown. üQuickStartÇprogramusedtohandleallmodemcontrolfora StandAloneQuickBBSsystem.Initialisesthe modem,answersthephoneifitrings,starts upQuickBBSitselfnowandthen.Alsoactsas aterminalandashellforalltheutilities. üQuoteÇpartofthemessagetowhichtheuseris replying.Byquotingpartsofthemessagehe canremindthewriterwhatthemessagewas about. êRÇ üRDÇêRÇeceiveêDÇata,pin3ontheRS-232interface. SometimescalledRX.Thisconnectionisused totransferbytesfromthemodemtotheST. üRecover,to-Ç1.whatyoutrytodowhenyougoonholiday toJamaicaafterabrain-crash,approx.14 monthssinceyoustartedrunningaBBS. 2.whatZmodemdoeswhenitstarts transferringafilewhichwasaborted before.IfaZmodemtransferfailsitwill pickupwhereitleftoffthenexttimeyou try. üReplyLinkÇpointertothemessagetowhichthismessage isareply.Byusingthe-and+commandsin theReadMessagemenuyoucanseetheoriginal messageandrepliestothismessage.QuickBBS doesn'tdothisinEchoMailbyitself.A utilityisavailabletocreateReplyLinksin EchoMail. üRequestÇseeFileRequest. üRS-232ÇtheserialinterfaceonthebackofyourST, markedwithalittlephone.ThepinsonanRS- 232interfaceare+3V..+15Vwhentheyare logicallylow,-3V..-15Vwhentheyare logicallyhigh.Recommendedvoltagesare+12V and-12V. üRTS/CTSÇêRÇequestêTÇoêSÇendandêCÇlearêTÇoêSÇend,pins4and 5ontheRS-232interface.Theseareflow controlsignals.WhentheSTwantstosend dataitmakesRTShigh.Whenthemodemis readytoreceiveitmakesCTShigh.It enablestheSTtosendatahigher(locked) baudratethanthemodemcanhandle.Doesn't workinmostTOSversions,andisnotreally neededforQuickBBS. êSÇ üSEAlinkÇtransferprotocolfromSystemEnhancement Associates(SEA)basedonXmodem.Insteadof waitingfortheotherendtoacknowledgeeach blockitkeepsonsending,andassumesnonews isgoodnews.Ifanerroroccursitgoesback tothefaultyblock.Thisprotocolisnearly asfastasZmodem!Canalsotransfermorethan onefileatonce(batchprotocol). üSecurityLevelÇanumbereachuserhasinQuickBBS.Basedon thisnumberyoucantellQuickhowmuchtime theusermayspendintheBBSeachday,allow himtoaccesscertainmenuoptions,message areasetc. üSeen-ByÇkludgelineaddedtoEchoMailmessagesthat informsthemailutilitieswhichnodeshave receivedthismessage. üShellÇautilitywhichallowsyoutotypeincommands onthekeyboardinsteadofclickingonfiles withthemouse.Hastheusefulside-effect thatyoucanputlotsofthesecommandsina batchfilewhichcanbeexecutedwhenyou're notthere. üSleepDelayÇthenumberofsecondsQuickwaitsbeforeit disconnectstheuserwhenhedoesn'ttype anything.Thisisincasetheuserhasfallen asleep,orincasehisownmajorintestine,in adesperateattempttosavelifeand civilization,leapsstraightupthroughhis neckandthrottleshisbrain.Whateverthe reason,itshouldkeepyourBBSavailable. üStartBitÇoneortwobitssentbeforeeachdatabyte overanRS-232connectiontosynchronisethe transmitterandthereceiver. üStopBitÇsameasStartBit,butnowsentafterthedata byte.ABBSshoulduse1stopbit. üSynchronousÇmethodofconnectionusedbylargecomputer systems.Insteadofsendingstartandstop bitsthesynchronisationinfois'hidden'in thedatabyte.Therecan'tbeanypausesin thetransmission,otherwisethe synchronisationislost.ABBSneverusesthis method. üSysOpÇêSysÇtemêOpÇerator,thepersonwhomakessurethe BBSisinworkingorder,helpsuserswhenthey haveproblemswiththeBBSanddoesabout threemillionothertasks. üSTZipÇ ProgramportedfromtyhePCPKZIP,STZip  generatesandunpack.ZIPfiles.Itis written/portedtotheAtaribyVincentPomey. êTÇ üTDÇêTÇransmitêDÇata,pin2onanRS-232interface. ThisisusedtotransmitbytesfromtheSTto themodem.SometimescalledTX. üTerminalÇ1.thecomputerwhichisconnectedtotheBBS viaamodem. 2.thecommunicationsprogramtheuseris running. üTerminalEmulationÇamethodofcontrollingthecolouroftext, positioningthecursor,clearingthescreen andallotherfancythings.Thisisdoneby sendingEscapesequences.TheBBSandtheuser mustbeusingthesameTerminalEmulation (graphicsmode). üTeaÇthemostscarcedrinkintheuniverse. üThe-BoxÇamailerprogramwhichworksnicelywith QuickBBS. üTowelÇanitemthateachHitchHikershouldhave. üTransferÇSeeFileTransfer. üTurboDosÇaprogramavailablefromAtariwhichspeedsup theharddiskby200%to500%.Youshould installeitherTurboDosorTOS1.4whenyou runQuickBBS,otherwiseitain'tsoQuick. êUÇ üULÇseeêUÇpêLÇoad. üUploadÇ1.toUpload:tosendafilefromtheuserto theBBS. 2.anUpload:afileuploadedbyauser. üUppercaseÇwhatmostmessagesfromusersarewrittenin ifyouhaveUppercaseCheckingswitchedoff. üUserÇ1.onewhocallsaBBS, 2.---CENSORED--- üUserBaseÇ1.allusersofaBBS. 2.thefilecontaininginformationaboutall yourusers,calledUSERS.BBS. üUseNetÇanetworkofUnixmachineswhichhassome quiteinterestingmessages.UseNethaslinks withFidoNet(i.e.somemessagesfromUseNet canbetransferredtoFidoNet). êVÇ üV.21ÇhardwarestandarddefinedbytheCCITTfor transferringinformationat300bps. üV.22ÇsameasV.21,butnowfor1200bps.ü V.22bisÇsameasV.21,butnowfor2400bps. üV.23ÇsameasV.21,butnowfor1200/75split baudrate.NotoftenusedforBBSsystems. üV.29ÇsameasV.21,butnowfor4800bps. üV.32ÇsameasV.21,butnowfor9600bps. üV.32bisÇ sameasV.21,butnowfor14400bps.ü VT-52ÇterminalemulationdefinedbyDEC.Muchfaster thanAnsi(infactit'sasubsetofAnsiX3.64 andVT-100),butdoesn'tprovideasmany possibilities.ThescreenonanSTcanbe controlledusingVT-52escapesequences. üVT-100ÇanotherterminalemulationfromDEC.Thisis nearlythesameasAnsi-BBS,butdoesn't supportthingslikecolourchanges. êWÇ üWaZooÇêWaÇrpêZÇillionêOÇpus-to-êOÇpus,oneofthe sessionsusedbymodernmailers.AWaZoo sessionstartswithaYOOHOOpacketexchange andthensendsmailorfileswithSEAlinkor Zmodem. üWindowedXmodemÇseeXmodem,Windowed.ü Wow!ÇsoundoftenheardwhenobservingaFoReMsysop whohasjustloggedintoaQuickBBSsystem. êXÇ üXferÇshortforTransfer.ü XmodemÇanoldtransferprotocol.Useseither128byte or1024byteblocksandeitherChecksumorCRC errorchecking.Slow. üXmodem-1KÇtheversionofXmodemwhichuses1024byte blocks.OftenincorrectlycalledYmodem. üXmodem,WindowedÇsortofXmodemwherethetransmitterdoesn't waitforthereceivertoacknowledgeablock. Itassumesthatnonewsisgoodnews.Much fasterthanXmodem. üXon/XoffÇanotherflowcontrolmethod.Thereceivercan senda^Scodetopausethetransmitter,and continuewitha^Qcode.Notusuallyusedin QuickBBS. êYÇ üYell,to-ÇtocalltheSysOpforachat. üYmodemÇasortofXmodemwhichcantransfermorethan onefileatonce.OftenXmodem1Kiscalled Ymodem,butthisisincorrect.Ymodemis êalwaysÇabatchprotocol. üYOOHOOÇahandshakingprotocolusedbymodern(WaZoo) mailers.TheYOOHOO/2U2handshakepassessuch informationasyouraddress,systemand operatornameaswellaspasswordinformation. êZÇ üZIPÇnameoffilesgeneratedbyPKZiponaPCor STZipontheAtariseriesofcomputers. üZoneÇalargegeographicareainFidoNet.Thewhole networkissplitintothreezones,each coveringacontinent.Eachzoneissplitup intoregionsandnets. üZoneGateÇanodeinFidoNetwhichtransfersmailfrom onezonetoanother. üZOOÇyetanotherarchiver.It'sfast,slightly betteratcompressingthanARC,butnotas goodasLHarc.STversionavailable. üZmodemÇThebesttransferprotocolavailable.Very fast,extremelyeasytouseandveryreliable. Ifyou'vegotZmodem:êuseitÇ! êOtherÇ ü0ÇIQofanaverageuser. ü8-)Çsmiley,turn90degreesclockwise. ü150ÇpriceofaFullKeyinDutchGuilders. ü-218ÇIQofanaverageAmigauser. ü^Ç1.CharacterusedtosignifytheControl-key. ^Cmeansholddownthecontrolkeyand pressC. üÇ2.CharacterusedtomarkaControl-code. ^CisthecharacterwiththeASCIIvalueof theCcharacterminus64. ü^AÇASCIIcode1,marksthestartofakludge lineinamessage.AlsousedinQuickBBSmenus todefineamenuoptionasauto-executing. ÇëAPPENDIXB-SYSOPKEYSÇ 9 [.◆..◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆]0110 Keysavailablewhileauserisonline: üHelpÇbrieflistofavailableSysOpkeys. üClr/HomeÇupdates/restoresstatusbar. üCursorUpÇincreasesuserstimelimitby5minutes. üCursorDownÇdecreasesuserstimelimitby5minutes. üAlt-AÇchangeusersgraphicsmodetoASCII. üAlt-CÇenterschatmode. üAlt-DÇcyclesDisplayMode.Shift-Shift-Alt-Drestores. üAlt-FÇeditusersflags. üAlt-HÇhangup:disconnectsuserdirectly. üAlt-IÇ showinfoovertheuserinthestatusbar,nr.of  calls,lastdatecalled,phonenumbersetc.etc. üAlt-JÇjumptoDOS. üAlt-LÇlockout:disconnects,zeroessecuritylevel. üAlt-OÇ editusersaccount.ü Alt-PÇswitchesprinterloggingonandoff. üAlt-SÇedituserssecuritylevel. üUndoÇcleardailydownload&askfornewdownloadlimit. Additionalkeysinchatmode:  üControl-CÇclearthescreen. üControl-FÇ switchFunmodeonoroff üControl-GÇsoundabell,beeportune. üControl-LÇswitchthechatlogonandoff. üControl-UÇswitchtheusersCapsLockonandoff. üControl-VÇviewafile. üEscapeÇexitchatmode. ÇëAPPENDIXC-MENUOPTIONSÇ 9 [....◆..............................◆.............................]0110 Inthisreferencechartoptionalparametersareenclosedinsquare brackets[x]andrequiredparametersinangledbrackets<x>. êTypeÇêNameÇêDataLine Ç 0TextLine(notacommand) 1GoToNewMenu<menuname>[parameters] 2GoSubNewMenu<menuname>[parameters] 3ReturnfromPreviousGosub 4ClearStack&GoToNewMenu<menuname>[parameters] 5DisplayTextFile<1-8charactername> 7ExecuteProgram<fullpath+name>[commandline] 8VersionInformation 9Logoff 10DisplaySystemUsageGraph 11YellforSysop 13List/SearchUserBase 14DisplayTime/DownloadStats 15ExitwithErrorLevel<errorlevel> 16ChangeCity 17ChangePassword 18ChangeScreenLength 19ToggleClearScreen 20ToggleMore[Y/n]Prompt 21ChangeGraphicsMode 22CheckforPersonalMail[boardnumber]or[ALL] 23ReadMessages<boardnumber> 24 ScanMessages <boardnumber> 25QuickScanMessages<boardnumber> 27WriteaNewMessage<boardboard>[/L][/T=...] 30RawDirectory<pathtoarea> 31DisplayFileList<pathtoarea> 32DownloadaFile<pathtoarea>[filename] 33UploadaFile<pathtoarea> 34ShowContentsofArchive<pathtoarea> 35SearchforaFilebyKeyword 37ListNewFiles[pathtoarea] 38ViewTextFile<pathtoarea> 39DisplayDirectTextFile<fullpath&name> 40ReplaceMenuText(AutoExec)<1-8charactername> 41ToggleFSE 45DisplayTextFilewithReturn<1-8charactername> 57ChangeVoicePhone 58 ChangeDataPhone 80OnlineArchiver<pathtoarea> 81PumpFile<+or-><fullpath&name> 82SelectMenuOptimiser 83FileBrowser<fullpath&name> 84MarkFilemenu <pathtoarea> 85 Mailareaslister <groupnr.>[menutojumpto] 86 Fileareaslister <searchkey>[menutojumpto] ÇëAPPENDIXD-SYSTEMTEXTFILESÇ 9 [.◆.......◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆]0110 ü ÇThesetextfilesaredisplayedatvariouspointsduringthe operationofQuickBBSandQuickStart. ü êNAMEüêDISPLAYED...ü BANNERÇbyQuickStartwhiletheBBSisbeingloaded.ASCIIonly, maynotcontainanycontrolcodes. üBROWSERÇwhentheuserselects[H]elpfromtheFileBrowser. üDNLDHRSÇiftheuserattemptstodownloadoutsidedownloadhours. üEDITHELPÇwhentheuserselects[H]elpfromtheMessageEditor. üFILEMENUÇ whentheuserselects[H]elpüÇfromtheFileMenu.ü GOODBYEÇjustbeforeQuickBBSdisconnects. üGRAPHELPÇwhentheuserselects[H]elpfromtheGraphicsModemenu. üHOTNEWSÇ displayedafterlogininthefileisnewerthenthelast  timetheusercalled. üLANGUAGEÇwhentheusertriestosaveamessagewhichdoesn'tpass thelanguagetest. üLOGOÇbeforetheusertypeshisname.ASCIIonly. üMAXPAGEÇiftheuserattemptstopageyoumoretimesthanallowed. üNEWSÇjustbeforethesystemchecksfornewmail. üNEWUSER1Çtoanewuserafterhehasverifiedhisname,butbefore anyquestionsareasked.ASCIIonly. üNEWUSER2Çafterthenewuserhasselectedapassword. üNEWUSER3Çwhenthenewuserhasfilledinallthequestions. üNO300Çwhenacallcomesinat300Bpsoutsidethe300Bps hours. üNODELISTÇwhenauserselects[H]elpfromtheNodeListmenu. üNOTAVAILÇwhenauserpagesyououtsidethepaginghours. üNOTFOUNDÇifthesystemcan'tfindtheuserintheUserBase,but beforeheisaskedwhetherhisnameiscorrect. üOARCHELPÇwhentheuserselects[H]elpfromtheOnlineArchiver mainmenu. üOARCTYPEÇwhentheuserselects[H]elpfromtheOnlineArchiver typeselectionmenu(whenhechoosesbetweenü.ARCÇand ü.LZHÇarchives). üOPTIMISEÇwhentheuserselects[H]elpfromtheMenuOptimiser menu. üPAGEABRTÇiftheSysOpabortsapage. üPAGEDÇwhenyoudon'trespondtoapage. üPASSWORDÇbeforeanewuserisaskedforapassword,andwhenthe userchangeshispassword. üPOSTCHATÇ displayedafterachat. üPRECHATÇ displayedbeforeachatü PRE-UPLDÇ displayedbeforeuploading.ü READHELPÇwhentheuserselects[H]elpfromtheReadMessagesmenu. üSCANHELPÇ whentheuserselects[H]elpfromtheScanMessagesmenu.ü SECxxxÇ whenauserwithlevelxxxcalls(ex.SEC100.ASC)ü TOOSLOWÇifausersbaudrateistooslow. üTRASHCANÇifthenametypedinbythenewuserconflictswiththe üTRASHCAN.CTLÇfile.ASCIIonly. üUP-DESCÇ displayedbeforedescribinganupload.ü UPPERÇwhenausertriestosaveamessagewhichdoesn'tpass theUpperCasecheck. üUSERxxxÇ whenusernr.xxxcalls(ex.USER001.ASC)ü WELCOMEÇaftertheuserhasenteredhisnameandpassword. üXFERHELPÇwhenauserselects[H]elpfromtheFileTransfer Protocolmenu. ÇëAPPENDIXE-TEXTFILECONTROLCODESÇ 9 [.◆..◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆]0110 canbeusedinanytextfiledisplayedbyQuickBBS. üSystemControl ë ÇêCodeÇêASCIIÇêFunction Ç ^A001PauseandwaitfortheusertopressReturn. ^B002Turn[S]topabortingoff. ^C003Turn[S]topabortingon. ^D004TurntheMore[Y/n]promptsoff. ^E005TurntheMore[Y/n]promptson. ^F006UserInformationcode. ^G007Soundbell/beep. ^H008BackSpace. ^I009Tab. ^J010LineFeed. ^K011SystemInformationcode. ^L012FormFeed(clearscreen). ^M013CarriageReturn üUserInformation Ç êCodeÇêASCIIÇêFunction Ç^FA006065Usersfullname. ^FB006066City. ^FC006067Password(usewithcare!). ^FD006068Dataphone. ^FE006069Voicephone. ^FF006070Lastdateusercalled. ^FG006071Lasttimeusercalled. ^FH006072UsersA-Flags. ^FI006073UsersB-Flags. ^FJ006074UsersC-Flags. ^FK006075UsersD-Flags. ^FL006076NetMailCreditincents. ^FM006077Numberofmessagestheuserhasposted. ^FO006079UsersSecurityLevel. ^FP006080Numberoftimestheuserhascalled. ^FQ006081Numberoffilestheuserhasuploaded. ^FR006082NumberofKiloBytestheuserhasuploaded. ^FS006083Numberoffilestheuserhasdownloaded. ^FT006084NumberofKiloBytestheuserhasdownloaded. ^FU006085Numberofminutesuserhasbeenonlinetoday. ^FV006086Lengthoftheusersscreen. ^FW006087Usersfirstname. ^FX006088UsersGraphicsMode. ^FY006089Moreprompt:ONorOFF. ^FZ006090ScreenClear:ONorOFF. ^F0006048Optimiser:ONorOFF. ^F1006049NumberofKiloBytestheuserhasdownloadedtoday. ^F2n006050FlagAn:ONorOFF. ^F3n006051FlagBn:ONorOFF. ^F4n006052FlagCn:ONorOFF. ^F5n006053FlagDn:ONorOFF. ^F6006054CurrentAccount ^F7006055FullScreenEditor:ONorOFF. üSystemInformation Ç êCodeÇêASCIIÇêFunction Ç ^KA011065NumberofcallstotheBBS. ^KB011066Nameofthelastcaller. ^KF011070Numberoftimesyou'vebeenpaged. ^KG011071Dayoftheweek(i.e.Monday,Tuesdayetc.). ^KH011072NumberofusersintheUserBase. ^KI011073Currenttimein24hourformat(HH:MM) ^KJ011074Currentdate,formatDDMMMYY(04Nov89). ^KK011075Timeconnected-minutes. ^KL011076Timeconnected-seconds. ^KM011077Timeused-minutes. ^KN011078Timeused-seconds. ^KO011079Timeremaining-minutes. ^KP011080Timeremaining-seconds. ^KQ011081Timelimitinminutes. ^KR011082Baudrate. ^KS011083Abbreviateddayofweek(i.e.Mon,Tueetc.). ^KT011084DownloadlimitinKb. ^KWx011087Amountoffreespaceondrive'x'. ^KX011088AmountoffreeRAM. ÇëAPPENDIXF-.DORFILECOMMANDSÇ 9 [..................◆◆....◆....◆....◆....◆....◆....◆....◆....◆....◆]0110 Thedatalineofmenuoptiontype7cancontainthe*E(extended) commandtoexecuteinstructionsina.DORfile.Thecommandsare... ACCOUNT<number> increases,decreasesorsetstheaccount CD<path>changesthecurrentdirectoryto<path> CL <command>setsthecurrentcommandline CLRFLAG<flag>Switchesoneoftheusersflagsoff CLS clearsthescreen COPY <src><dest>copiesfile<src>to<dest> CTIME<number> increases,decreasesorsetscurrenttimelimit DEL<spec>deletesfilesmatching<spec> DEXIST<path> checksifadirectoryexists DLIMIT increases,decreasesorsetsdownloadlimit ECHO<text.sendstheline<text>totheuser EXEC<program><cl> executes<program>withcommandline EXIT stopexecutingthecurrent.DORfileandreturn FEXIST<file> checksifafileexists GOTO<label> jumptolabel(:labelin.dorfile) IF<value><operator><value>THEN<command>  iftrueexecute<command> INPUT<type>[<len>][<"str">]  inputslineoftextfromuser,storedin*TXT KEY Waitforkeypress,storedin*CHRand*ASC LEVEL<number>Increases,decreasesorsetsthesecuritylevel LOCAL<text> <text>isdisplayedlocallyêonlyÇ LOG<text> writes<text>tothesystemlogfile MENU<option><data> executeamenuoption. PAUSE Promptandwaitforreturn PROMT<text> sends<text>butleavescursoronsameline READMARKED readMARKED.DATandreadmarkedmessages REN<old><new>renamesfile<old>to<new> SEND<text>Sendstheline<text>totheuser SETFLAG<flag>Switchesoneoftheusersflagson SHOW<file>Displays<file>inthetextfiledirectory STATUS<on|off>Switchesthestatusbaronoroff SYSTEM<command> send<command>toCraft,MupfelorGulam TIME<number> increase,decreaseorsettimelimitforthe   restoftheday WRITE<type>willwriteafiledependingon<type>,whichcan beLASTUSER.LOG,FOREM.DATorDORINFO1.DEF TheDELcommandistheonlycommandwhichacceptswildcardsas parameters. 9 [.◆..◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆]0110 ÇëAPPENDIXG-VT-52ESCAPECODESÇ PleasenotethatallülowercaseÇcharactersareAtari-private,and shouldênotÇbeusedinVT-52Standardmode. Esc-AMovesthecursoruponeline,butnotbeyondthetopof thescreen. Esc-BMovesthecursordownoneline,butnotbeyondthebottom ofthescreen. Esc-CMovesthecursorrightonecolumn,butnotbeyondthe edgeofthescreen. Esc-DMovesthecursorleftonecolumn,butnotbeyondtheedge ofthescreen. Esc-EClearsthescreenandputsthecursorinthetopleft corner.ThiscodeisüAtari-privateÇ! Esc-HPlacesthecursorinthetopleftcornerofthescreen. Esc-IMovesthecursoruponeline.Ifthecursorwasalready atthetop,thescreenisscrolleddown. Esc-JErasesthescreenstartingatthecurrentcursor position. Esc-KClearsthescreenbetweenthecursorandtheendofthe line. Esc-LInsertsanemptylineatthecurrentcursorposition.The cursorisplacedinthefirstcolumnofthenewline,the restofthescreenisscrolleddown. Esc-MDeletesthelineatthecurrentcursorpositionand scrollstherestofthescreenup.Thecursorismovedto thefirstcolumnoftheline. Esc-YyxMovesthecursortothepositiondefinedinthe characters<y>and<x>,ofwhichtheASCIIcodesmustbe incrementedby32(i.e.Esc-Y-space-spacemovesthe cursorhome). Esc-bxSetstheforegroundtextcolourto<x>.Onlythelower4 bitsofthecolourareused,soEsc-b-1isthesameas Esc-b-A.Thenumberofcoloursavailabledependsonthe screen'resolution'. Esc-cxSameasEsc-bx,butnowforthebackgroundcolour.All screenclearingisdoneinthiscolour. Esc-dClearsthescreenbetweenthecursorpositionandthe startofthescreen. Esc-eSwitchesthecursoron. Esc-fSwitchesthecursoroff. Esc-jRemembersthecursorposition. Esc-kRestoresthecursorpositionsavedwithEsc-j.Not nestable. Esc-lErasesthecurrentlineandputsthecursoronthefirst column. Esc-oErasesthecurrentlinebetweentheleftofthescreen andthecursorposition. Esc-pSwitchestoreversevideo. Esc-qSwitchesreversevideooff. Esc-vCausesthetexttowrapovertherighthandsideofthe screenifalineislongerthan80characters. Esc-wCausesthetextwhichexceeds80characterstobe discarded. ÇëAPPENDIXH-ANSI-BBSESCAPECODESÇ DuetothestructuraldifferencesbetweenthescreenofaPCand thatofanST,theAnsidriverinQuickBBSSThassome 'differences'... »APCwithCGAmonitorcandisplay8coloursforforegroundand8 coloursforbackground,whereastheSTcanonlydisplay4eachon acolourmonitor.Seethe'changeattributes'escapesequenceto seehowQuickhandlescolours. »APCcanunderline,highlight,blinkandreversetext.AnST usingBIOS/GEMDOSforoutputcanonlyusereverse.Seethe 'changeattributes'escapesequence. »IhavenotfoundanywayofchangingthescrollregionX,Y,and WidthforTOSoutput. »AllescapesequencesthatQuickBBSSTdoesn'tknowwillbe ignored.TheyêwillÇbesenttotheuseron-line. TheimplementationinQuickBBSSTalsohassomeescapesequences notfoundinANSI.SYS(theAnsidriveronaPC),butwhicharepart ofX3.64,orfrequentlyusedbyUnixmachines. QuickBBSSTrecognisesandreactstothefollowingescape sequences.Allcharactersin<brackets>shouldbereplaced,and spacesshouldberemoved... Name:CUU-CursorUp Escape:<ESC>[<n>A Example:<ESC>[5A Thissequencemovesthecursorup<n>lines.Ifparameter<n>is omitted,thecursormovesuponeline.Thecursorwillnotmoveoff thescreen,norwillthescreenscrolldown.Thecursorremainson thesamecolumn. Name:CUD-CursorDown Escape:<ESC>[<n>B Example:<ESC>[3B CUDisthesameasCUU(cursorup),butthecursorismoveddown instead. Name:CUF-CursorForward(right) Escape:<ESC>[<n>C Example:<ESC>[8B Thismovesthecursor<n>columnstotheright.Ifthecursor reachescolumn80,itwillstaythere.Thecursorremainsonthe sameline.If<n>isomitted,thecursormovesonecolumn. ÇName:CUB-CursorBackward(left) Escape:<ESC>[<n>D Example:<ESC>[7D IsidenticaltoCUF(cursorforward),exceptthatthecursoris movedtotheleft,asfarasthelefthandsideofthescreen. Name:CUP-CursorPosition Escape:<ESC>[<y>;<x>H Example:<ESC>[10;20H Thisescapemovesthecursortolocation(x,y),whereXisbetween 1and80,andYbetween1and24.If<y>and<x>areomitted,the cursorismovedtothetopleft-handcorner(1,1).Thesequences <ESC>[<y>;<x>H <ESC>[<y>;<x>f <ESC>[<y>;<x>j areidentical,butthefirstisrecommended. Name:SCP-SaveCursorPosition Escape:<ESC>[s  SCPtellstheAnsidrivertonotedownthecurrentcursorposition forfutureuse.IfanRCPisreceivedthecursorwillbereturned tothisposition.TheSCPandRCPescapesarenotnestable. Name:RCP-RestoreCursorPosition Escape:<ESC>[u RCPplacesthecursoratthelocationnoteddownbySCP. Name:ED-EraseDisplay Escape:<ESC>[<n>J Example:<ESC>[2J EDerasesallorpartofthescreendependingontheparameter<n>. Ifthisparameterisomitted,itisassumedtobe'0'... <n>=0:Thescreeniserasedbetweenthecurrentcursor locationandthelowerrightcornerofthescreen, inclusive.Thecursordoesn'tmove. <n>=1:Thescreeniserasedbetweentheupperleftcorner ofthescreenandthecurrentcursorlocation, inclusive.Thecursordoesn'tmove. <n>=2:Thewholescreeniserasedandthecursorismoved totheupperleftcorner. Thescreenisclearedusingthecurrentbackgroundcolour. ÇName:EL-EraseLine Escape:<ESC>[<n>K Example:<ESC>[0K Allorpartofthecurrentlineiserased,dependingonparameter <n>.Thecursorisnevermovedbythisescape.If<n>isomitted, itisassumedtobe'0'... <n>=0:Allcharacterstotherightofthecursorareerased. <n>=1:Allcharacterstotheleftofthecursorareerased. <n>=2:Allcharactersonthecurrentlineareerased. Thelineisclearedusingthecurrentbackgroundcolour. Name:IL-InsertLines Escape:<ESC>[<n>L Example:<ESC>[3L ILinserts<n>linesatthecurrentcursorlocation.Thecurrent lineandalllinesbelowitaremoveddown.Linesatthebottomof thescreenwillbelost.If<n>isomitted,onelineisinserted. Thecursordoesn'tmove.Thenewlinewillbedisplayedinthe currentbackgroundcolour. Name:DL-DeleteLines Escape:<ESC>[<n>M Example:<ESC>[9M DLdeletes<n>lines,startingwiththecurrentcursorline.All linesunderneaththeline(s)tobedeletedwillbemovedup.New lines,inthecurrentbackgroundcolour,willappearatthebottom ofthescreen.Thecursordoesn'tmove. Name:DECSC-DECPrivate,SaveCursorParameters Escape:<ESC>7 ThisissupposedtobeaDECPrivateescape,butisusedonother systemsaswell.Itsavesthecurrentcursorposition(likeSCP), butalsostoresthecurrenttextattributesandcolours.WithDECRC theseparameterscanberestored.üThisisnotimplementedin ANSI.SYSÇ!!! Name:DECRC-DECPrivate,RestoreCursorParameters Escape:<ESC>8 DECRCistheoppositeofDECSC,andrestoresthesavedcursor parameters.üThisisnotimplementedinANSI.SYSÇ!!! Name:RIS-ResettoInitialState Escape:<ESC>c This'resets'theAnsidriver:thecoloursaresettodefault values,alltextattributesareswitchedoffandthescreenis cleared.ItisthesameasdoinganSGR0followedbyED2.üThisis notimplementedinANSI.SYSÇ!!! ÇName:NEL-NextLine Escape:<ESC>E Thismovesthecursortothefirstpositiononthenextline, scrollingthescreenupifnecessary.Itiseffectivelythesameas CarriageReturnfollowedbyLineFeed,andisünotimplementedin ANSI.SYSÇ!!! Name:SGR-SetGraphicsRendition Escape:<ESC>[<n>;<n>;...;<n>m Example:<ESC>[1;37m Nowthisisthegoodstuff...Withthisescapeyoucancontrol threethings: »Thetextforegroundcolour, »Thetextbackgroundcolour, »Thetextattributes. Therecanbeanynumberofparameters,separatedby';'characters. Theeffectiscumulative.Ifnoparametersarepassed,'0'is assumed.Thefollowingparametersareavailable: 0Resetcoloursandattributes 1Bold(*) 4Underlined(*) 5Blink(*) 7ReverseVideo 30ForegroundBlack 31ForegroundRed 32ForegroundGreen 33ForegroundYellow 34ForegroundBlue 35ForegroundMagenta 36ForegroundCyan 37ForegroundWhite 40to47BackgroundColours Attributesmarkedby(*)areignoredbyQuick.Whenrunningona monochromemonitorthecoloursarealsoignored.Onacolour monitorcolour30isblack(register0),colour37iswhite (register3),andallcoloursinbetweenarealternatedBlue (register1)andRed(register2).Ofcoursethisdependsonyour screensettings,buttheabovearetheQuickBBSdefaults.If foregroundandbackgroundturnouttobethesame,Quickwill adjustthebackgroundcolour. ÇSomeexamples... Bold,WhiteonBlue:<ESC>[0;1;37;44m Blink,RedonYellow:<ESC>[0;5;31;43m Normal,WhiteonBlack:<ESC>[mor<ESC>[0m Bold,Underlined,Green:<ESC>[0;1;4;32m Notethatsetting-say-Bolddoesnoteffectanyoftheother attributes,northecolours.Tomakesureyou'vegottheright mode,youcouldadda'0'atthebeginning,butthatdependsonhow intelligentyourAnsieditoris. YoucancreateyourAnsiscreensinanumberofdifferentways.The hardestwayistodoitallinatexteditorlikeTempusorthe capturebufferinFlash.Thisislotsofhardwork,andyoucan't getmanyfancyeffectsthisway. ThemostexpensivemethodistobuyaPCanduseaneditorlike TheDraw.Theseeditorshavelotsofniceoptionstodostufflike animation. ThesimplestistocreateyourscreensinaVT-52editorand convertthemtoAnsiusingtheQANSIprogram,availablefromour SupportBBS.YoujustspecifytheinputVT-52file,andyourAnsi fileisreadytouse!Theonlylimitationis:QANSIcan'thandle morethanonescreenatatime. PerhapssomeonehastimetowriteagoodVT-52andAnsieditorfor theST?It'sabouttimewehadsomethingwecanworkwith! ÇëAPPENDIXI-RS-232PINOUTÇ 9 [.◆..◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆]0110 OnanRS-232interfacealogicallylow(binary0)signalisbetween +3Vand+15V(+12Visrecommended).Alogicallyhigh(binary1) signalisbetween-3Vand-15V(-12Vrecommended).Therearetwo typesofports(DCEontheSTandDTEonthemodem),which generallyensurethatreceiveandsendareinter-connectedon eitherside. MostRS-232portshave25pins(pinnumber1shouldbemarkedon theplug).SomePC'suse9-pin'joystick'connectorsfortheirRS- 232.Thepinnumberingisdifferent,butthemeaningisthesame.A jumperboxalwayscomesinhandywhentryingtoconnectequipment usingRS-232! TheminimumrequirementforQuickBBSisCD,DTR,TD,RD,PGand GND.Formodemsof9600bpsoroveryouêmustÇalsouseRTSandCTS. NotallpinsareconnectedonanST.Availablepinsare... êPinÇêNameÇêDescriptionÇ 1PGêPÇrotectiveêGÇround,protectsyourequipmentagainst currentsurges,differentvoltagelevelsetc. 2TDêTÇransmitêDÇata.Thecomputersendsdatatothemodem onthispin. 3RDêRÇeceiveêDÇata.Datasentfromthemodemtothe computergoesthroughthispin. 4RTSêRÇequestêTÇoêSÇend,goeshighwhenthecomputerwants tosenddatatothemodem. 5CTSêCÇlearêTÇoêSÇend(responsetoRTS),goeshighwhenthe modemisreadytoreceivedatafromthecomputer. 7GNDGround,allothersignalsarerelativetothe voltageonthispin. 8CDêCÇarrierêDÇetectismadehighbythemodemwhenauser isonline(aconnectionisinprogress). 20DTRêDÇataêTÇerminalêRÇeady,ismadelowbyQuickBBSwhen themodemshouldterminatetheconnection. 22RIêRIÇng,goeshighwhenthemodemdetectsanincoming call(thephoneisringing). ÇëAPPENDIXJ-FSEINTERFACEÇ TheFullScreenEditoriscalledbyQuickBBSwhentheuserwants towriteamessage.BeforeQuickexecutestheFSEitchangesthe currentdirectorytothedirectorywheretheFSEprogramis locatedandwritesoneortwofiles.ThecommandlineoftheFSE containsthecurrentbaudrate(0forlocal),thenumberofminutes theuserhasleft,thenumberofsecondsbeforetheusershouldbe timedoutandtheusersgraphicsmodenumber. QuickwillalwayswriteafilecalledüMSGINFO.FSEÇ,whichisaplain ASCIIfilewith7lines: »whothemessageisfrom(max.35characters), »whothemessageisto(max.35characters), »thesubjectofthemessage(max.72characters), »theoriginatingFidoNetaddress, »thedestinationFidoNetaddress, »anareaname(max.35characters), »somemessagebits. Theto,fromandsubjectlinesarecheckedforvaliditybyQuick. IfthemessageisaLocalorEchoMailmessagetheFidoNetaddresses are0,otherwisetheselinescontainthezone,netandnodenumbers intheusualformat,followedbyaspaceandthenameofthenode (max.35characters). Themessagebitsarestoredasastringof8zeroesandones(MSB first),whichmean: êBitÇêChange?ÇêMeaningÇ 0Yesthemessageisprivate 1Nothemessageisareply 2Nothemessageislocal 3NothemessageisEchoMail 4Yesthemessage'to'linemaybechanged 5Yesthemessage'subject'linemaybechanged 6Yesthemessagehasafileattached 7Noreserved IfthemessageisareplyQuickwillcreateafilecalled üMSGTEXT.FSEÇ,whichcontainsthetextoftheoriginalmessage.Itis unformatted,nullterminatedandcontainslinefeedstomarkthe end-of-paragraph.Itmayalsocontainkludgelines. TheFSEshouldadditsownquotecharacters,butpleaseusethe standardquoteformat(e.g."XX>"or">").Thiswayother editorscandetectthemandquotingwillnotendupinanextreme mess. ÇWhentheeditorreturnstotheBBSitshouldexitwithan errorlevel: êErrorLevelÇêMeaningÇ  0allwentokay,savethemessage 1userabortedthemessage 2userdroppedthecarrier 3userfellasleep otherinternalerror-Quickwillabortthemessage Iftheeditorreturnswitherrorlevel0itmusthavewrittenthe twofileswithnewinfo.üMSGTEXT.FSEÇwillcontainthemessagetext, nullterminated,LF'stoterminateparagraphs.CR'swillbeignored byQuick.ThemessagetextmayêonlyÇcontaincharacters10,13and therange32to127.Anullshouldbeusedtoterminatethe message.  ThenewüMSGINFO.FSEÇmayhavelines2and3changed,andinline7 onlythosebitsmarkedwith'change?'above.Ifline2or3have beenchangedthenthecorrespondingmessagebitsshouldbeset.If the'to'fieldischangedinalocalmessagetheFSEshouldcheck theuserbasetovalidatethenewname. IfeitherofthetwofilesarenotfoundQuickwillabortthe message. ÇëAPPENDIXK-EXTERNALCHATINTERFACEÇ Theexternalchatprogramiscalledif... »theuseryellsfortheSysOp »theSysOppressesAlt-Ctostartchatting Quickchangesthecurrentdirectorytothedirectorycontainingthe chatprogramandexecutesitwithcommandline <Yell?><Baud><FirstName><LastName><Graphics><Record> where <Yell?>is1iftheuseryelledor0iftheSysOppressed Alt-C, <Baud>isthecurrentbaudrate,or0inlocalmode, <FirstName>istheusersfirstname, <LastName>istheuserslastname, <Graphics>istheusersgraphicsmodenumber, <Record>istheusersrecordnumberinüUSERS.BBSÇ. ThechatprogramshouldpagetheSysOpif<Yell?>is1etc. ÇëAPPENDIXL-AVAILABLEUTILITIESÇ 9 [.◆..◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆]0110 TherearealreadyquitealotofutilitiesavailableforQuickBBS ST.MostofthemcanbedownloadedfromourSupportBBS.Some utilitiesrequireabatchfilesetup.Theonessuppliedwith QuickBBSaren'tlistedhere. ü êUtilitiesÇ »üCOMPOSERÇcanbeusedtocreateyelltunes.Runsinhighresolution onlyandneedsGfA-Basic2.0.Providedassourcecode. »üFSUÇcanbeusedtoscanyourfileareasformissingfilesand/or descriptions. »üWOWSERÇcanextracttextfilesfromarchivesandreadsthem,wrks abitliketheinternalbrowser. »ü AMAILÇcangenerateü.QWKÇmailpacketsforusewithoff-line  editors.Verypower-andusefull,it'sshareware »üFIBUÇcompilesyourFILES.BBSfiledescriptionsintoonebigfile. »üLAST10ÇmakeschartsinASCII,VTMandVTCgraphicsmodesofthe last10callers. »üLEDÇisanofflinemessageeditorinaGemenvironment(i.e.with windowsetc).Veryniceindeed! »üQANSIÇconvertsVT-52screenstoAnsigraphics.Supportslimited animationbutcanonlyhandleonescreenatatime. »üSTICKÇ(FidoNet),usedtosendandreceivefilestoandfromother FidoNetnodes.Itautomaticallysendsnewestversions, descriptionsetc. »üTOP10ÇmakeschartsinASCII,VTMandVTCgraphicsmodesofthe top10uploaders,downloaders,messagewritersandcallers. ü êDoorGamesü Ç BecauseQuickcanrunPandoraandFoReMDoorGamesyouhavequitea choiceinthisdepartmenttoo.Asmallselection... »üArcadeÇisacollectionofsimplegameslikehangmanandtic-tac- toe(noughts&crosses). »üDungeons&DragonsÇshouldringabell?Inthisgametheuser playsagainstyourST.Hemustsearchthroughdungeonscollecting treasures&fightingmonsters.VeryniceVT-52graphics! »üGalacticEmpireÇisasortofSpaceEmpireElite,butdoesn'tplay aswell. »üSpaceEmpireEliteÇisanoldfavouriteofmine.Usersbattle otheruserstryingtobuildalargeempire.Yousetamaximum numberofturnsperday.Thereareplanetstobeboughtandfed, troopstobepayed,espionagetobedoneetc.etc.Very addictive. Ç»üSpaceTraderEliteÇisanotherspacegamewhichisplayedona map.Youcantravelfromplanettoplanet,buyandsellgoods, attackotherusersandsoon.NotascompetitiveasSpaceEmpire though. »üSTNationalsÇconcernsroadracing.Youcanraceagainstother usersandspendyourwinningsonneworbetterpartsforyour car. êOthersÇ »üQSTRUCTÇcontainsalltheQuickBBSSTfilestructures. ÇëAPPENDIXM-ERRORLEVELS&PARAMETERSê ÇQuickBBSexitswithdifferentErrorLevelswhenNetMailorEchoMail isentered,whenasystemerroroccursetc... êErrorlevelÇêMeaningÇ 0NormalExit 1NormalExit 2Setuperror 3CarrierDropped 4NetMailwritten 5EchoMailwritten otherMenuoptionerrorlevel(type15) Bycheckingforerrorlevels4and5youcanrunScanandPack directlyafterQuickBBStoexportanymailwhichwasjustwritten. Afewparameterscanbepassedonthecommandlinetoo... êParameterÇêMeaning Ç -B300Useronline,300bps -B1200Useronline,1200bps -B2400Useronline,2400bps -B4800Useronline,4800bps -B9600Useronline,9600bps -B14400Useronline,14400Bps -B19200Useronline,19200bps -LOperateinLocalMode -RRe-loginafterexit-with-errorlevel -SSimulate:don'tusefastscreenroutineslocally -N Disablestatusbarandshowmouse.Shouldbeusedwhen  runningMulitTos. Asyoucansee,whenstartedfromabatchfile(withamailer) Quickcanoperateatspeedsupto19200bps.Withthe-Rparameter youdon'tneedtoselectspeedorlocalmode. ÇëAPPENDIXN-EXAMPLEBATCHFILESÇ ThebatchfileslistedhereareforthePCommandshell.Thisshell hasafewbugsinthebatchfilehandlingdepartment.Thebatch filesshouldn'tbetoobig(nolargerthan5or6Kb),anditseems likecallingonebatchfilefromanothercausesproblems.All commandsareinuppercase,theparametersareinlowercase(for clarity,PCommanddoesn'tcare).Thecommentsinbracketsshould notbetypedin. êRunningQuickBBSwithQuickStartÇ ECHO off REM========== REM QuickBBS ST + QuickStart example batch file. To use this one REM youmustrename QSTART.OVL to QSTART.PRG. REM========== :start(jumpheretorerunQuickStart) CLS ECHO Loading QuickStart CD \qbbs(changetorightdirectory) qstart(runQuickStart) CLS ECHO QuickStart exit with ErrorLevel %:e REMCheckerrorlevelreturnedbyQuickStart... IFERRORLEVEL192GOTOqbbs  (errorlevel192?19200bps) IFERRORLEVEL144GOTOqbbs (errorlevel144?14400bps) IFERRORLEVEL96GOTOqbbs (errorlevel96?9600bps) IFERRORLEVEL48GOTOqbbs (errorlevel48?4800bps) IFERRORLEVEL24GOTOqbbs (errorlevel24?2400bps) IFERRORLEVEL12GOTOqbbs  (errorlevel12?1200bps) IFERRORLEVEL3GOTOqbbs  (errorlevel3?300bps) IF ERRORLEVEL 2 GOTO errorend(level2:error!) IF ERRORLEVEL 1 GOTO local(level1:local) GOTO end(level0:offline) REM========== :local(jumpheretologinlocally) CLS CD \qbbs(gotorightdirectory) quickbbs -L(runQuickBBSinlocalmode) IF ERRORLEVEL 6 GOTO afterquick(exitwitherrorlevel?) GOTO start(nope,rerunQuickStart) ÇREM========== :qbbs(jumphereforxxxbpsusers) CLS ECHO Starting up QuickBBS at %:e00 bps. CD \qbbs (gotorightdirectory) quickbbs -B%:e00(runQuickBBSat300bps) IF ERRORLEVEL 6 GOTO afterquick(exitwitherrorlevel?) GOTO start(no,backtoQuickStart) REM========== :end(jumpheretobringboardoffline) CLS ECHO @3 18 - QuickBBS is Offline- ECHO. CD\QBBS EXIT(outofbatchfile) REM========== :errorend(jumphereiferroroccurs) BELL(soundthebell) CLS ECHO @3 18 - QuickStart Error ECHO. CD \qbbs BELL EXIT(outoutout) REM========== REMDoorGames etc. here... REM========== :afterquick REMCheckwhaterrorlevelwasreturnedbyQuick.Notethatthe REM'iferrorlevel6'bitactuallymeans'iferrorlevel>=6' IF ERRORLEVEL 7 GOTO dosgate(level7:remoteshell) IF ERRORLEVEL 6 GOTO starwars (level6:playagame) GOTO relogin(shouldnevergethere) REM========== :relogin(rerunQuickwithuserstillonline) CLS ECHO Restarting QuickBBS. CD \qbbs quickbbs -R (rerunQuick,-RmeansRelogin) IF ERRORLEVEL 6 GOTO aferquick(anotherexit-with-errorlevel?) GOTO start(no,backtoQuickStart) ÇREM========== :dosgate(jumphereforremoteshell) CLS ECHO Remote Dosgate in operation... CD \qbbs CTTY AUX(redirectPCommandtomodem) cdwatch ON (monitorcarrier,resetiflost) ECHO QuickBBS DOSGATE ECHO ================ ECHO Type 'EXIT' to return to QuickBBS. INPUT (interactivecommands) cdwatch OFF(carrierwatchingoff) CTTY CON(redirectbacktoconsole) ECHO Back from Dosgate GOTO relogin(rerunQuickBBS) REM========== :starwars(Jumpheretoplaygame) CLS ECHO Starting DoorGame: StarWars CD \qbbs\starwars starwars(startupprogram) GOTO relogin(rerunQuickBBS) REM======= REMTheEnd REM======= ÇêRunningQuickBBSwithThe-BoxorBinkleyÇ ECHO off REM========== REM QuickBBS ST +The-Boxexample batch file. REM========== :start(jumpheretorerunThe-Box) CLS ECHO Loading The-Box CD \qbbs(changetorightdirectory) tbunattended(runThe-Boxinmailermode) CLS ECHO The-Boxexit with ErrorLevel %:e REMCheckerrorlevelreturnedbyThe-Box... REMUsef10tologinlocally.Thelevelsforimport/exportdepend REMonyourTB.EVTconfigurationfile. IFERRORLEVEL100GOTOlocal(level100:local) IFERRORLEVEL192GOTOqbbs  (errorlevel192?19200bps) IFERRORLEVEL144GOTOqbbs (errorlevel144?14400bps) IFERRORLEVEL96GOTOqbbs (errorlevel96?9600bps) IFERRORLEVEL48GOTOqbbs (errorlevel48?4800bps) IFERRORLEVEL24GOTOqbbs (errorlevel24?2400bps) IFERRORLEVEL12GOTOqbbs  (errorlevel12?1200bps) IFERRORLEVEL9GOTOimport(level9:receivedmail) IFERRORLEVEL4GOTOexport(level4:packmail) IFERRORLEVEL3GOTOqbbs  (errorlevel3?300bps) IF ERRORLEVEL 1 GOTO errorend(level1:error!) GOTO end(level0:offline) REM========== :local(jumpheretologinlocally) CLS CD \qbbs(gotorightdirectory) quickbbs -L(runQuickBBSinlocalmode) IF ERRORLEVEL 6 GOTO afterquick(exitwitherrorlevel?) GOTO start(nope,rerunThe-Box) REM========== :qbbs(jumphereforxxxbpsusers) CLS ECHO Starting up QuickBBS at %:e00 bps. CD \qbbs (gotorightdirectory) quickbbs -%:e300(runQuickBBSatxxbps) IF ERRORLEVEL 6 GOTO afterquick(exitwitherrorlevel?) GOTO start (no,backtoThe-Box) ÇREM========== :end(jumpheretobringboardoffline) CLS ECHO @3 18 - QuickBBS is Offline- ECHO. CD\QBBS EXIT(outofbatchfile) REM========== :errorend(jumphereiferroroccurs) BELL(soundthebell) CLS ECHO @3 18 - The-BoxError- ECHO. CD \qbbs BELL EXIT(outoutout) REM========== REMDoorGames etc. here... REM========== :afterquick REMCheckwhaterrorlevelwasreturnedbyQuick.Notethatthe REM'iferrorlevel6'bitactuallymeans'iferrorlevel>=6' IF ERRORLEVEL 7 GOTO dosgate(level7:remoteshell) IF ERRORLEVEL 6 GOTO starwars (level6:playagame) GOTO relogin(shouldnevergethere) REM========== :relogin(rerunQuickwithuserstillonline) CLS ECHO Restarting QuickBBS. CD \qbbs quickbbs -R (rerunQuick,-RmeansRelogin) IF ERRORLEVEL 6 GOTO aferquick(anotherexit-with-errorlevel?) GOTO start(no,backtoThe-Box) REM========== :dosgate(jumphereforremoteshell) CLS ECHO Remote Dosgate in operation... CD \qbbs CTTY AUX(redirectPCommandtomodem) cdwatch ON (monitorcarrier,resetiflost) ÇECHO QuickBBS DOSGATE ECHO ================ ECHO Type 'EXIT' to return to QuickBBS. INPUT (interactivecommands) cdwatch OFF(carrierwatchingoff) CTTY CON(redirectbacktoconsole) ECHO Back from Dosgate GOTO relogin(rerunQuickBBS) REM========== :starwars(Jumpheretoplaygame) CLS ECHO Starting DoorGame: StarWars CD \qbbs\starwars starwars(startupprogram) GOTO relogin(rerunQuickBBS) REM========== :import (jumpheretoimportreceivedmail) CLS CD \qbbs ECHO Mail received, starting Import. ECHO# import(runImport) GOTO start (backtoThe-Box) REM========== :export (jumpheretopackoutboundmail) CD \qbbs CLS ECHO Scanning echomail... ECHO # scan -p (nowscanEchoMail) CLS ECHO Scanning NetMail... ECHO # pack(thenscanNetMail) GOTO start(backtoThe-Box) REM======= REMTheEnd REM======= ÇëAPPENDIXO-BUGREPORTFORMÇ 9 [.◆..◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆]0110 TobeusedifyoudiscoverabuginQuickBBSSToroneofthe providedutilities. Ifyouhaveproblemspleasemakesure... »thatyouhavereadthedocumentationproperly, »thatyourconfigurationisright, »thatyoursystemdateiscorrect, »thatyouhaveinstalled4KBUFinyourAutofolder, »thatyouhavethelatestversionoftheprogram. ThenremoveêallÇprogramsfromyourAutofolder(except4KBUF)and êallÇaccessories,rebootandtryagain. Ifitstillgoeswrong,fillinthebugreportformbelowandsend it(asamessageorasafile)toourSupportBBS.Pleasetellus asmuchasyoucanabouttheproblem,andifpossibledescribehow wecanreproduceit.Ifyou'rehavingtroublewithterminal emulationorduringfiletransfers,includethenameoftheprogram 'ontheotherend'(e.g.Flash,Interlink,Procommetc.).Thank you! üYournameÇ_______________________________________________ üKeyserialnumberÇ_______________________________________________ü BBSnameÇ_______________________________________________ üBBSphonenumberÇ_______________________________________________ üFidoNetaddressÇ_______________________________________________ü SystemÇAtari_______ST______________________________ _______________________________________Monitor ______________________________________Harddiskü Ç_________________________________________Modem TOSversion___________________________________ ___________________________________KbRAMfree _______________________________________________ _______________________________________________ü AutofolderÇ_______________________________________________ _______________________________________________ _______________________________________________ _______________________________________________ü Ç üAccessoriesÇ_______________________________________________ _______________________________________________ü Ç_______________________________________________ _______________________________________________ü ProgramÇ_______________________________________________ü VersionÇ_______________________________________________ü ÇüDescriptionetc.Çü:Ç