WERKEN MET AMIGADOS 3.0 deel 19
 """""""""""""""""""""""""""""""
 EXECUTE
 """""""
 Formaat: EXECUTE <script> [{<arguments>}]
 Kort:    FILE/A
 Functie: Een script opstarten met eventueel argumenten
 Pad:     C:EXECUTE
 
 Beschrijving:
 EXECUTE wordt gebruikt om AmigaDOS scripts op te starten.  De regels in het
 script worden uitgevoerd alsof ze in de Shell waren ingetikt.  Als
 protectie bit s van het file is gezet dan hoeft U alleen de naam van het
 script te geven.  EXECUTE is dan niet nodig.
 
 In scripts kunt U ook parameters gebruiken door speciale keywords in het
 script te zetten.  Als u deze keywords gebruikt kunt U argumenten meegeven
 aan een script door ze mee te geven in de Shell.  U kunt ook automatisch
 default waardes laten geven als er geen parameters zijn meegegeven.  Als u
 geen variabele meegeeft en er is geen default aangegeven in het script dan
 is de waarde van de parameter leeg.
 
 De toegestane keywords worden hieronder uitgelegd.  Elk keyword moet
 beginnen met een punt (.).
 
 Met het .KEY keyword geeft u aan wat voor argumenten het script mag
 krijgen.  Het verteld het script hoeveel en wat voor soort parameters er
 gegeven kunnen worden.  Er is maar één .KEY toegestaan in een script en hij
 moet op de eerste regel staan.
 
 U kunt aan de argumenten op de .KEY regel net als bij de korte beschrijving
 /A en /K meegeven.  Argumenten gevolgd door /A MOETEN worden gegeven.
 Argumenten gevolgd door /K gebruiken de naam van het argument als keyword.
 Bijv.  als uw script begint met .KEY filenaam/A dan betekend dat dat de
 filename gegeven MOET worden.  Bijv als de eerste regel van een script is :
 
 .KEY filenaam/A, TO/K
 
 dan betekend dat dat de filenaam moet worden gegeven en dat de TO variabele
 optioneel is, maar als TO wordt gegeven dan moet het keyword TO worden
 gebruikt.  Bijv:
 
 1> EXECUTE Script TextFile TO NieuweFile
 
 Voordat het script wordt uitgevoerd doorzoekt AmigaDOS het hele script naar
 stukjes die tussen BRA en KET tekens staan (< en >).  Deze stukjes mogen
 een keyword zijn of een keyword en een default waarde.  Overal waar
 AmigaDOS een keyword vind tussen de haakjes dan zal worden geprobeerd dit
 te vervangen door het gegeven keyword.  Als u echter strings wilt gebruiken
 die < of > bevatten dan zal U andere haakjes moeten kiezen met de .BRA en
 .KET commando's.  .BRA <ch> verandert het < haakje en .KET <ch> verandert
 het > haakje.  Bijv:
 
 .KEY filenaam/A
 ECHO "Deze regel drukt geen < of > haakjes."
 .BRA {
 .KET }
 ECHO "Deze regel drukt WEL < en > haakjes !!"
 ECHO "De gekozen filenaam is : {filenaam}."
 
 Dit script geeft het volgende resultaat : 
 
 1> EXECUTE Script TestFile
 Deze regel drukt geen  haakjes.
 Deze regel drukt WEL < en > haakjes !!
 De gekozen filenaam is : TestFile.
 
 Als u een keyword tussen haakjes zet dan kunt U ook een default waarde
 geven als het gevraagde keyword niet als argument is meegegeven.  Er zijn
 twee manieren om een default aan te geven.  De eerste manier is het default
 elke keer aangeven als het gebruikt moet worden.  De twee strings moet U
 scheiden door een dollar teken ($).  Bijv:
 
 ECHO "<woord1$defwoord1> is het default voor woord1."
 
 defwoord1 is het default voor voor woord1.  Het zal worden afgedrukt als
 geen waarde is gegeven voor woord1.  Als U echter meerdere keren in het
 script gebruik maakt van het woord1 keyword dan moet U elke keer het
 default aangeven.
 
 Met het .DOLLAR <ch> (of .DOL <ch>) commando kunt U een ander teken
 gebruiken voor het dollar teken.  Bijv:
 
 .DOL #
 ECHO "<woord1#defwoord1> is het default voor woord1."
 
 De tweede manier om een default aan te geven is met het .DEF commando.  Met
 het .DEF commando kunt U voor een bepaald keyword een default aangeven.
 Bijv:
 
 .DEF woord1 "defwoord1"
 
 Dit zorgt ervoor dat als woord1 niet wordt gegeven dat defwoord1 gebruikt
 zal worden.  Bijv:
 
 ECHO "<woord1> is het default voor woord1"
 
 zal als output geven :
 
 defwoord1 is het default voor woord1
 
 U kunt in een script ook commentaar zetten.  U doet dit door voor het
 commentaar een ; te zetten, of een punt met daarna een spatie, gevolgd door
 het commentaar.
 
 .KEY                     Geeft formaat van argumenten aan.
 .DOT <ch>                Verander het punt van . naar <ch>
 .BRA <ch>                Verander haakje openen van < naar <ch>
 .KET <ch>                Verander haakje sluiten van > naar <ch>
 .DOL <ch>                Verander dollar teken van $ naar <ch>
 .DEF <keyword> <waarde>  Geef default waarde voor parameter aan
 .<spatie>                Commentaar regel
 
 AmigaDOS heeft een aantal makkelijke commando's om te gebruiken in scripts:
 IF, ELSE, SKIP, LAB en QUIT.  Deze commando's en zowel het EXECUTE commando
 kunt U in een script gebruiken.
 
 Om de uitvoer van een script te stoppen moet U op CTRL+D drukken.  Als er
 vanuit een script een ander script is opgestart dan moet U op CTRL+C
 drukken.
 
 Het huidige Shell nummer kunt U verkrijgen door $$ neer te zetten in een
 script.  Dit is handig om unieke filenamen te verkrijgen.
 
 Voorbeeld 1:
 
 Neem aan dat het script Print het volgende bevat :
 
 .KEY filenaam
 RUN COPY <filenaam> TO PRT: +
 ECHO "Het printen van <filenaam> is klaar."
 
 Het volgende commando :
 
 1> EXECUTE Print s:startup-sequence
 
 zal de inhoud van de startup-sequence naar de printer sturen.
 
 Voorbeeld 2:
 
 Nog een voorbeeld, noem het script Display.
 
 .KEY naam/A
 IF EXISTS <naam>
     TYPE <naam> NUMBER ; als de file bestaat, laat hem zien met regelnummers
 ELSE
     ECHO "<naam> niet gevonden"
 ENDIF
 
 Het commando :
 
 1> EXECUTE Display s:startup-sequence
 
 Zal  als  het  goed  is de startup-sequence afdrukken met regelnummers voor
 elke regel.
 
 Zie ook : IF, SKIP, FAILAT, LAB, ECHO, RUN, QUIT
 
 
 FAILAT
 """"""
 Formaat: FAILAT [<n>]
 Kort:    RCLIM/N
 Functie: In een script aangeven dat het script moet stoppen als er een fout
          optrad met een return code groter of gelijk aan n
 Pad:     Intern
 
 Beschrijving:
 Als er iets mis gaat met het uitvoeren van een commando dan geven ze een
 return code terug.  Een return code die groter is dan 0 geeft een of andere
 fout aan.  De return code, normaal gesproken 5, 10 of 20 geeft aan hoe
 serieus de error was.  Fouten groter of gelijk aan de gegeven limiet met
 het FAILAT commando zullen een script onderbreken.
 
 U kunt FAILAT gebruiken om de default waarde van 10 te veranderen.  Als U
 de waarde verhoogt dan geeft U aan dat sommige fouten niet fataal zijn voor
 de uitvoer van een script.  Het argument moet een positief nummer zijn.
 Als een script is beeindigd dan wordt de waarde weer op 10 gezet.  Als u
 geen argument meegeeft dan krijgt U de huidige RCLIM (Return Code Limit) te
 zien.
 
 Voorbeeld :
 
 Een scipt bevat de volgende regels :
 
 COPY DF0:MijnFile TO RAM:
 ECHO "MijnFile is gekopieerd"
  
 Als MijnFile niet gevonden wordt dan wordt het script afgebroken.  De
 volgende foutmelding zal in het Shell window komen te staan :
 
 COPY: object not found
 COPY failed returncode 20:
 
 Als U echter de waarde voor FAILAT hoger had gezet dan 20 dan was het
 script gewoon verder gegaan.  Bijv:
 
 FAILAT 21
 COPY DF0:MijnFile TO RAM:
 ECHO "MijnFile is gekopieerd"
 
 Zelfs als MijnFile niet wordt gevonden dan zal het script verder gaan.  Het
 volgende zal dan in het Shell window komen te staan :
 
 COPY: object not found
 MijnFile is gekopieerd
 
 Zie ook : ECHO, EXECUTE