1.13.5. GCIS_SET_DCHANCFG Parameter Set

1.13.5. GCIS_SET_DCHANCFG Parameter Set

The set is used for to configure the Digital Subscriber Loop (DSL) for the D channel. Setting the configuration causes the activation of links if the switch type specified is valid. This set encapsulates the DSL-specific and logical Data Link-specific parameters. These parameters include switch type, switch side (Network or User) and terminal assignment (fixed Terminal Endpoint Identifier or auto-initializing Terminal Endpoint Identifier). Each station interface can be configured separately, which allows you to run different protocols on different stations simultaneously.

When the switch is operating as the User side in North American protocols, the gc_SetConfigData( ) (to set DSL configuration) function is used to program the Service Profile Identifier (SPID). The SPID must be transmitted and acknowledged by the switch (see the gc_RespService ( ) function for more information).

The gc_SetConfigData( ) (to set DSL configuration) function is also used to define Layer 3 timer values, specify Layer 2 Access and set firmware features such as firmware-applied call progress tones.

Although the gc_SetConfigData( ) (to set DSL configuration) function is supported for BRI/2 and PRI protocols, it can be used only to define Layer 3 timer values. All other parameters in the set are applicable only to BRI/SC.

Table 14. GCIS_SET_DCHANCFG Parameter IDs
Parameter ID Type Description

GCIS_PARM_DCHANCFG_AUTOINITFLAG char Boolean value defining whether the terminal is an auto initializing terminal. This field applies only when configuring the DSL as the User side and only to North American protocols.

AUTO_INIT_TERMINAL = auto initializing terminal
NON_INIT_TERMINAL = non-auto initializing term

GCIS_PARM_DCHANCFG_FIRMWARE_FEATUREMASKA int Firmware feature control field A. This is a bit mask field for setting features in the firmware.The following defines are used to configure the firmware features. The lowest two bits provide a combination of four possible settings for the TONE feature. where:

NO_PCM_TONE = Disable firmware from providing tones and set default encoding according to switch type
ULAW_PCM_TONE = Provide tones and use ULAW encoding for B channel tones

ALAW_PCM_TONE = Provide tones and use ALAW encoding for B channel tones
DEFAULT_PCM_TONE = Provide tones and use default encoding for B channel tones according to the switch type setting
SENDING_COMPLETE_ATTACH = Add Sending Complete IE to SETUP message
USER_PERST_L2_ACT = Persistent L2 activation on User side
HOST_CONTROLLED_RELEASE = Delay RELEASE reply until host issues cc_ReleaseCall( )

GCIS_PARM_DCHANCFG_FIRMWARE_FEATUREMASKB int Firmware feature control field. This is a bit mask field for setting features in the firmware. Currently not used.

GCIS_PARM_DCHANCFG_FIXEDTEIVALUE int Defines the TEI to be used for a fixed TEI assigning terminal. Valid values lie in range 0 to 63 (Required when GCIS_PARM_DCHANCFG_TEIASSIGNMENT = FIXED_TEI_TERMINAL).

GCIS_PARM_DCHANCFG_L2ACCESS int Boolean value used to configure the DSL for direct layer 2 access or for full stack access.
Valid values are:

LAYER_2_ONLY: ISDN access at layer 2. If this is selected then no other parameters are required.
FULL_ISDN_STACK: ISDN access at L3 call control.

GCIS_PARM_DCHANCFG_NUMENDPOINTS int Number of logical data links to be supported. Valid values lie in 1 to MAX_DLINK range, where MAX_DLINK is currently set to 8. This field only has significance when configuring the DSL as the NETWORK side.

GCIS_PARM_DCHANCFG_SPID char (ASCII digit string limited to the digits 0-9 and limited in length to MAX_SPID_SIZE). - Defines the assigned Service Provider Identifier (SPID) value for terminal initialization. It is only applicable to User side US switches. Note: When you set the SPID, it is assigned to both bearer channels associated with the D channel. To subsequently modify SPID assignments, use this parameter to modify the value. MAX_SPID_SIZE = (20+1) - Required when GCIS_PARM_DCHANCFG_AUTOINITFLAG = AUTO_INIT_TERMINAL. Most North American switches require a SPID.

