## O programu | Parametry (batch mode)

^ Úkoly | ^ Parametry (obecně) | ^^ O programu

#### Parametry programu (batch mode)

Command-line verze programu (neboli verze spustitelná z příkazového řádku) může být spuštěná standardním způsobem (více viz o parametrech tohoto použití), nebo v tzv. batch módu (dávkové zpracování), pokud pro určité, dvěma daty ohraničené období (počáteční datum, konečné datum) vytvoří dávkový soubor (skript), obsahující volání (volby???) programu s nastavenými parametry. Skript po spuštění generuje modlitby pro dané období (buď pro každou modlitbu do samostatného souboru, nebo všechny modlitby do jednoho souboru). Tento způsob použití se značně liší od ostatních, proto ho popisujeme na tomto místě zvlášť.

- q | Typ úlohy, kterou má program vykonat (query type)
  - pbm | batch mode (dávkové zpracování)
  - ostatní hodnoty: viz parametry použití programu (všeobecně)
- d | Den počátečního data (hodnoty: 1-31)
- m | Měsíc počátečního data (hodnoty: 1-12)
- r | Rok počátečního data (např. 2000)
- f | Den konečného data (hodnoty: 1-31)
- g | Měsíc konečného data (hodnoty: 1-12)
- p | Rok konečného data (např. 2000).
  Mělo by přitom platit: počáteční datum <= konečné datum.
- b | Název výsledného skriptu (např. delej.bat). Výsledky jeho spuštění jsou popsané níže.
- n | Název použitého command-line příkazu online breviáře (např. breviar.exe pro DOS). Tento název bude použitý ve výsledném skriptu.
- 1 | Možnost zobrazit neměnné součásti modlitby (default: ne)
- 2 | Možnost brát žalmy ze dne, nebo z vlastní/společné části slavení
- 3 | Je-li možnost výběru z více společných částí, tento parametr určuje, kterou společnou část brát.
- 4 | Možnost zobrazit popis k modlitbě z vlastní části (většinou stručný životopis světce toho dne; default: ano)
- 5 | Možnost brát žalmy k modlitbě během dne z běžného, nebo doplňkového žaltáře (default: ne)
- e | Název souboru, do kterého se má exportovat (DOS default: export.htm, linux default: stdout). Tento soubor bude v případě chyb obsahovat chybná hlášení. V případě úspěchu bude obsahovat jen hlavičku HTML dokumentu, protože výsledkem bude skript, jehož jméno specifikoval parametr b.
- a | Možnost všechny modlitby dát do 1 souboru (default: ne)

Pro parametry určující možnosti mají hodnoty následovný význam: 1 – ano, 0 – ne.

#### Výsledky po spuštění vytvořeného skriptu

Vytvořený skript po spuštění vygeneruje modlitb pro dané období do souborů yyyy-mm-dd_xp.htm, kde význam jednotlivých částí názvu souboru je následovný:

- yyyy | rok
- mm | měsíc (např. 05 pro květen)
- dd | den (např. 07)
  Datum je uvedeno v souladu s normou ISO 8601.
- x | pořadí světce (0 až 4). 0 většinou znamená všední den, nebo slavnost s nejvyšší prioritou. 4 znamená nezávaznou sobotní památku Panny Marie, 1 až 3 znamenají většinou svátky svatých.
- p | modlitba (r = ranní chvály, v = nešpory – použité je "v" z latinského "vesperae")

V případě, že je použitý parametr a (append), bude vytvořený jen jeden soubor s následujícím názvem: yyyy-mm-dd_YYYY-MM-DD.htm, kde význam jednotlivých částí názvu souboru je následující:

- yyyy | rok počátečního data
- mm | měsíc počátečního data
- dd | den počátečního data
- YYYY | rok konečného data
- MM | měsíc konečného data
- DD | den konečného data
  Data jsou uvedena v souladu s normou ISO 8601.

Pokud program dostane nesprávné paramety (tzn. i případy nesprávných hodnot parametrů, nebo další chybějící parametry závislé na jiných parametrech), export obsahuje chybné hlášení. Navíc command line verze vypíše chybné hlášení na stderr.

#### Příklady

Jak známo, příklad může všechny pochybnosti rázem odstranit, nebo naopak podnítit další otázky. Z obou důvodů jsou uvedeny následující příklady použití batch modu.

- breviar.exe -qpbm -d7 -m5 -r2000 -f3 -g4 -p2001 -bdelej.bat -nbreviar.exe -ic:\breviar\
  Program vygeneruje skript delej.bat, který vytvoří modlitby od 7. května 2000 do 3. dubna 2001. Přitom include adresář se nachází v adresáři c:\breviar\ a název programu je breviar.exe. (Použití v DOSu/Windows.)
- breviar.exe -qpbm -d7 -m5 -r2000 -f3 -g4 -p2001 -bdelej.bat -nbreviar.exe -ic:\breviar\ -a1
  Program vygeneruje skript delej.bat, který vytvoří modlitby od 7. května 2000 do 3. dubna 2001. Po spuštění skriptu budou všechny modlitby zařazeny do jednoho souboru s názvem 2000-05-07_2001-04-03.htm. Přitom include adresář se nachází v adresáři c:\breviar\ a jméno programu je breviar.exe. (Použitie v DOSe/Windows.)
- breviar -qpbm -d7 -m5 -r2000 -f3 -g4 -p2001 -brob.sh -nbreviar -i~/breviar/
  Program vygeneruje skript rob.sh (možná bude potřebný chmod na nastavení práv), který vytvoří modlitby od 7. května 2000 do 3. dubna 2001. Přitom include adresář se nachází v adresáři ~/breviar/ a název programu je breviar. (Použití v UNIXu.)

Pokud se vyskytnou nějaké nesrovnalosti, nebo nefunkčnosti, prosím pište, protože batch mode je zatím jen takový experiment. Děkuji.

Autor programové části © 1999-2009 Juraj Vidéky
Pomoc při překladu do češtiny: Gorazd
Všechna práva vyhrazena.