7plus.exe:n käyttö

Mikä ihmeen 7plus?

7plussan tarkoitus on mahdollistaa binaaristen tiedostojen (kuten ohjelmien tai kuvien) siirto pakettiradiopostin välityksellä.

BBS:t on normaalisti tarkoitettu käsittelemään pelkkää tekstiä joten 7plussan tarkoitus on kääntää binaariset tiedostot muotoon, joka on yhteensopiva postilaatikkojen kanssa ja pilkkoa ne tarvittaessa pienempiin osiin, jotka on mahdollista lähettää bbs-verkon yli muiden viestien joukossa.

7plus tarjoaa myös tavan korjata virheet vastaanottajan päässä, jolloin kokonaisia tiedostoja ei tarvitse lähettää uudelleen ja uudelleen. Kun vastaanottaja yrittää purkaa 7plus tiedostoa ja siinä on virhe luo 7plus virheraportin (.err päätteinen tiedosto). Tämä tulee lähettää alkuperäisen 7plus tiedoston lähettäneelle henkilölle, joka voi luoda tämän ja alkuperäisen tiedoston avulla korjaustiedoston (.cor päätteinen tiedosto).

 

Esimerkkejä 7plussan käytöstä


Kääntö

Tiedostojen kääntö 7plus muotoon
Komento Selitys
7plus testi.txt 7plus kääntää tiedoston testi.txt (ja jos tarpeellista) pilkkoo sen automaattisesti noin 10 kt kokoisiin tiedostoihin.
7plus testi.txt -s 7plus kääntää tiedoston testi.txt ja pilkkoo sen maksimikokoisiin tiedostoihin (korkeintaan 512 riviä tiedostoa kohti).
7plus testi.txt -s 30 Kääntää ja pilkkoo tiedoston testi.txt 30 riviä pitkiin tiedostoihin.
7plus testi.txt -sp 3 Kääntää ja pilkkoo tiedoston testi.txt kolmeen suurinpiirtein yhtä suureen tiedostoon.
7plus testi.txt -sb 5000 Kääntää ja pilkkoo testi.txt:n suurinpiirtein 5000 tavun pituisiksi tiedostoiksi.

 

Purku

7plus tiedostojen purkaminen
Komento Selitys
7plus testi.7pl 7plus purkaa tiedoston testi.7pl. Jos kyseisessä tiedostossa ei ole virheitä 7plus luo kopion alkuperäisestä tiedostosta. Jos virheitä löytyy 7plus luo virheraportin (testi.err). Jos 7plus löytää korjaustiedoston 'testi.cor' samasta hakemistosta käyttää se sitä automaattisesti.
7plus testi.p01 7plus purkaa kaikki osat (*.p01, *.p02 jne.).
7plus testi
Automaattinen tila
7plus   -joko purkaa tiedoston 'testi.7pl' tai 'testi.pxx'
  -tai kääntää 'testi' nimisen tiedoston (ilman päätettä)

 

7plus ja eri toiminnot

7plus.exe:n eri toiminnot
Toiminto Selitys
7plus -h Näyttää lyhyet ohjeet ohjelman käyttöön.
7plus -j Käännettäessä 7plus kirjoittaa kaikki syntyneet 7plus osat yhteen tiedostoon. Tiedoston tunnistaa 'upl' päätteestä (upload).
7plus -k Tällä valinnalla 7plus poistaa automaattisesti kaikki tiedostot, joita ei enää tarvita. Poikkeuksena tähän on korjaustiedoston kääntö: Virheraportteja ei poisteta, koska niitä voidaan vielä tarvita koottujen korjaustiedostojen tekoon.
7plus -n (vain Atari_ST versio)
Yleensä 7plus odottaa näppäimen painallusta ajon jälkeen.
-n valinta kytkee pois tämän kehoitteen. Tämä on käytännöllistä, kun 7plussaa ajetaan jostain toisesta ohjelmasta (shell).
7plus -p Käännetyt tiedostot, virheraportit ja korjaustiedostot kirjoitetaan niin, että rivinrajoittimena käytetään CR:ää. Tämä on tarpeellista niiden pääteohjelmien kanssa, joissa 7plus-tiedostot pitää lähettää binaaritilassa, koska ne eivät pysty käsittelemään 8 bittisiä merkkejä tekstitilassa. Tämä on vielä tärkeämpää Amigassa tai Unixissa, koska vakio rivinrajoitin siellä on LF!
7plus -r Jos käy niin että moniosaisesta 7plus lähetyksestä vain yksi osa täytyy kääntää uudelleen (Esim. Sellaisessa tapauksessa että kyseinen osa ei koskaan päässyt perille määränpäähänsä.) niin tässä tilanteessa ei ole tarpeellista kääntää kokonaista tiedostoa uudelleen. 7plus kykenee kääntämään pelkästään tarvitun osan uudelleen.

