Naplózza a MaxL Shell munkamenet kimenetét egy fájlba. A MaxL utasítások végrehajtása során keletkező standard kimenetek, tájékoztató üzenetek, hibaüzenetek és/vagy figyelmeztető üzenetek elküldése egy fájlba.
Ha a FILE-NAME nem létezik, létrehozza. Ha FILE-NAME már létezik, akkor felülíródik. Ha a FILE-NAME-hez nem adunk meg könyvtár elérési utat, a FILE-NAME a MaxL Shell aktuális könyvtárában jön létre. A könyvtárak nem hozhatók létre a spool paranccsal.
Az üzenetnaplózás a spool bekapcsolásával kezdődik és a spool kikapcsolásával végződik.
Példa
spool on to 'output.txt';
{MaxL utasítások}
spool off;
A MaxL utasítások kimenetét egy output nevű fájlba küldi.txt címre, amely az aktuális könyvtárban található, ahol a MaxL Shell meghívásra került, vagy a eas\console\bin könyvtárban, ha a MaxL Script Editor-t használja.
spool on to 'c:\hyperion\output.txt';
A MaxL utasítások kimenetét az output.txt nevű fájlba küldi, amely az abszolút elérési úttal megadott, már meglévő könyvtárban található.
spool on to '../../../output.txt';
A MaxL utasítások kimenetét az output.txt nevű fájlba küldi, amely a relatív elérési úttal megadott, már meglévő könyvtárban található. A fájl három könyvtárral az aktuális könyvtár felett található, vagy három könyvtárral az eas\console\bin felett, ha a MaxL Script Editor-t használja.
leírás
A legtöbb operációs rendszer három csatornát támogat a be- és kimenethez:
-
STDIN (standard bemeneti csatorna)
-
STDOUT (standard kimeneti csatorna)
-
STDERR (standard hiba csatorna)
A legtöbb operációs rendszer parancssori lehetőségeket is biztosít az alkalmazások által generált adatok átirányítására, attól függően, hogy az adatokat a fenti csatornák közül melyiken keresztül vezetik.
A MaxL-ben a hibák STDERR-ként vannak megjelölve, ami lehetővé teszi a hibák parancssori átirányítását az operációs rendszer átirányítási kezelőinek segítségével. A nem hibák STDOUT-ként vannak megjelölve; így a normál kimenet a hibakimenettől elkülönítve naplózható. Íme egy példa a hibakimenet átirányítására a híváskor:
essmsh script.mxl 2>errorfile.err
Megjegyzés: |
Az operációs rendszer átirányítási kezelői eltérőek; ellenőrizze a platform dokumentációját. |
Az STDERR és az STDOUT parancsokat egymástól függetlenül is átirányíthatja különböző MaxL kimeneti naplókba, a spool parancs megfelelő opcióival. Például a hibákat az egyik fájlba, a kimenetet pedig egy másikba irányíthatja, ha a következő sorokat helyezi el a szkriptben:
spool stdout on to 'output.txt';spool stderr on to 'errors.txt';
vagy csak a hibákat irányíthatja:
spool stderr on to 'errors.txt';
vagy csak a kimenetet irányíthatja:
spool stdout on to 'output.txt';
Figyelem: |
Az általános és a speciális kimeneti csatornás orsót nem használhatja ugyanabban a szkriptben. Például a következő nem érvényes: |
spool on to 'session.txt';spool stderr on to 'errors.txt';
spool on to 'session.txt';spool stderr on to 'errors.txt';