The MAKECALL_BLK structure contains the parameters used to specify an outgoing call. Outgoing calls are made using the cc_MakeCall( ) function. The parameters for outgoing calls are set when the MAKECALL Block function is initialized. For information on initializing the MAKECALL Block, see Section 6.8.1. MAKECALL_BLK Initialization.
The structure is defined as follows:
struct is {
unsigned char BC_xfer_cap;
unsigned char BC_xfer_mode;
unsigned char BC_xfer_rate;
unsigned char usrinfo_layer1_protocol;
unsigned char usr_rate;
unsigned char destination_number_type;
unsigned char destination_number_plan;
unsigned char destination_sub_number_type;
unsigned char destination_sub_number_plan;
char destination_sub_phone_number[MAXPHONENUM];
unsigned char origination_number_type;
unsigned char origination_number_plan;
char origination_phone_number[MAXPHONENUM];
unsigned char origination_sub_number_type;
unsigned char origination_sub_number_plan;
char origination_sub_phone_number[MAXPHONENUM];
unsigned char facility_feature_service;
unsigned char facility_coding_value;
int completion_point;
union {
struct {
int rfu;
} att;
struct {
CHAN_ID channel_id;
} bri;
struct {
int rfu;
} vn3;
struct {
int rfu;
} dass;
}u; /* switch system dependent parameters */
USRINFO_ELEM *usrinfo_bufp;
NFACILITY_ELEM *nsfc_bufp;
}isdn;
} MAKECALL_BLK, *MAKECALL_BLK_PTR;
The following table provides definitions of the MAKECALL block parameters. All elements in the MAKECALL_BLK structure must be specified. To use the default setting, specify ISDN_NOTUSED.
Table 37. MAKECALL_BLK Parameter ID Definitions
Parameter |
Description |
Supported values |
BC_xfer_cap |
Bearer channel information transfer capability. |
BEAR_CAP_SPEECH - speech BEAR_CAP_UNREST_DIG - unrestricted digital data BEAR_REST_DIG - restricted digital data NOTE: The value specified by cc_SetParm( ) is used if this element is set to ISDN_NOTUSED. |
BC_xfer_mode |
Bearer channel information transfer mode |
ISDN_ITM_CIRCUIT - circuit switch mode NOTE: The value specified by cc_SetParm( ) is used if this element is set to ISDN_NOTUSED. |
BC_xfer_rate |
Bearer channel information transfer rate |
BEAR_RATE_64KBPS - 64K bps transfer rate NOTE: The value specified by cc_SetParm( ) is used if this element is set to ISDN_NOTUSED. |
usrinfo_layer1_protocol |
Layer 1 protocol to use on bearer channel |
ISDN_UIL1_CCITTV.110 - CCITT standardized rate adaptation V.110) ISDN_UIL1_G711uLAW - recommendation G.711 u-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.772 and G.725 - 7kHz ISDN_UIL1_H261 - recommendation H.262 - 384 kbits/s video ISDN_UIL1_NONCCITT - Non-CCITT standardized rate adaptation ISDN_UIL1_CCITTV120 - CCITT standardize rate adaptation V.120 ISDN_UIL1_CCITTX31 - CCITT standardized rate adaptation X.31HDLC NOTE: This element must be set to ISDN_NOTUSED if it is not to be used in the setup message. |
usr_rate |
User rate to use on bearer channel (layer 1 rate) |
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 - 1345 kbits, X.1 ISDN_UR_12000 - 12 kbits, V.6 NOTE: This element must be set to ISDN_NOTUSED if it is not to be used in the setup message. |
destination_number_type |
Called party number type |
EN_BLOC_NUMBER - number is sent en-block (in whole, not overlap sending) INTL_NUMBER - international number for international call. (verify availability with service provider) NAT_NUMBER - national number for call within national numbering plan (accepted by most networks) LOC_NUMBER - subscriber number for a local call (verify availability with service provider) OVERLAP_NUMBER - overlap sending; number is not sent in whole (not available on all networks) NOTE: The value specified by cc_SetParm( ) is used if this element is set to ISDN_NOTUSED. |
destination_number_plan |
Called party number plan |
UNKNOWN_NUMB_PLAN unknown new plan ISDN_NUMB_PLAN - ISDN/telephony - E.164/E.163 (accepted by most networks) TELEPHONY_NUMB_PLAN telephony numbering plan - E.164 PRIVATE_NUMB_PLAN - private numbering plan NOTE: The value specified by cc_SetParm( ) is used if this element is set to ISDN_NOTUSED. |
destination_sub_number_type |
Called party sub-number type |
OSI_SUB_ADDR - NSAP - (X.213/ISO 8348 AD2) (not accepted by all networks) USER_SPECIFIC_SUB_ADDR - user specified (not accepted by all networks) IA_5_FORMAT IA5 - sub-address digit format; telephony numbering plan (accepted by most networks) NOTE: This element must be set to ISDN_NOTUSED if it is not to be used in the setup message. |
destination_sub_number_plan |
Called party sub-number plan |
ISDN_NOTUSED (reserved for future use) |
destination_sub_phone_ number [MAXPHONENUM] |
Called party sub-phone number |
ASCII digit string of MAXPHONENUM. If the first character is set to ISDN_NOTUSED, the number plan and type are ignored and the destination_sub_phone_number IE will not be sent. NOTE: This element must be set to ISDN_NOTUSED if it is not to be used in the setup message. |
origination_number_type |
Calling party number type |
Same values as destination_number_type |
origination_number_plan |
Calling party number plan |
Same values as destination_number_plan |
origination_phone_number [MAXPHONENUM] |
Calling party phone number - sets the calling party number for this call only. |
ASCII digit string of MAXPHONENUM. If the first character is set to ISDN_NOTUSED, the number plan and type are ignored and the origination_phone_number IE will not be sent. Use cc_SetCallingNum( ) to set the number permanently. NOTE: This element must be set to ISDN_NOTUSED if it is not to be used in the setup message. |
origination_sub_number_type |
Calling party sub-number type |
Same values as destination_sub_number_type |
origination_sub_number_plan |
Calling party sub-number plan |
Same values as destination_sub_number_plan |
origination_sub_phone_ number [MAXPHONENUM] |
Calling party sub-phone number |
ASCII digit string of MAXPHONENUM. If the first character is set to ISDN_NOTUSED, the number plan and type are ignored and the origination_sub_phone_number IE will not be sent. NOTE: This element must be set to ISDN_NOTUSED if it is not to be used in the setup message. |
facility_feature_service |
Identifies facility request as a feature or a service (see Note below) |
ISDN_FEATURE - request is a facility feature. Features are normally used in the facility message after a call is initiated. Features can also be used in the setup message. ISDN_SERVICE - requested facility is a service. Service can be used at any time in the NSF IE. Service is often used in the setup message to select a specific network service. NOTE: This element must be set to ISDN_NOTUSED if it is not to be used in the setup message. |
facility_coding_value |
Facility coding value; identifies the specific feature or service provided (see Note below) |
ISDN_CPN_PREF - calling party number preferred ISDN_SDN - AT&T Software Defined Network ISDN_BN_PREF - billing number preferred ISDN_ACCUNET - AT&T ACCUNET service ISDN_LONG_DIS - long distance service ISDN_INT_800 - international 800 service ISDN_CA_TSC - CA TSC service ISDN_ATT_MULTIQ - AT&T Multiquest 900 service NOTE: This element must be set to ISDN_NOTUSED if it is not to be used in the setup message. |
completion_point |
Reserved for future use |
Set to ISDN_NOTUSED (reserved for future use) |
channel_id |
Channel ID structure |
See Section 6.2. channel_id for a description of the structure and the supported values. |
USRINFO_ELEM *usrinfo_bufp |
User information element |
Not used, set to NULL. See the cc_SetInfoElem( ) function to add custom IEs to the MAKECALL Block. NOTE: This element must be set to NULL if it is not to be used in the setup message. |
NFACILITY_ELEM *nsfc_bufp |
Network specific facility element |
Not used, set to NULL. See the cc_SetInfoElem( ) function to add custom IEs to the MAKECALL Block. NOTE: This element must be set to NULL if it is not to be used in the setup message. |
NOTE: The facility_feature_service and facility_coding_value data elements must be paired to support the specific feature or service requested from the network. The specific feature/service that is being used must be identified before entering a value for facility_feature_service. | ||
6.8.1. MAKECALL_BLK InitializationBecause ISDN services vary with switches and provisioning plans, a set of default standards cannot be set for the MAKECALL_BLK. Therefore, it is up to the user application to fill in the applicable MAKECALL_BLK values that apply to the particular provisioning.
All of the bearer capability elements in the MAKECALL_BLK structure must be specified. Specify ISDN_NOTUSED will cause the default values to be sent. The application should first initialize the MAKECALL_BLK structure with a set of defaults prior to filling in settings pertaining to the particular ISDN service.
A sample MAKECALL_BLK initialization is shown below:
/* Initialize the MAKECALL block */
makecall_blk.isdn.BC_xfer_cap = BEAR_CAP_SPEECH;
makecall_blk.isdn.BC_xfer_mode = ISDN_ITM_CIRCUIT;
makecall_blk.isdn.BC_xfer_rate = BEAR_RATE_64KBPS;
makecall_blk.isdn.usrinfo_layer1_protocol = 0xFF;
makecall_blk.isdn.usr_rate = 0xFF;
makecall_blk.isdn.destination_number_type = 0xFF;
makecall_blk.isdn.destination_number_plan =0xFF;
makecall_blk.isdn.destination_sub_number_type = 0xFF;
makecall_blk.isdn.destination_sub_phone_number[0] = NULL;
makecall_blk.isdn.origination_number_type = 0xFF;
makecall_blk.isdn.origination_number_plan = 0xFF;
makecall_blk.isdn.origination_sub_number_type = 0xFF;
makecall_blk.isdn.origination_sub_phone_number[0] = NULL;
makecall_blk.isdn.origination_phone_number[0] = NULL;
makecall_blk.isdn.facility_feature_service = 0xFF;
makecall_blk.isdn.facility_coding_value = 0xFF;
makecall_blk.isdn.usrinfo_bufp = NULL;
makecall_blk.isdn.nsfc_bufp = NULL;
For more on the MAKECALL_BLK structure, see the cc_MakeCall( ) function description in Chapter 5. ISDN Function Reference.
Click here to contact Dialogic Customer Engineering
Copyright 2001, Dialogic Corporation