Global Call ISDN Technology User's Guide: 2.32. gc

2.32. gc_SetParm( )

When using Springware boards, Table 14 lists the parameter selections that can be set using gc_SetParm( ) function. All valid values are defined in the isdncmd.h header file. The default values appear in bold. If no default value is indicated, you need to set the parameter using the gc_SetParm( ) function or specify the parameter in the MAKECALL_BLK data structure. Unspecified parameters that do not have default values are not included in the setup message.

Table 14. Call Setup Parameters When Using gc_SetParm( )

Parameter

Level

Description

BC_XFER_CAP chan Bearer channel information transfer capacity. Possible values are: BEAR_CAP_SPEECH - speech BEAR_CAP_UNREST_DIG - unrestricted data BEAR_CAP_REST_DIG - restricted data

BC_XFER_MODE chan Bearer channel information transfer mode. Possible values are: ISDN_ITM_CIRCUIT - circuit switch

BC_XFER_RATE chan Bearer channel information transfer rate. Possible values are: BEAR_RATE_64KBPS - 64K bps transfer rate

USRINFO_LAYER1_ PROTOCOL chan Layer 1 protocol to use on bearer channel. Possible values are: ISDN_UIL1_CCITTV110 - CCITT standardized rate adaptation V.110/X.30 ISDN_UIL1_G711ULAW - Recommendation G.711 m-Law ISDN_UIL1_G711ALAW - Recommendation G.711 a-Law ISDN_UIL1_CCITTV120 - CCITT standardized rate adaptation V.120 ISDN_UIL1_CCITTX31 - CCITT standardized rate adaptation X.31 HDLC ISDN_UIL1_G721ADCPM - Recommendation G.721 32 kbits/s ADCPM and Recommendation I.460 ISDN_UIL1_G722G725 - Recommendation G.722 and G.725 - 7kHz audio

USRINFO_LAYER1_ PROTOCOL (continued) chan ISDN_UIL1_H261 - Recommendation H.261 - 384 kbits/s video ISDN_UIL1_NONCCITT - Non-CCITT standardized rate adaptation ISDN_UIL1_CCITTV120 - CCITT standardized rate adaptation V.120 ISDN_UIL1_CCITTX31 - CCITT standardized rate adaptation X.31 HDLC ISDN_UIL1_CCITTV110 - CCITT standardized rate adaptation V.110/X.30 ISDN_UIL1_G711ULAW - Recommendation G.711 m-Law ISDN_UIL1_G711ALAW - Recommendation G.711 a-Law ISDN_UIL1_G721ADCPM - Recommendation G.721 32 kbits/s ADCPM and Recommendation I.460 ISDN_UIL1_G722G725 - Recommendation G.722 and G.725 - 7kHz audio ISDN_UIL1_H261 - Recommendation H.261 - 384 kbits/s video ISDN_UIL1_NONCCITT - Non-CCITT

USR_RATE chan User rate to use on bearer channel (layer 1 rate). Possible values are: ISDN_UR_EINI460 - Determined by E bits in I.460 ISDN_UR_56000 - 56 kbits, V.6 ISDN_UR_64000 - 64 kbits, X.1 ISDN_UR_134 - 134.5 bits, X.1 ISDN_UR_12000 - 12 kbits, V.6

CALLED_NUM_TYPE chan Called party number type. Possible values are: EN_BLOC_NUMBER - number is sent en-block (in whole - not overlap sending) INTL_NUMBER - international number for international call. Check with service provider to see if your subscription allows international calls. NAT_NUMBER - national number for call within national numbering plan (accepted by most networks) LOC_NUMBER - subscriber number for a local call. Check with service provider to see if your subscription allows local calls. OVERLAP_NUMBER - overlap sending - number is not sent in whole (not available on all networks).

CALLED_NUM_PLAN chan Called party number plan. Possible values are: UNKNOWN_NUMB_PLAN - unknown plan ISDN_NUMB_PLAN - ISDN/telephony (E.164/E.163) (accepted by most networks) TELEPHONY_NUMB_PLAN - telephony numbering plan PRIVATE_NUMB_PLAN - private numbering plan

