rmccli 情報

オンライン編集

目的

Resource Monitoring and Control (RMC) と関連するコマンドについての一般情報を提供します。

説明

RMC および関連コマンドに関する一般情報 (データ・タイプ、用語、および関連情報への参照を含む) が記載されています。

コマンドの構造および使用
RMC コマンドは、リソース・クラスおよびリソースに対して実行できるさまざまな操作を表すカテゴリーにグループ化することができます。
  • リソースの作成と削除: mkrsrc、 rmrsrc
  • リソースの変更: chrsrc、 refrsrc
  • 定義およびデータの表示: lsrsrc、 lsrsrcdef
  • アクションの表示: lsactdef
  • アクションの実行: runact
RMC コマンドはコマンド・ラインから直接実行することも、ユーザー作成スクリプトによって呼び出すこともできます。 さらに、RMC コマンドは、イベント応答リソース・マネージャー (ERRM) コマンドのような高水準コマンドの基本としても使用されます。
データ表示情報
RMC CLI ルーチンの表示機能を制御するフラグは、優先順位の順に以下のとおりです。
  1. –l (長時間表示の場合)。 これは、デフォルトの表示形式です。
    例えば、次のコマンド
    lsrsrc -s 'Name == "c175n05"' IBM.Foo Name NodeList SD Binary RH Int32Array
    次のような出力が生成されます。
    Persistent Attributes for Resource: IBM.Foo
resource 1:
        Name       = "c175n05"
        NodeList   = {1}
        SD         = ["testing 1 2 3",1,{0,1,2}]
        Binary     = "0xaabbcc00 0xeeff"
        RH         = "0x0000 0x0000 0x00000000 0x00000000 0x00000000 0x00000000"
        Int32Array = {1,5,-10,1000000}
  2. –t (表形式の表示の場合)。
    例えば、次のコマンド
    lsrsrc -s 'Name ?= "Page"' -t IBM.Condition Name EventExpression
    次のような出力が生成されます。
    Persistent Attributes for Resource: IBM.Condition

Name                  EventExpression       
"Page space out rate" "VMPgSpOutRate > 500" 
"Page fault rate"     "VMPgFaultRate > 500" 
"Page out rate"       "VMPgOutRate > 500"   
"Page in rate"        "VMPgInRate > 500"    
"Page space in rate"  "VMPgSpInRate > 500"
  3. 印刷時にヘッダーを抑止する場合は、 –x 。
  4. コロン (:) で区切られた表示の場合は、 –d 。
    例えば、次のコマンド
    lsrsrc -xd -s 'Name == "c175n05"' IBM.Foo Name Int32 Uint32Array SD Binary
    次のような出力が生成されます。
    c175n05:-100:{}:["hel  lo1",1,{0,1,2}]:"0xaabbcc00 0xeeff":
    –x フラグを –d フラグと一緒に使用することに注意してください。
  5. –D delimiter (ストリング区切り表示の場合)。
    例えば、次のコマンド
    lsrsrc -xD:: -s 'Name == "c175n05"' IBM.Foo Name Int32 Uint32Array SD Binary
    次のような出力が生成されます。
    c175n05::-100::{}::["hel  lo1",1,{0,1,2}]::"0xaabbcc00 0xeeff"::
    –x フラグを –D Delimiter フラグと一緒に使用することに注意してください。
リスト・コマンド (lsrsrc、 lsrsrcdef) の出力が表形式の出力形式で表示される場合、印刷列の幅が切り捨てられることがあります。 さらに多くの文字を表示する必要がある場合は (ストリングの場合のように)、 –l フラグを使用してフィールド全体を表示します。
データ入力フォーマット
バイナリー・データは、以下の形式で入力できます。
  • "0x######## 0x######## 0x####..."
  • "0x###################..."
  • 0x################...
