lsrel

Nom

lsrel - Répertorie une relation gérée déjà définie et ses attributs.

Synopsis

lsrel [-h] [-s "selection_string"] [-A p | d | b] [-l | -t | -d | -D Délimiteur] [-T] [-V] [Attr... ]

lsrel [-h] [-M nom_relation] [-A p | d | b] [-l | -t | -d | -D Délimiteur] [-T] [-V] [Attr... ]

lsrel [-h] [-S Source_Class[:nom_ressource[:Noeud] ] [-s "Source_string"] [-G classe_cible[:nom_ressource[:Node] [, Target class[:nom_ressource[:Node] [, ... ] ] ] ] [-g "Target_string"] [-P Current_relationship] [-O condition_en_cours] [-A p | d | b] [-l | -t | -d | -D Délimiteur] [-T] [-V] [Attr... ]

Descriptif

La commande lsrel répertorie les relations gérées. Si le nom de la relation est omis, toutes les relations gérées sont répertoriées. Si la relation entre les ressources est indiquée, les attributs persistants de la relation précisée sont répertoriés. Si le paramètre attr est précisé, les attributs indiqués de l'équivalence sont répertoriés.

Si l'option d'attribut est indiquée, les attributs persistants ou dynamiques des relations sont répertoriés. S'il est spécifié, le paramètre Attr remplace l'option -A . Le paramètre attr doit être un attribut de relation valide lorsque les informations sur les relations sont répertoriées. Si des paramètres attr sont indiqués, la valeur exacte de ces attributs est répertoriée. Sinon, certaines valeurs d'attribut sont traduites en anglais.

Options

-A p | d | b
Spécifie un type d'attribut. Par défaut, seuls les attributs persistants sont affichés. Cette option peut être utilisée uniquement si aucun nom d'attribut n'est indiqué sur la ligne de commande. Pour afficher tous les attributs persistants des ressources membres, l'option doit être utilisée avec le type d'attribut -p .
p
Affiche uniquement les attributs persistants.
d
Affiche uniquement les attributs dynamiques.
b
Affiche à la fois les attributs persistants et dynamiques.
Pour de meilleures performances, spécifiez l'option -A p .
-d
Indique la sortie formatée par des délimiteurs. Le délimiteur par défaut est le signe deux-points (:). Utilisez l'option -D si vous souhaitez modifier le délimiteur par défaut.
-D délimiteur
Indique la sortie formatée par le délimiteur précisé. Cette option permet d'indiquer un délimiteur autre que le deux-points (:) employé par défaut. Par exemple, lorsque les données à afficher contiennent elles-mêmes des deux-points. Utilisez cette option pour indiquer un délimiteur d'un ou de plusieurs caractères.
-g chaîne_cible
Target_string est appliqué à toutes les ressources de la classe de ressources spécifiée par l'option -G , afin de déterminer les cibles de la relation.

Si l'option -g est utilisée pour spécifier une chaîne de sélection de source, nom_ressource et Noeud ne doivent pas être spécifiés pour l'option -G .

- -G Classe_cible [ :Nom_de_la_ressource [ :Nœud ]]

Indique les ressources cible à afficher avec la relation. La ou les ressources cible sont employées avec la source et toute autre requête visant à trouver une correspondance à partir de toutes les autres relations définies. Une ressource cible est identifiée par la classe de la ressource (classe_ressources), son nom (nom_ressource), et éventuellement par le noeud (noeud) sur lequel réside la ressource. classe_cible, nom_ressource et noeud doivent être séparés par le délimiteur deux-points. Vous pouvez indiquer plusieurs ressources cible en les séparant par une virgule. Les deux-points sont obligatoires, mais si la classe_cible est omise, la classe précédemment indiquée est utilisée lorsque plusieurs ressources cible sont précisées.

Si l'option -g est utilisée pour spécifier une chaîne de sélection cible, nom_ressource et Noeud ne doivent pas être spécifiés pour l'option -G .

-h
Ecrit la syntaxe de la commande dans la sortie standard.
-l
Indique la sortie au format long. Chaque attribut est affiché sur une ligne distincte (format d'affichage par défaut).
-M nom_relation
Indique le nom de la relation gérée à répertorier.
-P relation_en_cours
Indique la valeur de la relation gérée à employer pour interroger toutes les relations définies afin de trouver une correspondance. La valeur peut être numérique ou nominative (la distinction majuscules-minuscules n'est pas respectée) :
0x0001 ou Collocated
Indique que les ressources source et cible sont situées sur le même noeud.
0x0002 ou AntiCollocated
Indique que les ressources source et cible sont sur des noeuds différents.
0x0003 ou Affinity
Indique que la ressource source et sa ressource d'affinité indiquée doivent se trouver sur le même noeud si possible.
0x0004 ou AntiAffinity
Indique que la ressource source et sa ressource d'affinité précisée doivent se trouver sur des noeuds différents, si possible.
0x0005 ou IsStartable
Indique que la source et ses ressources cible sont démarrables.
0x0006 ou StartAfter
Indique que la source doit être démarrée après les ressources cible.
0x0007 ou DependsOn
Indique que les ressources cible doivent être en ligne avant le démarrage de la ressource source qui inclut une colocalisation entre les ressources source et cible.
0x0008 ou DependsOnAny
Indique que la cible doit être en ligne avant le démarrage de la ressource source. Est identique à la relation DependsOn, à l'exception qu'elle ne fournit pas la contrainte de colocalisation pour la séquence de démarrage. Par conséquent, les ressources source et cible ne peuvent pas être démarrées sur le même noeud.
0x0009 ou StopAfter
Indique que la ressource source ne peut être arrêtée qu'après la mise hors ligne de la ressource cible.
0x000A ou ForcedDownBy
Indique que la ressource source doit être mise hors ligne de manière forcée lorsque la ressource cible est mise hors ligne de manière imprévue ou que la ressource cible est elle-même mise hors ligne de manière forcée.
-O condition_en_cours
En cas d'interrogation de la condition. Indique la valeur de la condition pour l'interrogation de toutes les relations définies visant à trouver une correspondance. La valeur peut être numérique ou nominative (la distinction majuscules-minuscules n'est pas respectée) :
0x0000 ou NoCondition
Indique une relation d'emplacement inconditionnelle.
0x0001 ou IfOnline
Indique que la ressource cible est en ligne.
0x0002 ou IfOffline
Indique que la ressource cible est hors ligne, hors ligne et défaillante ou inconnue.
0x0003 ou IfNotOnline
Indique que la ressource cible n'est pas en ligne.
0x0004 ou IfNotOffline
Indique que la ressource cible n'est pas en ligne, ni hors ligne et défaillante.
0x0005 ou IfPossible
Utilisée conjointement avec la relation StartAfter. Indique que le groupe de ressources cible peut être ignoré s'il ne peut pas être lié. Dans ce cas il passe à l'état Sacrificed et la relation StartAfter est ignorée.
-s "chaîne_sélection"
Spécifie une chaîne de sélection. Cette option sans l'option -S est appliquée à toutes les relations définies et à ses zones d'attribut. Toutes les chaînes de sélection doivent être entre guillemets doubles ou simples. Si la chaîne de sélection contient des guillemets doubles, placez l'intégralité de la chaîne de sélection entre des guillemets simples. Par exemple :
-s 'Name == "testing"'
-s 'Name ?= "test"'

Seuls les attributs persistants peuvent être répertoriés dans une chaîne de sélection.

-s chaîne_source

Indique la chaîne de sélection source de la relation à répertorier. chaîne_source est appliqué à toutes les ressources de la classe de ressources spécifiée par l'option -S pour déterminer la source de la relation. Le résultat de la sélection peut contenir une ou plusieurs ressources.

Si l'option -s est utilisée pour spécifier une chaîne de sélection de source, nom_ressource et Noeud ne doivent pas être spécifiés pour l'option -S .

- -S Classe_source [ :Nom_de_la_ressource [ :Nœud ]]

Indique la ressource source de la relation à répertorier. Une ressource source est identifiée par la classe de ressources (classe_ressource) de la ressource, le nom de la ressource (nom_ressource), et éventuellement par le noeud (noeud) sur lequel réside la ressource. Le résultat de la sélection peut contenir une ou plusieurs ressources.

Si l'option -s est utilisée pour spécifier une chaîne de sélection de source, nom_ressource et Noeud ne doivent pas être spécifiés pour l'option -S .

-t
Indique la sortie au format tableau. Chaque attribut est affiché dans une colonne, une ressource par ligne.
-T
Ecrit les messages de trace de la commande dans l'erreur standard. Réservé à l'organisation chargée du support de vos logiciels.
-V
Ecrit les messages en mode prolixe de la commande dans la sortie standard.

Paramètres

Attr
Indique le nom d'un ou de plusieurs attributs dont les valeurs doivent être affichées. Ces attributs doivent être séparés par un espace. Lorsque l'option -m est spécifiée, ces attributs doivent correspondre aux zones d'attribut de ressource membre ; lorsque l'option -m n'est pas spécifiée, les attributs doivent correspondre aux zones d'attribut de groupe de ressources.
Noeud
Indique le nom du noeud. Il est nécessaire d'inclure le nom du noeud lorsque vous tentez de répertorier une ressource membre fixe. Le noeud et sa ressource doivent être séparés par le délimiteur deux-points (:) .
classe_ressources
Indique le nom de la classe de ressources à laquelle appartient la ressource membre. La ressource et la classe de ressources doivent être séparées par un espace.
nom_ressource
Indique le nom de la ressource. Vous pouvez indiquer une ou plusieurs ressources avec la classe de ressources à laquelle elles appartiennent. Chaque ressource ou ensemble de ressources doit être précédé de sa classe de ressources. La ressource et la classe de ressources doivent être séparées par un espace.

Etat de sortie

0
La commande a abouti.
1
Une erreur s'est produite en relation avec RMC.
2
Une erreur s'est produite en relation avec le script de l'interface de ligne de commande.
3
Option incorrecte sur la ligne de commande.
4
Paramètre incorrect sur la ligne de commande.
5
Une erreur s'est produite en relation avec RMC due à une entrée incorrecte sur la ligne de commande.
6
La ressource indiquée est introuvable.

Sécurité

Cette commande requiert des droits d'accès root ou un ID utilisateur doté des droits appropriés. Pour plus d'informations, voir Configuration d'ID utilisateur non root pour l'interface de ligne de commande.

Exemples

  1. Pour répertorier toutes les relations gérées en cours définies, entrez :
    lsrel

    Sortie :

    Displaying Managed Relations :
Name       Resource:Node[Source]       ResourceGroup[Source]
resA       IBM.Application:ja                   ResA
jaffinity  IBM.Application:ja                   ResA
           IBM.ResourceGroup:john               Ja
  2. Pour répertorier les attributs persistants de la relation gérée resA, entrez :
    lsrel -A p -M resA

    Sortie :

    Displaying Managed Relationship Information:
Persistent Attributes
for Managed Relationship "resA".

Managed Relationship 1:
    Class:Resource:Node[Source] = IBM.Application:ja:nodename
    Class:Resource:Node[Target] = {IBM.Application:Nate:Nodename}
    Relationship                = Collocated
    Conditional                 = NoCondition
    Name                        = resA
  3. Pour répertorier la relation gérée qui correspond à la source resA à partir de la classe IBM.Application et ayant une valeur de relation colocalisée (Collocated) avec la ressource cible narten de la classe IBM.ResourceGroup, entrez :
    lsrel -S IBM.Application:ResA -P Collocated 
      -G IBM.ResourceGroup:narten

    Sortie :

    Displaying Managed Relationship Information:
Managed Relationship 1:
Name                        = ResA
Class:Resource:Node[Source] = IBM.Application:ResA
Class:Resource:Node[Target] = {IBM.ResourceGroup:Narten 
,IBM.Application:ja}
Relationship                = Collocated
Conditional                 = NoCondition
ResourceGroup[Source]       = charm
  4. Pour répertorier les attributs dynamiques de la relation gérée nommée resA, entrez :
    lsrel -A d -M resA
  5. Pour répertorier les attributs persistants de la relation gérée nommée resA à l'aide d'une chaîne de sélection, entrez :
    lsrel -A p -s 'Name == "resA"'

Fichiers

/usr/sbin/rsct/bin/lsrel
Emplacement de la commande lsrel .

Voir aussi

Les commandes addrgmbr, samctrl, chrg, chrgmbr, mkrg, rmrg, rmrgmbr .

Le fichier d'informations générales d' rmccli .