TMETXXXX.ZIP

Telix script paketti erityisesti Metropolin ja yleisesti PcBoard 
jrjestelmien automatisoituun kyttn.

Lue dokumentointi kunnolla ennenkuin alat kyttmn pakettia. Sstyt 
monelta turhalta vaivalta ja ylltykselt.

Paketti on viel keskenerinen ja jossainmrin toimimaton. Scriptit 
sietvt vhn virheit, mutta joskus eivt lainkaan. Jos joku scripti 
j jumiin, paina enteri ja katso jatkaako se menoaan. Jos se on 
edelleen jumissa paina ESC-nppint ja keskeyt scripti. Tmn jlkeen 
olet aivan normaalissa ksikyttisess yhteydess BBS-jrjestelmn.

TMETXXXX.ZIP sislt seuraavat tiedostot:

        METROPOL.SL?    Pscripti. Kynnist POLL scriptin.

            POLL.SLC    Lukee asetukset ja kutsuu muita scriptej.
            GETF.SLC    (Erikoistapauksia varten)
          GETMES.SLC    (Erikoistapauksia varten)

        MARKFILS.SLC    Valmiiksi knnetyt tiedostot Telixille.
         PCBGETF.SLC
        PCBLOGIN.SLC
         PCBNEWF.SLC
        METROMSG.SLC
        PCBLOGOU.SLC

        METROPOL.CFG    Configuraatio tiedosto Metropoliin.
        MIGETMES.SL?    Esimerkki scripti Metropoliin. (ONLINE)
          MIGETF.SL?    Esimerkki scripti Metropoliin. (ONLINE)
         JOKUMUU.SLT    Esimerkki scripti muualle.

        LUEMINUT.TXT    Tm teksti, jota juuri luet.
         HISTORY.TXT    Aikojen kuluessa tulleet muutokset.

             SRC.ZIP    .SLC tiedostojen lhdekoodi.

   hienot.ansi.kuvat    Mainoksia. Poista huoletta paketista...

Kuinka saat hienon jrjestelmn toimimaan Telixisssi:

-       Purat paketin kaikki tiedostot Telixin script-hakemistoon. Jos 
        et ole viel mritellyt erillist script-hakemistoa, niin on 
        korkea aika tehd niin. (Httapauksessa mys Telixin hakemisto 
        ky, mutta silloin tytyy asettaa Telixin asetuksista Script 
        Directory samaksi kuin Telix Directory).

-       Laitat SCRIPT, UP- ja DOWNLOAD hakemistosi Telixin asetuksiin 
        kuntoon. Hakemiston nimen tulee ptty kenoviivaan (\)

-       Muutat METROPOL.CFG tiedostossa olevia tietoja siten, ett
        haluamasi valinnat ovat voimassa.

-       Laitat Telixin Dialing directoryyn Metropolin numeron alle 
        kohtaan Linked Script: METROPOL ja kohtaan Password OMAN 
        salasanasi Metropoli jrjestelmn.

-       Jos haluat kyttsi MARKFILS.SLC:n, laita se esim. Alt-N 
        -nppimen takaa suoritettavaksi scriptiksi. Eli Regural 
        Keyboard definition, Alt-N, @markfils.

Kuinka saat PcBoardin toimimaan tmn scriptin kanssa.

-       Laita oletusprotokollaksi ZModem. Paketti ei tue muita 
        tiedonsiirtoprotokollia... ja miksi muka tukisi ?? Siis kskyll 
        T niinkuin Trans. Protocol ja Z.

-       Saavutat nopeutta jos laitat Expert Menus on, kskyll X. 
        Ilmeisesti PcBoard kyselee joiden kskyjen suoritusten jlkeen, 
        jotta Press Enter to Continue, jos eXpert menus eivt ole 
        pll. Scripti paketti ei hallitse sellaisia tilanteita... eli 
        laita se eXpert menus on.

-       Jos kytt QWK jrjestelm ja QMail 4.0:a (ainoa joka toimii 
        tmn paketin kanssa) laita QMailin asetuksiin eXpert menus ON

