resource_data_input 情報

オンライン編集

目的

リソース・クラスおよびリソース属性の名前と値を Resource Monitoring and Control (RMC) コマンド・ライン・インターフェース (CLI) に渡すための入力ファイルの使用に関する情報を提供します。

説明

-f コマンド・ライン・フラグを使用してリソース・データ入力ファイルの名前を指定することで、コマンド・ラインを直接使用する場合に、リソースの永続属性値を RMC CLI に渡すことができます。この場合、コマンド・ラインの使用が煩雑になったり、タイプミスが発生しやすくなったりする可能性があります。 このファイルのデータは、リソースを定義したり、リソースまたはリソース・クラスの永続属性の値を変更したりする際に使用します。 このファイルにはロケーションが設定されていません。 要件に応じて、一時ファイルまたは永続ファイルにすることができます。

mkrsrc および chrsrc コマンドは、 -f フラグを指定して発行されると、このファイルを読み取ります。 lsrsrcdef および lsactdef コマンドは、 -i フラグを指定して発行されると、このフォーマットのファイルを生成します。

PersistentResourceAttributes
新規リソースを定義するか、あるいは既存のリソースの属性値を変更するために使用される、特定のリソース・クラスの 1 つ以上のリソースの永続属性名および値です。 永続リソース属性は、コマンド mkrsrc および chrsrcによって読み取られます。 -c フラグで指定された chrsrc コマンドによって入力ファイルが読み取られる場合、これらの属性は無視されます。
PersistentResourceClassAttributes
既存のリソース・クラスの属性値を変更するために使用されるリソース・クラスの永続属性名および値です。 永続リソース・クラス属性は、 -c フラグが指定されている場合にのみ、コマンド chrsrc によって読み取られます。
一般に、 resource_data_input ファイルは、以下の形式のフラット・テキスト・ファイルです。 太字の単語はリテラルです。 単一コロン (:) の前にあるテキストは任意のラベルであり、任意の英数字テキストにすることができます。
PersistentResourceAttributes::
# This is a comment
    label:
      AttrName1  = value 
      AttrName2  = value 
      AttrName3  = value 
    another label:
        Name        = name
        NodeNumber  = 1
        ::
PersistentResourceClassAttributes::
    label:
      SomeSettableAttrName 		= value
      SomeOtherSettableAttrName 	= value
    ::
