15.7. Informacje przekazywane uruchamianym akcjom (programom)

Program, który ma zostać uruchomiony, jako swoje parametry uruchomienia (poza tymi wyspecyfikowanymi w polu program danej akcji), otrzymuje informacje dotyczące całej sprawy i każdego zdarzenia, które wchodzi w jego skład. Rodzaje parametrów dla każdego zdarzenia wchodzącego w skład sprawy zależą od jego rodzaju, tzn. czy jego źródłową wiadomością jest dana typu SNMP Trap, czy SNMP Data. Wszystkie jednak parametry są poprzedzone słowami kluczowymi zaczynającymi się podwójnym lub pojedynczym znakiem minus. Wszystkie programy otrzymują poniższe parametry:

Tabela 15.2. Parametry uruchamianych akcji (programów)

Nazwa parametru	Opis
--flow-severity severity	Wewnętrzna ważność sprawy.
--flow-id ID	Numer sprawy w danym dniu.
--action-id ID	Numer akcji (wartość pola id danej akcji).
--opened	Informacja o tym, że sprawa została otworzona (uruchamiane programy decydują, co to znaczy; zazwyczaj jest to powiadomienie operatora). Parametr ten nie wystąpi, jeśli sprawa nie została zaznaczona jako otwarta.
--community community	Suma wszystkich communities wchodzących w skład, każdego zdarzenia wchodzącego w skład sprawy.
--closing-reason description	Informacja o przyczynie zamknięcia sprawy. Parametr ten nie wystąpi, jeśli nie został podczas wcześniejszych akcji podany. Jednak dla akcji uruchamianej po śmierci sprawy, nigdy nie będzie pusty, gdyż domyślną wartością jest tekst "Not specified".
--closed-by uid	Identyfikator osoby zamykającej sprawę. Parametr ten nie wystąpi, jeśli nie został podczas wcześniejszych akcji podany. Jednak dla akcji uruchamianej po śmierci sprawy, nigdy nie będzie pusty, gdyż domyślną wartością jest liczba "-1".
--action-done numer_akcji:kod_powrotu	Numer akcji oraz kod ostatniego jej powrotu (argument może wystąpić zero lub więcej razy).
--flow-ctime seconds	Czas utworzenia sprawy (w sekundach od początku ery UNIX-owej).
--flow-mtime seconds	Czas modyfikacji sprawy (w sekundach od początku ery UNIX-owej).

Poniższe argumenty występują dla każdego zdarzenia wchodzącego w skład danej sprawy. Może ich więc być więcej niż jeden pełen zbiór podany poniżej:

Tabela 15.3. Argumenty występujące dla każdego zdarzenia wchodzącego w skład danej sprawy

Nazwa argumentu	Opis
--event-hitsnumber number	Ilość wystąpień tego zdarzenia podczas trwania tej sprawy.
--event-state state	Stan zdarzenia, gdzie parametr state może przybrać jedną z poniższych wartości: active - aktywna, passive - pasywna.
--event-id number	Numer jednoznacznie identyfikujący zdarzenie.
--event-ctime seconds	Czas utworzenia zdarzenia (w sekundach od początku ery UNIX-owej).
--event-mtime seconds	Czas modyfikacji zdarzenia (w sekundach od początku ery UNIX-owej).
--event-type type	Rodzaj komunikatu, do którego odnosi się zdarzenie. Możliwe są dwa poniższe typy wartości: snmptrap, snmpdata.

W przypadku, kiedy typem jest wartość snmptrap, wówczas występują poniższe parametry:

Tabela 15.4. Argumenty występujące dla zdarzenia typu snmptrap

Nazwa argumentu	Opis
-T seconds	Czas otrzymania komunikatu (w sekundach od początku ery UNIX-owej).
-s IP	Źródłowy adres komunikatu.
-a IP	Adres IP agenta SNMP, który wysłał wiadomość.
-c community	Nawa wspólnoty wiadomości.
-n OID	Identyfikator komunikatu w bazie MIB.
-e OID	Identyfikator producenta w bazie MIB.
-t timestamp	Znacznik czasowy nadawcy komunikatu.
-g generic	Ogólny numer komunikatu.
-p specific	Specyficzny numer komunikatu.
-d string	Identyfikator komunikatu w Operation Manager.
-m message	Czytelna dla człowieka wiadomość wyjaśniająca znaczenie komunikatu.

W przypadku, kiedy typem jest wartość snmpdata, wówczas występują poniższe parametry:

Tabela 15.5. Argumenty występujące dla zdarzenia typu snmpdata

Nazwa argumentu	Opis
-f type	Powód przesłania wiadomości do Bazy Danych Skojarzeń. Może przybrać jedną z następujących wartości: min - wartość poniżej dolnej krawędzi okna średnich wartości tej danej, max - wartość powyżej górnej krawędzi okna średnich wartości tej danej, error - błąd dla tej danej, timeout - przekroczony czas oczekiwania na odpowiedź dla tej danej.
-T seconds	Czas otrzymania wiadomości (w sekundach od początku ery UNIX-owej).
-s IP	Adres odpytywanego urządzenia.
-o OID	Identyfikator danej w bazie MIB.
-t type	Typ danej będący jedną z poniższych wartości: counter - licznik, gauge - dowolna wartość, error - błąd, timeout - przekroczony czas oczekiwania na odpowiedź, other - żaden z powyższych typów.
-v value	Ostatnia wartość danej.
-a value	Dolna krawędź okna średnich wartości tej danej.
-A value	Górna krawędź okna średnich wartości tej danej.
-d string	Identyfikator komunikatu w Operation Manager.
-m massage	Czytelna dla człowieka wiadomość wyjaśniająca znaczenie komunikatu.