Záznam výstupu relace MaxL Shell do souboru. Odeslání standardního výstupu, informačních zpráv, chybových zpráv a/nebo varovných zpráv generovaných při provádění příkazů MaxL do souboru.
Pokud soubor FILE-NAME neexistuje, je vytvořen. Pokud FILE-NAME již existuje, je přepsán. Není-li pro FILE-NAME zadána cesta k adresáři, vytvoří se FILE-NAME v aktuálním adresáři prostředí MaxL Shell. Adresáře nelze vytvořit pomocí příkazu spool.
Zaznamenávání zpráv začíná příkazem spool on a končí příkazem spool off.
Příklad
spool on to 'output.txt';
{Příkazy MaxL}
spool off;
Odesílá výstup příkazů MaxL do souboru s názvem output.txt, který se nachází v aktuálním adresáři, kde byl vyvolán MaxL Shell, nebo v adresáři eas\console\bin, pokud se používá editor skriptů MaxL.
spool on to 'c:\hyperion\output.txt';
Odesílá výstup příkazů MaxL do souboru s názvem output.txt, který se nachází v již existujícím adresáři určeném absolutní cestou.
spool on to '../../../output.txt';
Odesílá výstup příkazů MaxL do souboru s názvem output.txt, který se nachází v již existujícím adresáři určeném relativní cestou. Soubor bude umístěn tři adresáře nad aktuálním adresářem nebo tři adresáře nad eas\console\bin, pokud se používá editor skriptů MaxL.
Popis
Většina operačních systémů podporuje tři kanály pro vstup/výstup:
-
STDIN (standardní vstupní kanál)
-
STDOUT (standardní výstupní kanál)
-
STDERR (standardní chybový kanál)
Většina operačních systémů také poskytuje možnosti příkazového řádku pro přesměrování dat generovaných aplikacemi v závislosti na tom, přes který z výše uvedených kanálů jsou data vedena.
Chyby v MaxL jsou označeny jako STDERR, což umožňuje přesměrování chyb z příkazového řádku pomocí handle pro přesměrování operačního systému. Chyby, které nejsou chybami, jsou označeny jako STDOUT; normální výstup tak může být logován odděleně od chybového výstupu. Zde je příklad přesměrování chybového výstupu v době volání:
essmsh script.mxl 2>errorfile.err
Poznámka: |
Operating-system redirection handles se liší; zkontrolujte dokumentaci platformy. |
Můžete také přesměrovat STDERR a STDOUT nezávisle na sobě do různých výstupních protokolů MaxL pomocí odpovídajících voleb v příkazu spool. Můžete například nasměrovat chyby do jednoho souboru a výstup do jiného umístěním následujících řádků do skriptu:
spool stdout on to 'output.txt';spool stderr on to 'errors.txt';
nebo můžete nasměrovat pouze chyby:
spool stderr on to 'errors.txt';
nebo můžete nasměrovat pouze výstup:
spool stdout on to 'output.txt';
Poznámka: |
V jednom skriptu nelze použít obecný spool a speciální spool výstupního kanálu. Například následující příklad není platný: |
spool on to 'session.txt';spool stderr on to 'errors.txt';
.