Befehl "lsactdef"

Zweck

Zeigt die Aktionsdefinitionen einer Ressource oder einer Ressourcenklasse an.

Syntax

Aktionsdefinitionen für eine Ressource anzeigen:

lsactdef [-p Eigenschaft] [-s i | o] [-e] [-l | -i | -t | -d | -D Begrenzer] [-x] [-h] [-TV] Ressourcenklasse [ action1 [ action2 … ] ]

Aktionsdefinitionen einer Ressourcenklasse anzeigen:

lsactdef -c [-p Eigenschaft] [-s i | o] [-e] [-l | -i | -t | -d | -D Begrenzer] [-x] [-h] [-TV] Ressourcenklasse [ action1 [ action2 … ] ]

Alle Ressourcenklassennamen anzeigen:

lsactdef

Beschreibung

Der Befehl lsactdef zeigt eine Liste der Aktionsdefinitionen einer Ressource oder einer Ressourcenklasse an. Standardmäßig zeigt dieser Befehl die Aktionsdefinitionen einer Ressource an. Zum Anzeigen der Aktionsdefinitionen einer -Ressourcenklasse geben Sie das Flag -c an.

Wenn Sie keine Aktionen in der Befehlszeile angeben, werden mit diesem Befehl nur Aktionen angezeigt, die als publicdefiniert sind. Verwenden Sie zum Überschreiben dieser Standardeinstellung das Flag -p oder geben Sie in der Befehlszeile die Namen der Aktionen an, für die Definitionen angezeigt werden sollen.

Um die strukturierte Datendefinition anzuzeigen, die als Eingabe erforderlich ist, wenn diese Aktion aufgerufen wird, geben Sie das Flag -s i an. Geben Sie das Flag -s o an, um die strukturierte Datendefinition anzuzeigen, die mit der Ausgabe verknüpft ist, die sich aus dem Aufrufen dieser Aktion ergibt.

Standardmäßig zeigt dieser Befehl keine Aktionsbeschreibungen an. Geben Sie das Flag -e an, um Aktionsdefinitionen und Beschreibungen anzuzeigen.

Flags

-c

Zeigt die Aktionsdefinitionen für die angegebene Ressourcenklasse an.

-d

Gibt eine Ausgabe mit Begrenzern an. Der Standardbegrenzer ist ein Doppelpunkt (:). Verwenden Sie das Flag -D , um den Standardbegrenzer zu ändern.

--D Begrenzer

Gibt eine formatierte Ausgabe mit dem angegebenen Begrenzer an. Verwenden Sie dieses Flag, um einen anderen Begrenzer als den Standarddoppelpunkt (:) anzugeben, z. B., wenn die angezeigten Daten Doppelpunkte enthalten. Verwenden Sie dieses Flag, um einen aus einem oder mehreren Zeichen bestehenden Begrenzer anzugeben.

-e

Gibt das erweiterte Format an. Zeigt Beschreibungen zusammen mit den Aktionsdefinitionen an.

-i

Gibt das Eingabeformat an. Generiert eine Vorlage der Eingabedatei_für_Ressourcendaten. Die Ausgabe wird im Langformat (Zeilengruppe) angezeigt. Die SD-Elementdatentypen des Attributs werden als Wert in den Attr=Wert-Paaren angezeigt. Wenn Sie dieses Flag verwenden, wird empfohlen, die Ausgabe des Befehls lsactdef in eine Datei zu übertragen. Dieses Flag überschreibt das Flag -s o .

-l

Gibt das Langformat an, in dem ein Eintrag pro Zeile angezeigt wird. Dies ist das Standardanzeigeformat. Wenn der Befehl lsactdef mit dem Flag -l , aber ohne Ressourcenklassennamen ausgegeben wird, wird das Flag -l ignoriert, wenn der Befehl die Liste der definierten Ressourcenklassennamen zurückgibt.

--p Eigenschaft

Zeigt Aktionen mit der angegebenen Eigenschaft an. Standardmäßig werden nur die Definitionen für öffentliche Aktionen angezeigt. Verwenden Sie das Flag -p 0 , um alle Aktionsdefinitionen unabhängig von der Aktionseigenschaft anzuzeigen.

