# Programmeren in REXX/Host Commando's

In dit hoofdstuk leggen we uit hoe we host-commando's kunnen uitvoeren en waarop we daarbij moeten letten.

# Oproepen van een host-commando

Met de term host bedoelen we het programma dat ons REXX programma heeft opgeroepen. We moeten dus aannemen dat die host een omgeving heeft waar we commando's kunnen laten uitvoeren.
Het besturingssysteem voorziet in zo'n omgeving. In Windows systemen is dat de CMD-shell (de opdrachtprompt), op Linux systemen de "bash"-shell.
In de rest van dit hoofdstuk zullen we voorbeelden gebruiken van een Windows systeem.

## DOS commando's

We spreken wel van Windows commando's, maar eigenlijk bekijken we hier de oeroude MS-DOS commando's. Normaal voeren we die uit door een CMD opdrachtprompt te openen, of door ze in een BAT procedure te steken. Maar het kan dus evengoed met REXX, met dan alle toeters en bellen die daarmee gepaard gaan.
Een commando roepen we op als een op zichzelf staand statement. Als REXX, na interpretatie, tot het besluit is gekomen dat het niet een werkje voor hem is (een assignatie of een REXX bevel) dan geeft hij het resultaat van de interpretatie door aan wie hem heeft opgeroepen. Hopelijk begrijpt de oproeper het commando en kan die er iets zinnigs mee doen. Als er problemen optreden, of het is een onbekend commando, dan hopen we een returncode terug te krijgen. Deze returncode zet REXX dan in de gereserveerde variabele RC. Windows is spijtig genoeg nogal spaarzaam wat returncodes betreft. Daarom bestaan er functies die voor een wat betere samenwerking zorgen. We zullen die bestuderen in het hoofdstuk RexxUtil functies.
In dit eerste voorbeeld roepen we het "COPY" commando op:
In het geval de bestandsnaam of pad een spatie bevat moet die voor Windows tussen aanhalingstekens worden geplaatst. Dan moet ons voorbeeld als volgt worden aangepast:
Voor REXX is de string die aan de variabele MijnBestand moet worden toegekend alles wat tussen de enkelvoudige aanhalingstekens staat, dus inclusief de dubbele aanhalingstekens. Dan zal het COPY commando geen problemen opleveren.
Alvorens we nu verder kunnen gaan moeten we een uiterst belangrijk punt aansnijden...

## Van levensbelang

Wanneer we een host-commando willen uitvoeren, dan houden we best volgende regel aan:
* Schrijf alles wat niet variabel is, als een constante !
Wat kan er namelijk gebeuren als we dit niet doen ? Laten we kijken naar dit stukje programma:
Hier maken we het wel erg bont door niets tussen aanhalingstekens te schrijven. Niet te verwonderen dat we het volgende op het scherm zien verschijnen:
REXX kan helemaal niets doen met de ":", want dit is geen geldig teken voor een token, en als label kan het ook al niet dienen, want het is niet het eerste woord van een zin.
OK, laten we dat proberen te verbeteren:
We krijgen nu wel
doch er blijft een groot gevaar dreigen. Het woord "copy" is voor REXX geldig als naam voor een variabele. Het programma zal werken zolang we geen waarde aan deze variabele toekennen... maar...
Oef, het bestand is als systeembestand en enkel-lezen gedefinieerd, er is dus gelukkig niets gebeurd, maar het kon catastrofaal zijn, niet ? In bovenstaand voorbeeld ziet men natuurlijk onmiddellijk de fout. Maar een REXX programma kan honderden statements bevatten (en dat is echt niet overdreven) waarbij het statement copy="ERASE" ergens ver van het statement copy "C:\IO.SYS" kan verwijderd zijn.
Dus, nogmaals, en we kunnen het niet genoeg herhalen:
* Schrijf alles wat niet variabel is, als constante !

## Een andere REXX oproepen

