Commande lsresponse

Objectif

Répertorie des informations sur une ou plusieurs réponses.

Syntaxe

lsresponse [-a] [ -C | -l | -t | -d | -D délimiteur ] [-A] [-q] [-U] [-x ] [ -b ] [-h] [-TV] [réponse1[,réponse2,... ] :nom_poste]

Descriptif

La commande lsresponse répertorie les informations suivantes sur les réponses définies:
Zone Descriptif
ResponseName Nom de la réponse.
Noeud Emplacement de la réponse.
Opération Nom d'une action.
DaysOfWeek

Jours de la semaine où l'action peut être exécutée. DaysOfWeek et TimeOfDay définissent ensemble l'intervalle pendant lequel l'action peut être exécutée.

Les valeurs des jours peuvent être séparées par des signes plus (+) ou affichées sous la forme d'une plage de jours séparés par un trait d'union (-). Les valeurs DaysOfWeek multiples sont séparées par des virgules (,). Le nombre de valeurs DaysOfWeek doit correspondre au nombre de valeurs TimeOfDay . Les valeurs de chaque jour sont les suivantes:

1
Dimanche
2
Lundi
3
Mardi
4
Mercredi
5
Jeudi
6
Vendredi
7
Samedi
TimeOfDay

Intervalle de temps pendant lequel Action peut être exécuté, composé de l'heure de début suivie de l'heure de fin, séparés par un trait d'union. DaysOfWeek et TimeOfDay définissent ensemble l'intervalle pendant lequel l'action peut être exécutée.

L'heure est au format 24 heures (HHMM), où les deux premiers chiffres représentent l'heure et les deux derniers chiffres représentent les minutes. Les valeurs TimeOfDay multiples sont séparées par des virgules (,). Le nombre de valeurs DaysOfWeek doit correspondre au nombre de valeurs TimeOfDay .

ActionScript Script ou commande à exécuter pour l'action.
ReturnCode Code retour attendu pour ActionScript.
CheckReturnCode Indique si le code retour réel de ActionScript est comparé à son code retour attendu. Les valeurs sont: y (oui) et n (non).
EventType Type d'événement qui entraîne l'exécution de l'action: événement, événement de réenclenchement, ou les deux.
StandardOut Indique si la sortie standard est dirigée vers le journal d'audit. Les valeurs sont: y (oui) et n (non).
EnvironmentVars Indique les variables d'environnement qui seront définies avant l'exécution de l'action.
UndefRes Indique si l'action doit être exécutée si une ressource contrôlée devient indéfinie. Les valeurs sont: y (oui) et n (non).
Verrouillé Indique si la ressource est verrouillée ou déverrouillée.
EventBatching Indique si l'action de réponse prend en charge la création de lots d'événements.

Pour obtenir la liste de tous les noms de réponse, exécutez la commande lsresponse seule sans spécifier de nom de réponse. Une liste de tous les noms de réponse est renvoyée. Dans ce cas, le format par défaut est tabulaire.

La spécification d'un nom de noeud après les noms de réponse limite l'affichage aux réponses définies sur ce noeud. Répertoriez toutes les réponses sur un noeud en spécifiant un signe deux-points (:) suivi du nom de noeud. Le nom de noeud est un noeud dans la portée de gestion déterminée par la variable d'environnement CT_MANAGEMENT_SCOPE. La portée de gestion détermine la liste des noeuds à partir desquels les réponses sont répertoriées. Pour la portée locale, seules les réponses sur le noeud local sont répertoriées. Sinon, les réponses de tous les noeuds du domaine sont répertoriées.

Pour afficher toutes les informations sur tous les noms de réponse, spécifiez l'indicateur -A avec la commande lsresponse . L'indicateur -A permet de répertorier toutes les informations relatives à une réponse lorsqu'aucun nom de réponse n'est spécifié. Lorsque toutes les informations sur toutes les réponses sont répertoriées, le format long est la valeur par défaut.

Lorsque plusieurs réponses sont spécifiées, les informations de réponse sont répertoriées dans l'ordre dans lequel les réponses sont entrées.

Si Cluster Systems Management (CSM) est installé sur votre système, vous pouvez utiliser des groupes de noeuds définis par CSM comme valeurs de nom de noeud pour faire référence à plusieurs noeuds. Pour plus d'informations sur l'utilisation des groupes de noeuds CSM et de la commande CSM nodegrp , voir CSM: Guide d'administration et CSM: Command and Technical Reference.

