Vorheriges Thema: tngfilter_rule.datNächstes Thema: So installieren Sie CA EEM


tngwriter_rule.dat

Die Datei tngwriter_rule.dat enthält Folgendes:

# evt 
id:::dev:::user:::majorSrc:::minorSrc:::action:::template:::cmd:::log:::event_token:::user_parms

wobei:

# event id

eine Zeichenfolge oder einen regulären Hexadezimalausdruck enthält.

device

eine Zeichenfolge, einen regulären Hexadezimalausdruck oder ein Sternchen (*) enthält oder leer ist.

Anwender

eine Zeichenfolge oder ein Sternchen (*) enthält oder leer ist.

majorSrc

die Zeichenfolgen „uni“ aus „uniconverter“ oder „tng“ aus „tngconverter“.

minorSrc

die Zeichenfolge oder ein Sternchen (*) enthält.

action

die Aktionsoptionen enthält. Folgende Optionen stehen zur Verfügung:

CR_CREATE

Schreiben eines neuen Request für jedes Event.

CR_UPDATE

Aktualisieren eines vorhandenen Request oder vorhandener Requests (falls vorhanden) oder Erstellen eines neuen Request, wenn keine Requests gefunden wurden. Standardmäßig werden Datensätze durch Vergleichen der Felder „log_agent“ und „affected_resource“ (Anlage) gesucht. Der Anwender kann die Standardwerte durch Angabe einer Liste von Aufruf-Request-Attributen überschreiben

CR_UPDATE_ONLY

Wie „CR_UPDATE“, mit der Ausnahme, dass kein neuer Request erstellt wird, wenn keine passenden Requests gefunden werden.

COMMAND

Führt das in dieser Tabelle beschriebene <cmd> aus.

template

Gibt den Namen einer Request-Vorlage an, die für die Erstellung eines Request zu verwenden ist. Dieser Parameter ist nicht erforderlich und wird ignoriert, wenn die Aktion nicht CR_CREATE ist.

Hinweis: Die Request-Vorlage muss erstellt werden, bevor diese Regel definiert wird.

cmd

Der Befehl wird an die Shell übergeben und bei allen Aktionen außer „COMMAND“ ignoriert.

Protokollierung

Die Optionen für die Protokollierung sind folgende:

KEINE

Keine Protokollierung außer der normalen Fehlerprotokollierung.

SYS

Protokolliert Incidents im UNIX-Systemprotokoll (Unicenter-Meldungskonsole)

PDM

Incidents in das Anwendungsprotokoll schreiben ($NX_ROOT/log).

BOTH

Incidents in das Anwendungs- und das Systemprotokoll (syslog) schreiben

event_token

(Optional). Ein anwenderspezifischer Tag mit 30 Zeichen zur Kennzeichnung eines bestimmten Request, die einer „event_id“ (tng-Event-Meldung) oder allen Meldungen wie „event_id“ (z. B. einer „event_id“ mit Platzhaltern) zugeordnet ist.

„event_token“ ist ein Request-Attribut, das in allen Requests gespeichert wird, die durch die TNG-Schnittstelle generiert werden. Wenn kein „event_token“ in der Erstellerregel angegeben ist, wird die Zeichenfolge „tng_generated“ verwendet. Dadurch kann der Anwender alle Requests aktualisieren, die dem Attribut „event_token“ entsprechen. Zum Beispiel können jetzt zwei verschiedene Meldungen für dieselbe Anlage eindeutige Requests aktualisieren. Jede CR_UPDATE-Erstellerregel gibt die eindeutigen Meldungsteile und ein eindeutiges event_token an. Das event_token wird für die Suche und Aktualisierung des entsprechenden Request verwendet. Standardmäßig wird ein Aktivitätsprotokoll, das die Meldung enthält, zum entsprechenden Request hinzugefügt.

In einem weiterem Beispiel kann der Anwender in einem vorhandenen Request das Statusattribut aktualisieren (z. B. status=CL (geschlossen)), indem er dasselbe „event_token“ in der Erstellerregel „CR_UPDATE“ angibt, die verwendet wurde, als der Request mithilfe der Erstellerregel „CR_CREATE“ erstellt wurde.

user_parms

(Optional). Dieser Parameter enthält die folgenden drei Arten von Informationen:

