システムレベルでの RunCommand マクロ

RunCommand マクロは、データソースでコマンドを実行するために使用します。これは RunSQL マクロの拡張されたバージョンです。このマクロは、シナリオのコンテキストに固有でないシステムレベルのコマンドをサポートしています。このコマンドを使用すると、SCP または外部データで静的データまたは構成データが更新されます。

次の表に、システムレベルでの RunCommand マクロの実行に使用するパラメーターを示します。


パラメーター	説明
データソース	コマンドを実行するデータソース。[データベース] を選択します。
コマンドテキスト	指定したデータソースで実行するコマンド。
タイムアウト	現在処理中の場合、ブロックプロセスが完了するまで待機する時間 (秒)。注: この値が指定されていない場合、待機期間は無限になります。

[コマンド] フィールドの値を次の形式で指定する必要があります。RunCommand (データソース、コマンドテキスト、[タイムアウト])

注: オプションパラメーターは [ ] で指定します。

表 1. 例
要件	パラメーター
データソース「テスト」で「リセット」コマンドを実行します。	RunCommand ("Test", "Reset")

コマンドは、マクロの検証と実行に成功したときに指定されたデータソースに対して実行されます。

RunCommand マクロの実行時に検証が実行されます。検証に失敗した場合、マクロは中止され、関連するエラーメッセージが表示されます。次の表は、さまざまな検証エラーで表示されるエラーメッセージを示しています。


検証条件	エラーメッセージ
RunCommand は、データソースタイプ「Database」のみをサポートしています。	RunCommand マクロには、タイプ Database のデータソースが必要です。
データソースが有効であることを確認します。	データソース {0} が見つかりません。