CALLING_NUM_TYPE chan Calling party number type. Possible values are: EN_BLOC_NUMBER - number is sent en-block (in whole - not overlap sending) INTL_NUMBER - international number for international call. Check with service provider to see if your subscription allows international calls. NAT_NUMBER - national number for call within national numbering plan (accepted by most networks) LOC_NUMBER - subscriber number for a local call. Check with service provider to see if your subscription allows local calls. OVERLAP_NUMBER - overlap sending - number is not sent in whole (not available on all networks).

CALLING_NUM_PLAN chan Calling party number plan. Possible values are: UNKNOWN_NUMB_PLAN - unknown plan ISDN_NUMB_PLAN - ISDN/telephony (E.164/E.163) (accepted by most networks) TELEPHONY_NUMB_PLAN - telephony numbering plan PRIVATE_NUMB_PLAN - private numbering plan

CALLING_ PRESENTATION chan Calling presentation indicator. Possible values are: PRESENTATION_ALLOWED - allows the display of the calling number at the remote end

CALLING_SCREENING chan Calling screening indicator field. Possible values are: USER_PROVIDED - user provided, not screened (passes through)

GCPR_MINDIGITS trunk Sets minimum number of DDI digits to collect prior to terminating gc_WaitCall( ). GCPR_MINDIGITS may be set using the gc_SetParm( ) function. This parameter value cannot be retrieved using the gc_GetParm( ) function. Possible values are any positive value that indicates the number of digits expected before GCEV_OFFERED is received.

RECEIVE_INFO_BUF chan Multiple IE buffer. Sets the size, that is, the number of messages that can be stored in the information queue. The maximum size of the queue is MAX_RECEIVE_INFO_BUF. NOTE: The gc_SetParm( ) function can be called only once in the application to set the RECEIVE_INFO_BUF buffer size. For gc_SetParm( ), the function returns <0 on failure, 0 on success. For gc_GetParm( ), the buffer number is returned. Possible values are any number in the range of 1 to MAX_RECEIVE_INFO_BUF (currently defined as 160).

Not supported on DM3 boards. Use the gc_SetInfoElem( ) function instead.

When using DM3 boards, the following parameters are supported:

GCPR_MINDIGITS - The minimum number of digits to receive before a call is offered to the application.
GCPR_CALLINGPARTY - The calling party number.
GCPR_RECEIVE_INFO_BUF - The size of the buffers used to store signaling information in incoming ISDN messages.
GCPR_MEDIADETECT - Used to enable or disable post-connect call progress or media detection; disabled by default.
GCPR_CALLPROGRESS - Used to enable or disable call progress; enabled by default. In ISDN, pre-connect call analysis is not used, therefore the function of this parameter is as follows:

If this parameter is enabled, post-connect call progress is dependent on the GCPR_MEDIADETECT parameter above.
If this parameter is disabled, call progress is completely disabled regardless of the value of GCPR_MEDIADETECT parameter above.