Die Request-Werte und die Liste der Attribute werden mithilfe der folgenden Syntax angegeben: %<SCHLÜSSELWORT>=<Wert>. Wenn Sie mehrere Schlüsselwort/Wert-Paare verwenden, müssen Sie jedes Paar durch ein Semikolon („;“) trennen.

Request-Attributwerte werden mit Hilfe der Syntax "%<ATTRIBUT>=<Wert>" angegeben, wobei "ATTRIBUT" der in der Datei "text_api.cfg" (im Verzeichnis "$NX_ROOT/site") aufgeführte Attributname ist, der die Zuordnung zu einem Majic-Request-Attribut der AHD-Funktion herstellt.

Die Syntax für die Liste der Attribute zur Überprüfung der Übereinstimmung wird wie folgt angegeben: %SEARCH=<Attribut1>[,<Attribut2>.], wobei „SEARCH“ ein feststehendes Schlüsselwort ist und „Attribut1“ usw. die in der Datei text_api.cfg angegebenen Attributnamen sind.

Sie können die folgenden speziellen Parameternamen an beliebiger Stelle in der Zeichenfolge „user_parms“ verwenden.

&Message

Der CA NSM-Meldung zugeordnete Meldungstext.

&Parm

Das Parameterfeld der Datei "AHD.DLL" im CA NSM-Meldungsaktionsdialogfeld

&Uuid

Eindeutiges Kennzeichen aus Unicenter TNG.

&Device

Das Gerät, z. B. Hostname, das die CA NSM-Meldung generiert hat.

&Majorsrc

Die wichtigste Quelle (Typ), die Events an den Event-Ersteller leitet. Bei Events aus CA NSM unter Windows lautet der Wert "tng". Bei Events aus CA NSM unter UNIX lautet der Wert "uni".

&Minorsrc

Die unbedeutendste Quelle (Typ), die Events an den Event-Ersteller leitet.

&Node

Das Gerät, z. B. Hostname, das die CA NSM-Meldung generiert hat.

&Addr

Die IP-Adresse des Hosts, der die CA NSM-Meldung generiert hat.

&Username

Der Anwendername auf dem Host, auf dem die CA NSM-Meldung generiert wurde.

&Date

Die Ganzzahl für die Zeit seit 1970, zu der die CA NSM-Meldung generiert wurde.

&Time

Datum und Uhrzeit der CA NSM-Meldung. Zum Beispiel Die, 4. Jul 10:23:37 2000.

&Severity

Der Schweregrad der CA NSM-Meldung.

&Tag

Der CA NSM-Meldung zugeordnete Tagdaten.

Beispielsweise sollten bei Verwendung der Angaben aus "Beispiel 2: Alternative "Cawto"-Formate für das Generieren und Aktualisieren eines neuen Request "die Standard-Event-Erstellungsregeln wie folgt geändert werden:

*:::.*:::*:::uni:::*:::CR_CREATE:::::::::NONE

in:

CFNEW.*:::.*:::*:::tng:::*:::CR_UPDATE:::::::::NONE::::::&Parm;%SEARCH_EXPLICIT=STRING1
CFNEW2.*:::.*:::*:::tng:::*:::CR_UPDATE:::::::::NONE::::::&Parm;%SEARCH=Event_Token
CFUPDATE.*:::.*:::*:::tng:::*:::CR_UPDATE_ONLY:::::::::NONE::::::&Parm;%SEARCH_EXPLICIT=STRING1
CFUPDATE2.*:::.*:::*:::tng:::*:::CR_UPDATE:::::::::NONE::::::&Parm;%SEARCH=EVENT_TOKEN;%STATUS=CL

Hinweis: Der Parameter "%SEARCH_EXPLICIT" wird verwendet, um sicherzustellen, dass bei Durchführung einer Aktualisierung nach einem entsprechenden Request gesucht wird, indem die Inhalte des Feldes "STRING1" miteinander verglichen werden, bevor die Aktualisierung fortgesetzt wird. Weitere Informationen zu "text_api.cfg", und wie CA SDM die Text-API zum Erstellen von Requests aus CA NSM verwendet, finden Sie im Administrationshandbuch.

Weitere Informationen:

Regeldefinitionen von Ereigniserstellern