:SEND_MSG

Fehlerbehandlung und Meldungen

:SET_LAST_ERR

---

:SEND_SNMP_TRAP

Script-Anweisung: Sendet einen SNMP-Trap.

Syntax

:SEND_SNMP_TRAPTrap Code, Parameter, [Parameter], [Parameter]...

Anmerkungen

Die Script-Anweisung sendet einen SNMP-Trap mit den angegebenen Parametern an ein Management-System. Sie kann nur eingesetzt werden, wenn zuvor alle Voraussetzungen für die SNMP-Funktionalität realisiert wurden.

Es können bis zu 10 Parameter mitgeschickt werden. Davon dürfen maximal 5 Zeichenketten und maximal 5 Zahlen sein. Die Position von Zeichenketten und Zahlen ist fest vorgegeben. Zuerst müssen die Zeichenketten, dahinter die Zahlen stehen. Es muss mindestens eine Zeichenkette angegeben werden.

Von AE und HP OpenView Integrator (Trap-Codes 10000 - 10010) generierte Trap-Codes dürfen nicht verwendet werden.

Beispiele

Das erste Beispiel zeigt einen einfachen Test. Mit dem SNMP-Trap 50000 werden alle möglichen Parameter an ein Management-System geschickt.

:SEND_SNMP_TRAP 50000,"Text1","TEXT2","TEXT3","TEXT4","TEXT5",1,2,3,4,5

Im zweiten Beispiel werden zunächst die eigenen Aktivierungsdaten ermittelt. Abhängig davon, ob es sich um eine direkte Aktivierung oder um eine Aktivierung innerhalb eines Workflows handelt, werden unterschiedliche Traps geschickt. Beide Traps bestehen aus dem Trap-Code und einer aufbereiteten Zeichenkette.

:SET &NAME#     = SYS_ACT_ME_NAME()
:SET &ID#       = SYS_ACT_ME_NR()
:SET &JPNAME#   = SYS_ACT_PARENT_NAME()
:SET &CLIENT#   = SYS_ACT_CLIENT()
!Trap type = Alarm
:SET &TYPE#     = 4
!Importance of the event
:SET &SEV#      = 4


:IF  "&JPNAME#" = ""
:    SEND_SNMP_TRAP 50001, "&CLIENT#","Error in task &NAME# (&ID#)!",,,,&TYPE#,&SEV#
:ELSE
:    SET &JPID# = SYS_ACT_PARENT_NR()
:    SEND_SNMP_TRAP 50002, "&CLIENT#","Error in workflow &JPNAME# (&JPID#) in the task &NAME# (&ID#m)!",,,,&TYPE#,&SEV#
:ENDIF

Das dritte Beispiel zeigt, wie die ermittelten Aktivierungsdaten der Script-Anweisung als einzelne Parameter übergeben werden. Damit stehen die Aktivierungsdaten im Management-System auch als einzelne Werte zur Verfügung und können dort einfacher weiterverarbeitet werden.

:SET &NAME#     = SYS_ACT_ME_NAME()
:SET &ID#       = SYS_ACT_ME_NR()
:SET &JPNAME#   = SYS_ACT_PARENT_NAME()
:SET &CLIENT#   = SYS_ACT_CLIENT()
!Trap type = Alarm
:SET &TYPE#     = 4
!Importance of the event
:SET &SEV#      = 4



:IF   &JPNAME# = ""
:    SEND_SNMP_TRAP 50001,"&CLIENT#","&NAME#",,"Error in the task!",,&TYPE#,&SEV#,&ID#
:ELSE
:    SET &JPID = SYS_ACT_PARENT_NR()
:    SEND_SNMP_TRAP 50002,"&CLIENT#","&NAME#","&JPNAME#","Error in the workflow!",,&TYPE#,&SEV#,&ID#,&JPID#
:ENDIF

Sollen &ID# und/oder &JPID# nicht als Zeichenketten sondern als Zahlen gesendet werden, dürfen sie erst ab dem sechsten Parameter übergeben werden. Anstelle der ausgelassenen Parameter, die für Zeichenketten vorgesehen sind, müssen die Kommas stehen.

Siehe auch:

Script-Sprachmittel - Fehlerbehandlung und Meldungen

AE und SNMP 

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung