beautypg.com

Esnmp_trap – Compaq AAR04BCTE User Manual

Page 74

background image

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