Compaq AAR04BCTE - Manual (Page 74)

eSNMP API Routines
esnmp_trap
esnmp_trap
Sends a trap message to the master agent.
Format
int esnmp_trap ( int *generic_trap,
int specific_trap,
char *enterprise,
varbind *vb ) 2 ;
Arguments
generic_trap
A generic trap code. Set this argument value to 0 (zero) for SNMPv2 traps.
specific_trap
A specific trap code. Set this argument value to 0 (zero) for SNMPv2 traps.
enterprise
An enterprise OID string in dot notation. Set to the object identifier defined by
the NOTIFICATION-TYPE macro in the defining MIB specification. This value is
passed as the value of SnmpTrapOID.0 in the SNMPv2-Trap-PDU.
vb
A VARBIND list of data (a null pointer indicates no data).
Description
This function can be called any time. If the master agent is not running, traps
are queued and sent when communication is possible.
The trap message is actually sent to the master agent after it responds
to the
esnmp_init routine. This occurs with every API call and for most
esnmp_register routines. The quickest process to send traps to the master
agent is to call the esnmp_init, esnmp_poll , and esnmp_trap routines.
The master agent formats the trap into an SNMP trap message and sends it to
management stations based on its current configuration.
The master agent does not respond to the content of the trap. However, the
master agent does return a value that indicates whether the trap was received
successfully.
Return Values
ESNMP_LIB_OK The routine has completed successfully.
ESNMP_LIB_LOST_
CONNECTION Could not send the trap message to master agent.
ESNMP_LIB_NOTOK Something failed and the message could not be
generated.
5–16 eSNMP API Routines