gc_UnListen( )

---

Termination Events | Cautions | Errors | Example | See Also

Name:	int gc_UnListen(linedev, mode)
Inputs:	LINEDEV linedev	Global Call line device handle
	unsigned long mode	async or sync
Returns:	0 if successful <0 if failure
Includes:	gclib.h gcerr.h
Category:	system controls and tools
Mode:	asynchronous or synchronous
Platform and Technology:	Springware: T-1/E-1 (PDKRT only) DM3: T-1/E-1, ISDN, Analog SS7 IP (host-based stack† and embedded stack†) †See the Global Call Technology User's Guides for additional information.

Description

The gc_UnListen( ) function disconnects a channel from the network CT Bus time slot for a line device that was connected previously using the gc_Listen( ) function.

Parameter	Description
linedev	Global Call line device handle
mode	set to EV_ASYNC for asynchronous execution or to EV_SYNC for synchronous execution

Termination Events

GCEV_UNLISTEN

indicates that the time slot has been unrouted successfully.

GCEV_TASKFAIL

indicates that the time slot unrouting has failed.

Cautions

For routing on resources such as voice resources, the routing function for the corresponding library must be called, for example, dx_getxmitslot( ), dx_listen( ), dx_unlisten( ).

Errors

If this function returns <0 to indicate failure, use the gc_ErrorInfo( ) function to retrieve the reason for the error. See the "Error Handling" section in the Global Call API Programming Guide. All Global Call error codes are defined in the gcerr.h file. If the error returned is technology specific, see the technology-specific error header file(s) for the error definition (for example, ccerr.h or isdnerr.h file for the ISDN call control library).

Example

#include <stdio.h>
#include <srllib.h>
#include <gclib.h>
#include <gcerr.h> 
#define MAX_CHAN 30              /* max. number of channels in system */ 
/*
* Data structure which stores all information for each line
*/
static struct linebag {
    LINEDEV  ldev;      /* GlobalCall API line device handle */
    CRN      crn;       /* GlobalCall API call handle */
    int      blocked;   /* channel blocked/unblocked */
    int      networkh;  /* network handle */
} port[MAX_CHAN+1];
struct linebag *pline;           /* pointer to access line device */ 
/*
 * Assume the following has been done:
 *    1. Opened line devices for each time slot on DTIB1.
 *    2. Each line device and voice handle is stored in linebag structure "port"
 */
int call_unlisten(int port_num)
{
    GC_INFO        gc_error_info;   /* GlobalCall error information data */ 
    /* Find info for this time slot, specified by 'port_num' */
    /* (assumes port_num is valid) */
    pline = port + port_num; 
    /* Disconnect receive of digital board 1, timeslot 1
       from all CTbus timeslots */
    if (gc_UnListen(pline->ldev, EV_SYNC) == -1) 
    {
        /* process error return as shown */
        gc_ErrorInfo( &gc_error_info );
        printf ("Error: gc_UnListen() on device handle: 0x%lx, GC ErrorValue: 0x%hx - %s, 
                CCLibID: %i - %s, CC ErrorValue: 0x%lx - %s\n",
                pline->ldev, gc_error_info.gcValue, gc_error_info.gcMsg, 
                gc_error_info.ccLibId, gc_error_info.ccLibName,
                gc_error_info.ccValue, gc_error_info.ccMsg);
        return (gc_error_info.gcValue);
    }
    return (0);
} 

See Also

• gc_GetCTInfo( )
• gc_GetXmitSlot( )
• gc_Listen( )

Click here to contact Telecom Support Resources