Esnmp_Trap - Compaq TCP/IP Services for OpenVMS Programming And Reference Manual

eSNMP API Routines

esnmp_trap

esnmp_trap
Sends a trap message to the master agent.
Format
int esnmp_trap ( int *generic_trap,
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
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
esnmp_register
agent is to call the
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
ESNMP_LIB_LOST_
CONNECTION
ESNMP_LIB_NOTOK
5–16 eSNMP API Routines
int specific_trap,
char *enterprise,
varbind *vb ) 2 ;
string in dot notation. Set to the object identifier defined by
OID
routine. This occurs with every API call and for most
routines. The quickest process to send traps to the master
esnmp_init, esnmp_poll
The routine has completed successfully.
Could not send the trap message to master agent.
Something failed and the message could not be
generated.
, and routines.
esnmp_trap