Akcia RUN

Funkcia

Akcia umožňuje odštartovať externý program.

Deklarácia

alebo

alebo

Parametre

Popis

Akcia RUN odštartuje program daný textovým reťazcom "meno programu". Akcia RUNEX odštartuje program daný hodnotou identifikátora typu text _toExec.
Pri prvom variante je možné špecifikovať, či bude program spustený synchrónne (SYNC) alebo asynchrónne (ASYNC). Druhý variant je vždy synchrónny. Po skončení programu je jeho návratový kód priradený do identifikátora intIdent_Int.

Ak je maximálny čas behu programu ohraničený kľúčovým slovom TIMEOUT a program neskončí v časovom limite, bude násilne ukončený a návratová hodnota (v prvom prípade) nadobudne hodnotu _ERR_TIME_OUT.

V niektorých prípadoch je potrebné, aby meno programu vzniklo na základe textových operácií. Tu je vhodné použiť akciu RUNEX, ktorá štartuje program daný hodnotou textového identifikátora _toExec.
Rovnaký efekt dosiahneme akciou RUN, ak ako meno programu bude prázdny textový reťazec a celý príkaz sa uvedie ako parameter pomocou výrazu paramExpr_Str (viď. príklad).
Pre Linux/Raspberry PI je nutné zadávať oddelene "meno programu" a parametre, napr.
RUN "/usr/bin/ncftpget" SYNC _paramStr
Pokiaľ bude "meno programu" prázdne alebo bude obsahovať aj parametre, program sa nespustí.

Ak je akcia použitá vo variante s návratovým kódom a nepodarilo sa spustiť program, návratový kód (intIdent_Int) bude nastavený na neplatnú hodnotu.

Poznámka k  "wildcard" parametrom pre Linux/Raspberry PI 
Treba si uvedomiť, že expanziu hviezdičiek a podobných špeciálnych znakov vykonáva shell (napr. bash). Preto nasledovný príkaz nebude fungovať:
RUNEX "/usr/bin/rm" SYNC "/tmp/*.txt" 

Je nutné vytvoriť pomocný shell skript (napr. /opt/d2000/bin/mydel.sh), ktorý obsahuje volaný príkaz a parameter $* (v syntaxi bash reprezentuje všetky parametre, s ktorými je skript volaný), tj. skript bude obsahovať dva riadky:

#!/usr/bin/env bash
/usr/bin/rm $@

Nezabudnite nastaviť práva skriptu, aby ho užívateľ, pod ktorým je spustený D2000 (štandardne d2000), mohol tento skript spúšťať, tj.
chmod 755 /opt/d2000/bin/mydel.sh
Takýto skript je možné volať a pri volaní shell vykoná expanziu parametrov:

RUNEX "/opt/d2000/bin/mydel.sh" SYNC "/tmp/*.txt" 

Iný príklad pre kopírovanie súborov na vzdialený server pomocou ncftpput. Skript /opt/d2000/bin/ncftpput.sh bude obsahovať riadky:

#!/usr/bin/env bash
/usr/bin/ncftpput $@

Volanie zo skriptu:

  _parameter := "-F -u myuser -p mypassword ftpserver /some/server/path /some/local/path/*.zip"
  _retCode := RUN "/opt/d2000/bin/ncftpput.sh" HIDE SYNC _parameter TIMEOUT 60

Príklad

Nasledujúci príklad kopíruje súbor d:\d2000.v70\prefix\sqlback\syscfg.db do adresára c:\archiv pomocou štandardných prostriedkov operačného systému (shell spustí príkaz copy).