Esimerkki: 7plus test.txt -sp 10 -r 5

Tässä esimerkissä 7plus kääntää pelkästään osan 5 eikä ollenkaan osia 1-4 ja 6-10.

Uudelleen käännettäessä on erittäin tärkeää kääntää täsmälleen samalla tavalla, kuin alkuperäinen kääntö tapahtui. Muista kääntää tiedosto yhtä moneen tai suureen osaan kuin aiemmin.
7plus -sysop Tämä valinta mahdollistaa purkamisen jopa siinä tapauksessa, että kaikkia osia ei ole vastaanotettu. Puuttuvia osia vastaavat paikat metatiedostossa jätetään tyhjiksi, ja rivit merkitään puuttuviksi myöhempää korjausta varten. Tämän valinnan käyttöä tulisi välttää. Käytä sitä vain kun muita vaihtoehtoja ei ole. (Puuttuvat osat eivät ilmesty bbs:ään, vaikka yli viikko on kulunut.)
7plus -t Tätä valintaa voidaan käyttää lisäämään tiedoston lopetusmerkki 7plus tiedostojen, virheraporttien ja korjaustiedostojen perään ilmoittamaan automaattisesti mihin tiedosto päättyy, kun se lähetetään postilaatikkoon.

Esimerkki: 7plus test.txt -t /ex

Huomaa: Jos lopetusmerkki alkaa miinusmerkillä '-' täytyy koko lopetusmerkki sijoittaa sitaattien väliin ("-ex"), koska muuten 7plus sekoittaisi sen ohjelman valintoihin.
7plus -tb format.def Kun tätä valintaa käytetään käännettäessä niin 7plus lisää automaattisesti "head" ja "foot" tekstit format.def tiedostosta. Katso taulukon alla oleva esimerkki.
7plus -y 7plus olettaa, että vastaus kaikkiin kyselyihin on myöntävä (YES). Tämä valinta on käytännöllinen, kun 7plussaa ajetaan jostain toisesta ohjelmasta (shell, palvelin).
7plus -# Kun 7plussaa käytetään tiedostopalvelimen kanssa niin ongelmana on se, että palvelimelle tulisi antaa tieto siitä kuinka monta tiedostoa syntyi käännettäessä. Palvelin voisi etukäteen laskea kuinka monta tiedostoa syntyy, mutta 7plus voi tuottaa pienen tiedoston nimeltä 7plus.fls, joka sisältää tiedot siitä kuinka monta tiedostoa luotiin ja mitkä käännettyjen tiedostojen nimet ovat. 7plus.fls tiedoston sisältö voisi esimerkiksi olla '10 test'.

 

Esimerkki format.def tiedostosta:

@@top
sb ibm @ww
%O %p/%q 7+

@@bottom

Lähetä ERR-tiedostot osoitteella: FIN6TR @FI6BBS.#MUS.FIN.EU!

73, Timo

/ex

 

Format.def tiedostossa käytettävien muuttujien merkitykset

Format.def tiedostossa käytettävät muuttujat
Muuttuja Selitys
%n Käännetyn tiedoston nimi.
%N Käännetyn tiedoston nimi. (isoin kirjaimin)
%o Alkuperäisen tiedoston nimi.
%O Alkuperäisen tiedoston nimi. (isoin kirjaimin)
%p 7plus osan numero.
%P 7plus osan numero. (heksalukuna)
%q 7plus osien määrä yhteensä.
%Q 7plus osien määrä yhteensä. (heksalukuna)
%% Prosenttimerkki '%'.

 

Yläpuolella ollut esimerkki format.def tiedostosta tekisi seuraavan näköisiä 7plus tiedostoja:

sb ibm @ww
OHJELMA.EXE 01/04 7+

... Tässä kohtaa on itse 7plus tiedosto ...

Lähetä ERR-tiedostot osoitteella: FIN6TR @FI6BBS.#MUS.FIN.EU!

73, Timo.

/ex

 

Valinta '-tb' toimii pelkästään käännettäessä, mutta ei tehtäessä korjaustiedostoja tai virheraportteja. Tiedoston format.def @@top ja @@bottom kohtiin voidaan sijoittaa enintään 256 merkkiä.

Jos lisäät valinnan '-j' luodut osat kirjoitetaan samaan tiedostoon.

Käyttämällä yhdessä '-j' ja '-tb' valintoja voit siis tehdä tiedoston, joka on valmis lähetettäväksi.

 

Korjaustiedoston kääntö

7plus testi.err c:\pr\

7plus kääntää korjaustiedoston 'testi.cor'.

7plus etsii alkuperäistä tiedostoa 'testi.txt' hakemistosta 'c:\pr\'.

Jos mitään etsintäpolkua eli hakemistoa ei mainita 7plus etsii tiedostoa 'testi.txt' hakemistosta, jossa komento annettiin.

