Systemwalker Centric Manager リファレンスマニュアル - UNIX/Windows(R)共通 -

1.2.65 idorcagent(操作制御エージェント起動条件ファイル作成コマンド)

■機能説明

操作制御エージェント起動条件ファイルを作成し、適用します。

コマンドを実行後に、Administratorsグループに所属したユーザのユーザIDとパスワードの入力が必要です。

■記述形式

idorcagent

filename [-r] [-n]

■オプション

filename:

操作制御エージェント起動条件記述ファイルをフルパスで指定します。

-r:

操作制御エージェント起動条件ファイルから操作制御エージェント起動条件記述ファイルを復元します。Systemwalker Centric Managerの再起動後に反映するように操作制御エージェント起動条件ファイルを作成した場合は、現在の動作している定義ではなく、次回起動時に反映する情報から復元します。

“-n”オプションと同時に指定した場合は、現在動作中の操作制御エージェント起動条件ファイルから復元します。

-n:

操作制御エージェント起動条件ファイルの設定内容を即時適用する場合に指定します。-nを指定しない場合は、次回のSystemwalker Centric Manager起動時に設定内容を反映します。

“-r”オプションと同時に指定した場合は、現在動作中の操作制御エージェント起動条件ファイルから復元します。

■復帰値

0:

正常終了

0以外:

異常終了

■参照

操作制御エージェント起動条件記述ファイル

■コマンド格納場所

Windows

Systemwalkerインストールディレクトリ\mpwalker.dm\MpOrCtrl\bin

■実行に必要な権限/実行環境

【Windows】

• Administrator権限が必要です。
• Windows Vista で本コマンドを実行する場合、[管理者として実行]を選択して起動したコマンドプロンプト上で実行してください。
  以下にコマンドプロンプトの起動例を示します。
  例：
  [スタート]-[アクセサリ]-[コマンド プロンプト]を右クリックして表示されるメニューから、[管理者として実行]を選択して起動する。
• 運用管理サーバ/運用管理クライアントで実行可能です。

■注意事項

• コンソール操作制御の運用が「ログインIDでの操作の保護」の場合、本コマンドによる設定は必要ありません。
• 操作制御エージェント起動条件記述ファイルに指定するパラメタの値をすべて省略値で運用する場合、本コマンドによる設定は必要ありません。

■使用例

操作制御エージェント起動条件ファイルを作成します。

c:\win32app\mpwalker.dm\MpOrCtrl\bin\idorcagent.exe c:\temp\idorcagent.conf
User Name: User
Password: XXXXX

■実行結果/出力形式

操作制御エージェント起動条件記述ファイルの形式が正しくない場合、以下のように出力されます。以下の例はintervalパラメタに不当な値を指定した場合です。

処理を継続する場合：

c:\win32app\mpwalker.dm\MpOrCtrl\bin\idorcagent.exe c:\temp\idorcagent.conf
line 2: Invalid value. [interval=9999]
Continue the conversion? (y/n) y
User Name:User
Password: XXXX

処理を中断する場合：

c:\win32app\mpwalker.dm\MpOrCtrl\bin\idorcagent.exe c:\temp\idorcagent.conf
line 2: Invalid value. [interval=9999]
Continue the conversion? (y/n) n

Command aborted.

■コマンドが出力するメッセージ

本コマンドでは以下のメッセージを出力します。

メッセージ：	Unauthorized to execute the command.
意味と対処：	実行権限のないユーザでコマンドを実行しました。 Administrator権限のあるユーザで実行してください。
メッセージ：	Systemwalker Centric Manager is currently not running. The settings will take effect when Systemwalker Centric Manager is started next time.
意味と対処：	コンソール操作制御のサービスが停止しているときに、-nオプションを指定してコマンドを実行しました。定義は次回のSystemwalker Centric Manager起動時に有効になります。 定義を有効にするためにはSystemwalker Centric Managerを起動してください。
メッセージ：	Please input the administrators id and password.
意味と対処：	入力されたユーザIDまたはパスワードが正しくありません。または、ユーザIDにコマンドの実行権がありません。 正しいユーザIDとパスワードを入力してください。
メッセージ：	No parameter is specified. The default values will be used for all parameters.
意味と対処：	指定された操作制御エージェント起動条件記述ファイル内に有効なパラメタが存在しません。継続する場合、継続確認メッセージ（“Continue the conversion? (y/n)”）に“y”を入力してください。中断する場合は、“n”を入力してください。

■操作制御エージェント起動条件記述ファイルの形式エラーのメッセージ

操作制御エージェント起動条件記述ファイルの形式に誤りがある場合は、誤りを訂正して使用するようにしてください。

コンソール操作制御では操作制御エージェント起動条件記述ファイルの形式に誤りがある場合に、その定義を省略値に変更または定義を無効にして、処理を続行することが可能です。形式エラーの内容を示すエラーメッセージを出力後に以下の問合せのメッセージが出力されます。

メッセージ：	Continue the conversion? (y/n)
対処：	エラー内容を確認し変換処理を継続する場合は、"y"を入力後、Enterキーを入力します。処理を中断する場合は、"n"を入力後、Enterキーを入力します。
継続時の処理：	エラーと判定した項目に省略値がある場合は、省略値で定義されます。省略値がないものは定義された項目が無効となります。
中断時の処理：	以下のメッセージを出力し、変換処理を中止します。 "Command aborted."

操作制御エージェント起動条件記述ファイルの形式エラーの内容は、以下の形式で出力されます。

line NN: メッセージ [エラー文字列]

　NN: 操作制御エージェント起動条件記述ファイルの先頭からの行番号

　メッセージ: エラーメッセージ

　エラー文字列: エラーと判定した文字列

形式エラーとして以下のメッセージが出力されます。

メッセージ：	Invalid value.
意味:	不当な値が指定されました。
メッセージ：	Invalid format.
意味:	記述形式が正しくありません。
メッセージ：	The parameter "interval" is already declared.
意味:	intervalパラメタはすでに指定されています。
メッセージ：	The parameter "hide_id" is already declared.
意味:	hide_idパラメタはすでに指定されています。
メッセージ：	The line is too long.
意味:	1行の長さが1040バイトを超えています。