Voit yritt kytt valmiiksi knnettyj scriptej mys muissa 
BBS-jrjestelmiss. Parametrit pit antaa juuri samassa jrjestyksess, 
ja niiden (luultavasti) pit olla muuttujia. (Eli pelkk arvo ei riit, 
vaan tytyy olla mritelty muuttujaksi. SALT dokumentaatiossa ei 
kerrota, siirretnk parametrit pinossa, vai menevtk ainoastaan 
niiden pointterit perille.)

Voit kytt scriptej esim:

main()          // Hakee MITSista uusien tiedostojen listauksen
{               // ja MITS.REQ tiedostossa olevat uudet tiedostot
        str abbrev[]="MITS";    // MITSin tunnus
        int zprot   = 'Z';      // Sisinen ZModem
        int addtime = 0;        // Ei pyydet lisaikaa
        str addtimecmd[]="OPEN 2^M";    // Lisaika ksky Metropolissa

        call("pcbnewf",abbrev);
        call("pcbgetf",abbrev,zprot,addtime,addtimecmd);
}

------------------------------------------------------------------------

Scriptien selitykset ja vaatimat parametrit:

POLL.SLC

-       Lukee configuraatiotiedoston ja kutsuu muita scriptej: 
        pcblogin, pcbnewf, metromsg, pcbgetf ja pcblogou. Laittaa 
        talteen kaiken linjaliikenteen (capturella) download hakemistoon 
        nimell [abbrev].LOG. ABBREV muuttuja on sama kuin kytettvn 
        offline jrjestelmn tunnustavut (eli sama kuin PCBGETF, PCBNEWF 
        ja MARKFILS).

-       POLL:n vaatimat parametrit ovat:
        -       str configfilename      // Kytettvn configuraatio-
                                        // tiedoston nimi.

-       Voit laatia useita configuraatiotiedostoja eri BBS-
        jrjestelmille ja hoitaa niiden liikenteen kutsumalla tt 
        scripti esim:

main()  // MITS.SLT
{       // Kynnist POLL.SLC:n configuraatiolla MITS.CFG
        str configfilename[]="MITS.CFG";
        call("poll",configfilename);
}

PCBLOGIN.SLC

-       Hoitaa PcBoardiin sisnkirjoittautumisen. Toimii Metropolin 
        epstandardin kysymyksen kanssa, muttei vaadi sit. Toiminee 
        mys muissa PcBoardeissa. PCBLOGIN.SLC hakee kytettvn 
        salasanan Telixin Dialing directoryn kohdasta Password.

-       Jos mitn tunnistettava ei tule 10 sekunnin kuluessa, laittaa 
        scripti linjalle yhden ^M:n ja odottaa uudelleen 10 sekuntia. 
        (Tt odotusta ja ENTERin painelua jatkuu hamaan ikuisuuteen, 
        jos sielt ei tule jotain tunnistettavaa, kuten "name?".)

-       Kytettvn kielen tunnistus ei vlttmtt toimi kovinkaan 
        hyvin, sill jokainen purkki tuntuu kysyvn omalla tavallaan 
        kytettv kielt. Scripti etsii .CFG tiedostossa mritelty
        stringin ptk ja laittaa sen jlkeen ilmoille mritellyn
        englannin kielen numeron.

-       PCBLOGIN:n vaatimat parametrit ovat:
        -       str _user_name  // Kyttjn login nimi
        -       int lang_number // Kytettvn kielen numero
        -       int fast_login  // Nopea/hidas login
        -       str ask_lang_str        // Kysymys, johon vastataan
                                        // lang_numberilla.
        -       str mainboardprompt     // main boardin prompt

-       PCBLOGIN palauttaa:     0       kaikki meni OK
                                -1      Scripti keskeytetty
                                -4      carrier hvinnyt

PCBNEWF.SLC

-       Hakee PcBoardista uusien tiedostojen listauksen ja tallentaa sen 
        download hakemistoon [abbrev].NFI tiedostoon.

-       Poistaa MARKFILS.SLC:n tekemt indeksitiedostot (.DAT),
        jotta MARKFILS tiet tehd ne uusiksi uudelle tiedostolle.

-       PCBNEWF:n vaatimat parametrit ovat:
        -       str abbrev      // Tunnusstringi (max. 8 mrk)
        -       str mainboardprompt     // main boardin prompt

-       PCBNEWF palauttaa:      0       kaikki meni OK
                                -1      Scripti keskeytetty
                                -4      carrier hvinnyt

