名称

      mxcollection - Systems Insight Managerでの収集の追加、表示、、削除およ
      び収集のメンバー


構文

      mxcollection -a -f filename (収集の追加)
      mxcollection -a mem -f filename xmlファイルから既存の収集へメンバー
      の追加)
      mxcollection -m mem -f xmlファイルから収集内のメンバーのプロパティの
      編集)
      mxcollection -d 収集名 (収集の削除)
      mxcollection -r mem -f filename xmlファイルから収集内のメンバーの削
      除)
      mxcollection -ln (階層ツリー形式での収集名の表示)
      mxcollection -lf 収集名 [-b encoding] xmlファイルへの指定した収集メ
      ンバーの表示)


説明

      mxcollection コマンドにより、Systems Insight ManagerユーザにSystems
      Insight Managerの収集の追加、表示、変更、削除を許可します。


      重要: 初期のHP Systems Insight Managerリリースでは、mxqueryコマンドで
      カテゴリを作成したり処理することができました。このリリースでは、収集は
      カテゴリの拡張で、mxcollectionコマンドで管理されます。 mxcollection
      は、名前により個別にメンバーを選択することができます。 クエリの作成お
      よび管理する場合、検索属性を指定するにはmxqueryを使用する必要がありま
      す。


      mxcollectionの最初の形式(mxcollection -a -f filename)は、ユーザに収
      集と収集の中のメンバーの追加を許可します。システム、クエリ、およびその
      他の収集は収集のメンバーになります。収集に関する情報は、収集スキーマ
      ファイル( mxcollection(4) 参照)で提供されていて、ユーザはSystems
      Insight Managerの収集を追加できます。


      追加操作中、Systems Insight Managerは、現在のSystems Insight Managerレ
      ポジトリにある収集およびノード グループを参照しない名前のみ収集を追加
      することができます。 Systems Insight Managerが名前の重複を検出した場
      合、Systems Insight Manager重複した収集はスキップしますが、重複しない
      収集は追加します。重複した収集をスキップした場合、終了コードには影響さ
      れません。


      mxcollectionの2番目の形式(mxcollection -a mem -f filename)は、ユーザ
      に既存の収集にメンバーの追加を許可します。

      収集を変更する場合、ユーザは収集の所有者か完全な権限を持つユーザでなけ
      ればなりません。

      mxcollectionの3番目の形式(mxcollection -m mem -f filename)は、ユーザ
      にプロパティまたは既存のSystems Insight Manager収集にメンバーのの変更
      を許可します。

      収集およびその内容を変更する場合、ユーザは収集の所有者か完全な権限を持
      つユーザでなければなりません。


      mxcollectionの3番目の形式(mxcollection -d collectionname)は、ユーザ
      にSystems Insight Managerの収集の削除を許可します。完全な権限を持つ
      ユーザまたは収集の所有者のみが収集を削除できます。ユーザがSystems
      Insight Managerの収集に一致しない収集名を指定した場合、Systems Insight
      Managerは収集を削除できないというメッセージを表示します。

      タスク、レポート、認証、またはバナー ステータス エリアで使用されている
      場合、収集は削除できません。それらにメンバーを含んでいる場合、収集は削
      除できません。

      mxcollectionの4番目の形式(mxcollection -r mem -f filename)は、ユーザ
      に指定した収集からメンバーの削除を許可します。完全な権限を持つユーザま
      たは収集の所有者のみが収集の内容を削除できます。

      クエリまたはサブの収集は、他の収集のメンバーではない場合、指定した収集
      から削除できません。


      mxcollectionの5番目の形式(mxcollection -ln)は、ユーザにすべての
      Systems Insight Managerの収集を階層ツリー形式での表示を許可します。


      mxcollectionの6番目の形式(mxcollection -lf collectionname)は、指定し
      たSystems Insight Manager収集の完全なSystems Insight Managerの収集定義
      ( mxcollection(4) を参照) を標準出力に出力します。



    オプション
      mxcollection には、以下のオプションがあります。

	   -a -f		  収集定義ファイルで指定した1つ以上のSystems Insight
			  Manager収集が追加されたことを意味します。


	   -a mem	  指定した収集定義ファイルで定義された収集に1つ以上
			  のSystems Insight Managerメンバーが追加されたこと
			  を意味します。


	   -m mem	  指定した収集定義ファイルで定義によって、1つ以上の
			  Systems Insight Manager収集メンバーが変更されたこ
			  とを意味します。

	   -d		  指定したSystems Insight Manager収集が削除されたこ
			  とを意味します。

	   collectionname	  削除または表示するSystems Insight Manager収集の名
			  前を指定します。

	   -lf		  Systems Insight Manager収集のファイル フォーマット
			  形式を表示します。

	   -ln		  Systems Insight Manager収集の名前をツリー階層形式
			  で表示します。

	   -b encoding	   -lf オプションと併せて使用する場合は、XMLファイル
			  の文字エンコードを指定します。




戻り値

      終了すると mxcollection は以下を返します。


	     0	操作は正常終了しました。
	     -1	実行中にエラーが発生しました。

著者

      mxcollection は、HPにより開発されました。

mxcollection(4)

      を参照してください。