GCIS_PARM_DCHANCFG_SWITCHSIDE int Boolean value defining whether the DSL should be configured as the Network side (NT) or the User side (TE). Valid values are:

USER_SIDE = User side of ISDN protocol
NETWORK_SIDE = Network side of ISDN protocol

GCIS_PARM_DCHANCFG_SWITCHTYPE int Basic rate protocol (switch type) for DSL. Multiple run-time selectable switch types are available. Valid values are:

ISDN_BRI_5ESS = ATT 5ESS BRI
ISDN_BRI_DMS100 = Northern Telecom DMS100 BRI
ISDN_BRI_NTT = Japanese INS-Net 64 BRI
ISDN_BRI_NET3 = EuroISDN BRI
ISDN_BRI_NI1 = National ISDN 1
ISDN_BRI_NI2 = National ISDN 2
Example: typedef enum {
ISDN_INVALID_SWITCH=0x80,
ISDN_BRI_5ESS,
ISDN_BRI_DMS100,
ISDN_BRI_NTT,
ISDN_BRI_NET3,
ISDN_BRI_NI1,
ISDN_BRI_NI2
} IsdnSwitchType;

GCIS_PARM_DCHANCFG_TEIASSIGNMENT int Applies to User Side only. It specifies if the terminal has a fixed TEI or an auto-assigning TEI. If it is fixed, then GCIS_PARM_DCHANCFG_FIXEDTEIVALUE must be specified (see below). Valid values are:

AUTO_TEI_TERMINAL = auto TEI assigning Term
FIXED_TEI_TERMINAL = Fixed TEI assigning Term
The following timers define the Layer 3 timer values.

GCIS_PARM_DCHANCFG_TMR302
GCIS_PARM_DCHANCFG_TMR303
GCIS_PARM_DCHANCFG_TMR304
GCIS_PARM_DCHANCFG_TMR305
GCIS_PARM_DCHANCFG_TMR306
GCIS_PARM_DCHANCFG_TMR308
GCIS_PARM_DCHANCFG_TMR309
GCIS_PARM_DCHANCFG_TMR310
GCIS_PARM_DCHANCFG_TMR312
GCIS_PARM_DCHANCFG_TMR313
GCIS_PARM_DCHANCFG_TMR318
GCIS_PARM_DCHANCFG_TMR319
GCIS_PARM_DCHANCFG_TMR322 (long)
Values are not needed.

**Table 14. GCIS_SET_DCHANCFG Parameter IDs**
Parameter ID	Type	Description
GCIS_PARM_DCHANCFG_AUTOINITFLAG	char	Boolean value defining whether the terminal is an auto initializing terminal. This field applies only when configuring the DSL as the User side and only to North American protocols. AUTO_INIT_TERMINAL = auto initializing terminal NON_INIT_TERMINAL = non-auto initializing term
GCIS_PARM_DCHANCFG_FIRMWARE_FEATUREMASKA	int	Firmware feature control field A. This is a bit mask field for setting features in the firmware.The following defines are used to configure the firmware features. The lowest two bits provide a combination of four possible settings for the TONE feature. where: NO_PCM_TONE = Disable firmware from providing tones and set default encoding according to switch type ULAW_PCM_TONE = Provide tones and use ULAW encoding for B channel tones
		ALAW_PCM_TONE = Provide tones and use ALAW encoding for B channel tones DEFAULT_PCM_TONE = Provide tones and use default encoding for B channel tones according to the switch type setting SENDING_COMPLETE_ATTACH = Add Sending Complete IE to SETUP message USER_PERST_L2_ACT = Persistent L2 activation on User side HOST_CONTROLLED_RELEASE = Delay RELEASE reply until host issues cc_ReleaseCall( )
GCIS_PARM_DCHANCFG_FIRMWARE_FEATUREMASKB	int	Firmware feature control field. This is a bit mask field for setting features in the firmware. Currently not used.
GCIS_PARM_DCHANCFG_FIXEDTEIVALUE	int	Defines the TEI to be used for a fixed TEI assigning terminal. Valid values lie in range 0 to 63 (Required when GCIS_PARM_DCHANCFG_TEIASSIGNMENT = FIXED_TEI_TERMINAL).
GCIS_PARM_DCHANCFG_L2ACCESS	int	Boolean value used to configure the DSL for direct layer 2 access or for full stack access. Valid values are: LAYER_2_ONLY: ISDN access at layer 2. If this is selected then no other parameters are required. FULL_ISDN_STACK: ISDN access at L3 call control.
GCIS_PARM_DCHANCFG_NUMENDPOINTS	int	Number of logical data links to be supported. Valid values lie in 1 to MAX_DLINK range, where MAX_DLINK is currently set to 8. This field only has significance when configuring the DSL as the NETWORK side.
GCIS_PARM_DCHANCFG_SPID	char	(ASCII digit string limited to the digits 0-9 and limited in length to MAX_SPID_SIZE). - Defines the assigned Service Provider Identifier (SPID) value for terminal initialization. It is only applicable to User side US switches. Note: When you set the SPID, it is assigned to both bearer channels associated with the D channel. To subsequently modify SPID assignments, use this parameter to modify the value. MAX_SPID_SIZE = (20+1) - Required when GCIS_PARM_DCHANCFG_AUTOINITFLAG = AUTO_INIT_TERMINAL. Most North American switches require a SPID.
GCIS_PARM_DCHANCFG_SWITCHSIDE	int	Boolean value defining whether the DSL should be configured as the Network side (NT) or the User side (TE). Valid values are: USER_SIDE = User side of ISDN protocol NETWORK_SIDE = Network side of ISDN protocol
GCIS_PARM_DCHANCFG_SWITCHTYPE	int	Basic rate protocol (switch type) for DSL. Multiple run-time selectable switch types are available. Valid values are: ISDN_BRI_5ESS = ATT 5ESS BRI ISDN_BRI_DMS100 = Northern Telecom DMS100 BRI ISDN_BRI_NTT = Japanese INS-Net 64 BRI ISDN_BRI_NET3 = EuroISDN BRI ISDN_BRI_NI1 = National ISDN 1 ISDN_BRI_NI2 = National ISDN 2 Example: typedef enum { ISDN_INVALID_SWITCH=0x80, ISDN_BRI_5ESS, ISDN_BRI_DMS100, ISDN_BRI_NTT, ISDN_BRI_NET3, ISDN_BRI_NI1, ISDN_BRI_NI2 } IsdnSwitchType;
GCIS_PARM_DCHANCFG_TEIASSIGNMENT	int	Applies to User Side only. It specifies if the terminal has a fixed TEI or an auto-assigning TEI. If it is fixed, then GCIS_PARM_DCHANCFG_FIXEDTEIVALUE must be specified (see below). Valid values are: AUTO_TEI_TERMINAL = auto TEI assigning Term FIXED_TEI_TERMINAL = Fixed TEI assigning Term The following timers define the Layer 3 timer values. GCIS_PARM_DCHANCFG_TMR302 GCIS_PARM_DCHANCFG_TMR303 GCIS_PARM_DCHANCFG_TMR304 GCIS_PARM_DCHANCFG_TMR305 GCIS_PARM_DCHANCFG_TMR306 GCIS_PARM_DCHANCFG_TMR308 GCIS_PARM_DCHANCFG_TMR309 GCIS_PARM_DCHANCFG_TMR310 GCIS_PARM_DCHANCFG_TMR312 GCIS_PARM_DCHANCFG_TMR313 GCIS_PARM_DCHANCFG_TMR318 GCIS_PARM_DCHANCFG_TMR319 GCIS_PARM_DCHANCFG_TMR322 (long) Values are not needed.

Click here to contact Dialogic Customer Engineering