'testi.txt'-tiedoston lähettäneen henkilön ei tarvitse säilyttää käännettyjä tiedostoja (testi.7pl tai testi.pxx), koska niitä ei tarvita korjaustiedoston kääntämiseen. Ainut, joka hänen tulee säilyttää on alkuperäinen kääntämätön tiedosto 'testi.txt'!

Ilman sitä korjaustiedostoja ei voida kääntää. Hänen tulisi myös muistaa kuinka hän pilkkoi 'testi.txt' tiedoston, jotta hän pystyy kääntämään kokonaiset osat uudelleen, jos sattuu että ne ovat kadonneet matkalla kokonaan.

7plus pilkkoo erittäin isot korjaustiedostot automaattisesti noin 10 kt kokoisiin tiedostoihin. Kokoa jolloin 7plus alkaa pilkkomaan voidaan muuttaa '-sb' valinnalla. Ks. 'Kääntö'.

 

Korjaaminen

7plus testi.cor

7plus käyttää korjaustiedostoa 'testi.cor' täyttääkseen aukot 'testi.7mf' metatiedostossa. Jos kaikkia aukkoja ei pystytty täyttämään 7plus luo uuden virheraportin. Tämä tulee kyseeseen, jos korjaustiedosto ei täytä kaikkia aukkoja tai tarvittavia aukkoja. Uusi virheraportti tulee lähettää tiedoston lähettäneelle henkilölle ja pyytää uutta korjaustiedostoa. Jos 7plus löytää lisäksi muita korjaustiedostoja (testi.c01, testi.c02 jne.) samasta hakemistosta missä 'testi.cor' tiedosto on, käyttää se niitä automaattisesti.

7plus testi.p03 -c

7plus sallii myös tavallisen 7plus tiedoston käytön korjaustiedostona. Se ottaa tarvittavat rivit tiedostosta 'testi.p03' ja täyttää metatiedoston aukot. Jos aukkoja jää niin 7plus luo uuden virheraportin juuri kuten edellisessä esimerkissä mainittiin.

7plus testi.7mf -c

7plus etsii tarvittavat 7plus tiedostot (testi.pxx) ja käyttää niitä metatiedoston korjaukseen. Verrattuna edelliseen esimerkkiin, 7plus etsii kaikki tarvittavat 7plus tiedostot ja käyttää niitä korjauksen tekoon.

7plus testi

Automaattinen tila:

Automaattista tilaa voidaan käyttää myös tässä tapauksessa. 7plus etsii tiedostot, joita se tarvitsee ja käyttää niitä. (Olkoon kyseessä korjaustiedostot tai 7plus tiedostot, joita voidaan käyttää korjauksen tekoon.)

 

Virheraporttien yhdistäminen

Virheraporttien yhdistäminen on käytännöllistä silloin, kun tiedoston lähettäjä on vastaanottanut useamman, kuin yhden virheraportin. Hän voi käyttää yhdistettyä virheraporttia luodakseen kootun korjaustiedoston, joka sisältää kaikki rivit, jotka ilmoitettiin virheellisiksi. Jos kaikki virheraportit ovat samoja yhdistäminen ei tietenkään ole tarpeellista.

7plus testi.err testi2.err -j

7plus yhdistää virheraportit 'testi.err' ja 'testi2.err'.

7plus testi.err -j

7plus yhdistää automaattisesti kaikki virheraportit, jotka luotiin purkaessa '-x' valinnalla. 7plus etsii tiedostoja 'testi.e01', 'testi.e02' jne.

 

Uuden virheraportin luonti metatiedostosta

Siinä tapauksessa, että virheraportti katoaa tai, jos haluat lähettää sen uudelleen (koska ensimmäiseen ei vastattu) voidaan se luoda uudelleen metatiedostosta.

7plus testi.7mf

7plus lukee index tiedot metatiedoston lopusta ja käyttää sitä luodakseen virheraportin 'testi.err'.

 

Tarkempia ohjeita
Tarkemmat ohjeet 7plus.exe:n käyttöön löydät englanninkielisestä manuaalista (v2.10).
Kehityksen sekä muutokset kyseisen version jälkeen löydät 7pl_hist.nts tiedostosta.

Yllä olevan tekstin lähteenä on käytetty 7plus v2.10:n manuaalia. (© DG1BBQ)
Suomennos: © FIN6TR

 

7plus versio 2.21

DOS versio
Paikallinen tiedosto: 7pl221ei.zip, koko 38 kt
ftp.funet.fi: 7pl221ei.zip

Win32 versio
Paikallinen tiedosto: 7pl221en.zip, koko 48 kt
ftp.funet.fi: 7pl221en.zip

 

Takaisin pääsivulle

© 2004-2006 FIN6TR