Informations sur resource_data_input

Objectif

Fournit des informations sur l'utilisation d'un fichier d'entrée pour la transmission de noms et de valeurs d'attribut de classe de ressource et de ressource à l'interface de ligne de commande RMC (Resource Monitoring and Control).

Descriptif

Vous pouvez spécifier le nom d'un fichier d'entrée de données de ressource à l'aide de l'indicateur de ligne de commande -f pour transmettre des valeurs d'attribut persistant de ressource à l'interface de ligne de commande RMC lorsque l'utilisation directe de la ligne de commande est trop lourde ou risque de générer des erreurs typographiques. Les données de ce fichier sont utilisées pour définir des ressources ou pour modifier les valeurs d'attribut persistant d'une ressource ou d'une classe de ressources. Ce fichier n'a pas d'emplacement défini. Il peut s'agir d'un fichier temporaire ou d'un fichier permanent, selon les besoins.

Les commandes mkrsrc et chrsrc lisent ce fichier lorsqu'elles sont émises avec l'indicateur -f . Les commandes lsrsrcdef et lsactdef génèrent un fichier avec ce format lorsqu'elles sont émises avec l'indicateur -i .

PersistentResourceAttributes
Noms et valeurs d'attribut persistants pour une ou plusieurs ressources d'une classe de ressources spécifique utilisées pour définir une nouvelle ressource ou pour modifier les valeurs d'attribut d'une ressource existante. Les attributs de ressource persistants sont lus par les commandes mkrsrc et chrsrc. Ces attributs sont ignorés si le fichier d'entrée est lu par la commande chrsrc qui a été spécifiée avec l'indicateur -c .
PersistentResourceClassAttributes
Noms et valeurs d'attribut persistants pour une classe de ressources utilisée pour modifier les valeurs d'attribut d'une classe de ressources existante. Les attributs de classe de ressources persistantes sont lus par la commande chrsrc uniquement lorsque l'indicateur -c est spécifié.
En général, un fichier resource_data_input est un fichier texte à plat au format suivant. Les mots en gras sont des littéraux. Le texte qui précède un signe deux-points (:) est un libellé arbitraire et peut être n'importe quel texte alphanumérique.
PersistentResourceAttributes::
# This is a comment
    label:
      AttrName1  = value 
      AttrName2  = value 
      AttrName3  = value 
    another label:
        Name        = name
        NodeNumber  = 1
        ::
PersistentResourceClassAttributes::
    label:
      SomeSettableAttrName 		= value
      SomeOtherSettableAttrName 	= value
    ::
Voir la section Examples pour plus de détails.
Voici quelques remarques sur le formatage:
  • Les mots clés PersistentResourceAttributes et PersistentResourceClassAttributes sont suivis d'un double signe deux-points (::).
  • L'ordre des strophes de mots clés n'est pas significatif dans le fichier. Par exemple, PersistentResourceClassAttributes peut précéder PersistentResourceClass. Elle n'affecte pas la partie des données lues par l'interface de ligne de commande appelante.
  • Les en-têtes de section individuels (sous les mots clés) sont suivis d'un signe deux-points (:), par exemple: c175n05 resource info:
  • L'espace au début des lignes n'est pas significatif. Des tabulations ou des espaces sont suggérés pour la lisibilité.
  • Toute ligne comportant un signe dièse (#) comme premier caractère imprimable est un commentaire.
  • Chaque entrée d'une ligne individuelle est séparée par des espaces (espaces ou tabulations).
  • Les lignes vides du fichier ne sont pas significatives et sont suggérées pour la lisibilité.
  • Il n'y a pas de limite au nombre de sections d'attribut de ressource incluses dans une section PersistentResourceAttributes particulière.
  • Il n'y a pas de limite au nombre de strophes d'attributs de classe de ressources incluses dans une section PersistentResourceClassAttributes particulière. En règle générale, il n'existe qu'une seule instance d'une classe de ressources. Dans ce cas, une seule strophe est attendue.
  • Si une seule section d'attribut de ressource est incluse dans une section PersistentResourceAttributes particulière, la ligne label: peut être omise.
  • Si une seule section d'attribut de classe de ressources est incluse dans une section PersistentResourceClassAttributes particulière, la ligne label: peut être omise.
  • Les valeurs qui contiennent des espaces doivent être placées entre guillemets.
  • Un double signe deux-points (::) indique la fin d'une section. Si aucun signe deux-points de fin n'est trouvé, le Reserved Keyword ou end of file suivant signale la fin d'une section.
  • Les guillemets inclus dans une chaîne entourée de guillemets doivent être mis en échappement. (\").
    Remarque: Les guillemets peuvent être imbriqués dans des guillemets simples.
    Voici des exemples:
    • "Name == \"testing\""
    • 'Name == "testing"'

      Cette syntaxe est recommandée si votre chaîne est une chaîne de sélection et que vous allez la couper et la coller sur la ligne de commande.

  • Les guillemets simples inclus dans une chaîne entourée de guillemets simples doivent être mis en échappement. (\').
    Remarque: Les guillemets simples peuvent être imbriqués dans des guillemets doubles.
    Voici des exemples:
    • 'Isn\'t that true'
    • "Isn't that true"

      Cette syntaxe est recommandée si vous allez couper et coller dans la ligne de commande.

  • Le format que vous utilisez pour entrer des données dans un fichier resource_data_input peut ne pas être le même que celui utilisé sur la ligne de commande. Le shell dans lequel vous choisissez d'exécuter les commandes possède ses propres règles concernant les guillemets. Reportez-vous à la documentation de votre interpréteur de commandes pour ces règles, qui déterminent comment entrer des données sur la ligne de commande.

Exemples

  1. Cet exemple de commande mkrsrc :
    mkrsrc -f /tmp/my_resource_data_input_file IBM.Example
    utilise l'exemple de fichier d'entrée /tmp/my_resource_data_input_file pour la classe de ressources IBM.Example . Le contenu du fichier d'entrée se présente comme suit:
    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. Cet exemple de commande chrsrc :
    chrsrc -f  /tmp/Example/ch_resources -s 'Name == "c175n05"' IBM.Example
    utilise l'exemple de fichier d'entrée /tmp/Example/ch_resources pour modifier les valeurs d'attribut des ressources IBM.Example existantes. Le contenu du fichier d'entrée se présente comme suit:
    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}