Spool on/off

MaxL Shellセッションの出力をファイルに記録します。 MaxL文の実行によって生成された標準出力、情報メッセージ、エラー・メッセージまたは警告メッセージ(あるいはそのすべて)をファイルに送信します。

FILE-NAMEが存在しない場合は作成されます。 FILE-NAMEがすでに存在する場合は、上書きされます。 FILE-NAMEにディレクトリ・パスが指定されていない場合、FILE-NAMEはMaxL Shellの現在のディレクトリに作成されます。 spoolコマンドを使用してディレクトリを作成することはできません。

メッセージ・ロギングはspool onで始まり、spool offで終わります。

「図hspool.gifの説明」

FILE-NAME

例

spool on to 'output.txt';

{MaxL statements}

spool off;

MaxL文の出力を、MaxL Shellが起動された現在のディレクトリにあるoutput.txtというファイルに送信します。

spool on to 'c:\hyperion\output.txt';

MaxL文の出力を、絶対パスで指定された既存のディレクトリにあるoutput.txtというファイルに送信します。

spool on to '../../../output.txt';

相対パスで指定された既存のディレクトリにあるoutput.txtというファイルにMaxL文の出力を送信します。このファイルは、現在のディレクトリの上に3つのディレクトリとして配置されます。

説明

ほとんどのオペレーティング・システムでは、入出力用に次の3つのチャネルがサポートされています:

STDIN (標準入力チャネル)
STDOUT (標準出力チャネル)
STDERR (標準エラー・チャネル)

ほとんどのオペレーティング・システムでは、データがパイプされる前述のチャネルに応じて、アプリケーションによって生成されたデータをリダイレクトするためのコマンドライン・オプションも提供されます。

MaxLのエラーにはSTDERRのフラグが付けられ、オペレーティング・システムのリダイレクション・ハンドルを使用したエラーのコマンドライン・リダイレクションが可能になります。エラー以外の場合はSTDOUTとしてフラグが付けられるため、通常の出力はエラー出力とは別に記録されることがあります。呼出し時にエラー出力をリダイレクトする例を次に示します:

essmsh script.mxl 2>errorfile.err

ノート:

オペレーティング・システムのリダイレクション・ハンドルは異なります。プラットフォームのドキュメントを確認してください。

spoolコマンドの対応するオプションを使用して、STDERRとSTDOUTを別々のMaxL出力ログにリダイレクトすることもできます。たとえば、スクリプトに次の行を配置することで、あるファイルにエラーを送り、別のファイルに出力できます:

spool stdout on to 'output.txt';
spool stderr on to 'errors.txt';

または、次の場合にのみエラーを送信できます:

spool stderr on to 'errors.txt';

または、次の場合にのみ出力を送信できます:

spool stdout on to 'output.txt';

ノート:

汎用スプールと特殊な出力チャネル・スプールを同じスクリプトで使用することはできません。たとえば、次の例は無効です:

spool on to 'session.txt';
spool stderr on to 'errors.txt';