Aktionseigenschaften:

0x0001

long_running

0x0002

public

Für die Eigenschaft kann ein Dezimal- oder Hexadezimalwert angegeben werden. Um die Aktionsdefinitionen für alle Aktionen anzufordern, die eine oder mehrere Eigenschaften haben, "ODER" die gewünschten Eigenschaften zusammen und geben Sie dann den Wert "ODER" mit dem Flag -p an. Geben Sie beispielsweise Folgendes ein, um die Aktionsdefinitionen für alle Aktionen anzufordern, die long_running oder publicsind:

-p 0x03

-s i | o

Zeigt die strukturierte Datendefinition für die Aktionseingabe oder Aktionsantwort an.

i

Zeigt die strukturierten Datendefinitionen der Aktionseingabe an. Dies ist die Standardeinstellung.

o

Zeigt die strukturierten Datendefinitionen für die Aktionsantwort (Ausgabe) an.

-t

Gibt das Tabellenformat an. Jedes Attribut wird in einer separaten Spalte mit einer Ressource pro Zeile angezeigt.

-x

Unterdrückt die Ausgabe von Überschriften.

-h

Schreibt den Verwendungshinweis für den Befehl in die Standardausgabe.

-T

Schreibt die Tracenachrichten des Befehls in die Standardfehlerausgabe. Dieses Flag ist ausschließlich für die Verwendung durch die Software-Service-Organisation bestimmt.

-V

Schreibt die ausführlichen Nachrichten des Befehls in die Standardausgabe.

Parameter

Ressourcenklasse

Gibt den Namen der Ressourcenklasse mit den Aktionsdefinitionen an, die Sie anzeigen möchten. Wenn keine Ressourcenklasse angegeben ist, wird eine Liste aller Ressourcenklassennamen angezeigt.

action1 [action2…]

Gibt eine oder mehrere Aktionen an. Wenn eine Ressourcenklasse angegeben ist, können null oder mehr Aktionsnamen angegeben werden. Wenn keine Aktionen angegeben sind, werden alle Aktionsdefinitionen für Ressourcenklasse angezeigt. Geben Sie spezifische Aktionsnamen ein, um festzulegen, welche Aktionen angezeigt werden sollen und in welcher Reihenfolge. Verwenden Sie Leerzeichen, um Aktionsnamen voneinander zu trennen.

Sicherheit

Der Benutzer benötigt Leseberechtigung für die Ressourcenklasse , die in lsactdef angegeben ist, um lsactdefausführen zu können. Berechtigungen werden in der ACL-Datei (Access Control List) auf dem kontaktierten System angegeben. Informationen zur ACL-Datei und deren Änderung finden Sie in der Veröffentlichung RSCT: Administration Guide.

Exitstatus

0

Der Befehl wurde erfolgreich ausgeführt.

1

Es ist ein Fehler in RMC aufgetreten.

2

Bei der Ausführung des CLI-Scripts (Command-Line Interface, Befehlszeilenschnittstelle) ist ein Fehler aufgetreten.

3

In der Befehlszeile wurde ein falsches Flag angegeben.

4

In der Befehlszeile wurde ein falscher Parameter angegeben.

5

Es ist ein Fehler in RMC aufgetreten, der auf eine falsche Eingabe in der Befehlszeile zurückzuführen ist.

Umgebungsvariablen

CT_CONTACT

Wenn die Umgebungsvariable CT_CONTACT auf einen Hostnamen oder eine IP-Adresse gesetzt ist, kontaktiert der Befehl den RMC-Dämon (Resource Monitoring and Control) auf dem angegebenen Host. Wenn die Umgebungsvariable nicht gesetzt wird, stellt der Befehl eine Verbindung zum RMC-Dämon auf dem lokalen System her, auf dem der Befehl ausgeführt wird. Die Ressourcenklasse oder Ressourcen, die vom Befehl angezeigt oder geändert werden, befinden sich auf dem System, zu dem die Verbindung aufgebaut wird.

