:SEND_SNMP_TRAP
Script-Anweisung: Sendet eine SNMP-Trap
Syntax
: SEND_SNMP_TRAP Trap-Code, Parameter[, Parameter[, Parameter]]...
Syntax | Beschreibung/Format |
|---|---|
Trap Code | Frei definierbarer Code für die SNMP-Verwaltung kann reagieren |
Parameter | Zusätzliche Informationen, die mit der SNMP-Trap gesendet werden können Verwenden Sie Anführungszeichen für die Mandantennummer (z. B. "1000"). |
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 Strings und maximal 5 Zahlen sein. Die Position von Strings und Zahlen ist vorgegeben. Zuerst müssen die Strings, dahinter die Zahlen stehen. Es muss mindestens ein String angegeben werden.
Achtung! Von AE und von 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 einem aufbereiteten String.
: 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
!Bedeutung des Ereignisses
: 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#" , "Fehler im Workflow &JPNAME# (&JPID#) in der Aufgabe &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
!Bedeutung des Ereignisses
: SET &SEV# = 4
: IF &JPNAME# = ""
: SEND_SNMP_TRAP 50001, "&CLIENT#" , "&NAME#" ,, "Fehler in der Aufgabe!" ,, &TYPE# , &SEV# , &ID#
: ELSE
: SET &JPID = SYS_ACT_PARENT_NR ()
: SEND_SNMP_TRAP 50002, "&CLIENT#" , "&NAME#" , "&JPNAME#" , "Fehler im Workflow!" ,, &TYPE# , &SEV# , &ID# , &JPID#
: ENDIF
Sollen &ID# und/oder &JPID# nicht als Strings, sondern als Zahlen gesendet werden, dürfen sie erst ab dem sechsten Parameter übergeben werden. Anstelle der ausgelassenen Parameter, die für Strings vorgesehen sind, müssen Kommata stehen.
Siehe auch:
seealso