**Table 14. Call Setup Parameters When Using gc_SetParm( )**
Parameter	Level	Description
BC_XFER_CAP	chan	Bearer channel information transfer capacity. Possible values are: BEAR_CAP_SPEECH - speech BEAR_CAP_UNREST_DIG - unrestricted data BEAR_CAP_REST_DIG - restricted data
BC_XFER_MODE	chan	Bearer channel information transfer mode. Possible values are: ISDN_ITM_CIRCUIT - circuit switch
BC_XFER_RATE	chan	Bearer channel information transfer rate. Possible values are: BEAR_RATE_64KBPS - 64K bps transfer rate
USRINFO_LAYER1_ PROTOCOL	chan	Layer 1 protocol to use on bearer channel. Possible values are: ISDN_UIL1_CCITTV110 - CCITT standardized rate adaptation V.110/X.30 ISDN_UIL1_G711ULAW - Recommendation G.711 m-Law ISDN_UIL1_G711ALAW - Recommendation G.711 a-Law ISDN_UIL1_CCITTV120 - CCITT standardized rate adaptation V.120 ISDN_UIL1_CCITTX31 - CCITT standardized rate adaptation X.31 HDLC ISDN_UIL1_G721ADCPM - Recommendation G.721 32 kbits/s ADCPM and Recommendation I.460 ISDN_UIL1_G722G725 - Recommendation G.722 and G.725 - 7kHz audio
USRINFO_LAYER1_ PROTOCOL (continued)	chan	ISDN_UIL1_H261 - Recommendation H.261 - 384 kbits/s video ISDN_UIL1_NONCCITT - Non-CCITT standardized rate adaptation ISDN_UIL1_CCITTV120 - CCITT standardized rate adaptation V.120 ISDN_UIL1_CCITTX31 - CCITT standardized rate adaptation X.31 HDLC ISDN_UIL1_CCITTV110 - CCITT standardized rate adaptation V.110/X.30 ISDN_UIL1_G711ULAW - Recommendation G.711 m-Law ISDN_UIL1_G711ALAW - Recommendation G.711 a-Law ISDN_UIL1_G721ADCPM - Recommendation G.721 32 kbits/s ADCPM and Recommendation I.460 ISDN_UIL1_G722G725 - Recommendation G.722 and G.725 - 7kHz audio ISDN_UIL1_H261 - Recommendation H.261 - 384 kbits/s video ISDN_UIL1_NONCCITT - Non-CCITT
USR_RATE	chan	User rate to use on bearer channel (layer 1 rate). Possible values are: ISDN_UR_EINI460 - Determined by E bits in I.460 ISDN_UR_56000 - 56 kbits, V.6 ISDN_UR_64000 - 64 kbits, X.1 ISDN_UR_134 - 134.5 bits, X.1 ISDN_UR_12000 - 12 kbits, V.6
CALLED_NUM_TYPE	chan	Called party number type. Possible values are: EN_BLOC_NUMBER - number is sent en-block (in whole - not overlap sending) INTL_NUMBER - international number for international call. Check with service provider to see if your subscription allows international calls. NAT_NUMBER - national number for call within national numbering plan (accepted by most networks) LOC_NUMBER - subscriber number for a local call. Check with service provider to see if your subscription allows local calls. OVERLAP_NUMBER - overlap sending - number is not sent in whole (not available on all networks).
CALLED_NUM_PLAN	chan	Called party number plan. Possible values are: UNKNOWN_NUMB_PLAN - unknown plan ISDN_NUMB_PLAN - ISDN/telephony (E.164/E.163) (accepted by most networks) TELEPHONY_NUMB_PLAN - telephony numbering plan PRIVATE_NUMB_PLAN - private numbering plan
CALLING_NUM_TYPE	chan	Calling party number type. Possible values are: EN_BLOC_NUMBER - number is sent en-block (in whole - not overlap sending) INTL_NUMBER - international number for international call. Check with service provider to see if your subscription allows international calls. NAT_NUMBER - national number for call within national numbering plan (accepted by most networks) LOC_NUMBER - subscriber number for a local call. Check with service provider to see if your subscription allows local calls. OVERLAP_NUMBER - overlap sending - number is not sent in whole (not available on all networks).
CALLING_NUM_PLAN	chan	Calling party number plan. Possible values are: UNKNOWN_NUMB_PLAN - unknown plan ISDN_NUMB_PLAN - ISDN/telephony (E.164/E.163) (accepted by most networks) TELEPHONY_NUMB_PLAN - telephony numbering plan PRIVATE_NUMB_PLAN - private numbering plan
CALLING_ PRESENTATION	chan	Calling presentation indicator. Possible values are: PRESENTATION_ALLOWED - allows the display of the calling number at the remote end
CALLING_SCREENING	chan	Calling screening indicator field. Possible values are: USER_PROVIDED - user provided, not screened (passes through)
GCPR_MINDIGITS	trunk	Sets minimum number of DDI digits to collect prior to terminating gc_WaitCall( ). GCPR_MINDIGITS may be set using the gc_SetParm( ) function. This parameter value cannot be retrieved using the gc_GetParm( ) function. Possible values are any positive value that indicates the number of digits expected before GCEV_OFFERED is received.
RECEIVE_INFO_BUF	chan	Multiple IE buffer. Sets the size, that is, the number of messages that can be stored in the information queue. The maximum size of the queue is MAX_RECEIVE_INFO_BUF. NOTE: The gc_SetParm( ) function can be called only once in the application to set the RECEIVE_INFO_BUF buffer size. For gc_SetParm( ), the function returns <0 on failure, 0 on success. For gc_GetParm( ), the buffer number is returned. Possible values are any number in the range of 1 to MAX_RECEIVE_INFO_BUF (currently defined as 160).
Not supported on DM3 boards. Use the gc_SetInfoElem( ) function instead.

Click here to contact Telecom Support Resources