


















                        Turbď Bulletiî Boarä Systeí (TBBS)

                                   Versioî 2.2

                                 15 December 1984

                                Stevĺ Foř - Sysop

                        Albuquerquĺ RCP/Í    (505)299-5974









































                 Section                                        Page

        1.  HISTORŮ ANÄ BACKGROUND                                1
        2.  PURPOSĹ OĆ THĹ SYSTEM                                 2
        3.  MINIMUÍ SYSTEM                                        3
        4.  FILES                                                 4
        5.  SYSTEÍ INSTALLATION                                   5
          5.1  Creatĺ thĺ timĺ anä datĺ procedurĺ anä
             instalě intď TBBSCOM.INC                             5
          5.2  Definĺ thĺ defaultó anä instalě intď TBBSHDR.INC   5
          5.3  Compilĺ TBBÓ anä TUTL                              5
          5.4  Ediô thĺ systeí messagĺ filĺ (SYSMSG.BB#)          6
          5.5  Ruî TUTĚ tď creatĺ thĺ TBBÓ files                  6
          5.6  Loç intď TBBÓ aó SYSOP                             6
          5.7  Seô thĺ accesó leveě oć thĺ SYSOĐ witč TUTL        7
        6.  USINÇ THĹ SYSTEM                                      8
        7.  MAINTENANCE                                           9
        8.  'BUGS§ ANÄ PLANNEÄ ENHANCEMENTS                      10
















































        1.  HISTORŮ ANÄ BACKGROUND

        Thĺ originaě SJBBS¬  writteî iî Xitaî Basiă bů Howarä Moulton¬ waó Ť
        adapteä  tď  MBasiă bů Brucĺ R®  Ratoff®   Modificationó  tď  thió Ť
        systeí  werĺ madĺ bů Brucĺ Ratoff¬  Jameó Underwood¬  Roî  Fowler¬ Ť
        Bretô Berg¬  Stevĺ Foř anä many¬  manů others®   Jameó Whortoî anä Ť
        Eddiĺ  H®  Curliî  converteä thĺ RBBÓ tď Turbď  Pascaě  (copyrighô Ť
        Borlanä International© iî 198´ anä calleä thĺ systeí TPBBS.

        Turbď  Bulletiî  Boarä  Systeí  (TBBS©  waó  writteî  usinç  ideaó Ť
        gathereä  froí thesĺ systemó anä froí otheró operatinç oî  á  widĺ Ť
        varietů  oć computers®  Versioî 2.° oć TBBÓ waó reviseä tď includĺ Ť
        indexeä  filĺ  supporô usinç B« treeó provideä  bů  Turbď  Toolboř Ť
        (copyrighô Borlanä International).











































                                        1








        2.  PURPOSĹ OĆ THĹ SYSTEM

        TBBÓ  waó designeä aó á traditionaě bulletiî boarä systeí witč thĺ Ť
        addeä featurĺ oć privatĺ messaginç capability®   Messageó lefô  tď Ť
        alě  useró arĺ 'public§ anä readablĺ bů anyonĺ oî thĺ system¬  buô Ť
        messageó lefô tď á singlĺ useň arĺ 'private§ anä cannoô bĺ reaä bů Ť
        anyonĺ buô thĺ sendeň anä thĺ receiver®  Thĺ sysođ can¬ oć course¬ Ť
        reaä alě messageó aô anů time®  Á passworä ió requireä tď loç intď Ť
        thĺ systeí afteň thĺ firsô access®   Thió passworä ió selecteä  bů Ť
        thĺ useň wheî firsô logginç intď thĺ system®  Untiě 'validated§ bů Ť
        thĺ  sysop¬  useró  wilě noô bĺ alloweä tď exiô tď  thĺ  operatinç Ť
        systeí oň enteň messageó tď anyonĺ buô thĺ sysop.













































                                        2








        3.  MINIMUÍ SYSTEM

        TBBÓ  operateó  oî á 64Ë Z-8° computeň witč 44Ë oć TPÁ  (transienô Ť
        prograí area© operatinç undeň CP/Í 2.2®  BYEł versioî 1.· oň lateň Ť
        shoulä  bĺ useä anä maů usĺ anů addresó abovĺ B000Č  (thĺ  highesô Ť
        addresó  useä bů TBBS®   Ić ZCPŇ ió used¬  thĺ systeí wilě seô thĺ Ť
        patč foň thĺ sysođ anä thĺ drivĺ anä useň areá limits.


















































                                        3








        4.  FILES

        Thĺ  followinç  fileó  arĺ includeä iî thĺ  Turbď  Bulletiî  Boarä Ť
        System:

        TBBS.PAÓ       Turbď Bulletiî Boarä program
        TUTL.PAÓ    utilitů program
        TBBSHDR.INĂ    headeň filĺ (commoî tď botč programs)
        TBBSCOM.INĂ    commoî utilitieó (commoî tď botč programs)
        TBBSMSG.INĂ    messagĺ systeí foň TBBS
        TBBS.DOĂ       documentatioî (thió file)
        SYSMSG.TXÔ     samplĺ messagĺ file

        Iî  additioî tď these¬  thĺ followinç Turbď Toolboř fileó wilě  bĺ Ť
        needeä tď compilĺ thĺ system:

        ACCESS.BOX
        GETKEY.BOX
        ADDKEY.BOX
        DELKEY.BOX





































                                        4








        5.  SYSTEÍ INSTALLATION

        Thĺ  followinç stepó shoulä bĺ takeî tď instalě TBBÓ anä TUTĚ  foň Ť
        youň system:

        1© Creatĺ thĺ timĺ anä datĺ procedurĺ anä instalě intď TBBSCOM.INC
        2© Definĺ thĺ defaultó anä instalě intď TBBSHDR.INC
        3© Compilĺ TBBÓ anä TUTL
        4© Ediô thĺ systeí messagĺ filĺ (SYSMSG.BB#)
        5© Ruî TUTĚ tď creatĺ thĺ TBBÓ files
        6© Loç intď TBBÓ aó SYSOP
        7© Seô thĺ accesó leveě oć thĺ SYSOĐ witč TUTL

        5.1  Creatĺ thĺ timĺ anä datĺ procedurĺ anä instalě intď TBBSCOM.INC

        Thió  procedurĺ provideó TBBÓ anä TUTĚ witč thĺ  machinĺ  specifiă Ť
        timĺ anä datĺ informatioî foň youň computeň system®  Thĺ procedurĺ Ť
        musô  pasó bacë siř valueó whicč arĺ thĺ binarů representatioî  oć Ť
        seconds¬ hours¬ minutes¬ day¬ month¬ anä yeaň (iî thaô order)®  Ić Ť
        youň machinĺ doeó noô havĺ á reaě timĺ clock¬  thesĺ valueó shoulä Ť
        bĺ seô tď zero.

        5.2  Definĺ thĺ defaultó anä instalě intď TBBSHDR.INC

        Thesĺ arĺ thĺ defaulô valueó thaô thĺ systeí wilě assigî ne÷ useró Ť
        thaô  call®   Oncĺ  yoő havĺ validateä thĺ user¬  yoő maů wisč  tď Ť
        assigî otheň valueó oî aî individuaě basis.

        Ić  yoő arĺ noô usinç ZCPR¬  jusô leavĺ thĺ patč valueó  aô  zero®  Ť
        Thesĺ  valueó wilě bĺ pokeä intď memorů startinç aô locatioî 0048Č Ť
        wheî thĺ Sysođ logó in.

        5.3  Compilĺ TBBÓ anä TUTL

        Turbď  Pascaě  haó  twď quirkó thaô musô  bĺ  accounteä  foň  wheî Ť
        installinç TBBS®   First¬  Turbď staticallů allocateó higč memory¬ Ť
        i.e® aô compilĺ time¬ yoő MUSÔ telě Turbď thĺ highesô addresó thaô Ť
        wilě  bĺ  availablĺ  durinç  use®   Secondly¬  Turbď  attemptó  tď Ť
        initializĺ  thĺ installeä terminaě devicĺ wheî thĺ prograí starts®  Ť
        Thĺ solutionó tď thesĺ twď problemó arĺ aó follows:

        1©  seô thĺ enä addresó beforĺ compilinç TBBÓ sď thaô iô wilě  noô Ť
        conflicô  witč BYE®   Oî mů system¬  BYĹ useó memorů  startinç  aô Ť
        abouô  C000H¬  sď É seô thĺ enä addresó tď á loweň valuĺ (sucč  aó Ť
        B000Č  jusô tď bĺ safe© beforĺ compiling®   Ić yoő arĺ plaî tď ruî Ť
        TUTĚ froí á remotĺ site¬  thĺ enä addresó wilě havĺ tď bĺ seô  foň Ť
        thió prograí too» ić not¬ thĺ defaulô addresó ió safe.

        2©  creatĺ á 'vanilla§ versioî oć thĺ TURBO.COÍ filĺ whicč ió useä Ť
        foň thĺ finaě compilĺ oć TBBS®   Thió versioî oć Turbď shoulä  noô Ť
        usĺ ANŮ screeî controě codeó sucč aó highlighting®  TUTĚ useó somĺ Ť
        screeî  codeó  anä shoulä bĺ compileä oî thĺ versioî oć  TURBO.COÍ Ť
        installeä foň youň specifiă terminal.

        Thĺ stepó foň generatioî arĺ aó follows:Š

                                        5









        (witč 'vanilla§ versioî oć Turbo)

        1© Í - Maiî file
        2© Ď - Options
        3© Ă - COÍ file
        4© Ĺ - Enä address
        5© B000<ret>
        6© Ń - Quit
        7© Ă - Compile
        8© TBBS<retľ - worë file
        9© Ń - Quiô anä returî tď operatinç system

        Thió wilě creatĺ thĺ compileä versioî oć TBBÓ readů foň use.

        (witč thĺ versioî oć Turbď installeä foň youň terminal)

        1© Í - Maiî file
        2© Ď - Options
        3© Ă - COÍ file
        4© Ń - Quiô (don'ô havĺ tď worrů abouô enä addresó here)
        5© Ă - Compile
        6© TUTL<retľ - worë file
        7© Ń - Quiô anä returî tď operatinç system

        Thió wilě creatĺ thĺ compileä versioî oć TUTĚ readů foň use.

        5.4  Ediô thĺ systeí messagĺ filĺ (SYSMSG.BB#)

        Thĺ  systeí  messagĺ  filĺ shoulä bĺ editeä  foň  youň  particulaň Ť
        system®   Á samplĺ filĺ calleä SYSMSG.TXÔ (iî WordStaň format©  ió Ť
        includeä  aó á guideline®   Notĺ thaô Turbď cannoô handlĺ thĺ higč Ť
        ordeň  biô  thaô somĺ worä processoró (sucč aó WordStar©  usĺ  foň Ť
        formatting¬  sď thĺ filĺ wilě havĺ tď bĺ processeä beforĺ use®  Aî Ť
        easů  waů tď dď thió ió tď copů thĺ filĺ useä foň editinç  tď  thĺ Ť
        systeí  messagĺ  filĺ (SYSMSG.BB#© usinç PIĐ witč thĺ 'Z§  option®  Ť
        Thĺ  systeí attributĺ oć thĺ filĺ maů theî bĺ seô tď hidĺ iô  froí Ť
        view®  Thĺ commandó foň thesĺ operationó arĺ aó follows:

        PIĐ SYSMSG.BB#=SYSMSG.TXT[Z]
        STAÔ SYSMSG.BBŁ $SYS

        5.5  Ruî TUTĚ tď creatĺ thĺ TBBÓ files

        Thĺ  systeí ió no÷ readů tď bĺ initialized®   First¬  ruî TUTĚ  tď Ť
        creatĺ  thĺ  necessarů fileó foň TBBS®   Ić TUTĚ cannoô  finä  thĺ Ť
        fileó needeä tď ruî thĺ system¬ iô wilě creatĺ theí automatically®  Ť
        Afteň TUTĚ putó thĺ menő oî thĺ screen¬  thĺ fileó arĺ readů tď bĺ Ť
        used.

        5.6  Loç intď TBBÓ aó SYSOP

        Quiô  TUTĚ anä ruî TBBS®   Thĺ systeí wilě asë foň á namĺ  - enteň Ť
        SYSOP®   Noô  findinç sucč á user¬  thĺ systeí wilě prompô  foň  á Ť
        passworä - enteň onĺ oć youň choice®   Yoő arĺ no÷ loggeä intď thĺ ŤŠ

                                        6








        system¬ buô aó aî unvalidateä user.

        NOTEş  Iô ió IMPORTANÔ thaô yoő loç iî aó sysođ beforĺ puttinç thĺ Ť
        systeí uđ foň otheró tď use®   Therĺ arĺ folkó ouô therĺ thaô wilě Ť
        trů  tď loç iî aó sysop®   Ić yoő haven'ô seô youň password¬  theů Ť
        wilě seô iô foň you!

        5.7  Seô thĺ accesó leveě oć thĺ SYSOĐ witč TUTL

        Afteň  yoő havĺ exploreä á little¬  exiô thĺ systeí (Goodbye©  anä Ť
        usĺ  TUTĚ agaiî tď seô 'BBÓ stat§ foň thĺ sysođ tď '1'®   Yoő  maů Ť
        alsď wanô tď changĺ thĺ drivĺ anä useň areaó yoő wilě havĺ  accesó Ť
        to®  Futurĺ accesseó tď TBBÓ wilě allo÷ yoő fulě sysođ privileges.












































                                        7








        6.  USINÇ THĹ SYSTEM

        TBBÓ  expectó  tď finä alě fileó oî thĺ defaulô drivĺ anä  iî  thĺ Ť
        defaulô  useň areá whicč wilě normallů bĺ A0®  Thesĺ  files¬  wheî Ť
        created¬  wilě automaticallů havĺ thĺ 'system§ attributĺ set¬ i.e® Ť
        theů wilě noô bĺ visiblĺ witč á normaě directorů command.

        Yoő maů wanô tď renamĺ TBBS.COÍ filĺ tď RBBS.COÍ beforĺ puttinç iô Ť
        intď  use®   Thió ió tď minimizĺ confusioî oî thĺ parô oć  calleró Ť
        anä tď minimizĺ changeó tď BYE.

        TUTĚ  shoulä NOÔ bĺ madĺ availablĺ tď normaě useró becausĺ oć  thĺ Ť
        changeó  thaô  caî bĺ madĺ tď useň  records¬  particularlů  accesó Ť
        privileges.











































                                        8








        7.  MAINTENANCE

        Sincĺ  ne÷  useró arĺ noô alloweä tď senä messageó oň  accesó  thĺ Ť
        operatinç  system¬  thĺ sysođ shoulä usĺ thĺ TBBÓ oň TUTĚ dailů tď Ť
        geô messageó froí ne÷ useró desirinç validation¬  theî usĺ TUTĚ tď Ť
        validatĺ theí (thió ió donĺ bů settinç BBÓ staô tď '1')®   Á checë Ť
        shoulä  bĺ madĺ aô thió timĺ thaô thĺ messageó oî thĺ  systeí  arĺ Ť
        appropriatĺ  tď  thĺ  philosophů oć thĺ sysop®   BEWARĹ  oć  useró Ť
        leavinç messageó abouô crediô carä numbers¬ accesó codes¬ oň otheň Ť
        sucč information.

        Thĺ messagĺ systeí shoulä bĺ purgeä weekly®  Á gooä waů tď dď thió Ť
        ió  tď turî oî thĺ printer¬  prinô ouô  thĺ  users¬  callers¬  anä Ť
        messages¬  theî turî thĺ printeň ofć anä repacë thĺ messagĺ files®  Ť
        Thió way¬ á hardcopů recorä ió kepô oć alě activitů oî thĺ system®  Ť
        Thĺ calleň filĺ ió usuallů reseô afteň iô haó beeî printed.









































                                        9








        8.  'BUGS§ ANÄ PLANNEÄ ENHANCEMENTS

        Aó faň aó ió known¬  thĺ systeí doeó noô havĺ anů residuaě 'bugs'¬ Ť
        buô ić yoő dď finä any¬  pleasĺ leavĺ á messagĺ oî thĺ Albuquerquĺ Ť
        RCP/Í oň maiě tď Addař Systems®   If¬  aó yoő usĺ thĺ system¬  yoő Ť
        seĺ  thĺ  neeä foň otheň changeó pleasĺ leô uó kno÷ iî  á  similaň Ť
        fashion.

        Enhancementó planneä foň futurĺ versionó (3.° anä up):

        1©  multiplĺ  boardó  - messageó addresseä tď ALĚ arĺ  visiblĺ  tď Ť
        anyonĺ whď logó in®   Witč multiplĺ boards¬  thĺ useň woulä selecô Ť
        whicč messagĺ areá ió oć interesô anä reaä anä enteň messageó onlů Ť
        withiî thaô area®   Thió woulä providĺ useró witč commoî interestó Ť
        á morĺ closelů kniô workspace.

        2©  conferenceó - onlů twď typeó oć messageó arĺ currentlů  avail-Ť
        able¬  thosĺ addresseä tď ALĚ anä thosĺ addresseä tď á  particulaň Ť
        user®   Conferenceó woulä contaiî messageó senô froí onĺ useň tď á Ť
        selecô grouđ oć otheň users.

        3© contexô sensitivĺ helđ - wheî thĺ useň requireó help¬  thĺ TBBÓ Ť
        woulä  onlů displaů informatioî pertinenô tď thĺ specifiă functioî Ť
        beinç executed.

        4©  closĺ thĺ loođ oî thĺ accountinç systeí - onlů useró thaô  usĺ Ť
        thĺ TBBÓ Goodbyĺ functioî completĺ theiň accounting®   Ić theů loç Ť
        ouô witč BYĹ oň jusô hanç up¬  thĺ logouô valueó arĺ noô  updated®  Ť
        Thió modificatioî wilě havĺ tď bĺ madĺ iî conjunctioî witč BYE.

        5©  wastebaskeô  - inappropriatĺ languagĺ (stringó oć  characters© Ť
        wilě dumđ thĺ useň intď thĺ trash.

























                                       10