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

1.2.78 mpalsexdef(インストールレス型エージェント個別情報設定コマンド)

■機能説明

インストールレス型エージェントで監視するために必要な情報について、ノードごとに個別に定義したファイル（インストールレス型エージェント監視の個別定義ファイル）の情報を反映します。

インストールレス型エージェント監視の個別定義ファイルを編集した場合は、当コマンドを使用して反映します。

■記述形式

mpalsexdef

-i 入力ファイル名 | -o 出力ファイル名

■オプション

-i 入力ファイル名

ユーザが作成した個別定義のCSVファイルをフルパスで指定します。

ファイル名、パス名に使用できる文字は、日本語、英数字、記号です。ファイル名とパス名には、特殊文字（*,?,",<,>,|,/,\）は使用できません。空白を含む場合は、二重引用符で囲みます。ファイル名の最大長は、フルパスで256バイトです。

-oオプションと同時に指定できません。

-o 出力ファイル名

個別定義情報を出力するCSVファイルをフルパスで指定します。出力ファイル名に指定したファイルがすでに存在する場合は、以下のエラーメッセージを出力してコマンドは終了します。

mpalsexdef : ERROR: 1105: The specified file already exists.

ファイル名、パス名に使用できる文字は、日本語、英数字、記号です。ファイル名とパス名には、特殊文字（*,?,",<,>,|,/,\）は使用できません。空白を含む場合は、二重引用符で囲みます。ファイル名の最大長は、フルパスで256バイトです。

出力するファイルの形式は、インストールレス型エージェント監視の個別定義ファイルと同じです。ただし、パスワード情報は、アスタリスク(*)で出力されます。

-iオプションと同時に指定できません。

■復帰値

0 : 正常終了
1 : パラメタエラー
2〜4 : 環境異常 (部門管理サーバ/業務サーバで実行した場合など)
5〜10 : 定義ファイル異常 (CSVファイルの形式異常など)
99 : 内部異常

■参照

インストールレス型エージェント監視の個別定義ファイル

■コマンド格納場所

Windows	Systemwalkerインストール先ディレクトリ\mpwalker.dm\bin
Solaris Linux	/opt/systemwalker/bin

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

【Windows】

• Administrator権限が必要です。
• 運用管理サーバで実行可能です。

【Solaris/Linux】

• システム管理者(スーパーユーザ)権限が必要です。
• 運用管理サーバで実行可能です。

■注意事項

個別定義ファイルには、暗号化していないパスワードが記述されているため、本コマンド実行後は、個別定義ファイルを削除してください。個別定義ファイルはユーザの責任で管理してください。

■使用例

【Windows】

mpalsexdef -i c:\temp/nodedef.csv

【Solaris/Linux】

mpalsexdef -i /tmp/nodedef.csv

■実行結果/出力形式

以下の文字列が標準出力に出力されます。

復帰値	実行結果
0	mpalsexdef : INFO: 0001: Completed. The policy must be distributed in order for the definitions to become effective.
1	mpalsexdef : Parameter error. Usage : mpalsexdef -i filename | -o filename
2	mpalsexdef : ERROR: 1002: Execute this command on the Operation Management Server.
3	mpalsexdef : ERROR: 1003: You do not have the required privileges to execute this command.
4	mpalsexdef : ERROR: 1004: A Systemwalker Centric Manager environment has not been created.
5	mpalsexdef : ERROR: 1005: The specified file does not exist.
6	mpalsexdef : ERROR: 1101: The login sequence information is incorrect.
7	mpalsexdef : ERROR: 1102: Some required information has not been specified. Line:%d Column=%d (注1)
8	mplalsexdef : ERROR: 1103: Failed to read the individual definition file.
9	mpalsexdef : ERROR: 1104: Code conversion failed because an invalid character has been specified.
10	mpalsexdef : ERROR: 1105: The specified file already exists.
99	mpalsexdef : internal error. (%d) (注2)

注1)LineとRowは、エラーを検出した行番号と列番号です。
注2)(%d)には、詳細コードが表示されます。詳細コードの内容は調査用内部情報です。