Traps for PATROL Agent

The PATROL Agent sends traps to registered SNMP managers in V1 format only.

• To register an SNMP manager with the PATROL Agent, add the manager to a row in the piV1mTable.
• To add the manager, send an instance of piV1mRowStatus for the desired ip/port/community with a value of CreateAndGo (4).
• To delete the manager, set its value to Delete (6).

The PATROL Agent sends two types of traps as follows:

• patrolTrapV1StateChanged is sent to all registered SNMP managers when an application instance state changes.
• patrolTrapV1Raised is sent to registered SNMP managers when a PSL snmp_raise_std_trap( ) is called.

The object patrolTrapText carries text passed with the trap. For patrolV1TrapRaised, the value of patrolTrapText.0 is defined by the PSL program as the only parameter for the snmp_trap_raise_std_trap( ) function. For patrolV1TrapStateChanged, the value of patrolTrapText.0 is a string PATROL_OBJECT_NAME NEW_STATUS or PATROL_OBJECT_NAME NEW_STATUS NEW_VALUE (PATROL parameters).

Enterprise-specific 1 to 9 are reserved.

patrolTrapV1Raised TRAP-TYPE

ENTERPRISEpatrolTraps
OBJECTS{patrolTrapText}
DESCRIPTION "A patrolTrapV1Raised trap is sent when one of the PSL scripts calls the snmp_raise_std_trap function. This trap is sent to the SNMP V1 entity according to piV1mTable."
: := 10

patrolTrapV1StateChanged TRAP-TYPE

ENTERPRISEpatrolTraps
OBJECTS{variableValue}
DESCRIPTION "A patrolTrapV1StateChanged is sent when the PATROL Agent changes the state of the discovered application instances. This trap is sent to the SNMP V1 entity according to piV1mTable."
: := 11

patrolTrapText OBJECT-TYPE

SYNTAXOCTET STRING (SIZE (0..127))
ACCESSread-only
STATUSmandatory
DESCRIPTION "String passed by PSL to inform the agent about the trap reason"
: := { patrolTraps 9 }

patrolTrapOrigin OBJECT-TYPE

SYNTAXOCTET STRING (SIZE (0..127))
ACCESSread-only
STATUSoptional
DESCRIPTION "Name of the object that originated the trap"
: := { patrolTraps 10}

patrolTrapExtra OBJECT-TYPE

SYNTAXOCTET STRING (SIZE (0..127))
ACCESSread-only
STATUSoptional
DESCRIPTION "Extra information, usually parameter value"
: := {patrolTraps 11 }