Handleiding Re-Set Psion Series 3x Joop Nijenhuis 20 februari 2002 Inhoudsopgave 1 Inleiding 1.1 Algemeen 1.2 Dank 1.3 Registratie 1.4 Licentie voorwaarden 2 Voorbereiding 2.1 Voorbehoud en advies 2.2 Installeren 3 Werking van het programma 3.1 ReSetRun 3.2 Exit 4 C-SCRIPT 4.1 Documentatie 4.2 Standaard opstartscherm 4.3 Presentatie 4.4 Registratie herkenning 4.5 Bestandsnaam 5 Opdrachten 5.1 Cursor bediening 5.2 Archief 5.3 Disk 5.4 Apps 5.5 Info 5.6 Instellingen 5.7 Speciaal 5.8 Diamond 5.9 Extra 1 Inleiding 1.1 Algemeen Het kan voorkomen dat de Psion gereset moet worden of dat de Psion zich "spontaan" reset. Het gevolg van deze reset is dat de Psion zijn instellingen kwijt is. Alle instellingen, applicaties, groepen en lijsten zullen dan handmatig opnieuw moeten worden opgegeven. Dat kan een tijdrovende klus zijn en verder moet er ergens genoteerd zijn hoe de Psion was ingesteld en ingericht. Re-Set kan nu behulpzaam zijn en veel binnen korte tijd opnieuw instellen en installeren. Dit is de belangrijkste taak van Re-Set Re-Set kan echter meer, op dit moment wordt er nog gewerkt aan de nodige uitbreidingen. Het is alleen op dit moment niet mogelijk aan te geven welke richting dat kan uitgaan, veel hangt af van de schaars verkrijgbare documentatie en soms andere inzichten en idee‰n. Er wordt gewerkt aan een on- line help, een macro-achtige faciliteit en nog verdere uitbreiding van Re-Set zelf. Op dit moment zal Re-Set alleen werken op Nederlandstalige, Belgisch- Vlaamse en Engelstalige machines. Andere talen kunnen worden toegevoegd, maar daarvoor is inzicht in de menu's en de verkorte toetscodes noodzakelijk. Deze belangrijke informatie is helaas niet in mijn bezit. Door toedoen van Psion is het niet meer mogelijk om een uitgebreide programmeerhandleiding aan te schaffen. Dit heeft verregaande consequenties voor enkele zeer ingewikkelde en diepgaande opdrachten die mogelijk nu niet meer geimplementeerd kunnen worden. 1.2 Dank Re-Set werd ontwikkeld voor eigen gebruik om met behulp van de emulator snel in te kunnen spelen op de vele vragen die mij bereiken via de vraagbaak van de Psion Gebruikersvereniging Nederland. Voor de ontwikkeling heb ik dankbaar gebruik gemaakt van 'gereedschappen', opmerkingen en aanwijzingen van vele auteurs. Helaas is het niet meer mogelijk om iedereen bij de naam te noemen daar de ontwikkeling van dit programma veel tijd heeft gekost en enkele bronnen enorm van omvang zijn. 1.3 Registratie U mag het programma in de huidige vorm gebruiken, kopi‰ren en verspreiden. Na registratie ontvangt u een sleutelcode. Voor het gebruik van de sleutelcode verwijs ik u naar het betreffende hoofdstuk waarin de sleutelcode wordt behandeld. De registratie is gratis. Updates kunnen via email worden toegezonden, uw email adres is dan van belang, of worden opgehaald via het netwerk van BBS'en en internetsites. De beschikbaarheid op de laatste twee genoemde media kan echter niet gegarandeerd worden. In een apart bestand treft u een registratie formulier aan dat u ingevuld naar onderstaand adres moet opsturen. Uw gegevens op dit formulier moeten precies eender zijn aan de eigenaar gegevens, vanuit het hoofdmenu

