TMETXXXX.ZIP Telix script paketti erityisesti Metropolin ja yleisesti PcBoard j„rjestelmien automatisoituun k„ytt””n. Lue dokumentointi kunnolla ennenkuin alat k„ytt„m„„n pakettia. S„„styt monelta turhalta vaivalta ja yll„tykselt„. Paketti on viel„ keskener„inen ja jossainm„„rin toimimaton. Scriptit siet„v„t v„h„n virheit„, mutta joskus eiv„t lainkaan. Jos joku scripti j„„ jumiin, paina enteri„ ja katso jatkaako se menoaan. Jos se on edelleen jumissa paina ESC-n„pp„int„ ja keskeyt„ scripti. T„m„n j„lkeen olet aivan normaalissa k„sik„ytt”isess„ yhteydess„ BBS-j„rjestelm„„n. TMETXXXX.ZIP sis„lt„„ seuraavat tiedostot: METROPOL.SL? P„„scripti. K„ynnist„„ POLL scriptin. POLL.SLC Lukee asetukset ja kutsuu muita scriptej„. GETF.SLC (Erikoistapauksia varten) GETMES.SLC (Erikoistapauksia varten) MARKFILS.SLC Valmiiksi k„„nnetyt 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 T„m„ teksti, jota juuri luet. HISTORY.TXT Aikojen kuluessa tulleet muutokset. SRC.ZIP .SLC tiedostojen l„hdekoodi. hienot.ansi.kuvat Mainoksia. Poista huoletta paketista... Kuinka saat hienon j„rjestelm„n toimimaan Telixiss„si: - Purat paketin kaikki tiedostot Telixin script-hakemistoon. Jos et ole viel„ m„„ritellyt erillist„ script-hakemistoa, niin on korkea aika tehd„ niin. (H„t„tapauksessa my”s Telixin hakemisto k„y, mutta silloin t„ytyy asettaa Telixin asetuksista Script Directory samaksi kuin Telix Directory). - Laitat SCRIPT, UP- ja DOWNLOAD hakemistosi Telixin asetuksiin kuntoon. Hakemiston nimen tulee p„„tty„ 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 j„rjestelm„„n. - Jos haluat k„ytt””si MARKFILS.SLC:n, laita se esim. Alt-N -n„pp„imen takaa suoritettavaksi scriptiksi. Eli Regural Keyboard definition, Alt-N, @markfils. Kuinka saat PcBoardin toimimaan t„m„n scriptin kanssa. - Laita oletusprotokollaksi ZModem. Paketti ei tue muita tiedonsiirtoprotokollia... ja miksi muka tukisi ?? Siis k„skyll„ T niinkuin Trans. Protocol ja Z. - Saavutat nopeutta jos laitat Expert Menus on, k„skyll„ X. Ilmeisesti PcBoard kyselee joiden k„skyjen suoritusten j„lkeen, jotta Press Enter to Continue, jos eXpert menus eiv„t ole p„„ll„. Scripti paketti ei hallitse sellaisia tilanteita... eli laita se eXpert menus on. - Jos k„yt„t QWK j„rjestelm„„ ja QMail 4.0:a (ainoa joka toimii t„m„n paketin kanssa) laita QMailin asetuksiin eXpert menus ON Voit yritt„„ k„ytt„„ valmiiksi k„„nnettyj„ scriptej„ my”s muissa BBS-j„rjestelmiss„. Parametrit pit„„ antaa juuri samassa j„rjestyksess„, ja niiden (luultavasti) pit„„ olla muuttujia. (Eli pelkk„ arvo ei riit„, vaan t„ytyy olla m„„ritelty muuttujaksi. SALT dokumentaatiossa ei kerrota, siirret„„nk” parametrit pinossa, vai menev„tk” ainoastaan niiden pointterit perille.) Voit k„ytt„„ scriptej„ esim: main() // Hakee MITSista uusien tiedostojen listauksen { // ja MITS.REQ tiedostossa olevat uudet tiedostot str abbrev[]="MITS"; // MITSin tunnus int zprot = 'Z'; // Sis„inen ZModem int addtime = 0; // Ei pyydet„ lis„aikaa str addtimecmd[]="OPEN 2^M"; // Lis„aika k„sky 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 k„ytett„v„n offline j„rjestelm„n tunnustavut (eli sama kuin PCBGETF, PCBNEWF ja MARKFILS). - POLL:n vaatimat parametrit ovat: - str configfilename // K„ytett„v„n configuraatio- // tiedoston nimi. - Voit laatia useita configuraatiotiedostoja eri BBS- j„rjestelmille ja hoitaa niiden liikenteen kutsumalla t„t„ scripti„ esim: main() // MITS.SLT { // K„ynnist„„ POLL.SLC:n configuraatiolla MITS.CFG str configfilename[]="MITS.CFG"; call("poll",configfilename); } PCBLOGIN.SLC - Hoitaa PcBoardiin sis„„nkirjoittautumisen. Toimii Metropolin ep„standardin kysymyksen kanssa, muttei vaadi sit„. Toiminee my”s muissa PcBoardeissa. PCBLOGIN.SLC hakee k„ytett„v„n salasanan Telixin Dialing directoryn kohdasta Password. - Jos mit„„n tunnistettava ei tule 10 sekunnin kuluessa, laittaa scripti linjalle yhden ^M:n ja odottaa uudelleen 10 sekuntia. (T„t„ odotusta ja ENTERin painelua jatkuu hamaan ikuisuuteen, jos sielt„ ei tule jotain tunnistettavaa, kuten "name?".) - K„ytett„v„n kielen tunnistus ei v„ltt„m„tt„ toimi kovinkaan hyvin, sill„ jokainen purkki tuntuu kysyv„n omalla tavallaan k„ytett„v„„ kielt„. Scripti etsii .CFG tiedostossa m„„ritelty„ stringin p„tk„„ ja laittaa sen j„lkeen ilmoille m„„ritellyn englannin kielen numeron. - PCBLOGIN:n vaatimat parametrit ovat: - str _user_name // K„ytt„j„n login nimi - int lang_number // K„ytett„v„n 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 h„vinnyt PCBNEWF.SLC - Hakee PcBoardista uusien tiedostojen listauksen ja tallentaa sen download hakemistoon [abbrev].NFI tiedostoon. - Poistaa MARKFILS.SLC:n tekem„t 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 h„vinnyt 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 riitt„v„sti aikaa hakea tiedostoa. T„llaiset tiedostot j„tet„„n [abbrev].REQ tiedostoon odottamaan seuraavaa kertaa. Josko silloin olisi enemm„n aikaa k„yt”ss„si. - Parametri [addtime] kertoo, suoritetaanko [addtimecmd], jos l”ytyy [abbrev].REQ tiedosto. Jos [addtime]==1, suoritetaan komento. - Muista laittaa komennon per„„n ^M, jos haluat, ett„ komennon j„lkeen 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 K„ytt„j„ ei halunnut tiedostoja haettavan (keskeytys kysymyksess„) -4 carrier h„vinnyt PCBLOGOU.SLC - Kirjoittautuu PcBoard j„rjestelm„st„ ulos. Antaa 10 sekuntia aikaa keskeytt„„ automaattinen uloskirjoittautuminen. - Odottaa 2.5 sekuntia komennon antamisen j„lkeen (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 h„vinnyt METROMSG.SLC - Hoitaa viestipakettien siirron koneesi ja Metropolin v„lill„. Toimii ainoastaan Metropolissa olevien doorien kanssa (QMail 4.0 ja PCB-OMEN v1.7?). K„ytt„„ vain toista kerrallaan, joten voit k„ytt„„ esim. vain QMail 4.0:n kanssa (taitaa olla yleisempi). Lis„ksi l”ytyy PcBoardin sis„inen QWK. - Offline-pakettien siirron JŽLKEEN ilmestyy n„yt”lle 2 sekunnin ajaksi ikkuna: Transfers ready. T„m„n aikana voi painaa kerran (HUOM. Yhden kerran!) ESC-n„pp„int„. Ikkunan sulkeutumisen j„lkeen Telix kysyy, keskeytet„„nk” scripti. Jos mielest„si saamasi tiedosto oli liian pieni tai muuten ep„ilet tiedonsiirto-ongelmia, voit viel„ palauttaa viestiosoittimet (message pointers) ennen poistumistasi doorista. T„m„ siksi, ettei kaikki tunnu aina toimivan niinkuin pit„isi... - Jos PCB-OMEN ilmoittaa viestej„ olevan yli 1000 kappaletta, yritt„„ METROMSG hakea toisen paketin heti ensimm„isen per„„n. Vanhempi paketti nimet„„n [abbrev].OLD paketiksi ja uudempi haetaan oikealla nimell„. Huomioi t„m„ k„ynnist„ess„si et„lukijaasi. (Eli muista nimet„ .OLD paketti esim .ZIP paketiksi ja laittaa viimeisen„ haettu .ZIP paketti johonkin muuhun hakemistoon talteen... (sekavaako?)). - zprot muuttujalla voidaan vaikuttaa k„ytett„v„„n ZModem tiedonsiirtoprotokollaan. Voidaan k„ytt„„ my”s ulkoista ZModemia, jos sit„ tarvitaan. (Sis„inen = 'Z', ulkoinen on k„ytt„j„n m„„rittelem„ shortcut key.) - METROMSG:n vaatimat parametrit ovat: - int offline // Offline j„rjestelm„ (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 j„rjestelm„n tunnuskirjaimet // (Metropolissa OMEN=MI,QWK=MPOLI) - int zprot // K„ytett„v„ 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 h„vinnyt -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 k„yd„„n hakemassa. - Kannattaa asentaa Regular Keyboard Definition kautta esim Alt-N n„pp„imen takaa toimivaksi laittamalla Alt-N m„„ritykseksi: @markfils T„ll”in Alt-N n„pp„int„ painamalla MARKFILS k„ynnistyy. - MARKFILS k„y kaikki download hakemistossa olevat *.NFI tiedostot l„pi ja pyyt„„ valitsemaan haettavat tiedostot. Valitut tiedostot ker„t„„n upload hakemistoon *.REQ tiedostoiksi. - MARKFILS k„ytt„„ yht„ indeksitiedostoa, jonka avulla sen toimintaa pyrit„„n nopeuttamaan... ------------------------------------------------------------------------ ERIKOISSCRIPTIT: GETMES.SLC ja GETF.SLC - Voit k„ynnist„„ n„m„ scriptit vain kun olet online yhteydess„ Metropoliin. GETMES hakee uusien tiedostojen listauksen, viestit ja merkityt tiedostot ja suorittaa logoutin. GETF hakee ainoastaan merkityt tiedostot. K„ytt„„ksesi n„it„ 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 { // K„ynnist„„ GETMES.SLC:n configuraatiolla METROPOL.CFG str configfilename[]="METROPOL.CFG"; call("getmes",configfilename); } main() // MIGETF.SLT { // K„ynnist„„ GETF.SLC:n configuraatiolla METROPOL.CFG str configfilename[]="METROPOL.CFG"; call("getf",configfilename); } - Edelliset esimerkki scriptit voit k„ynnist„„ Telixist„ Alt-G (GO) ja annat ajettavan scriptin nimen. - GETMES:n ja GETF:n vaatimat parametrit ovat: - str configfilename // K„ytett„v„n configuraatio- // tiedoston nimi. - Voit tehd„ useita configuraatiotiedostoja eri BBS-j„rjestelmille ja k„ytt„„ samoja scriptej„ niiden liikenn”innin hoitamiseen. JOKUMUU.SLT - On esimerkki siit„, miten n„it„ scriptej„ voi k„ytt„„ 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. T„m„n tiedoston avulla on helpompi etsi„ syyt„ toimimattomuuteen (linja-roska vs. ohjelmointivirhe). Kaikki ideat ja kommentit ovat tervetulleita. ------------------------------------------------------------------------