詳しくは、 Examples のセクションを参照してください。
フォーマットに関する注の一部は次のとおりです。
  • キーワード PersistentResourceAttributes および PersistentResourceClassAttributes の後には、二重コロン (::) が続きます。
  • キーワード・スタンザの順序はこのファイルでは重要ではありません。 例えば、 PersistentResourceClassAttributes を PersistentResourceClassの前に置くことができます。 これは CLI の呼び出しで読み取られるデータ部分には影響しません。
  • 個々のスタンザ見出し (キーワードの下) の後には、単一のコロン (:) が続きます。例えば、 c175n05 resource info: のようになります。
  • 行の先頭の空白は特に意味がありません。 タブやスペースは読みやすくするために使用されています。
  • 最初の印刷可能文字としてポンド記号 (#) が付いている行は、コメントです。
  • 個々の行の各入力は空白 (タブまたはスペース) で区切られます。
  • ファイル中のブランク行には特に意味はありませんが、読みやすくするために使用されています。
  • 特定の PersistentResourceAttributes セクションに含まれるリソース属性スタンザの数に制限はありません。
  • 特定の PersistentResourceClassAttributes セクションに含まれるリソース・クラス属性スタンザの数に制限はありません。 通常、リソース・クラスにあるインスタンスは 1 つのみです。 この場合、必要となるスタンザは 1 つです。
  • 特定の PersistentResourceAttributes セクションに含まれるリソース属性スタンザが 1 つのみの場合は、 label: 行を省略できます。
  • 特定の PersistentResourceClassAttributes セクションにリソース・クラス属性スタンザが 1 つしか含まれていない場合は、 label: 行を省略できます。
  • スペースを含む値は引用符で囲む必要があります。
  • 二重コロン (::) は、セクションの終わりを示します。 終了の二重コロンが見つからない場合は、次の Reserved Keyword または end of file がセクションの終わりをシグナル通知します。
  • 二重引用符で囲まれたストリング内に含まれる二重引用符は、エスケープする必要があります。 (\")。
    注: 二重引用符は、単一引用符内にネストすることができます。
    以下に例を示します。
    • "Name == \"testing\""
    • 'Name == "testing"'

      その文字列が選択文字列であり、コマンド・ラインにカット・アンド・ペーストしたい場合は、この構文を使用します。

  • 単一引用符で囲まれたストリング内に含まれる単一引用符は、エスケープする必要があります。 (\')。
    注: 単一引用符は、二重引用符で囲んでネストすることができます。
    以下に例を示します。
    • 'Isn\'t that true'
    • "Isn't that true"

      コマンド・ラインにカット・アンド・ペーストしたい場合は、この構文の使用が推奨されます。

  • resource_data_input ファイルにデータを入力するために使用する形式は、コマンド行で使用する形式とは異なる場合があります。 コマンドを実行するために選択するシェルには、引用符に関する独自の規則があります。 コマンド・ラインへのデータ入力の方法を決定するこれらの規則については、そのシェルの資料を参照してください。

例

  1. この mkrsrc コマンドの例を以下に示します。
    mkrsrc -f /tmp/my_resource_data_input_file IBM.Example
    IBM.Example リソース・クラスのサンプル入力ファイル /tmp/my_resource_data_input_file を使用します。 入力ファイルの内容は次のようになります。
    PersistentResourceAttributes::
# Resource 1 - only set required attributes
resource 1:
    Name="c175n04"
    NodeList = {1}
# Resource 2 - setting both required and optional attributes
# mkrsrc -e2 IBM.Example displays required and optional
# persistent attributes
resource 2:
    Name="c175n05"
    NodeList = {1}
    Int32 = -99
    Uint32 = 99
    Int64 = -123456789123456789
    Uint64 = 123456789123456789
    Float32 = -9.89
    Float64 = 123456789.123456789
    String = "testing 123"
    Binary = 0xaabbccddeeff
    RH = "0x0000 0x0000 0x00000000 0x00000000 0x00000000 0x00000000"
    SD = [hello,1,{2,4,6,8}]
    Int32Array = {-4, -3, -2, -1, 0, 1, 2, 3, 4}
    Int64Array = {-4,-3,-2,-1,0,1,2,3,4}
    Uint32Array = {0,1,2,3,4,5,6}
    Uint64Array = {0,1,2,3,4,5,6}
    Float32Array = {-3.3, -2.2, -1.2, 0, 1, 2.2, 3.3}
    Float64Array = {-3.3, -2.2, -1.2, 0, 1, 2.2, 3.3}
    StringArray = {abc,"do re mi", 123}
    BinaryArray = {"0x01", "0x02", "0x0304"}
    RHArray     = {"0x0000 0x0000 0x00000000 0x00000000 0x00000000 0x00000000",
                   "0xaaaa 0xaaaa 0xbbbbbbbb 0xcccccccc 0xdddddddd 0xeeeeeeee"}
    SDArray     = {[hello,1,{0,1,2,3}],[hello2,2,{2,4,6,8}]}
  2. この chrsrc コマンドの例を以下に示します。
    chrsrc -f  /tmp/Example/ch_resources -s 'Name == "c175n05"' IBM.Example
    サンプル入力ファイル /tmp/Example/ch_resources を使用して、既存の IBM.Example リソースの属性値を変更します。 入力ファイルの内容は次のようになります。
    PersistentResourceAttributes::
# Changing resources that match the selection string entered
# when running chrsrc command.
	resource 1:
        String            = "this is a string test" 
        Int32Array        = {10,-20,30,-40,50,-60}