, anders werkt de sleutelcode niet correct en heeft u geen toegang tot het gebruik van de uitgebreide functies van Re-Set. Uw gegevens worden in een bestand opgeslagen en alleen gebruikt voor de Re-Set utilities. Adres email joop.nijenhuis@hccnet.nl 1.4 Licentie voorwaarden De niet geregistreerde versie mag in de huidige vorm worden gebruikt en gekopieerd. Het bestand RE-SETxx.ZIP mag in ongewijzigde vorm worden verspreid en weggegeven. Geregistreerde versies van Re-Set zijn persoonsgebonden en mogen niet worden verspreid. Geregistreerde versies van Re-Set mogen worden gebruikt op alle Series 3x modellen of emulatoren zolang deze de eigenaargegevens bevatten van de bij registratie opgegeven persoonsgegevens. Registratie geeft u het recht op het gebruik van de Re-Set utilities voor de geldende versie. De Re-Set utilities worden in strikte zin niet uw eigendom, u mag het programma dus niet decoderen, reverse engineren, wijzigen, e.d. Het auteursrecht blijft bij de auteur van de in de Re-Set utilities aangeboden software, de sourcecode wordt niet vrijgegeven. Alle rechten voorbehouden. Het gebruik van Re-Set is voor eigen rekening en risico. De auteur aanvaardt geen enkele aansprakelijkheid voor enige schade welke is veroorzaakt door direkt of indirekt gebruik van Re-Set. 2 Voorbereiding 2.1 Voorbehoud en advies Het programma Re-Set is gedurende de ontwikkeling uitgebreid getest. Ondanks die uitgebreide test kan er altijd iets fout gaan. Daarom is het aan te raden om bij het eerste gebruik of bij het gebruik van een ander of gewijzigd C- SCRIPT (C-SCRIPT wordt later verklaard) het volgende advies op te volgen. Maak een backup van de interne disk en de aanwezige SSD's in uw Psion! Het gebruik van Re-Set is voor eigen rekening en risico. De auteur aanvaardt geen enkele aansprakelijkheid voor enige schade welke is veroorzaakt door direkt of indirekt gebruik van Re-Set. 2.2 Installatie De installatie van Re-Set is uiterst simpel. Alle bestanden van Re-Set zijn verpakt in het bestand RE-SET12.ZIP. Het getal geeft de versie aan, in dit geval dus versie 1.2. Het bestand RE-SET12.ZIP moet eerst worden uitgepakt. Er zijn veel programma's beschikbaar die ZIP bestanden kunnen uitpakken. De programma onderdelen moeten in de volgende directories worden gekopieerd; RE-SET.OPO \OPO\ *.CFG \OPD\ C-SCRIPT.ALS \APP\ RESETRUN.OPA \APP\ (nog niet beschikbaar) EXIT.OPA \APP\ RE-SET.PIC \PIC\ RE-SET1.WRD \WRD\ RE-SET2.WRD \WRD\ RE-SET.TXT \WRD\ REGISTER.WRD \WRD\ REGISTER.TXT \WRD\ LEESMIJ.TXT \WRD\ EXIT.OPA \APP\ Vervolgens zijn er twee applicaties die op de gebruikelijke wijze als applicatie in het systeemscherm ge‹nstalleerd kunnen worden: Kies en druk op . Kies het programma C-SCRIPT.ALS op de schijf waarnaar u het programma gekopieerd heeft, kies de positie in het scherm en druk op . U kunt nu vanuit het Systeem-scherm een nieuw bestand met uw script beginnen door op te drukken. Kies en druk op . Kies het programma EXIT.OPA op de schijf waarnaar u het programma gekopieerd heeft, kies de positie in het scherm en druk op . Het programma EXIT.OPA is speciaal ontworpen voor gebruik met de emulator van de Series 3x. Om de emulator van de Series 3x te be‰indigen moet er een bepaalde combinatie van toetsen worden ingedrukt. Afhankelijk van het type toetsenbord en het gebruikte OS kan dit enige problemen geven omdat toetsen ver uiteen op het toetsenbord voorkomen. Het programma EXIT.OPA geeft nu uitkomst. De enige werking die dit programma heeft is het be‰indigen van de emulator Series 3x. Het programma test tijdens de werking op welk systeem het is opgestart, mocht dit per abuis een echte Psion zijn, dan be‰indigd het programma zonder iets te doen. 3 Werking van het programma Nadat om de een of andere reden de Psion 3x is gereset heeft u het probleem dat alle instellingen weg zijn. Start de Psion opnieuw, desnoods via de meest rigoreuze methode van de algehele reset of door het verwijderen van alle batterijen. Uiteraard moet u natuurlijk wel een recente backup hebben. Indien die niet aanwezig is kunt u alleen een soft-reset uitvoeren, zie de handleiding van de Psion. Een zogenaamde harde reset of het verwijderen van alle batterijen zal alle programma's, gegevens en instellingen verwijderen. Zet eventueel de backup terug, zie hiervoor de handleiding. Zorg er daarna voor dat de module RUNOPL uit de standaard installaties op het scherm wordt ge‹nstalleerd. Start Re-Set. Al naar gelang de naam van het script gaat of Re- Set automatisch aan het werk of u moet eerst een script uitkiezen uit een lijst met scripts. Het programma zal het script lezen en de daarin opgenomen opdrachten ‚‚n voor ‚‚n uitvoeren. Nadat alle opdrachten zijn uitgevoerd verwijderd Re-Set zich uit het geheugen en heeft u uw van te voren geschreven opzet op de Psion staan. Het schrijven van een script wordt uitvoerig behandelt. Daarna worden alle mogelijke opdrachten besproken. Opdrachten met aan het einde een (*) zijn alleen beschikbaar voor geregistreerde versies. De toevoeging (*) is dus geen onderdeel van de opdracht. De opdrachten zijn zowel in het Nederlands als in het Engels op te geven. De Engelse taal is opgenomen omdat veel machines in Nederland Engelstalig zijn. In deze handleiding wordt de Nederlandstalige machine als voorbeeld aangehouden. Echter met de kennis van hoe de opdrachten werken kunnen de Engelstalige machine specifieke codes worden toegepast. Ter voorbeeld. Op een Nederlandstalige machine bestaan er opdrachten die "aan" of "uit" gezet kunnen worden, bij een Engelstalige machine is dat "on" en "off". Afhankelijk van de positie van "on" en "off" moet er dan voor een bepaalde keuze tweemaal een "O" worden gegeven om die keuze op "on" of "off" te zetten. Andere talen zijn op verzoek eventueel implementeerbaar op de voorwaarde dat ik ook precies weet hoe de toetsen en verkorte Psion codes zijn gerangschikt c.q. werken. Verder zijn er andere programma's die ongeveer eenzelfde werking hebben. Er is gepoogt om zoveel mogelijk de scripts van deze programma's te kunnen lezen. Op een aantal punten wijkt dit af. 3.1 ReSetRun (nog niet beschikbaar) Re-Set kan alleen gedraaid worden als RunOpl is ge‹nstalleerd. In veel gevallen is dat niet wenselijk daar waar het gaat om een applicatie. ReSetRun is een OPA en kan met een eigen ikoon op het scherm worden gezet gelijk andere applicaties. Op dit moment is de werking van ReSetRun nog bijna identiek aan Re-Set. De enige verschillen op dit moment zijn dat Re-Set ook werkt met C- SCRIPTS van uit de root, dus vanuit bijvoorbeeld drive M (I) en vanuit willekeurig welke OPD directory. ReSetRun werkt alleen met C-SCRIPTS vanuit de OPD directory en niet vanuit de root van een schijf. Het doel van ReSetRun is een runtime versie van Re-Set die het mogelijk maakt eerder opgestarte configuraties te herprogrammeren in een andere indien gewenst. Zo kan met ReSetRun snel een groep worden verwijderd en een andere groep worden toegevoegd of kan het hele systeem bijvoorbeeld omgezet worden naar een die meer geschikt is voor het programmeren onder OPL. Het is de bedoeling dat de functionaliteit van ReSetRun nog verder wordt uitgebreid, maar het is nog onzeker hoe, een en ander hangt sterk af van de beschikbare documentatie en tijd. 3.2 Exit Exit is een zelfstandig programma welke onafhankelijk van Re-Set gedraaid kan worden. Exit moet in de \APP\ directory worden gekopieerd, en kan daarna worden ge‹nstalleerd. Dit gaat als volgt; Kies en druk op . Kies het programma EXIT.OPA op de schijf waarnaar u het programma gekopieerd heeft, kies de positie in het scherm en druk op . Het programma EXIT.OPA is speciaal ontworpen voor gebruik met de emulator van de Series 3x. Om de emulator van de Series 3x te be‰indigen moet er een bepaalde combinatie van toetsen worden ingedrukt. Afhankelijk van het type toetsenbord en het gebruikte OS kan dit enige problemen geven omdat toetsen ver uiteen op het toetsenbord voorkomen of niet de gewenste code genereren. Het programma EXIT.OPA geeft nu uitkomst. De enige werking die dit programma heeft is het be‰indigen van de emulator Series 3x. Het programma test tijdens de werking op welk systeem het is opgestart, mocht dit per abuis een echte Psion zijn, dan be‰indigd het programma zonder iets te doen. Het programma is ook getest in de Sienna emulator. Met deze emulator is iets speciaals aan de hand. Bij het testen van Exit is gebleken dat de standaard toetscode om via het toetsenbord het programma te be‰indigen niet werkt. Alleen met het programma Exit blijkt deze emulator tot andere gedachte te brengen! Exit is ook aangepast aan het schermformaat van de Sienna. De detectie van dit scherm gaat volautomatisch, daar behoeft u dus niets voor te doen. 4.0 C-script Het programma RE-SET kan alleen maar goed werken met een configuratie script of te wel een C-SCRIPT. Dit C-SCRIPT verteld RE-SET wat het moet gaan doen. RE-SET opstarten zonder C-SCRIPT heeft dus geen zin en kan zelfs niet. Er moet dus een C-SCRIPT geschreven worden. Dit hoofdstuk geeft uitleg hoe u dat kunt doen en welke effecten mogelijk zijn. Uiteindelijk is het uw fantasie die de vorm aan het C-SCRIPT zal gaan geven. Voor het schrijven van een C-SCRIPT kunt u C-SCRIPT.ALS installeren. Na installatie kunt u het programma opstarten. Bij het bewaren/wegschrijven van het C-SCRIPT wordt deze direkt in de juiste directory weggeschreven. Onder het ikoon kunt u zien welke C-SCRIPTS al gemaakt zijn. 4.1 Documentatie Wat u ook doet met uw script, documenteer het goed. Een goed gedocumenteerd C- SCRIPT is na jaren ook nog steeds begrijpbaar. Zet dus in het C-SCRIPT waarom u iets laat verdwijnen en waarom u een bepaalde instelling wenst, waarom een bepaalde groep installeren en waarom juist op die plaats, enz. In RE-SET is speciaal voor deze doelstelling meerdere manieren van het maken van een opmerking of remark ingeprogrammeerd. In RE-SET2.WRD kunt u lezen welke. Maak dus ook gebruik van de verschillende vormen. Voorbeeld REM Opstart C-SCRIPT voor de emulator Series 3a op mijn pc REM C-SCRIPT versie 1.1, 4-12-00 door uw naam REM Reden van herziening; REM nieuwe opzet REM emulator zo laten opstarten dat deze dezelfde opzet heeft als mijn Psion REM Series 3a REM Voorbeeld ' Zet de geheugen status balk onder in het scherm STATUSBAR ' Instellen op het kleinste standaard font, want dan past alles op het scherm. ZOOM- ZOOM- 4.2 Standaard opstartscherm Een ander heel vervelend probleem is dat nergens staat genoteerd hoe uw machine eruit ziet na een reset. Dit standaard opstartscherm staat voor enkele machines hieronder weergegeven, mocht u een Psion hebben met een afwijkende start indeling dan verneem ik dat graag van u. Deze informatie is nodig voor het schrijven van een "goed" C-SCRIPT. De applicaties staan hier per machine type onder elkaar, in werkelijkheid staan ze naast elkaar. Psion Series 3a Psion Siena (engelse versie) Data Data Word Word Agenda Agenda Time Time World World Calc Calc Sheet Sheet Record Program Program RunOpl (niet standaard ge‹nstalleerd) RunOpl RunImg (niet standaard ge‹nstalleerd) RunImg Psion Series 3c Psion Series 3mx NL Data Data Word Word Agenda Agenda Time Time World World Calc Calc Sheet Sheet Jotter Jotter Spell (alleen Engelstalige machines) Patience Patience Files Files Sound Sound Program Program RunOpl RunOpl (naam op het scherm Rtinstal) RunImg (niet standaard ge‹nstalleerd) RunImg (niet standaard ge‹nstalleerd) Comms (niet standaard ge‹nstalleerd) Comms (niet standaard ge‹nstalleerd) Script (niet standaard ge‹nstalleerd) Script (niet standaard ge‹nstalleerd) 4.3 Presentatie Het C-SCRIPT begint meestal met de keuze wat u van het C-SCRIPT wenst te zien. Wilt u op het scherm een lijst met opdrachten zien, of een plaatje, of een voortgangsbalkje of het systeemscherm, of een mix? Deze mogelijkheden zijn allemaal aanwezig. Hieronder enkele voorbeelden. Voorbeeld 1 REM Dit voorbeeld laat zien hoe u een lijst van opdrachten op het scherm REM krijgt. Naarmate de vordering van het C-SCRIPT zal deze over het scherm REM gaan lopen, d.w.z. onderaan worden nieuw gelezen opdrachten toegevoegd en REM bovenaan verdwijnen oude afgehandelde opdrachten uit het zicht. REM Deze opzet is goed te gebruiken voor het debuggen van een C-SCRIPT. REM Voor de duidelijkheid blijven de vier regels bij elk voorbeeld staan zodat REM goed te zien is welke opdracht wat gaat doen. ECHO ON rem GAVOOR rem SHOWPIC M:\PIC\RE-SET.PIC rem GAACHTER Voorbeeld 2 REM Doet precies hetzelfde als het voorbeeld (1) hierboven. ECHO ON GAVOOR rem SHOWPIC M:\PIC\RE-SET.PIC rem GAACHTER Voorbeeld 3 REM Dit voorbeeld laat ondanks de opdracht "ECHO ON" het systeemscherm zien. REM U ziet REM dus menu's aangeroepen worden, applicaties verdwijnen of REM worden juist ge‹nstalleerd. Het scherm laat alles direkt zien. ECHO ON rem GAVOOR rem SHOWPIC M:\PIC\RE-SET.PIC GAACHTER Voorbeeld 4 REM Dit voorbeeld brengt het systeem scherm naar voren, doet hetzelfde als REM voorbeeld 3. ECHO OFF rem GAVOOR rem SHOWPIC M:\PIC\RE-SET.PIC GAACHTER Voorbeeld 5 REM Dit voorbeeld laat een PIC-plaatje op het scherm zien. Links onderaan kunt REM u de vordering van het programma zien. ECHO OFF GAVOOR SHOWPIC M:\PIC\RE-SET.PIC rem GAACHTER Voorbeeld 6 REM Dit voorbeeld laat een vorderings/voortgangsbalk op het scherm zien. REM Links onderaan kunt u de vordering van het programma zien. ECHO OFF rem GAVOOR rem SHOWPIC M:\PIC\RE-SET.PIC rem GAACHTER Voorbeeld 7 REM Dit voorbeeld doet hetzelfde als voorbeeld 6. ECHO OFF GAVOOR rem SHOWPIC M:\PIC\RE-SET.PIC rem GAACHTER Het is ook mogelijk bovenstaande zaken in een C-SCRIPT te combineren, halverwege kan er overgeschakeld worden naar een andere opzet, ander plaatje enz. De vorderings/voortgangsbalk is alleen zichtbaar als er geen plaatje met SHOWPIC is gedeclareerd en er dan sprake is van een "leeg scherm". 4.4 Registratie herkenning De volgende reeks opdrachten zijn noodzakelijk. Met deze opdrachten kan RE-SET zien of u wel of niet bent geregistreerd. Zonder deze opdrachten is de werking van RE-SET beperkt en kunt u alleen globaal zien wat RE-SET precies doet. Voorbeeld OWNER Naam:~voornaam~achternaam Tel.:~nummer Adres:~straat~huisnummer enz. REGISTER registratiecode Achter "OWNER" kunt u vier blokken tekst kwijt. Normaal zijn dit uw adres gegevens, maar iets anders kan ook. De "~" zijn nodig om ervoor te zorgen dat RE-SET het blok tekst ook als een blok tekst herkent en niet als afzonderlijke opdrachten. De gevens die bij "OWNER" of "EIGENAAR" worden ingevuld zijn van belang voor de registratiecode. Bij registreren moet u dus exact opgeven wat u bij "EIGENAAR" of "OWNER" in gaat vullen. Een spatie meer of minder maakt al uit. Deze twee regels deblokkeren veel afgeschermde opdrachten. Het is dus zaak deze twee regels zo hoog/bovenaan mogelijk in het C-SCRIPT op te nemen. Het voorgaande voorbeeld van presentatie wordt niet be‹nvloedt door deze twee regels en kunnen dus nog hiervoor worden opgenomen. Het C-SCRIPT kan er nu als volgt uitzien; Voorbeeld REM Opstart C-SCRIPT voor de emulator Series 3a op mijn pc REM C-SCRIPT versie 1.1, 4-12-00 door uw naam REM Reden van herziening; REM nieuwe opzet REM emulator zo laten opstarten dat deze dezelfde opzet heeft als mijn Psion REM Series 3a REM REM Dit voorbeeld doet hetzelfde als voorbeeld 6. ECHO OFF GAVOOR rem SHOWPIC M:\PIC\RE-SET.PIC rem GAACHTER OWNER Naam:~voornaam~achternaam Tel.:~nummer Adres:~straat~huisnummer enz. REGISTER registratiecode ' Zet de geheugen status balk onder in het scherm STATUSBAR ' Instellen op het kleinste standaard font, want dan past alles op het scherm. ZOOM- ZOOM- REM nog veel meer opdrachten kunnen hier worden geplaatst. REM REM een lege regel zoals hierboven kan een C-SCRIPT veel leesbaarder maken REM REM een goede gewoonte is ook om het C-SCRIPT af te sluiten zoals hieronder REM Einde opstart C-SCRIPT In bovenstaande voorbeeld kunt u op de aangegeven plaats verder gaan met het geven van opdrachten. Er zijn enkele voorbeelden toegevoegd. Belangrijk in het verhaal is dat het schrijven van een goed C-SCRIPT een planning vergt, wat gaat weg en wat komt terug en waar. Een C-SCRIPT start dus in principe op papier, of als u alles in de Psion wenst te houden, in Word als tekst document. Hier gaat u beschrijven waar wat komt. Eventueel kunt u dat rechtstreeks doen in een C-SCRIPT. 4.5 Bestandsnaam De C-SCRIPTS worden opgeslagen in de directory \OPD en hebben als extensie ".CFG". Normaal worden de C-SCRIPTS op de interne schijf bewaard, maar op schijf A of B kan ook, zolang het maar in de directory staat met de naam \OPD. Op de interne schijf is er dan nog een uitzondering. Het C-SCRIPT mag ook in de root van de schijf worden geplaats, dus in "M:\", maar dan met een speciale naam. Als op de interne schijf in de directory \OPD of in de root het bestand de naam SYS$INST.CFG staat wordt deze direkt na het opstarten van RE-SET uitgevoerd. U krijgt geen keuzescherm voor het kiezen van een C-SCRIPT. Ook wordt het C-SCRIPT met de naam SYS$INST.CFG niet onder het ikoon van C- SCRIPT geplaatst, het is voor het bestandssysteem onzichtbaar. Deze automatische opstart voorziening kan prima werken als u slechts met een C- SCRIPT werkt, bijvoorbeeld op de Psion zelf, maar voor de emulator is het wellicht handiger om een keuze te hebben. Vanzelfsprekend moet een C-SCRIPT met de naam SYS$INST.CFG vlekkeloos lopen. 5.0 Opdrachten De opdrachten zijn te vinden in het bestand RE-SET2.WRD. 5.0 Opdrachten Toetsen en toetscombinaties worden weergegeven met scherpe haken: betekent bijvoorbeeld dat u de Esc-toets moet indrukken; betekent dat u de Help-toets moet indrukken. Cursief gedrukte tekst bevat belangrijke aanwijzingen. Voorbeelden worden tussen de tekens " gegeven als deze in een tekst zijn opgenomen zoals "HOME". Opdrachten die in het programma ingebouwd zijn zullen in hoofdletters worden geschreven. Als er van een opdracht meerdere sleutelwoorden beschikbaar zijn staan deze in de handleiding direkt onder elkaar, de opdrachten hebben dan een zelfde uitwerking om het even welk van de sleutelwoorden wordt gebruikt. Voor alle opdrachten geldt dat een goede kennis van de handleiding en het gebruik van uw Psion noodzakelijk is. Hierna volgen de tot en met de huidige versie ingebouwde opdrachten. Deze opdrachten kunnen bestaan uit een enkel woord zoals "HOME" of " BACKLIGHT", uit een enkel teken zoals ";" of "*" en uit meer gecompliceerde opdrachten zoals "PRINTERCFG~S~19200~8~1~G~N~U~A~U~A~C~1~A" of "IN~UTILS.GRP~I~L". Merk op dat in de laatste twee opdrachten het teken "~" voorkomt. Deze tekens moeten in de echte opdracht of script vervangen worden door spaties en dienen voor het scheiden van de bij de opdracht horende variabelen en de variabelen onderling. 5.1 Cursor bediening HOME Hiermee gaat u naar het hoofdscherm en naar het eerste ikoon/toepassing LINKS LEFT Hiermee gaat de cursor een ikoon naar links RECHTS RIGHT Hiermee gaat de cursor een ikoon naar rechts EINDE END Hiermee gaat u naar het hoofdscherm en naar het laatste ikoon-toepassing NAARBOVEN UP Hiermee gaat de cursor een regel naar boven NAARBENEDEN DOWN Hiermee gaat de cursor een regel naar beneden SELECTEER SELECT Hiermee selecteert u wat onder of waarop de cursor staat 5.2 Archief KOPIEERBESTAND~bron~bestemming (*) FILECOPY~bron~bestemming (*) Met deze opdracht kunnen complexe kopieeropdrachten worden uitgevoerd. De opdracht kopieert de bron, ongeacht het(de) type bestand(en), naar de bestemming. Indien de bestemming al bestaat wordt deze verwijderd en overschreven. Met deze opdracht kan er ook van de ene schijf naar de andere gekopieerd worden. Geef het juiste bestandstype aan met behulp van de bestandsextensie. Eventueel kunnen er jokertekens worden opgenomen om meerdere bestanden tegelijk te kopi‰ren. Als in de bron jokertekens staan mag de bestemming alleen een schijfaanduiding en directories en geen bestandsnaam bevatten. Bij de bron moet u een extensie of een .* opgeven. Zie voor bestandsextensies de gebruikershandleiding van uw Psion. De bestemming moet bij het gebruik van jokertekens afgesloten worden met een backslash, het teken "\". Voorbeeld KOPIEERBESTAND~M:\*.*~B:\BACKUP\ Met de opdracht wordt alleen de opgegeven bron gekopieerd, de opdracht "M:\*.*" kopieert alle bestanden uit de root van schijf M:, maar geen directories. Alle bestanden in de bestemming worden zonder waarschuwing overschreven door bestanden uit de bron als deze dezelfde tenaamstelling hebben. VERWIJDERBESTAND~bestand (*) FILEDELETE~bestand (*) Deze opdracht verwijdert een bestand, ongeacht het bestandstype. Het gebruik van jokertekens is toegestaan. Er wordt vooraf geen waarschuwing gegeven als deze opdracht wordt uitgevoerd noch een foutboodschap als het niet goed gegaan is. HERNOEM~oud~nieuw (*) RENAME~oud~nieuw (*) Deze opdracht wijzigt de naam van een bestand van "oud" in "nieuw". De namen moeten bestandsnamen zijn al dan niet in combinatie met een directory. Het gebruik van jokertekens is niet toegestaan. Met deze opdracht kunnen bestanden ook verplaatst worden mits dit op dezelfde disk/schijf gebeurt. 5.3 Disk MAAKDIR~directory (*) MAKEDIR~directory (*) Deze opdracht maakt een nieuwe directory. Voorbeeld MAAKDIR~M:\ARCHIEF\SPR Bovenstaande opdracht maakt de directory M:\ARCHIEF\SPR en cre‰ert daarbij ook de directory M:\ARCHIEF als deze nog niet bestond. VERWDIR~directory (*) REMDIR~directory (*) Deze opdracht verwijderd een directory mits deze directory geen bestanden bevat. STANDAARDDISK~station (*) DEFAULTDISK~station (*) Deze opdracht wijzigt de voorkeur van opslag van bestanden op een bepaalde schijf/disk. Alle bestands-geori‰nteerde opties zullen na deze opdracht de opgedragen voorkeur aanhouden. Standaard staat de voorkeur op de interne schijf/disk. Station moet worden vervangen door een van de volgende letters; A=SSD in slot A I=Interne disk B=SSD in slot B Het is niet mogelijk om in een emulator andere schijven/disks te kiezen dan de hierboven genoemde, ook niet als deze via de DOS-opdracht SUBST een letter zijn toegekend. 5.4 Apps IN~bestandsnaam.extensie~station~positie (*) Installeert het applicatie-ikoon op de aangegeven positie. In werkelijkheid wordt het opgegeven bestand uit de opgegeven disk ge‹nstalleerd. Het teken "~" moet vervangen worden door een spatie. Bestandsnaam.extensie moet worden vervangen door de te installeren volledige bestandsnaam van de applicatie. Er mag geen pad worden opgegeven en alle te installeren programma's moeten in de directory \APP\ staan. Deze directory mag op alle stations voorkomen. Station moet worden vervangen door een van de volgende letters; I=Interne disk A=SSD in slot A B=SSD in slot B C=Applicaties in de 3-Link kabel *=Andere disks in de emulator Positie moet worden vervangen door een van de volgende letters; H=Huidige (cursor)positie E=Eerste positie L=Laatste positie Voorbeelden IN~MONEY.APP~I~H De applicatie Money wordt vanuit de Interne disk op de huidige positie ge‹nstalleerd. Op die plaats verschijnt dus het bij Money.app behorende ikoon. IN~UTILS.GRP~I~L De groep met alle utilities wordt vanuit de Interne disk op de laatste positie ge‹nstalleerd. Op deze plaats verschijnt dus de bij de Utils.grp horende ikoon. JN~applicatie~positie Installeert een standaard applicatie-ikoon op de aangegeven positie. Het teken "~" moet vervangen worden door een spatie. Applicatie moet worden vervangen door de te installeren applicatie. Positie moet worden vervangen door de volgende letters; H=Huidige (cursor)positie E=Eerste positie L=Laatste positie Voorbeeld JN~SHEET~H De applicatie Sheet wordt op de huidige positie ge‹nstalleerd. Op die plaats verschijnt dus het bij Sheet behorende ikoon. VERWIJDER REMOVE Verwijdert de op de cursorplaats aanwezige applicatie van het scherm. KNOP~knop~combinatie (*) KEY~knop~combinatie (*) Het is mogelijk om aan vaak gebruikte applicaties een knop toe te kennen zodat er via deze knop een verkorte methode ontstaat voor het omschakelen naar de applicatie. Om een knop aan een applicatie toe te kennen moet de cursor op die applicatie staan. Daarna kan dan een knop worden toegekend. Over het algemeen is de eerste letter van de toe te wijzen knop voldoende, dus D van Data of A van Agenda. In de Nederlandstalige machines hebben echter World en Word dezelfde beginletter. Om nu de knop World toe te kennen aan een applicatie moet bij knop tweemaal de letter W worden opgegeven. Voorbeeld KNOP~WW~C In bovenstaand voorbeeld is Control-World toegekend aan een applicatie. De letter in de combinatie is afhankelijk van de taal. De combinatie control is meestal een C maar de combinatie geen is voor Nederlandstalige machines een G en voor Engelstalige machines een N van none. Om de combinatie control+Data toe te kennen aan een applicatie moet het volgende voorbeeld worden gebruikt. Voorbeeld KEY~D~C XSTOP~bevestiging (*) Laat alle geopende applicaties op Time na stoppen. 3-Link wordt niet met deze opdracht uitgeschakeld, dat kan alleen handmatig plaatsvinden. De bevestiging kan taal afhankelijk zijn. Op Nederlandstalige machines zal de bevestiging een "J" zijn en op Engelstalige machines een "Y". Toevallig is de ontkenning bijna altijd een "N", al zal dat bij het toepassen van deze opdracht niet zo vaak voorkomen. Voorbeeld XSTOP~J 5.5 Info EIGENAAR~regel#1~regel#2~ regel#3~regel#4 OWNER~regel#1~regel#2~ regel#3~regel#4 Met deze opdracht kunt u vier regels informatie opgeven welke worden geplaatst in het eigenaar informatie scherm. Elke regel mag maximaal 50 tekens bevatten, echter ongeveer 40 tekens zijn zichtbaar. U kunt kiezen voor een eigen opmaak of gebruik maken van de voorgestelde opmaak met Naam:~, Tel:~, Adres:~ en Woonplaats:~. Bij het gebruik van dergelijke toevoegingen kunt u in verband met de registratie code gebruik maken van ":~" of van ";~". Een eigen opmaak zonder die tekens kan ook, u begint dan direkt op positie 1 van elke regel. Wat u v¢¢r eventueel de combinaties ":~" en ";~" plaatst laat ik aan u over. Dat kan natuurlijk de voorgestelde opmaak zijn, maar iets anders mag ook. De regels worden gescheiden door een spatie, alles wat op ‚‚n regel geschreven moet worden moet aan elkaar worden geschreven. Voor de spaties in een regel gebruik ik even het teken "#" ter verduidelijking, in werkelijkheid moeten deze vervangen worden door het teken "~". Re-Set vervangt deze dan weer voor echte spaties. Het gegeven voorbeeld bevat maar drie regels omdat het anders niet op een regel past. Voorbeeld EIGENAAR~Naam:#Voornaam#Achternaam~Tel:#nummer~Adres:#straat#huisnummer Het is van belang dat u bij het registreren exact opgeeft wat u in deze vier regels gaat plaatsen. Spaties, maar ook een hoofdletter en leestekens zijn van belang. Vult u in een van de vier regels iets anders in dan bij het registreren, dan zal het programma u niet kunnen herkennen als een geregistreerd gebruiker. Veel opdrachten zullen dan niet werken. Het is dus zaak goed na te denken over wat u hier gaat opgeven. Het achteraf wijzigen van gegevens kost echter een nieuwe registratievergoeding, dit ter beveiliging voor het geval uw Psion ontvreemd werd. SYSINFO (*) Deze opdracht laat het copyright-scherm zien. Dit is hetzelfde scherm dat werd getoond toen u uw Series 3x voor de allereerste keer of na een "harde" reset inschakelde. De verwerking van het script vindt op de voorgrond plaats zodat het scherm niet zichtbaar is. Het volgende voorbeeld laat zien hoe het scherm wel zichtbaar wordt. Voorbeeld SYSINFO GAACHTER BEEP~2~150 PAUSE~10 SELECT In het voorbeeld wordt het verdere verloop van het script na de opdracht SYSINFO naar de achtergrond verplaatst met de opdracht GAACHTER. Vervolgens worden er diverse opdrachten in de achtergond, dus niet zichtbaar, uitgevoerd. Aan het einde van het script wordt met SELECT een "Enter" gegeven waarmee de opdracht SYSINFO wordt be‰indigd. 5.6 Instellingen GELUID~geluid~alarmsignalen~pieptonen~toetsenbord (*) SOUND~geluid~alarmsignalen~pieptonen~toetsenbord (*) Na een harde reset zijn standaard alle geluidsopties ingeschakeld. Een situatie die vaak niet gewenst wordt. Met deze opdracht kan van die standaard worden afgeweken. Geluid moet vervangen worden door een van de volgende letters; A=Aan U=Uit, deze optie schakelt de overige keuzes uit. Alarmsignalen moet vervangen worden door een van de volgende letters; A=Aan U=Uit Pieptonen moet vervangen worden door een van de volgende letters; U=Uit Z=Zacht H=Hard Toetsenbord moet vervangen worden door een van de volgende letters; U=Uit Z=Zacht H=Hard PRINTERCFG (*) PRINTER (*) Deze opdracht is ‚‚n van de meest complexe in Re-Set. De uitleg van deze opdracht wordt onderverdeeld naar de keuzemogelijkheden bij printer. De eerste keuze is parallel, de tweede serieel, de derde bestand en de vierde infrarood. Nu eerst dus de uitleg over de keuze parallel. PRINTERCFG~P~eenheden~weergave~marges (*) PRINTER~P~eenheden~weergave~marges (*) De letter "P" geeft aan dat het hier gaat om de instellingen voor verwerking via de parallelle poort. Eenheden moet vervangen worden door een van de volgende letters; I=Inches C=Centimeters Weergave moet vervangen worden door een van de volgende letters; P=Pagina's naast elkaar 1=1 pagina 2=2 pagina's 3=3 pagina's 4=4 pagina's Marges moet vervangen worden door een van de volgende letters; U=Uit A=Aan PRINTERCFG~S~eigenschappen~handshake~eenheden~weergave~marges (*) PRINTER~S~eigenschappen~handshake~eenheden~weergave~marges (*) De letter "S" geeft aan dat het hier gaat om de instellingen voor verwerking via de seri‰le poort. Eigenschappen moet vervangen worden door de volgende opgaven; baudsnelheid~databits~stopbits~pariteit~negeer pariteit Baudsnelheid moet vervangen worden door een getal met een waarde tussen 300 en 115200, afhankelijk van het type Psion en printer. Databits moet vervangen worden door een van de volgende getallen; 5 6 7 8 Stopbits moet worden vervangen door een van de volgende getallen; 1 2 Pariteit moet worden vervangen door een van de volgende letters; G=Geen E=Even O=Oneven Negeer pariteit moet worden vervangen door een van de volgende letters; N=Nee J=Ja Handshake moet vervangen worden door de volgende opgaven; xon/xoff~rts/cts~dsr/dtr~dcd Xon/Xoff moet vervangen worden door een van de letters; U=Uit A=Aan RTS/CTS moet vervangen worden door een van de letters; U=Uit A=Aan DSR/DTR moet vervangen worden door een van de letters; U=Uit A=Aan DCD moet vervangen worden door een van de letters; U=Uit A=Aan Eenheden moet vervangen worden door een van de volgende letters; I=Inches C=Centimeters Weergave moet vervangen worden door een van de volgende letters; P=Pagina's naast elkaar 1=1 pagina 2=2 pagina's 3=3 pagina's 4=4 pagina's Marges moet vervangen worden door een van de volgende letters; U=Uit A=Aan Voorbeeld PRINTERCFG~S~19200~8~1~G~N~U~A~U~A~C~1~A PRINTERCFG~B~bestandsnaam~disk~eenheden~weergave~marges (*) PRINTER~B~bestandsnaam~disk~eenheden~weergave~marges (*) De letter "B" geeft aan dat het hier gaat om de instellingen voor verwerking via een bestand. De "B" zal op Engelstalige machines een "F" (van File) zijn. Bestandsnaam moet vervangen worden door een geldige bestandsnaam. Standaard wordt opgegeven P.lis. De naam mag maximaal acht tekens bevatten en de extensie drie. Voor meer informatie over naamgeving van bestanden verwijs ik naar de gebruikershandleiding van de machine. Disk moet vervangen worden door een van de volgende letters; A=linker SSD-poort I=interne disk B=rechter SSD-poort C=niet bruikbaar, dit is de seri‰le uitbreiding in de kabel. In de emulator worden net zoveel drives opgegeven als driveletters en substituten aanwezig zijn in de computer. Eenheden moet vervangen worden door een van de volgende letters; I=Inches C=Centimeters Weergave moet vervangen worden door een van de volgende letters; P=Pagina's naast elkaar 1=1 pagina 2=2 pagina's 3=3 pagina's 4=4 pagina's Marges moet vervangen worden door een van de volgende letters; U=Uit A=Aan PRINTERCFG~I~eenheden~weergave~marges (*) PRINTER~I~eenheden~weergave~marges (*) De letter "I" geeft aan dat dit de instellingen betreffen voor de Infrarood optie. Deze optie is niet op alle series 3x versies aanwezig. Eenheden moet vervangen worden door een van de volgende letters; I=Inches C=Centimeters Weergave moet vervangen worden door een van de volgende letters; P=Pagina's naast elkaar 1=1 pagina 2=2 pagina's 3=3 pagina's 4=4 pagina's Marges moet vervangen worden door een van de volgende letters; U=Uit A=Aan BACKLIGHT (*) Met deze opdracht kunt u aangeven of uw Psion een backlight functie heeft. Bij de Series 3mx is dit standaard, maar bij de Series 3c zijn er met en zonder deze functie. Deze opdracht moet voor de opdracht AUTOUIT OF AUTOOFF worden gegeven omdat anders deze functie niet correct werkt. AUTOUIT~aut. uitschakelen~uitschakeltijd~aut.uitschakelen backlight~uitschakeltijd (*) AUTOOFF~aut. uitschakelen~uitschakeltijd~aut.uitschakelen backlight~uitschakeltijd (*) Met deze opdracht is het automatisch uitschakelen in te stellen. In bovenstaande regels is de opdracht in zijn maximale omvang gegeven. Deze vorm is alleen geldig als de machine over een backlight beschikt en voor deze opdracht via de opdracht "BACKLIGHT" is aangegeven dat uw Psion over een backlight beschikt. Voor de Series 3a en de Series 3c zonder backlight vervallen de laatste twee parameters. Aut.uitschakelen moet vervangen worden door een van de volgende letters; N=Nee J=Ja A=Alleen bij batterijvoeding Uitschakeltijd moet vervangen worden door een getal met de volgende waarden; 000015=minimum waarde en staat voor 00:00:15=15 seconden 175959=maximum waarde en staat voor 17:59:59=17 uur, 59 minuten en 59 seconden Voorbeeld voor bijvoorbeeld een Series 3c zonder backlight AUTOUIT~A~000500 De volgende opgaven kunnen alleen worden opgegeven bij machines die beschikken over een backlight funktie. Tevens moet de gebruiker via de opdracht "BACKLIGHT" aangeven dat de machine over deze funktie beschikt. De opdracht "BACKLIGHT" moet voor deze opdracht in het script worden geplaatst. Aut.uitschakelen backlight moet vervangen worden door een van de volgende letters; N=Nee J=Ja Uitschakeltijd moet vervangen worden door een getal met de volgende waarden; 000001=minimum waarde en staat voor 00:00:01=1 seconde 001500=maximum waarde en staat voor 00:15:00=0 uur, 15 minuten en 0 seconden BELLEN~buitenlijn~standaard land~toontijd~vertragingstijd~pauzeertijd (*) DIAL~buitenlijn~standaard land~toontijd~vertragingstijd~pauzeertijd (*) Met deze opdracht kunnen de bel-instellingen worden opgegeven. Buitenlijn moet vervangen worden door een reeks van maximaal 5 tekens, bijvoorbeeld 0, Standaard land moet normaal vervangen worden door het land van de woonplaats. Omdat deze tabel zeer veel landen bevat is het raadzaam om eerst handmatig deze tabel te raadplegen om te zien of het land in de tabel voorkomt en zo ja hoe het land dan is gespeld. Bij opgave in het script is het dan raadzaam om de naam van het land volledig op te nemen. De overige drie variabelen bevatten soortgelijke waarden en moeten vervangen worden door een getal. Voorbeeld DIAL~0,~Nederland~6~4~18 WEERGAVE~formaat~decimalen~trigonometrische eenheden (*) EVALUATE~formaat~decimalen~trigonometrische eenheden (*) Formaat moet vervangen worden door een van de volgende letters; B=Bepaald W=Wetenschappelijk A=Algemeen H=Hexadecimaal Merk hierbij op dat de letters machine specifiek zijn. In bijvoorbeeld een Series 3mx Nederlands is de B van Bepaald vervangen door een V van Vast. GETALFORMAAT~scheidingstekens~decimalen (*) NUMBER~scheidingstekens~decimalen (*) De groep scheidingstekens bestaat uit de volgende opdrachten; Decimale komma Scheidingsteken duizendtallen Duizendtallen scheiden Decimale komma moet vervangen worden door een van de volgende letters; P=Punt Komma=K Scheidingsteken duizendtallen moet vervangen worden door een van de volgende letters; P=Punt K=Komma S=Spatie Duizendtallen scheiden moet vervangen worden door een van de volgende letters; N=Nee J=Ja 1=10000 en hoger De groep decimalen bestaat uit de volgende opdrachten; Teken Aantal decimalen Positie Negatieve waarden Teken moet vervangen worden door het te hanteren muntteken. Er zijn hiervoor maximaal 8 posities beschikbaar. Indien geen muntteken is gewenst kan op deze positie het teken # worden ingevuld. Re-Set zal bij de uitvoering van het script het door het systeem gehanteerde teken wissen. Aantal decimalen moet vervangen worden door een getal. De minimale waarde is 1 en de maximale waarde is 15. Positie moet vervangen worden door een van de volgende letters; E=Ervoor E=Ervoor, met met spatie E=Erachter E=Erachter, met met spatie Negatieve waarden moet vervangen worden door een van de volgende letters; M=Minteken T=Tussen haakjes Voorbeeld GETALFORMAAT~K~P~J~Ÿ~2~EE~T Merk hierbij op dat Positie voor alle keuzes dezelfde letter gebruikt.Voor "Erachter, met een spatie" moet dan worden opgegeven "EEE". STATUSVENSTER STATUSVENSTER~type klok~disk-ind.~link-ind.~hoofdbatterijen-ind.~caps lock- ind. (*) STATUSWIN STATUSWIN~type klok~disk-ind.~link-ind.~hoofdbatterijen-ind.~caps lock-ind. (*) Deze opdracht kent twee verschillende schrijfwijzen. Met de schrijfwijze zonder verdere opdrachten kan het statusvenster aan en uit gezet worden of kan het formaat worden gewijzigd. Voorbeeld STATUSVENSTER STATUSVENSTER Deze opdracht wordt zet het statusvenster aangezet en wordt er gekozen voor de smalle weergave. Bij de schrijfwijze met opdrachten moeten die opdrachten door het volgende worden vervangen; Type klok moet vervangen worden door een van de volgende letters; A=Analoog D=Digitaal Disk-indicators moet vervangen worden door een van de volgende letters; N=Nee J=Ja Link-indicator moet vervangen worden door een van de volgende letters; N=Nee J=Ja Hoofdbatterijen-indicator moet vervangen worden door een van de volgende letters; N=Nee J=Ja Caps lock-indicator moet vervangen worden door een van de volgende letters; N=Nee J=Ja Voorbeeld STATUSVENSTER~D~J~J~J~J 5.7 Speciaal VOORKEUREN~lijsten bijwerken~meerdere bestanden openen~lettertype~tips (*) PREFERENCES~lijsten bijwerken~meerdere bestanden openen~lettertype~tips (*) Lijsten bijwerken moet vervangen worden door een van de volgende letters; A=Automatisch S=Systemknop Meerdere bestanden openen moet vervangen worden door een van de volgende letters; S=Shift-Enter E=Enter Lettertype moet vervangen worden door een van de volgende letters; R=Roman S=Swiss Tips is alleen beschikbaar op een Psion series 3c/3mx en moet vervangen worden door een van de volgende letters; N=Nooit 1=1 x per dag A=Altijd Voorbeeld (3a) PREFERENCES~A~E~S Wachtwoord procedure is niet opgenomen in Re-Set. Het zou geen enkel probleem zijn om deze optie in een volgende versie op te nemen. Dat het nu niet in Re- Set is ingebouwd heb ik gedaan om de volgende reden. Stel u had uw Psion beveiligd met een password. Dan nog is het onder bepaalde condities mogelijk om uw Psion binnen te dringen, daarvoor is echter wel kennis van zaken nodig en zal er aan een aantal voorwaarden moeten zijn voldaan. Met een script zou het dan vrij simpel zijn om uw wachtwoord te achterhalen door simpel het script in een tekstverwerker te openen en te lezen. De tweede reden om het niet te doen is de mogelijkheid van het niet meer correct funktioneren van de Psion. Het script kan dan problemen ondervinden bij het uitvoeren van opdrachten en kan zelfs toetscodes bewaren tot een volgend zelfs voor die toetscode niet geldend invoerveld zoals uw password. Uw machine zit dan op slot door een ongelukkig voorval en een harde reset kan dan alleen nog uitkomst bieden. Ik sta echter open voor uw suggesties en beweegredenen. De optie 3-LINK is (nog) niet opgenomen vanwege onvoldoende en onvolledige informatie omdat deze optie sterk machine en taal afhankelijk is. Verder wordt 3-LINK pas geactiveerd op het moment dat 3-LINK nodig is omdat een geactiveerde 3-LINK stroom verbruikt. De optie 3-LINK heet in andere series 3x anders omdat er andere methoden van communicatie zijn toegevoegd. Nieuwe lijsten en nieuwe groepen zijn natuurlijk ook te automatiseren, maar het nut daarvan ontgaat me. Ik sta open voor uw suggesties en beweegredenen. ZOOMIN ZOOM+ Letters van de bestandenlijst groter maken. ZOOMUIT ZOOM- Letters van de bestandenlijst kleiner maken. 5.8 Diamond STATUSBAR Laat onderaan het scherm een balk zien met informatie over het geheugen. Om de informatie na het aanzetten weer te laten verdwijnen moet tweemaal de opdracht worden gegeven. Voorbeeld STATUSBAR STATUSBAR NORMAAL Laat de balk onderaan het scherm met geheugeninformatie verdwijnen. EXTRA Laat onderaan het scherm een balk zien met informatie over het geheugen. Op de 3C emulator geeft deze optie een foutmelding. Dit is geen fout van het programma, maar een bug in de emulator. Zonder dit programma krijg je met het activeren van de geheugenbalk dezelfde fout boodschap. De opdrachten "NORMAAL" en "EXTRA" hebben dezelfde funktie als "STATUSBAR". 5.9 Extra In dit hoofdstuk komen de extra mogelijkheden aan bod die niet via een menu optie bereikbaar zijn. BEVESTIG BEVESTIG~actie~mededeling CONFIRM CONFIRM~actie~mededeling Actie moet vervangen worden door een letter. S=Stop, procedure c.q. verdere verwerking van het C-SCRIPT wordt afgebroken. V=Verder, procedure slaat de opdrachtregel in het C-SCRIPT direkt na de opdracht "CONFIRM" over en gaat verder met de verwerking van de daarop volgende opdracht. G=Go, identiek aan de letter V. Mededeling moet vervangen worden door een boodschap waarop de bevestiging betrekking heeft. Als in de mededeling spaties voorkomen moeten deze vervangen worden door het teken "~" zodat de medeling een blok tekst is. Tijdens verwerking worden de "~"-tekens weer vervangen door spaties. Zonder mededeling wordt het versienummer van Re-Set getoond. Zonder verdere parameters wordt door Re-Set de actie vervangen door de letter "V" en wordt mededeling vervangen door het versienummer van Re-Set. Als "Nee" als antwoord op de dialoog wordt gegeven slaat Re-Set de regel direct volgend op "BEVESTIG" over en gaat vervolgens verder met het nog resterende C-SCRIPT. Voorbeeld CONFIRM V KOPIEERBESTAND M:\*.* B:\BACKUP\ BEEP 2 150 In bovenstaand voorbeeld wordt de dialoog getoond met het versienummer van Re- Set als mededeling. Eveneens is de keuze gemaakt om het C-SCRIPT niet voortijdig af te breken maar om door te gaan met de opdrachten. Als het antwoord "Ja" is wordt de kopieeropdracht uitgevoerd. Als het antwoord "Nee" is wordt de kopieeropdracht overgeslagen en gaat de verwerking verder met de volgende opdracht, in dit voorbeeld is dat het laten horen van een geluidje. Deze optie is ingebouwd om de gebruiker tijdens het uitvoeren van een script te laten kiezen tussen "Ja" en "Nee". Als het antwoord "Nee" is, is verdere verwerking afhankelijk van de actie-opdracht. Was de actie-opdracht een "S" dan wordt verdere verwerking afgebroken. Was de actie-opdracht een "V" of een "G", dan wordt de regel direkt na "BEVESTIG" overgeslagen en wordt het C-SRIPT vervolgd. Als het antwoord "Ja" is gaat de verwerking verder en wordt de regel direkt na "BEVESTIG" verwerkt alsof er geen "BEVESTIG" opdracht heeft bestaan. Deze opdracht moet dus voor die opdracht worden opgenomen waarvan over uitvoering de gebruiker wil beslissen. GAVOOR GOFRONT Met deze optie wordt wat RE-SET aan het doen is naar de voorgrond gebracht. GAACHTER GOBACK Met deze optie wordt het systeemscherm naar de voorgrond gebracht. RE-SET draait op de achtergrond verder. PAUSE PAUSE~getal (*) Deze optie kent twee uitvoeringen. De uitvoering met vooraf een in te stellen tijdslimiet is alleen aanwezig voor geregistreerde gebruikers. PAUSE zonder tijdslimiet wacht op actie van de gebruiker. Door het indrukken van een toets wordt de opdracht "PAUSE" afgebroken. Geadviseerd wordt om hiervoor de of de te gebruiken. PAUSE met een tijdslimiet. Getal moet vervangen worden door een waarde welke seconden voorstellen. De minimumwaarde is in principe 1 seconde, pas bij twee seconde is de vertraging merkbaar. De maximumwaarde is 120 seconden. De "PAUSE" kan voortijdig worden afgebroken door het indrukken van een toets. Geadviseerd wordt om hiervoor de of de te gebruiken. Deze actie is helaas wel voor alle in het C-Script opgenomen "PAUSE" opdrachten geldig. Voorbeeld PAUSE~5 In bovenstaand voorbeeld wordt er 5 seconden gewacht. PIEP PIEP~tijdsduur~toonhoogte (*) BEEP BEEP~tijdsduur~toonhoogte (*) Deze opdracht kent twee verschillende schrijfwijzen. Met de schrijfwijze zonder verdere opdrachten wordt er een standaard piep ten gehore gebracht. Voorbeeld PIEP De uitgebreidere opdracht kent de mogelijkheid om tijdsduur en toonhoogte te be‹nvloeden. Tijdsduur moet vervangen worden door een getal met een minimumwaarde van 1 en een maximumwaarde van 120. De getallen zijn in seconden. Bij overschrijding van de minimumwaarde of de maximumwaarde zal Re- Set de minimum- of maximumwaarde aanhouden. Toonhoogte moet vervangen worden door een getal met een minimumwaarde van 16 en een maximumwaarde van 5000. Bij overschrijding van de limieten zal Re-Set de minimum- of maximumwaarde aanhouden. Voorbeeld BEEP~3~2000 OPENGROEP (*) OPENGROUP (*) Met deze opdracht kan een groep worden geopend. Daartoe moet de cursor op de groep worden gezet. Het is mogelijk om de inhoud van een groep via een script te wijzigen. Deze opdracht controleert niet of de cursor ook inderdaad op een groep staat. SLUITGROEP (*) CLOSEGROUP (*) Deze opdracht sluit een groep. Het maakt niet uit waar de cursor zich in de groep bevindt. Ook deze opdracht controleert niet of de cursor ook inderdaad op een groep staat ALSBESTAAT~bestand (*) opdrachtregel als bestand bestaat. opdrachtregel als bestand niet bestaat. IFEXIST~bestand (*) opdrachtregel als bestand bestaat. opdrachtregel als bestand niet bestaat. Met deze opdracht kunnen zeer bijzondere scripts worden geschreven. Met "ALSBESTAAT" kan getest worden of iets wel of niet bestaat. In deze versie is dit nog beperkt tot het testen of een bestand bestaat of niet. Bestand moet vervangen worden door een geldige bestandsnaam inclusief het pad en de drive. Voorbeeld ALSBESTAAT~M:\WVE\INTRODUC.WVE PLAY~M:\WVE\INTRODUC.WVE~0~0 SYSINFO Als de voorwaarde bij "ALSBESTAAT" waar is, dus het bestand wordt gevonden, wordt de volgende regel in het script uitgevoerd. Als de voorwaarde niet waar is wordt de volgende regel overgeslagen en wordt de regel daarna uitgevoerd. Zie het voorbeeld. Als het geluidsbestand bestaat wordt deze afgespeeld. Als dat bestand niet bestaat wordt de opdracht "SYSINFO" uitgevoerd. ALSNIETBESTAAT~bestand (*) opdrachtregel als bestand niet bestaat. opdrachtregel als bestand bestaat. IFNOTEXIST~bestand (*) opdrachtregel als bestand niet bestaat. opdrachtregel als bestand bestaat. Met deze opdracht kunnen zeer bijzondere scripts worden geschreven. Met "ALSNIETBESTAAT" kan getest worden of iets niet of wel bestaat. In deze versie is dit nog beperkt tot het testen of een bestand wel of niet bestaat. Bestand moet vervangen worden door een geldige bestandsnaam inclusief het pad en de drive. Deze opdracht is eender aan "ALSBESTAAT" met dit verschil dat bij het niet voorkomen van het bestand de voorwaarde waar is. AFSPELEN~bestand~tijdsduur~volume (*) PLAY~bestand~tijdsduur~volume (*) Met deze opdrachten kunnen geluidsbestanden worden afgespeeld in het Psion WVE formaat. Bestand moet vervangen worden door een geldige bestandsnaam met directory en drive. Als de drive wordt weggelaten gaat de opdracht eerst zoeken in de directory van waaruit het programma is gestart, vervolgens de interne disk (M:) en daarna de linker drive (A:) en vervolgens de rechter drive (B:). Als de extensie van de bestandsnaam wordt weggelaten neemt het programma de standaard extensie .WVE aan. Als alleen de bestandsnaam wordt opgegeven zonder drive, directory en extensie, dan zal de opdracht eerst in de ROM:: gaan zoeken, vervolgens in de directory van waaruit het programma is gestart, daarna de \WVE directories van drive M:, A: en B: in de gegeven volgorde. De voorkeur is zo volledig mogelijk daar dit het zoeken verkort. Tijdsduur moet vervangen worden door het aantal seconden dat het bestand ten gehore moet worden gebracht. De minimum waarde is in theorie 1 seconde en er is geen maximum met dit verschil dat de opdracht zal worden afgebroken zodra het programma het script heeft verwerkt. Volume moet worden vervangen door een van de getallen 0, 1, 2, 3, 4 en 5. De Series 3a beschikt in principe slechts over vier niveaus; 0/1, 2, 3, 4/5. De waarde 0 is het hardst en de waarde 5 het zachtst. Voorbeeld PLAY~M:\WVE\INTRODUC.WVE~0~0 OPMERKINGENTEKENS REMARK-TEKENS De volgende tekens kunnen gebruikt worden om in het script opmerkingen en verduidelijkingen op te nemen. ' ; : * REM~opmerkingen lege regel De opmerkingen kunnen direkt achter de vier tekens worden geplaatst. Tussen "REM" en de opmerking zal echter een spatie moet worden opgenomen. Voorbeelden REM Instellingen Psion Series 3c van uw naam. REM versie 4, datum, tijd REM reden van versiewijziging - nwe groep toegevoegd. :Eigenaargegevens EIGENAAR naam telefoon adres woonplaats :Registratiecode REGISTRATIE code *verwijderen van de standaard applicaties HOME *Remove Data REMOVE *Remove Word REMOVE *Remove Agenda REMOVE ECHO OFF Deze opdracht voorkomt dat het script op het scherm wordt getoond. ECHO ON Deze opdracht zorgt ervoor dat het script op het scherm wordt getoond. MELDING MELDING~getal MENTION MENTION~getal Als in het C-Script gekozen is voor een plaatje of een voortgangsbalkje, verschijnt er linksonder tevens een melding dat Re-Set bezig is met het verwerken van het C-Script. In deze melding is ook de vordering van het verwerken ingebouwd. Met deze opdracht kan nu gekozen worden hoe deze vordering zich moet presenteren. Getal moet vervangen worden door een van onderstaande cijfers; 1=" verwerken opdrachten, nog X tekens te gaan " X wordt vervangen door een steeds kleiner wordend getal welke voorstelt de maximale omvang van het C-Script tot 0. Deze optie wordt tevens gekozen als de opdracht zonder een getal wordt opgegeven 2=" verwerken opdrachten, nog X% te gaan " X wordt vervangen door een steeds kleiner wordend getal in de reeks van 100 t/m 0. 3=" verwerken opdrachten, X tekens verwerkt " X wordt vervangen door een steeds groter wordend getal tot maximaal de omvang van het C-Script. 4=" verwerken opdrachten, X% verwerkt " X wordt vervangen door een steeds groter worderd getal in de reeks van 0 t/m 100. PLAATJE~bestand PLAATJE SHOWPIC~bestand SHOWPIC Met deze opdracht kan een bestand van het type PIC op het scherm worden afgebeeld. Het PIC-bestandsformaat is het formaat wat gebruikt wordt door OPL en dus door veel tekenpakketten. Het PIC-bestandsformaat van SHEET en daarmee Lotus 1-2-3 kan niet met deze optie worden afgebeeld. Het plaatje mag alle door de Series 3x gebruikte kleuren bevatten. Het plaatje wordt op het scherm gecentreerd afgebeeld. Bestand moet vervangen worden door een geldige bestandsnaam met directory en drive. Voorbeeld PLAATJE M:\PIC\RE-SET.PIC Zonder bestandsnaam wordt er (weer) een voortgangsbalkje op het scherm getoond. BALK BAR Deze opdracht laat een voortgangsbalkje op het scherm zien. Het programma bezit een mechanisme dat ervoor zorgt dat deze balk ook op het scherm verschijnt als er bij de start van het C-Script niets is gespecificeerd om op het scherm te tonen. Boven de voortgangsbalk is het versienummer van Re-Set zichtbaar. De voortgangsbalk zelf bestaat uit een zwart kader die grijs wordt ingevuld naar gelang het C-Script gevorderd is. Als het grijs niet goed zichtbaar is kan met contrast + +<>> deze zichtbaar gemaakt worden. De uiteinden van de balk zijn gemarkeerd met 0% en 100%. De puntjes boven de balk staan voor 25%, 50% en 75%. Bij kleinere schermen worden de puntjes die staan voor 25% en 75% in verband met de beschikbare ruimte niet weergegeven. De voortgangsbalk wordt automatisch aan de schermbreedte aangepast en gecentreerd op het scherm weergegeven. ALARM~tijd~dag~herhaal~bericht~alarm (*) Deze opdracht stelt het alarm in van de applicatie TIME. Deze opdracht kan maximaal zes keer herhaald worden om alle in TIME beschikbare alarms in te stellen. Tijd moet vervangen worden door een getal wat de tijd moet voorstelt. Acht uur s'avonds is dan 2000 en twee uur s'middags 0200. De kleinst geaccepteerde waarde is 0000, dit staat voor 12 uur s'nachts en de grootste waarde is 2359, wat staat voor ‚‚n minuut voor twaalf s'nachts. Dag moet worden vervangen door ‚‚n of meer van de volgende letters; M=Maandag D=Dinsdag W=Woensdag D=Donderdag V=Vrijdag Z=Zaterdag Z=Zondag Als u een alarm wilt laten afgaan op maandag is de letter "M" voldoende. Met de andere dagen ligt dat niet zo eenvoudig omdat de cursor door TIME op de dag wordt gezet dat alarm van de applicatie TIME wordt opgeroepen. Als het alarm op donderdag moet afgaan kan het beste "MDWD" worden opgegeven. Zondag wordt dan "MDWDVZZ". Deze methode zorgt ervoor dat ook de bewuste dag wordt gekozen ongeacht de dag dat het script wordt gedraaid. Herhaal moet vervangen worden door een van de volgende letters; E=Eenmalig W=Wekelijks W=Werkdag D=Dagelijks Merk op dat voor werkdag er tweemaal een "W" moet worden opgegeven, dus "WW". Bericht moet worden vervangen door een regel tekst met een maximale lengte van 60 tekens. Voor de spaties in een regel kunt u het teken "~" gebruiken. Re-Set vervangt deze dan weer voor echte spaties. Alarm moet vervangen worden door de eerste letter van de naam van het geluidsbestandje, voor een geluidje met de naam Succes is dat dan de S. Wilt u echter geen geluid en kiest u voor Stilte dan moet u tweemaal de letter S opgeven, dus SS. De keuze is beperkt als er gebruik wordt gemaakt van de emulator. Het geluid van Bel is standaard en alleen Carillon geeft een ander signaal. REGISTRATIE~code REGISTER~code Deze opdracht zorgt ervoor dat alle opdrachten voorzien van een (*) wel gebruikt kunnen worden in een script. Deze opdracht kan alleen gebruikt worden in samenwerking met de opdracht "EIGENAAR" of "OWNER" en moet na deze opdracht worden gegeven. De gegevens in "EIGENAAR" of "OWNER" zijn van belang bij het decoderen van de sleutel. Code moet vervangen worden door een via registratie verkregen sleutel.