Laten we veronderstellen dat we volgend eenvoudig REXXje willen oproepen:
We kunnen dat REXXje op verschillende manieren oproepen:
* Door het op te roepen als een DOS-commando;
* Door het op te roepen als een externe routine mits gebruik van een REXX call instructie
* Door het op te roepen als een externe functie.
Merk op dat een externe functie of routine steeds minder performant zal zijn dan wanneer we ze intern hadden geschreven. Om performant te werken moeten we dus dezelfde routine of functie steeds weer gaan kopiëren in elk programma dat er gebruik van wil maken.
In het hoofdstuk "Toch een beetje OORexx" zullen we echter leren dat OORexx mogelijkheden biedt om de externe functies toch even performant te laten werken als interne. We kunnen op die manier onze eigen functiepakketten samenstellen. Maar dit is dus niet in alle implementaties van REXX voorzien.

### Oproepen als een DOS commando

Met dit resultaat aan het scherm:
Ons tweede RexxSubProgramma wordt opgeroepen alsof het rechtstreeks vanaf de CMD-opdrachtprompt zou worden opgeroepen. Dus, parse source geeft dan ook "COMMAND" als tweede antwoord.
Het subprogramma kreeg ook maar één parameter door. Zelfs al plaatsen we een komma tussen de parameters, toch wordt alles als één parameter beschouwd. De komma staat immers in een constante, waarin REXX helemaal niet kijkt.
Het RexxSubProgramma draait in een proces, onderliggend aan het hoofdprogramma (child process). Het hoofdprogramma zal dus niet verder kunnen werken zolang het subprogramma niet is gestopt. Om dit te vermijden kan men gebruik maken van het Windows start commando om een ander proces te starten. We schrijven dan "START REXX D:\RexxSubProgramma.rex p1 p2 , p3". Willen beide programma's dan nog met elkaar kunnen praten, dan moeten speciale technieken van multi-programmatie worden gebruikt, en dat onderwerp laten we in dit boek links liggen.

### Oproepen met een CALL instructie

* Verwar dit REXX call bevel niet met het Windows call commando !
Nu zien we het volgende op het scherm verschijnen:
Oei, wat hebben we nu verkeerd gedaan ? Wel, wanneer REXX een call bevel krijgt gaat hij op zoek naar wat als eerste parameter is meegegeven. Die eerste parameter is D:\RexxSubProgramma.rex p1 p2 , p3. REXX kent geen interne of externe functie noch routine met die naam. Ook een extern REXX programma met die naam kan hij nergens vinden. We moeten ons call bevel dus als volgt verbeteren:
en nu zien we:
Ditmaal worden we dus opgeroepen als "SUBROUTINE" en niet als "COMMAND".
* Merk op dat we testen of rc<>"RC" na het oproepen van onze subroutine. Als deze statements een eind ver in een programma voorkomen kan het echter gebeuren dat de variabele rc al is opgevuld met een returncode van een andere instructie. Onze test is dus niet waterdicht, tenzij we vóór het oproepen van onze subroutine een drop rc zouden schrijven. Met een DROP bevel worden de opgesomde variabelen verwijderd uit de gekende variabelen. Ook een stem kan men met drop volledig "weggooien" (drop stem.).
In tegenstelling tot een commando, dat enkel een getal als returncode kan teruggeven (variabele RC), komt het resultaat van een subroutine in de gereserveerde variabele RESULT terecht. Dat resultaat kan echt alles zijn, een cijfer, een string, of zelfs helemaal niets.
Daarom passen we ons programmaatjes aan in functie van wat er moet teruggegeven worden:
We hebben ons programmaatje bimodaal gemaakt, het kan opgeroepen worden als commando of als externe subroutine/functie. Noteer daarbij het volgende:
* Return arg heeft hier hetzelfde effect als een exit arg. Met een return bevel moet REXX naar een hoger niveau terugkeren. Zit je in een REXX subroutine, ga je dus terug naar een oproepende subroutine of uiteindelijk naar het hoofdprogramma. Zit je al in het hoofdprogramma (zoals hier het geval is), dan verlaat je met een return bevel het hoofdprogramma, en komt het dus neer op een exit bevel.
* Langs de kant van het oproepend programma komt het resultaat van de externe subroutine terecht in variabele result, terwijl variabele RC niet wordt beïnvloed. Roept men een ander REXX programma op als een host commando, dan zit het resultaat wél in variabele RC, en kan het alleen een geheel getal zijn. Variabele result wordt dan niet beïnvloed.
In dit geval draait het RexxSubProgramma in hetzelfde proces als het hoofdprogramma. Ook hier zal het hoofdprogramma niet verder kunnen zolang het subprogramma niet is beëindigd.