ストリングを入力データとして指定する場合は、以下のことに注意してください。
  • 空白文字も非英数字文字も含まないストリングは、引用符で囲まずに入力として入力できます。
  • 空白文字またはその他の英数字を含むストリングは、引用符で囲む必要があります。
  • 単一引用符 (') を含むストリングは、二重引用符 (") で囲む必要があります。以下に例を示します。 "this is a string with 'single quotations marks'"
選択文字列内に二重引用符がない限り、選択文字列を二重引用符で囲む必要があります。二重引用符がある場合、選択文字列を一重引用符で囲む必要があります。 選択文字列を指定する方法については、「RSCT: Administration Guide」を参照してください。
  • 選択文字列の入力例は次のようになります。"NodeNumber == 1"
  • 二重引用符が選択文字列の一部である選択文字列の入力は次のようになります。'Name == "c175n05"'

構造化データ (SD) 型は、大括弧で囲む必要があります。[hello,1,{2,4,6,8}]

RMC コマンドへのコマンド行入力として構造化データ (SD) を指定する場合は、次のように SD を単一引用符で囲んでください。 SD='[hello,1,{2,4,6,8}]'

すべてのタイプの配列は中括弧 {} で囲む必要があります。
  • 整数の配列: {-4, -3, -2, -1, 0, 1, 2, 3, 4}
  • 文字列の配列: {abc, "do re mi", 123}
  • 構造化データの配列: {[hello,1,{0,1,2,3}],[hello2,2,{2,4,6,8}]}
複数のエレメントを持つすべてのタイプの配列は、引用符で囲む必要があります。 次に例を示します。
  • mkrsrc IBM® Foo Name=テスト NodeList={1 } {1,2,3}Uint32Array= ''
  • mkrsrc IBM Foo Name=testing NodeList='{1 }' {1,2,3}Uint32_array= ''
文字列の配列および構造化データの配列は、常に引用符で囲む必要があります。
構造化データの配列、または引用符で囲まれたストリングを含む配列を RMC コマンドへのコマンド行入力として提供する場合は、配列全体を単一引用符で囲んでください。
  • 文字列の配列: mkrsrc IBM.Foo Name="c175n05" NodeList={1} StringArray='{"a string","a different string"}'
  • 構造化データの配列: mkrsrc IBM.Foo Name="c175n05" NodeList={1} SDArray='{["string 1",1,{1,1}],["string 2",2,{1,2,3}]}'

その他の例については、 resource_data_input 情報ファイルを参照してください。

データ出力フォーマット
ストリング・データは、以下に示すように、常に二重引用符または単一引用符で囲んで表示されます。
  • ストリング「This is a string that contains white space」と等しい記述属性は、次のように長形式を使用して表示されます。
    Description = "This is a string that contains white space"
  • 空の文字列 "" と等しい記述属性値は次のように長形式で表示されます。
    Description = ""
  • 文字列の終わりに改行文字を含む文字列と等しい記述属性値は次のように長形式で表示されます。
    Description = "This string ends with a new-line character..."
  • 二重引用符を含む選択文字列は、次のように長形式で表示されます。
    SelectionString = 'Name == "c175n05"'
  • 文字列「c175n05」と等しい名前属性値は次のように長形式で表示されます。
    Name = "c175n05"
バイナリー・データは次のように表示されます。
"0x######## 0x######## 0x######## 0x###..."
命名規則
以下の変数名は、RMC コマンド情報全体で使用されます。
変数
説明
attr
リソース・クラスまたはリソース属性の名前
リソース・クラス
リソース・クラスの名前
用語
属性
属性は、永続的または動的のいずれかです。 リソース・クラスは、永続属性と動的属性のセットによって定義されます。 リソースも、永続属性と動的属性のセットによって定義されます。 永続属性は、リソース・クラスおよびリソースの構成を定義します。 動的属性は、リソース・クラスおよびリソースの状態またはパフォーマンス関連の側面を定義します。 同じリソース・クラスまたはリソースで、特定の属性名を永続または動的のいずれかとして指定できますが、両方とも指定することはできません。
リソース
システム内でのサービスのセットを提供するエンティティー。 ハードウェア・エンティティーには、プロセッサー、ディスク・ドライブ、メモリー、アダプターがあります。 ソフトウェア・エンティティーには、データベース・アプリケーション、プロセス、ファイルシステムがあります。 システム内の各リソースには、リソースの状態を定義する 1 つ以上の属性が存在します。
リソース・クラス
ノード、ファイルシステム、アダプターなどのシステム・リソースの広範なカテゴリー。 各リソース・クラスにはそのリソース・クラスに適用される機能、情報、動的属性、および条件を収めるコンテナーがあります。 例えば、 /tmp 使用済みスペース 条件はファイル・システム・リソース・クラスに適用されます。
リソース・マネージャー
リソースおよびリソース・クラス抽象を 1 つ以上の特定のタイプのリソースの呼び出しおよびコマンドにマップするプロセス。 リソース・マネージャーは、スタンドアロン・デーモンにすることも、アプリケーションまたはサブシステムに直接統合することもできます。
システムに定義されているすべてのリソース・クラスを表示するには、フラグまたはパラメーターを指定せずに lsrsrc コマンドを実行します。 システムに定義されている IBM.FileSystem リソース・クラスのすべてのリソースを表示するには、次のように入力します。
lsrsrc IBM.FileSystem
選択文字列
二重引用符または一重引用符で囲む必要があります。 選択文字列に二重引用符が含まれている場合は、その選択文字列全体を一重引用符で囲んでください。例えば、次のようになります。
-s 'Name == "testing"'

-s 'Name ?= "test"'

永続属性のみを選択文字列にリストすることができます。 選択文字列を指定する方法については、「RSCT: Administration Guide」を参照してください。

フラグ

-h
コマンドの使用ステートメント (使用法) を標準出力に書き込みます。
-T
コマンドのトレース・メッセージを標準エラーに書き込みます。 これは、ソフトウェア保守部門専用の機能です。
-V
コマンドの詳細メッセージを標準出力に書き込みます。
すべての RMC コマンドには、 -T フラグと -V フラグが含まれています。 -T フラグは、ソフトウェア・サービス組織からトレースをオンにするように指示された場合にのみ使用してください。 トレース・メッセージは変換されません。 コマンドに関する詳細情報を表示するには、「詳細」モードを示す -V フラグを使用します。 詳細メッセージは、メッセージ・カタログに含まれ、実行しているロケールおよびその他の基準に基づいて翻訳されます。

環境変数

CT_CONTACT
CT_CONTACT 環境変数をホスト名または IP アドレスに設定すると、コマンドは指定されたホストの RMC (Resource Monitoring and Control) デーモンにアクセスします。 この環境変数を設定しないと、コマンドは、そのコマンドが実行されているローカル・システムの RMC デーモンにアクセスします。 コマンドにより表示または変更されるリソースまたはリソース・クラスは、 接続が確立されたシステム上で探されます。
CT_MANAGEMENT_SCOPE
RMC デーモンがリソースおよびリソース・クラスをモニターし、制御するための セッションに使用する管理有効範囲を指定します。 この管理有効範囲により、リソースおよびリソース・クラスをモニターおよび制御できる候補ターゲット・ノードのセットが決定します。 有効な値は以下のとおりです。
0
local 有効範囲を指定します。
1
local 有効範囲を指定します。
2
peer domain (ピア・ドメイン) 有効範囲を指定します。
3
management domain (管理ドメイン) 有効範囲を指定します。

この環境変数が設定されていない 場合は、local 有効範囲が使用されます。