Fichier d'informations resource_data_input

Les mots clés sont utilisés dans le fichier d'entrée pour indiquer quel type de données est répertorié dans la strophe associée:

ResourceAction

Noms et valeurs des éléments d'action de ressource pour l'action de ressource lors du démarrage d'une action. La commande runact lit les éléments d'action de ressource. Ces éléments sont ignorés si le fichier d'entrée est lu par runact -c.

ResourceClassAction

Noms et valeurs des éléments d'action de classe de ressource pour l'action de classe de ressource lors du démarrage d'une action de classe. La commande runact lit les éléments d'action de ressource.

PersistentResourceArguments

Noms et valeurs des arguments de commande de ressource pour les commandes qui les acceptent: mkrsrc, resetrsrc, rmrsrc, startrsrcet stoprsrc. Les arguments de commande sont facultatifs et sont définis par la classe de ressources. Spécifiez l'option -l avec ces commandes pour afficher les arguments de commande d'une classe de ressources.

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 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 entrée_données_ressource est un fichier texte à plat au format suivant. Les mots Gras sont des littéraux. Le texte qui précède un seul 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::
# This is a comment
    label:
      SomeSettableAttrName 		= value
      SomeOtherSettableAttrName 	= value
    ::
⋮

PersistentResourceArguments::
# This is a comment
    label:
      ArgName1  = value 
      ArgName2  = value 
      ArgName3  = value 
    ::
⋮

Voir la section Exemples pour plus de détails.

Voici quelques remarques sur le formatage:

• Les mots-clés PersistentResourceAttributes, PersistentResourceClassAttributes et PersistentResourceArguments sont suivis de 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 strophes d'attributs de ressources incluses dans une section particulière PersistentResourceAttributes section.
• Il n'y a pas de limite au nombre de strophes d'attributs de classe de ressources incluses dans une section particulière PersistentResourceClassAttributes section. 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 strophe d'attribut de ressource est incluse dans une section particulière, la ligne label : peut être omise PersistentResourceAttributes la ligne label : peut être omise. Cela s'applique également à la section ResourceAction .
• Si une seule strophe d'attribut de classe de ressources est incluse dans une section particulière, la ligne label : peut être omise PersistentResourceClassAttributes la ligne label : peut être omise. Ceci s'applique également à la ResourceClassAction section.
• 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 Mot clé réservé ou fin de fichier 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.
  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 quelques 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 entrée_données_ressource 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.

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} 

3. Cet exemple de commande rmrsrc :

   rmrsrc -l IBM.Examplebar

   affiche les arguments de commande facultatifs:

   rmrsrc IBM.Examplebar ExampleInt32=int32 ExampleUint32=uint32

4. Cet exemple de commande rmrsrc :

   rmrsrc -f /tmp/Examplebar/rm_resources -s 'Name == "c175n05"' IBM.Examplebar 

   utilise l'exemple de fichier d'entrée /tmp/Examplebar/rm_resources pour spécifier les arguments de commande facultatifs pour la commande rmrsrc . Le contenu du fichier d'entrée se présente comme suit:

   PersistentResourceArguments:: 
   # Specifying command arguments when running rmrsrc command. 
   resource 1: 
   	ExampleInt32      =   1
           ExampleUint32     =   0