cc_SetParmEx( )

Description | Cautions | Example | Errors | See Also

Name:	int cc_SetParmEx(linedev, parm_id, *parminfoptr)
Inputs:	LINEDEV linedev	line device handle
	int parm_id	parameter identifier
	PARM_INFO *parminfoptr	pointer to the PARM_INFO block
Returns:	0 on success < 0 on failure
Includes:	cclib.h
Category:	System tools
Mode:	synchronous
Technology:	BRI/2; BRI/SC; PRI (all protocols)

Description

The cc_SetParmEx( ) function is an extension of the cc_SetParm( ) function that allows the application to set parameters requiring variable data to be passed down to the firmware, without reconfiguration. These parameters include the Service Protocol Identifier (SPID) number, the directory number, and the subaddress of a User-side line. The SPID must first be specified using the cc_SetDChanCfg( ) function and then can be changed using the cc_SetParmEx( ) function. The directory number and subaddress, which are used to restrict incoming calls to those whose parameters match the specified values, can be set and/or changed at any time using the cc_SetParmEx( ) function.

Parameter	Description
linedev:	The line device handle.
parm_id:	The parameter identification. This function supports all of the parameters listed in Table 26 in the cc_SetParm( ) function description. In addition, for BRI/SC only, the following parameters are also supported:   SPID_NUMBER - Service Protocol Identifier Number (applicable to BRI North American Protocols only)   SUBADDR_NUMBER - Subaddress Number (applicable to BRI User Side switches only)   DIRECTORY_NUMBER - Directory Number (applicable to BRI User Side switches only) The values for parm_id are defined in cclib.h.
parminfoptr:	A pointer to the PARM_INFO structure, which contains variable data to set in the firmware on a call-by-call basis. For a description of the PARM_INFO data structure, see 6.10. PARM_INFO.

Cautions

• In order to use the cc_SetParmEx( ) function to change the SPID, the D channel must first be configured as an initializing terminal using the cc_SetDChanCfg( ) function.
• When the link goes down, the last SPID negotiated with the network will be the only SPID to be renegotiated when the link comes back up. This means that both B channels will end up with the same renegotiated SPID. Use the cc_SetParmEx( ) function to reset the SPIDs for the B channels.

Example

#include <windows.h>   /* For Windows applications only */  
#include <stdio.h>  
#include <errno.h>  
#include <string.h>  
#include "srllib.h"  
#include "dtilib.h"  
#include "cclib.h"  
void main()  
{  
   LINEDEV   ldev = 0;  
   CRN       crn = 0;  
   char     *devname = "briS1T1";  /* device name for BRI station 1 timeslot 1 */  
   PARM_INFO *parminfo;   /* variable data to be set */  
   char *DN = "99330008080";  
   .  
   .  
   .  
  /* open the ISDN board device */  
  if ( cc_Open( &ldev, devname, 0 ) < 0 )   
   {  
      printf("Error opening device: errno = %d\n", errno);  
      exit(1);  
   }  
  /* initialize PARM_INFO structure */  
   parminfo.parmdatalen = strlen(DN);  
   strcpy (parminfo.parmdata, DN); /* directory number */  
  /* Specify the Directory Number */  
   if cc_SetParmEx(ldev, DIRECTORY_NUMBER, parminfo) < 0)  
   {  
      printf("Error in cc_SetParmEx(): %d\n", cc_CauseValue(ldev);  
   }  
    
   /* initialize D channel with cc_SetDChanCfg */  
        .  
        .  
        .  
   /* continue with call processing */  
        .  
        .  
        .  
        .  
} /* end main */  
int callfail(CRN crn)  
{            
        LINEDEV ld;  
         cc_CRN2LineDev(crn,&ld);  
         procdevfail(ld);  
}  
int procdevfail(LINEDEV handle)  
{  
        int reason;  
        char *msg;  
        reason = cc_CauseValue(handle);  
        cc_ResultMsg(handle,reason,&msg);  
        printf("reason = %x - %s\n",reason,msg);  
}

Errors

If the function returns < 0 to indicate failure, use the cc_CauseValue( ) function to retrieve the reason code for the failure. The cc_ResultMsg( ) function can be used to interpret the reason code. Error codes are defined in the files ccerr.h, isdnerr.h, and isdncmd.h.

Error codes from the cc_SetParmEx( ) function include the following:

Error Code	Description
ERR_ISDN_LIB | E_ISBADIF	Bad interface number
ERR_ISDN_LIB | E_ISBADTS	Bad time slot
ERR_ISDN_LIB | E_ISBADPAR	Bad input parameter

See Also

• cc_GetParmEx( )
• cc_SetParm( )

Click here to contact Dialogic Customer Engineering