PCBGETF.SLC

-       Hakee upload hakemistossa olevassa [abbrev].REQ tiedostossa 
        olevat tiedostot omaan koneeseesi PcBoardista.

-       PCBGETF.SLC scripti tunnistaa ilmoituksen, joka tulee jos 
        sinulla ei ole riittvsti aikaa hakea tiedostoa. Tllaiset 
        tiedostot jtetn [abbrev].REQ tiedostoon odottamaan seuraavaa 
        kertaa. Josko silloin olisi enemmn aikaa kytsssi.

-       Parametri [addtime] kertoo, suoritetaanko [addtimecmd], jos 
        lytyy [abbrev].REQ tiedosto. Jos [addtime]==1, suoritetaan 
        komento.

-       Muista laittaa komennon pern ^M, jos haluat, ett komennon 
        jlkeen painetaan enteri...

-       PCBGETF:n vaatimat parametrit ovat:
        -       str abbrev
        -       int zprot
        -       int addtime
        -       str addtimecmd
        -       str mainboardprompt     // main boardin prompt

-       PCBGETF palauttaa:      0       kaikki meni OK
                                -1      Scripti keskeytetty
                                -2      Aika loppu
                                -3      Kyttj ei halunnut tiedostoja
                                        haettavan (keskeytys
                                        kysymyksess)
                                -4      carrier hvinnyt

PCBLOGOU.SLC

-       Kirjoittautuu PcBoard jrjestelmst ulos. Antaa 10 sekuntia 
        aikaa keskeytt automaattinen uloskirjoittautuminen.

-       Odottaa 2.5 sekuntia komennon antamisen jlkeen (tai kunnes 
        linjalta tulee merkkijono "for calling") ja suorittaa Telixin 
        Hangup komennon.

-       PCBLOGOU:n vaatimat parametrit ovat:
        -       str mainboardprompt     // main boardin prompt

-       PCBLOGOU palauttaa:     0       kaikki meni OK
                                -1      Scripti keskeytetty
                                -4      carrier hvinnyt

METROMSG.SLC

-       Hoitaa viestipakettien siirron koneesi ja Metropolin vlill. 
        Toimii ainoastaan Metropolissa olevien doorien kanssa (QMail 4.0 
        ja PCB-OMEN v1.7?). Kytt vain toista kerrallaan, joten voit
        kytt esim. vain QMail 4.0:n kanssa (taitaa olla yleisempi).
        Lisksi lytyy PcBoardin sisinen QWK.

-       Offline-pakettien siirron JLKEEN ilmestyy nytlle 2 sekunnin
        ajaksi ikkuna: Transfers ready. Tmn aikana voi painaa kerran 
        (HUOM. Yhden kerran!) ESC-nppint. Ikkunan sulkeutumisen 
        jlkeen Telix kysyy, keskeytetnk scripti. Jos mielestsi 
        saamasi tiedosto oli liian pieni tai muuten epilet 
        tiedonsiirto-ongelmia, voit viel palauttaa viestiosoittimet 
        (message pointers) ennen poistumistasi doorista. Tm siksi, 
        ettei kaikki tunnu aina toimivan niinkuin pitisi...

-       Jos PCB-OMEN ilmoittaa viestej olevan yli 1000 kappaletta, 
        yritt METROMSG hakea toisen paketin heti ensimmisen pern. 
        Vanhempi paketti nimetn [abbrev].OLD paketiksi ja uudempi 
        haetaan oikealla nimell. Huomioi tm kynnistesssi 
        etlukijaasi. (Eli muista nimet .OLD paketti esim .ZIP 
        paketiksi ja laittaa viimeisen haettu .ZIP paketti johonkin 
        muuhun hakemistoon talteen... (sekavaako?)).

-       zprot muuttujalla voidaan vaikuttaa kytettvn ZModem 
        tiedonsiirtoprotokollaan. Voidaan kytt mys ulkoista 
        ZModemia, jos sit tarvitaan. (Sisinen = 'Z', ulkoinen on 
        kyttjn mrittelem shortcut key.)

