Event Management Functions

The enable processing of unsolicited and asynchronous termination events returned by library functions. For the Digital Network Interface, these functions include:

dt_rundiag( )

dt_setevtmsk( )

dt_tstcom( )

dt_tstdat( )

dt_xmitwink( )

Each of the Event Management functions applicable to the Digital Network Interface are listed in the following tables. Table 9 shows Digital Network Interface-specific inputs and Table 10 shows valid Digital Network Interface returns.

Table 9. Digital Network Interface Inputs for Event Management Functions

Event Management Function	Digital Network Interface-specific Input	Valid Input Value
sr_enbhdlr( )Enable event handler	evt_type	DTEV_T1ERRC - T-1 alarm condition detected
		DTEV_E1ERRC - E-1 alarm condition detected
		DTEV_SIG - Signaling transition event detected
		DTEV_COMRSP - Successful communications test
		DTEV_DATRSP - Response to data test
		DTEV_RETDIAG - Diagnostic complete
		DTEV_WINKCPLT - Wink transmission complete
		DTEV_RCVPDG - Receive pulse digits
		DTEV_PDDONE - Pulse dial complete events
		DTEV_ERREVT - Error condition event
		DTEV_MTFCNCPT - Multitasking function complete
sr_dishdlr( ) Disable event handler	evt_type	Same as above
sr_getevtdev( ) Get device handle	device	Digital Network Interface device handle
sr_getevttype( ) Get event type	event type	DTEV_T1ERRC
		DTEV_E1ERRC
		DTEV_SIG
		DTEV_COMRSP
		DTEV_DATRSP
		DTEV_RETDIAG
		DTEV_WINKCPLT
		DTEV_RCVPDG
		DTEV_PDDONE
		DTEV_ERREVT
		DTEV_MTFCNCPT
sr_getevtlen( ) Get event data length	event length	Number of bytes in the data returned
sr_getevtdatap( ) Get pointer to event data	event data	Pointer to event specific data

Table 10. Digital Network Interface Returns from Event Management Functions

Event Management Function	Digital Network Interface-specific Return	Returned Value
sr_getevtdev( ) Get device handle	device	Digital Network Interface device handle
sr_getevttype( ) Get event type	event type	DTEV_T1ERRC DTEV_E1ERRC
		DTEV_SIG
		DTEV_COMRSP
		DTEV_DATRSP
		DTEV_RETDIAG
		DTEV_WINKCPLT
		DTEV_RCVPDG
		DTEV_PDDONE
		DTEV_ERREVT
		DTEV_MTFCNCPT
sr_getevtlen( ) Get event data length	event length	Digital Network Interface event length information
sr_getevtdatap( ) Get pointer to event data	event data	Digital Network Interface event data pointer information

Click here to contact Dialogic Customer Engineering