Indicateurs

-a
Indique que cette commande s'applique à tous les noeuds du cluster. La portée du cluster est déterminée par la variable d'environnement CT_MANAGEMENT_SCOPE. S'il n'est pas défini, la portée du domaine de gestion est d'abord choisie si elle existe, puis la portée du domaine homologue est choisie si elle existe, puis la portée locale est choisie, jusqu'à ce que la portée soit valide pour la commande. La commande s'exécute une seule fois pour la première portée valide trouvée. Par exemple, si un domaine de gestion et un domaine homologue existent, lsresponse -a avec CT_MANAGEMENT_SCOPE non défini répertorie le domaine de gestion. Dans ce cas, pour répertorier le domaine homologue, définissez CT_MANAGEMENT_SCOPE sur 2.
-A
Affiche tous les attributs de la réponse.
-b
Affiche uniquement les réponses qui prennent en charge la création de lots d'événements.
-C
Affiche la commande mkresponse qui peut être utilisée pour créer la réponse et l'une de ses actions. Si plusieurs réponses sont spécifiées, chaque commande mkresponse apparaît sur une ligne distincte. Cet indicateur est ignoré lorsqu'aucune réponse n'est spécifiée. Cet indicateur remplace l'indicateur -l .
-d
Indique la sortie au format délimiteur. Le délimiteur par défaut est le signe deux-points (:). Utilisez l'indicateur –D si vous souhaitez modifier le délimiteur par défaut.
--D délimiteur
Indique la sortie au format délimiteur qui utilise le délimiteur spécifié. Utilisez cet indicateur pour spécifier autre chose que la valeur par défaut, le signe deux-points (:). Par exemple, lorsque les données à afficher contiennent des signes deux-points, utilisez cet indicateur pour spécifier un autre délimiteur d'un ou de plusieurs caractères.
-l
Affiche les informations de réponse sur des lignes distinctes (format long).
-q
Ne renvoie pas d'erreur lorsque response n'existe pas.
-t
Affiche les informations de réponse dans des colonnes distinctes (format tableau).
-U
Indique si la ressource est verrouillée.
-x
Supprime les en-têtes lors de l'impression.
-h
Ecrit l'instruction de syntaxe de la commande dans la sortie standard.
-T
Ecrit les messages de trace de la commande dans l'erreur standard. Pour l'utilisation de votre organisation de services logiciels uniquement.
-V
Ecrit les messages prolixes de la commande dans la sortie standard.

Paramètres

réponse1[,réponse2,... ]
Ce paramètre peut être un nom de réponse ou une sous-chaîne d'un nom de réponse. Vous pouvez spécifier plusieurs noms de réponse. Lorsqu'il s'agit d'une sous-chaîne, tout nom de réponse défini qui contient la sous-chaîne est répertorié.
nom_poste
Indique le noeud sur lequel la réponse est définie. Si nom_poste n'est pas spécifié, le noeud local est utilisé. nom_noeud est un noeud dans la portée déterminée par la variable d'environnement CT_MANAGEMENT_SCOPE.

Security

L'utilisateur a besoin de droits en lecture pour que la classe de ressources IBM.EventResponse puisse exécuter lsresponse. Les droits sont spécifiés dans le fichier de liste de contrôle d'accès (ACL) sur le système contacté. Voir le guide Administration de RSCT pour plus de détails sur le fichier ACL et pour savoir comment le modifier.

Statut de sortie

0
L'exécution de la commande a abouti.
1
Une erreur s'est produite avec RMC.
2
Une erreur s'est produite avec un script d'interface de ligne de commande.
3
Un indicateur incorrect a été entré sur la ligne de commande.
4
Un paramètre incorrect a été entré sur la ligne de commande.
5
Une erreur basée sur une entrée de ligne de commande incorrecte s'est produite.

Variables d'environnement