CT_IP_AUTHENT

Wenn die Umgebungsvariable CT_IP_AUTHENT vorhanden ist, verwendet der RMC-Dämon die IP-basierte Netzauthentifizierung, um die Verbindung zum RMC-Dämon auf dem System herzustellen, das mit der IP-Adresse angegeben ist, auf die die Umgebungsvariable CT_CONTACT gesetzt ist. Die Umgebungsvariable CT_IP_AUTHENT hat nur Bedeutung, wenn CT_CONTACT auf eine IP-Adresse gesetzt ist. Sie stützt sich nicht auf den DNS-Service (Domain Name System, Domänennamensservice).

CT_MANAGEMENT_SCOPE

Bestimmt den Managementbereich, der für die Sitzung mit dem RMC-Dämon verwendet wird, um die Ressourcen und Ressourcenklassen zu überwachen und zu steuern. Der Managementbereich bestimmt die Gruppe möglicher Zielknoten, auf denen die Ressourcen und Ressourcenklassen überwacht und gesteuert werden können. Die gültigen Werte sind im Folgenden beschrieben:

0

Gibt den lokalen Bereich an.

1

Gibt den lokalen Bereich an.

2

Gibt den Peerdomänenbereich an.

3

Gibt den Managementdomänenbereich an.

Wenn diese Umgebungsvariable nicht gesetzt ist, wird der lokale Bereich verwendet.

Implementierungsspezifikationen

Dieser Befehl ist Teil des RSCT-Dateisets ( Reliable Scalable Cluster Technology ) für AIX®.

Standardausgabe

Wenn das Flag -h angegeben ist, wird der Verwendungshinweis für diesen Befehl in die Standardausgabe geschrieben. Alle ausführlichen Nachrichten werden in die Standardausgabe geschrieben.

Standardfehlerausgabe

Alle Tracenachrichten werden in die Standardfehlerausgabe geschrieben.

Beispiele

1. Geben Sie Folgendes ein, um die Namen aller Ressourcenklassen aufzulisten:

   lsactdef

   Die Ausgabe gleicht der folgenden:

   class_name
   "IBM.Association"     
   "IBM.AuditLog"        
   "IBM.AuditLogTemplate"
   "IBM.Condition"       
   "IBM.EventResponse"   
   "IBM.Host"            
   "IBM.Program"         
   "IBM.Sensor"          
   "IBM.ManagedNode"     
   ... 

2. Zur Auflistung der öffentlichen Ressourcenaktionsdefinitionen für die Ressourcenklasse ' IBM® '.AuditLog, geben Sie ein:

   lsactdef IBM.AuditLog

   Die Ausgabe gleicht der folgenden:

   Resource Action Definitions for
   class_name: IBM.AuditLog
   action 1:
           action_name    = "GetRecords"
           display_name   = ""
           description    = ""
           properties     = {"public"}
           confirm_prompt = ""
           action_id      = 0
           variety_list   = {{1..1}}
           variety_count  = 1
           timeout        = 0
   action 2:
           action_name    = "DeleteRecords"
           display_name   = ""
           description    = ""
           properties     = {"public"}
           confirm_prompt = ""
           action_id      = 1
           variety_list   = {{1..1}}
           variety_count  = 1
           timeout        = 0
   ....

3. Um die Definition der strukturierten Daten aufzulisten, die für den Aufruf der Aktion auf Ressourcen in der Ressourcenklasse IBM.AuditLog, Aktion GetRecords, erforderlich sind, geben Sie ein:

   lsactdef -s i IBM.AuditLog GetRecords

   Die Ausgabe gleicht der folgenden:

   Resource Action Input for: IBM.AuditLog
   action_name GetRecords:
   sd_element 1:
           element_name      = "MatchCriteria"
   	display_name      = ""
   	description       = ""
           element_data_type = "char_ptr"
   	element_index     = 0 
   sd_element 2:
           element_name      = "IncludeDetail"
   	display_name      = ""
   	description       = ""
           element_data_type = "uint32"
           element_index     = 1
   	

Position

/opt/rsct/bin/lsactdef