dt_unlisten( )

Description | Cautions | Example | Errors | See Also

Name:	dt_unlisten(devh)
Inputs:	int devh	digital network interface device time slot
Returns:	0 on success -1 on error
Includes:	srllib.h dtilib.h
Category:	SCbus Routing
Mode:	synchronous

Description

The dt_unlisten( ) function disconnects the receive channel from the SCbus. This function disconnects the digital receive (listen) channel (T-1/E-1 time slot) such as on a D/240SC-T1 or D/300SC-E1 board from the SCbus time slot.

Calling the dt_listen( ) function to connect to a different SCbus time slot will automatically break an existing connection. Therefore, when changing connections, you need not call the dt_unlisten( ) function.

NOTE:

The SCbus convenience function nr_scunroute( ) includes dt_unlisten( ) functionality; see the SCbus Routing Function Reference.

Parameter	Description
devh:	Specifies a valid Digital Network Interface time slot device handle returned by a call to dt_open( )

Cautions

This function will fail if an invalid time slot device handle is specified.

Example

#include <windows.h>     /* For Windows applications only */  
#include <srllib.h>  
#include <dtilib.h>  
#include <errno.h>  
   
main( )  
{  
   int devh;             /* Digital channel (time slot) device handle */  
   
   /* Open board 1 time slot 1 device */  
   if ((devh = dt_open("dtiB1T1", 0)) == -1) {  
      printf("Cannot open time slot dtiB1T1.  errno = %d", errno);  
      exit(1);  
   }  
   
   /* Disconnect receive of board 1, time slot 1 from all SCbus time  
    slots */  
   if (dt_unlisten(devh) == -1) {  
      printf("Error message = %s", ATDV_ERRMSGP(devh));  
      exit(1);  
   }  
}

Errors

If the function returns -1, use the SRL Standard Attribute function ATDV_LASTERR( ) to obtain the error code or use ATDV_ERRMSGP( ) to obtain a descriptive error message. The error codes returned by ATDV_LASTERR( ) are:

• EDT_BADBRDERR - Board missing or defective
• EDT_BADCMDERR - Invalid command parameter to driver
• EDT_FWERR - Firmware returned an error
• EDT_INVTS - Invalid time slot device handle
• EDT_INVMSG - Invalid message
• EDT_SH_BADLCLTS - Invalid local time slot number
• EDT_SH_BADEXTTS - External time slot unsupported at current clock rate
• EDT_SH_BADINDX - Invalid Switch Handler library index number
• EDT_SH_BADMODE - Invalid Switch Handler bus configuration
• EDT_SH_BADTYPE - Invalid local time slot type
• EDT_SH_LCLDSCNCT - Local time slot is already disconnected from SCbus
• EDT_SH_LIBBSY - Switch Handler library busy
• EDT_SH_LIBNOTINIT - Switch Handler library is uninitialized
• EDT_SH_MISSING - Switch Handler is not present
• EDT_SH_NOCLK - Switch Handler clock fallback failed
• EDT_SYSTEM - system error
• EDT_TMOERR - Timed out waiting for reply from firmware

See Also

• dt_listen( )

Click here to contact Dialogic Customer Engineering