gc_SetCallProgressParm( )

---

Termination Events | Cautions | Errors | Example | See Also

Name:	int gc_SetCallProgressParm(linedev, parmp)
Inputs:	LINEDEV linedev	Global Call line device handle
	DX_CAP *parmp	pointer to the call analysis information structure
Returns:	0 if successful <0 if failure
Includes:	gclib.h gcerr.h
Category:	system controls and tools
Mode:	synchronous
Platform and Technology:	Springware: T-1/E-1 (PDKRT only)

Description

The gc_SetCallProgressParm( ) function allows the application to specify the values of the configurable call progress parameters, which override default call progress parameters provided by the protocol. The parameters are specified in the DX_CAP data structure.

Parameter	Description
linedev	Global Call line device handle
parmp	pointer to the call progress information structure, DX_CAP. For a description of the structure, see DX_CAP.

Termination Events

None

Cautions

None

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_setcallprogressparm(int port_num, DX_CAP *infop)
{
    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; 
    /* Set the number of maximum rings */
    infop->ca_nbrdna = 5; 
    /* Set information about the device and store it in the location pointed
       to by infop */
    if (gc_SetCallProgressParm(pline->ldev, infop) == -1)
    {
        /* process error return as shown */
        gc_ErrorInfo( &gc_error_info );
        printf ("Error: gc_SetCallProgressParm() 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_GetCallProgressParm( )

Click here to contact Telecom Support Resources