### Als functie

Nu maken we er een functie van door de oproep te vervangen in:
met als resultaat:
Let hierbij op volgende zaken:
* We werden wel degelijk opgeroepen als functie (FUNCTION);
* Variabele result is niet meer ingevuld, al schreven we return met een string. Na een call, en enkel dan zal REXX met variabele result iets doen. Komt er niets terug, dan wordt result namelijk "gedropped". Hier hebben we geen call gebruikt, dus variabele result blijft wat ze tevoren al was (in ons voorbeeld, een niet geïnitialiseerde variabele).
* De functie moet altijd iets teruggeven, al was het een nullstring (dus return "" is prima).
* We hebben nog steeds slechts één parameter binnengekregen in het RexxSubProgramma...
Antwoord:In al onze voorbeelden hebben we alles als één constante geschreven, niet te verwonderen dat we maar één parameter binnenkrijgen in de subroutine of functie. Willen we meer parameters doorgeven, dan moeten we het zo schrijven:
om dan dit te bekomen:
Ons hoofdprogramma kunnen we ook naar het expertniveau tillen:
De functie symbol laat namelijk toe te testen of aan een variabele een waarde toegekend is. Indien dat wel het geval is, dan antwoordt symbol met "VAR", anders met "LIT". Is de naam echter geen geldig token, dan krijgen we "BAD" als antwoord. Merk tevens op dat we de naam van de variabele tussen aanhalingstekens plaatsen. Doen we dat niet, dan zou eerst de waarde van de variabele worden ingevuld alvorens de functie symbol wordt opgeroepen.
Bekijk deze voorbeelden:
Het zal de aandachtige lezer ook zijn opgevallen dat we in het statement call "D:\RexxSubProgramma.rex" "p1 p2" , "p3" de naam van de functie tussen aanhalingstekens hebben geschreven. Dit is hier nodig omdat we leestekens zoals \ en een punt in de naam hebben. We willen namelijk niet dat REXX dit eerst probeert te interpreteren.
Maar er is nog een andere geval waarin we een functie als constante moeten schrijven. Stel dat we een interne functie gemaakt hebben met dezelfde naam als een standaardfunctie. Hoe kunnen we dan beslissen welke functie we willen oproepen ? Wel, willen we de standaardfunctie oproepen, dan moeten we de naam als constante - met hoofdletters - schrijven. Hoofdletters zijn voor onze externe functie niet nodig, want het verwijst naar een bestand, en REXX vraagt aan Windows om dat voor hem op te zoeken. Windows kan overweg met gemengde karakters.
Hier hebben we een voorbeeld:
Dit voorbeeld is een beetje bij z'n haar getrokken, maar een interne functie zou wel extra functionaliteit aan een standaardfunctie kunnen toevoegen.
Net als in het geval van de call draait de functie in hetzelfde proces als het hoofdprogramma en zal het hoofdprogramma niet verder kunnen zolang het subprogramma niet is beëindigd.
Kortom, als het na dit hoofdstuk duidelijk is dat
* alles wat niet variabel is, als constante moet geschreven worden !
dan hebben we het belangrijkste kunnen aanleren. We kunnen het echt niet genoeg herhalen !