Oakland CPM Archive/oakcpm.iso/cpm/turbopas/tbbs22.lbr/TBBS.DQC/TBBS.DOC

Text File | 1985-02-09 | 15KB | 791 lines

                        Turb∩ Bulletiε BoarΣ Systeφ (TBBS)

                                   Versioε 2.2

                                 15 December 1984

                                Stevσ Fo° - Sysop

                        Albuquerquσ RCP/═    [phone]









































                 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