CT_CONTACT
Détermine le système sur lequel se produit la session avec le démon RMC (Resource Monitoring and Control). Lorsque CT_CONTACT est défini sur un nom d'hôte ou une adresse IP, la commande contacte le démon RMC sur l'hôte spécifié. Si CT_CONTACT n'est pas défini, la commande contacte le démon RMC sur le système local sur lequel la commande est exécutée. La cible de la session du démon RMC et la portée de la gestion déterminent les classes de ressources ou les ressources qui sont traitées.
CT_IP_AUTHENT
Lorsque la variable d'environnement CT_IP_AUTHENT existe, le démon RMC utilise l'authentification réseau IP pour contacter le démon RMC sur le système spécifié par l'adresse IP à laquelle la variable d'environnement CT_CONTACT est définie. CT_IP_AUTHENT n'a de signification que si CT_CONTACT est défini sur une adresse IP ; il ne repose pas sur le service DNS (Domain Name System).
CT_PORT_GESTION
Détermine la portée de gestion utilisée pour la session avec le démon RMC lors du traitement des ressources du gestionnaire de ressources de réponse aux événements (ERRM). La portée de gestion détermine l'ensemble de noeuds cible possibles où les ressources peuvent être traitées. Les valeurs admises sont les suivantes :
0
Indique la portée locale .
1
Indique la portée locale .
2
Indique la portée du domaine homologue .
3
Indique la portée du domaine de gestion .

Si cette variable d'environnement n'est pas définie, la portée locale est utilisée.

Caractéristiques de mise en oeuvre

Cette commande fait partie du jeu de fichiers Reliable Scalable Cluster Technology (RSCT) pour AIX.

Sortie standard

Lorsque l'indicateur -h est spécifié, l'instruction de syntaxe de cette commande est écrite dans la sortie standard. Tous les messages prolixes sont écrits dans la sortie standard.

Erreur standard

Tous les messages de trace sont écrits dans l'erreur standard.

Exemples

  1. Pour répertorier toutes les réponses, exécutez la commande suivante:
    lsresponse 
    La sortie se présente comme suit:
    ResponseName
    "E-mail root anytime"
    "E-mail root first shift"
    "Critical notifications"  
    "Generate SNMP trap" 
    
  2. Pour voir quelles ressources sont verrouillées, exécutez la commande suivante:
    lsresponse -U
    La sortie se présente comme suit:
    ResponseName                   Node      Locked 
    "Broadcast event on-shift"     "nodeA"   "No"   
    "E-mail root off-shift"        "nodeA"   "No"  
    "E-mail root anytime"          "nodeA"   "No"  
    "Log event anytime"            "nodeA"   "No"
    "Informational notifications"  "nodeA"   "No"
    "Warning notifications"        "nodeA"   "No"  
    "Critical notifications"       "nodeA"   "No"
    "Generate SNMP trap"           "nodeA"   "No"
  3. Pour répertorier les informations générales sur la réponse "Critical notifications", exécutez la commande suivante:
    lsresponse "Critical notifications"
    La sortie se présente comme suit:
    ResponseName     = "Critical notifications"
    Node             = "nodeA"
    Action           = "Log Critical Event"
    DaysOfWeek       = 1+2+7
    TimeOfDay        = 0000-2400
    ActionScript     = "/opt/rsct/bin/logevent /tmp/criticalEvents"                                       
    ReturnCode       = 0
    CheckReturnCode  = "y"
    EventType        = "b"
    StandardOut      = "y"
    EnvironmentVars  = '"Env1=5","Env=10"'
    UndefRes         = "n"
    
    ResponseName     = "Critical notifications"
    Node             = "nodeA"
    Action           = "E-mail root"
    DaysOfWeek       = 6+2,6+2,6+5
    TimeOfDay        = 1700-2400,0000-0800,0000-2400
    ActionScript     = "/opt/rsct/bin/notifyevent root"
    ReturnCode       = 0
    CheckReturnCode  = "y"
    EventType        = "b"
    StandardOut      = "y"
    EnvironmentVars  = ""
    UndefRes         = "n"
    
    
  4. Pour répertorier la commande qui créerait la réponse "Critical notifications" avec l'une de ses actions, exécutez la commande suivante:
    lsresponse -C "Critical notifications"
    La sortie se présente comme suit:
    mkresponse -n "Log Critical Event" -d 1+2+7 -t 0000-2400 \
    -s "usr/sbin/rsct/bin/logevent /tmp/criticalEvents"  \
    -e b -r 0 "Critical notifications"
  5. Pour répertorier toutes les réponses dont le nom contient la chaîne E-mail , exécutez la commande suivante:
    lsresponse "E-mail"
    La sortie se présente comme suit:
    ResponseName = "E-mail root anytime"
    Action       = "E-mail root"
    ⋮
    ResponseName = "E-mail root first shift"
    Action       = "E-mail root"

Emplacement

/opt/rsct/bin/lsresponse