Important

   

This documentation space contains information about PATROL Agents when deployed in a TrueSight Operations Management environment. If you are a BMC Helix Operations Management user, see PATROL Agent 22.4 for BMC Helix Operations Management. Open link

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 }

Was this page helpful? Yes No Submitting... Thank you

Comments