-       METROMSG:n vaatimat parametrit ovat:
        -       int offline     // Offline jrjestelm (0=OMEN,1=QWK)
        -       int omen_pack   // Omen pakkeri (1=ZIP,2=LHA,3=ARJ)
        -       int qwk_doorn   // PcBoardin door numero QWK:lle
        -       int pst_doorn   // PcBoardin door numero OMENille
        -       str abbrev      // Offline jrjestelmn tunnuskirjaimet
                                // (Metropolissa OMEN=MI,QWK=MPOLI)
        -       int zprot       // Kytettv ZModem protokolla
        -       int pst_systfile// POSTin versionumero (1 tai 2)
        -       str mainboardprompt     // main boardin prompt
        -       int pst_expr    // express omen = 1, 0 = ei

-       METROMSG palauttaa:     0       kaikki meni OK
                                -1      Scripti keskeytetty
                                -2      Aika loppu
                                -3      Yli 2000 uutta viesti (eli 
                                        haettu toinenkin paketti).
                                -4      carrier hvinnyt
                                -5      PCBOMEN kaatunut erroriin ja
                                        tippunut takaisin PcBoardiin

MARKFILS.SLC

-       On paketin ainoa scripti, joka on tarkoitettu toimimaan offline. 
        Scriptill voit valita uusista tiedostoista haluamasi, jotka 
        seuraavalla kerralla sitten kydn hakemassa.

-       Kannattaa asentaa Regular Keyboard Definition kautta esim Alt-N 
        nppimen takaa toimivaksi laittamalla Alt-N mritykseksi:

                @markfils

        Tllin Alt-N nppint painamalla MARKFILS kynnistyy.

-       MARKFILS ky kaikki download hakemistossa olevat *.NFI tiedostot 
        lpi ja pyyt valitsemaan haettavat tiedostot. Valitut 
        tiedostot kertn upload hakemistoon *.REQ tiedostoiksi.

-       MARKFILS kytt yht indeksitiedostoa, jonka avulla sen
        toimintaa pyritn nopeuttamaan...

------------------------------------------------------------------------

ERIKOISSCRIPTIT:

GETMES.SLC ja GETF.SLC

-       Voit kynnist nm scriptit vain kun olet online yhteydess 
        Metropoliin. GETMES hakee uusien tiedostojen listauksen, viestit 
        ja merkityt tiedostot ja suorittaa logoutin. GETF hakee 
        ainoastaan merkityt tiedostot. Kyttksesi nit scriptej 
        sinun tulee tehd niit varten kutsuscriptit. Esim:

-       Scriptit tarkistavat, ett ne ovat online carrier() funktiolla, 
        ja lopettavat toimintansa, jos linja on tippunut.

main()  // MIGETMES.SLT
{       // Kynnist GETMES.SLC:n configuraatiolla METROPOL.CFG
        str configfilename[]="METROPOL.CFG";
        call("getmes",configfilename);
}
        
main()  // MIGETF.SLT
{       // Kynnist GETF.SLC:n configuraatiolla METROPOL.CFG
        str configfilename[]="METROPOL.CFG";
        call("getf",configfilename);
}

-       Edelliset esimerkki scriptit voit kynnist Telixist Alt-G 
        (GO) ja annat ajettavan scriptin nimen.

-       GETMES:n ja GETF:n vaatimat parametrit ovat:
        -       str configfilename      // Kytettvn configuraatio-
                                        // tiedoston nimi.

-       Voit tehd useita configuraatiotiedostoja eri BBS-jrjestelmille 
        ja kytt samoja scriptej niiden liikenninnin hoitamiseen.

JOKUMUU.SLT

-       On esimerkki siit, miten nit scriptej voi kytt jonkun
        muun PcBoard purnukan pollaamiseen.

------------------------------------------------------------------------

Jos ongelmia esiintyy, ota yhteytt minuun, joko

Metropoli:      Sami Pitko
Internet:       sami.pitko@pcb.mpoli.fi
X.400:          G=SAMI;S=PITKO;O=VANTAA;P=VAISALA;A=INFONET;C=US;

POLL scripti tallentaa kaikki tapahtumat download hakemistoon 
[abbrev].LOG tiedostoon. Tmn tiedoston avulla on helpompi etsi syyt
toimimattomuuteen (linja-roska vs. ohjelmointivirhe).

Kaikki ideat ja kommentit ovat tervetulleita.

------------------------------------------------------------------------
