Parametre programu (batch mode)

Command-line verzia programu (teda verzia spustiteľná z príkazového riadka) môže byť spustená štandardným spôsobom (pozri viac o parametroch tohto použitia), alebo v tzv. batch móde (dávkové spracovanie), keď pre určité dvoma dátumami ohraničené obdobie (počiatočný dátum, koncový dátum) vytvorí dávkový súbor (skript), obsahujúci volania programu s nastavenými parametrami. Skript po spustení generuje modlitby pre dané obdobie (buď pre každú modlitbu do samostatného súboru, alebo všetky modlitby do jedného súboru). Tento spôsob použitia sa značne líši od ostatných, preto ho popisujeme na tomto mieste osobitne.

• q | Typ úlohy, ktorú má program vykonať (query type)
  • pbm | batch mode (dávkové spracovanie)
  • ostatné hodnoty: viď parametre použitia programu (všeobecne)
• d | Deň počiatočného dátumu (hodnoty: 1-31)
• m | Mesiac počiatočného dátumu (hodnoty: 1-12)
• r | Rok počiatočného dátumu (napr. 2000)
• f | Deň koncového dátumu (hodnoty: 1-31)
• g | Mesiac koncového dátumu (hodnoty: 1-12)
• p | Rok koncového dátumu (napr. 2000).
  Malo by pritom platiť: počiatočný dátum <= koncový dátum.
• b | Názov výsledného skriptu (napr. rob.bat). Výsledky jeho spustenia sú popísané nižšie.
• n | Názov použitého command-line príkazu online breviára (napr. lh.exe pre DOS). Tento názov bude použitý vo výslednom skripte.
• 1 | Možnosť, či zobraziť nemenné súčasti modlitby (default: nie)
• 2 | Možnosť, či brať žalmy zo dňa alebo z vlastnej/spoločnej časti slávenia
• 3 | Ak je možnosť výberu viacerých spoločných častí, tento parameter určuje, ktorú spoločnú časť brať
• 4 | Možnosť, či zobraziť popis k modlitbe z vlastnej časti (zväčša stručný životopis svätca dňa; default: áno)
• 5 | Možnosť, či brať žalmy k modlitbe cez deň z bežnej alebo doplnkovej psalmódie (default: nie)
• e | Názov súboru, do ktorého sa má exportovať (DOS default: export.htm, linux default: stdout). Tento súbor bude v prípade chýb obsahovať chybové hlásenia. V prípade úspechu bude obsahovať iba hlavičku HTML dokumentu, pretože výsledkom bude skript, ktorého meno špecifikoval parameter b.
• a | Možnosť, či všetky modlitby dať do 1 súboru (default: nie)

Pre parametre určujúce možnosti majú nasledovné hodnoty: 1 - áno, 0 - nie.

Výsledky po spustení vytvoreného skriptu

Vytvorený skript po spustení vygeneruje modlitby pre dané obdobie do súborov yyyy-mm-dd_xp.htm, kde význam jednotlivých častí mena súboru je nasledovný:

• yyyy | rok
• mm | mesiac (napr. 05 pre máj)
• dd | deň (napr. 07)
  Dátum je uvedený v súlade s normou ISO 8601.
• x | poradie svätého (0 až 4). 0 zväčša znamená všedný deň alebo slávnosť s najvyššou prioritou. 4 znamená ľubovoľnú spomienku Panny Márie v sobotu, 1 až 3 znamenajú zväčša sviatky svätých.
• p | modlitba (r = ranné chvály, v = vešpery)

V prípade, že je použitý parameter a (append), bude vytvorený len jeden súbor s nasledovným menom: yyyy-mm-dd_YYYY-MM-DD.htm, kde význam jednotlivých častí mena súboru je nasledovný:

• yyyy | rok počiatočného dátumu
• mm | mesiac počiatočného dátumu
• dd | deň počiatočného dátumu
• YYYY | rok koncového dátumu
• MM | mesiac koncového dátumu
• DD | deň koncového dátumu
  Dátumy sú uvedené v súlade s normou ISO 8601.

Ak dostane program nesprávne parametre (zahŕňa i prípady nesprávnych hodnôt parametrov alebo ďalšie chýbajúce parametre závisiace od iných parametrov), export obsahuje chybové hlásenie. Naviac, command line verzia vypíše chybové hlásenie na stderr.

Príklady

Ako sa vraví, príklad môže všetky pochybnosti razom odstrániť alebo naopak, podnietiť ďalšie otázky. Za oboma účelmi sú uvedené nasledovné príkady použitia batch módu.

• lh.exe -qpbm -d7 -m5 -r2000 -f3 -g4 -p2001 -brob.bat -nlh.exe -ic:\breviar\
  Program vygeneruje skript rob.bat, ktorý vytvorí modlitby od 7. mája 2000 do 3. apríla 2001. Pritom include adresár sa nachádza v adresári c:\breviar\ a meno programu je lh.exe. (Použitie v DOSe/Windows.)
• lh.exe -qpbm -d7 -m5 -r2000 -f3 -g4 -p2001 -brob.bat -nlh.exe -ic:\breviar\ -a1
  Program vygeneruje skript rob.bat, ktorý vytvorí modlitby od 7. mája 2000 do 3. apríla 2001. Po spustení skriptu budú všetky modlitby vytvorené do jednoho súboru s menom 2000-05-07_2001-04-03.htm. Pritom include adresár sa nachádza v adresári c:\breviar\ a meno programu je lh.exe. (Použitie v DOSe/Windows.)
• lh -qpbm -d7 -m5 -r2000 -f3 -g4 -p2001 -brob.sh -nlh -i~/breviar/
  Program vygeneruje skript rob.sh (možno bude potrebný chmod na nastavenie práv), ktorý vytvorí modlitby od 7. mája 2000 do 3. apríla 2001. Pritom include adresár sa nachádza v adresári ~/breviar/ a meno programu je lh. (Použitie v UNIXe.)

Autor programovej časti © 1999-2006 Juraj Vidéky
Všetky práva vyhradené.