Introduction

ISDN_PROTOCOL_PARMS_Q931CC

services_list Field

in_calls_behaviour Field

out_calls_behaviour Field

acu_behaviour Field

ns_behaviour Field

qsig_source_party_nb_type Field

qsig_source_type_of_nb Field

ISDN_PROTOCOL_PARMS_LAPD

Introduction

This section lists the default settings of the parameters passed to isdnStartProtocol by means of the parms argument.

ISDN_PROTOCOL_PARMS_Q931CC

The ISDN_PROTOCOL_PARMS_Q931CC structure contains parameters which configure the ISDN protocol stack for Q.931 call control via the ACU. Either this structure or ISDN_PROTOCOL_PARMS_LAPD is passed to isdnStartProtocol, depending on how the ISDN protocol stack will be configured. For details, see Section 3.5.2. For a definition of the data structure, see Section 6.3.1.

Type	Parameter	Description	Default Value	Range of Values
DWORD	size	Size of the structure.	None.
WORD	rate	Data rate.	ISDN_RATE_ 64K	ISDN_RATE_ 64K, ISDN_RATE_ 56K
WORD	t309	T309 in use flag indicates if data link release and establish timers are in effect (used by D channel backup protocol). See Appendix F.	0	0, 1
timer_val_t	xxx	Timer values by country/operator.	(See Appendix E)	(See Appendix E)
BYTE	services_list[ ]	Services supported on incoming calls.	All services (See the services_list Field on page 291)	All services
WORD	max_FEC_errors	Maximum number of framing errors allowed during the T198 interval.	20	0 or more ms.
timer_val_t	t101	ms. of bad framing before disabling sending D channel packets.	750	0 or more ms.
timer_val_t	t102	ms. of good framing before enabling sending D channel packets.	50	0 or more ms.
timer_val_t	t198	Observation period for frame error count.	5	0 or more sec.
WORD	tei_time_assignment	TEI time assignment.	0	(reserved)
WORD	tei_time_removal	TEI time removal.	0	(reserved)
BYTE	tei[3]	TEI values.	0	(reserved)
BYTE	digitstoroute	Number of digits needed to route when using overlap receiving.	0	0 or more
WORD	in_calls_behaviour	Incoming calls behavior.	0	(See the services_list Field on page 291)
WORD	out_calls_behaviour	Outgoing calls behavior.	0	(See the services_list Field on page 291)
WORD	ns_behaviour	Bits controlling NS's automatic responses.	0	(See the services_list Field on page 291)
WORD	acu_behaviour	Bits controlling ACU's automatic responses.	0	(See the services_list Field on page 291)
BYTE	qsig_source_party_nb_type	Type of PINX node address. Used for network node addressing in supplementary services.1	None.	(See the services_list Field on page 291)
BYTE	qsig_source_type_of_nb	Type of public PINX number. Used for network node addressing in supplementary services.1	None.	(See the services_list Field on page 291)
BYTE	qsig_source_addr	Node address.1	None.	None.
BYTE	aoc_s_presubscribed	Indicates whether user has subscribed to Advice-of-Charge (Start of Call) supplementary service.1	OFF	ON, OFF
BYTE	aoc_d_presubscribed	Indicates whether user has subscribed to Advice-of-Charge (During Call) supplementary service.1	OFF	ON, OFF
BYTE	aoc_e_resubscribed	Indicates whether user has subscribed to Advice-of-Charge (End of Call) supplementary service.1	OFF	ON, OFF
BYTE	bpad2[1]	Padding for 8 byte alignment.	0	0
WORD	nfas_group	NFAS group number if duplicate NAI values.	0	ON, OFF
BYTE	bpad3[2]	Padding for 8 byte alignment.	0	0
WORD	rfu1	Reserved for future use.	0	0
WORD	rfu2	Reserved for future use.	0	0

1 For details on this field, see the AG ISDN Supplementary Services Developer's Reference Manual.

The following code segment illustrates the typical settings of the protocol parameter to isdnStartProtocol for application access to ACU SAP.

memset(&cc_parms, 0, sizeof(ISDN_PROTOCOL_PARMS_Q931CC));
cc_parms.rate = ISDN_RATE_64K;
cc_parms.services_list[0] = VOICE_SERVICE;
cc_parms.services_list[1] = NO_SERVICE;

services_list Field

The services_list data field included in ISDN_PROTOCOL_PARMS_Q931CC consists of a set of up to CC_MX_SERVICES elements, which together define the set of ACU services required by an instance of the ISDN protocol stack.

By default, all services are accepted. If you specify only certain services, and an incoming call requests a different service, the protocol stack automatically rejects the call.

The following available services are defined in isdnval.h.

Service	Description
FAX_SERVICE	Call for G3 facsimile service
FAX_4_SERVICE	Call for G4 facsimile service
DATA_SERVICE	Call for data service
DATA_GCI_SERVICE	Call for data service on GCI bus
DATA_56KBS_SERVICE	Call for data at 56 KBS service
RAW_DATA_SERVICE	Call for raw data service on GCI bus: no MPH_B_INIT_RQ is generated (no B-channel driver is associated)
DATA_TRANS_SERVICE	Call for transparent data service
MODEM_SERVICE	Call for modem data service
AUDIO_7_SERVICE	Call for 7 kHz audio service
X25_SERVICE	Call for X.25 circuit-mode service
X25_PACKET_SERVICE	Call for X.25 packet-mode service
VOICE_SERVICE	Call for voice service
VOICE_GCI_SERVICE	Call for voice service on GCI bus
RAW_TELEPHONY_SERVICE	Call for raw telephony service on GCI bus: no MPH_B_INIT_RQ generated (no B-channel driver is associated)
VOICE_TRANS_SERVICE	Call for transparent voice service
V110_SERVICE	Call for V.110 service
V120_SERVICE	Call for V.120 service
VIDEO_SERVICE	Call for VIDEO service
TDD_SERVICE	Call for TDD service
DATA_H0_SERVICE	Call for data using H0 (384kbs) channel service (PRI only)
DATA_H11_SERVICE	Call for data using H11 (1536kbs) channel service
DATA_H12_SERVICE	Call for data using H12 (1536kbs) channel service
DATA_MULTIRATE_SERVICE	Call for data using Multirate (2..30*64kbs) channel service
DATA_128KBS_SERVICE	Call for data using 2*64kbs channel service (BRI only)
NO_B_CHAN_SERVICE	Call for no B-channel service (bearer-independent calls - QSIG only)
FAX_RELAY_SERVICE	Call for G3 facsimile service (for use with Physical Relay process)
DATA_RELAY_SERVICE	Call for data service (for use with Physical Relay process)
DATA_56KBS_RELAY_SERVICE	Call for data at 56 KBS service (for use with Physical Relay process)
DATA_TRANS_RELAY_SERVICE	Call for data transparent service (for use with Physical Relay process)
MODEM_RELAY_SERVICE	Call for modem data service (for use with Physical Relay process)
X25_RELAY_SERVICE	Call for X.25 circuit-mode service (for use with Physical Relay process)
VOICE_RELAY_SERVICE	Call for voice service (for use with Physical Relay process)
VOICE_GCI_RELAY_SERVICE	Call for voice service on GCI bus (for use with Physical Relay process)
NO_SERVICE	Undefined service

The services array must be terminated by NO_SERVICE. Thus you can specify at most CC_MX_SERVICES minus 1.

Note: The delivery of some of these services may be regulated by local authorities. You may be responsible for formally certifying these services in some countries. Check with the local authority for more specific information on these limitations.

in_calls_behaviour Field

The in_calls_behaviour field included in ISDN_PROTOCOL_PARMS_Q931CC determines how an incoming call is handled by the ISDN protocol stack. Refer to isdnparm.h for more details.

Note: The bit settings in this field regarding call control actions (namely CC_SEND_ALERT_IN, CC_SEND_CALL_PROC_RQ, CC_DATA_ALERT_RQ, CC_VOICE_ALERT_RQ, CC_DATA_CONN_RS and CC_VOICE_CONN_RS) must not be set when the protocol stack is started in Channelized stack mode.

Each bit set by the value in this field determines a particular element of the ISDN protocol stack's behavior. The values are defined as follows:

Bit	Description
--	Reserved for compatibility with former auto_answer field values (ON/OFF).
CC_SEND_ALERT_IN	Determines if ACU_ALERT_IN is automatically sent after ACU_CONN_IN. If this bit is set, the stack generates an ACU_ALERT_IN after having sent an ACU_CONN_IN.
CC_SEND_CALL_PROC_RQ	Determines if CALL PROCEEDING is automatically sent on incoming calls. If this bit is set, the ACU sends CALL PROCEEDING on an incoming call. Otherwise, the application must send ACU_CALL_PROC_RQ for this. (This message is optional).
CC_DATA_ALERT_RQ	Determines if ALERTING is automatically sent when a NOT TELEPHONY call arrives. If this bit is set, the stack sends ALERTING on a NOT TELEPHONY incoming call.
CC_VOICE_ALERT_RQ	Determines if ALERTING is automatically sent when a TELEPHONY call arrives. If this bit is set, the stack sends ALERTING on a TELEPHONY incoming call.
CC_DATA_CONN_RS	Determines if NOT TELEPHONY incoming calls are automatically answered. If this bit is set, the stack sends CONNECT on NOT TELEPHONY incoming calls.
CC_VOICE_CONN_RS	Determines if TELEPHONY incoming calls are automatically answered. If this bit is set, the stack sends CONNECT on TELEPHONY incoming calls.
CC_TRANSPARENT_OVERLAP_RCV	If this bit is set, the stack sends an ACU_CONN_IN to the application even if not all digits have arrived. (i.e. the Sending Complete IE is not present). Additional incoming digits arrive in ACU_DIGIT_IN messages. If this bit is not set, then the ACU waits for at least nb_digits_to_route digits (see the configuration structure) to arrive before sending an ACU_CONN_IN message to the application. Additional digits coming in INFORMATION messages are ignored.
CC_TRUNCATE_NB	Meaningful only in buffered Overlap Receiving mode. If this bit is set, the called number is truncated to the number of digits specified by the nb_digits_to_route configuration field.
CC_CALLED_NB_ABSENT_MATCH	If this bit is set, a received incoming call with no called number will match a list with a programmed address.
CC_CALL_WAITING	If this bit is set, the stack will support the call-waiting supplementary service: an incoming call received with a channel ID indicating No-channel will be accepted by the stack. If this bit is not set, then the stack will reject these calls with the appropriate cause value (#34 in most cases).
CC_DISABLE_SUPPLEMENTARY_ SERVICES	If this bit is set, supplementary services are disabled: supplementary service extended data structures in the extended data area are ignored.
CC_SET_CHAN_ID	If this bit is set, the stack forces the Channel Id Information Element to be present in the first message in response to a SETUP even if the specifications do not consider this mandatory.
CC_BEHAVIOUR_NIL	If this bit is set to 1 and all other bits in in_calls_behaviour are set to 0, no messages are automatically sent by the stack in response to an incoming call. The application must build and send all messages. If any of the other bits are set, this bit is ignored. The stack will send all messages you specify.

If in_calls_behaviour is set to 0 or not set at all, the ISDN protocol stack behaves in one of the following ways, depending upon how the partner_equipment argument is set in the call to isdnStartProtocol:

If partner_equipment is set to:	The stack behaves as if:
EQUIPMENT_TE	CC_SEND_CALL_PROC_RQ is set, all other bits cleared.1
EQUIPMENT_NT	CC_VOICE_ALERT_RQ and CC_DATA_ALERT_RQ are set, all other bits cleared.1

1 When using the 4ESS variant, all three bits are set (both on the TE side and NT side).

out_calls_behaviour Field

The out_calls_behaviour field included in ISDN_PROTOCOL_PARMS_Q931CC determines how an outgoing call is handled by the ISDN protocol stack. Refer to isdnparm.h for more details.

Each bit set by the value in this field determines a particular element of the ISDN protocol stack's behavior. The values are defined as follows:

Bit	Usage
--	Reserved for compatibility with former auto_answer field values (ON/OFF).
CC_USER_SENDING_COMPLETE	Determines if Sending-complete IE is automatically generated in ACU_CONN_RQ. If this bit is set, the stack does not automatically generate the Sending-complete IE. Instead, the application must request it in ACU_ CONN_RQ. If the bit is not set, the stack will generate the Sending-complete IE automatically in the ACU_CONN_RQ only. This bit does not affect ACU_DIGIT_RQ (the application must specify the acu_digit_rq_ sending_complete field value explicitly).
CC_SEND_CONN_CO_ON_PROGRESS	If this bit is set, the stack sends ACU_CONN_ CO when it receives a PROGRESS message for a VOICE call. Otherwise, it sends ACU_CONN_CO when it receives a CONNECT message.
CC_SEND_DIGIT_CO_ON_PROGRESS	If this bit is set, and if the stack receives NS_CALL_PROC_IN before NS_SETUP_ACK_IN, it sends ACU_DIGIT_CO and then ACU_CALL_PROC_IN. Otherwise, it only sends ACU_CALL_PROC_IN (default behavior).
CC_USE_MU_LAW	For Korean operator only: If this bit is set, the stack sends G711-Mu-Law in outgoing voice calls. If this bit is cleared, the stack sends G711-A-Law in outgoing voice calls. The value of this bit is used by the stack in all stack modes.
CC_BEHAVIOUR_NIL	If this bit is set to 1 and all other bits in out_calls_behaviour are set to 0, no messages are automatically sent by the stack during an outgoing call. The application must build and send all messages. If any of the other bits are set, this bit is ignored. The stack will send all messages you specify.

If out_calls_behaviour is set to 0 or not set at all, the ISDN protocol stack behaves as if all out_calls_behaviour bits are cleared.

acu_behaviour Field

The acu_behaviour field included in ISDN_PROTOCOL_PARMS_Q931CC determine what automatic responses the ACU layer makes. Refer to isdnparm.h for more details.

Note: The bit settings in this field are ignored when the protocol stack is started in Channelized stack mode.

Each bit set by the value in this field determines a particular element of the ACU layer's behavior. The values are defined as follows:

Bit	Usage
ACU_SEND_Q931_BUFFER	If this bit is set, the stack sends a whole received Q.931 message to the application, along with the ACU primitive.
ACU_SEND_D_CHANNEL_STATUS_ CHANGE	If this bit is set, when the status of the D channel changes, an ACU_D_CHANNEL_STATUS_IN primitive is automatically sent to the application, indicating the change. The acu_d_channel_state in this primitive indicates the status of the channel: 0=OFF, 1=ON.
ACU_BEHAVIOUR_NIL	This is the default value corresponding to the behavior of the ACU entity when this field was not in configuration.

If acu_behaviour is set to 0 or not set at all, the ISDN protocol stack behaves as if the ACU_BEHAVIOUR_NIL bit is set.

ns_behaviour Field

The ns_behaviour field included in ISDN_PROTOCOL_PARMS_Q931CC determines which automatic responses the NS layer makes. Refer to isdnparm.h for more details.

Note: The bit settings in this field are ignored when the protocol stack is started in Channelized stack mode.

Each bit set by the value in this field determines a particular element of the NS layer's behavior. The values are defined as follows:

Bit	Usage
NS_NO_STATUS_ON_UNKNOWN_IE	If this bit is set, the stack does not generate a STATUS message when it receives a message containing one or more unknown/unrecognized IE(s). This bit applies only to network variants for which the sending of STATUS under these circumstances is optional.
NS_NO_STATUS_ON_INV_OP_IE	If this bit is set, the stack does not generate a STATUS message when it receives a message containing one or more optional IE(s) with invalid content. This bit applies only to network variants for which the sending of STATUS under such circumstances is optional.
NS_ACCEPT_UNKNOWN_FAC_IE	If this bit is set, the stack accepts incoming messages containing Facility IEs that it does not recognize. The stack does not check the IE: it operates as if the FIE was correct. If this bit is not set, the stack rejects messages containing unknown Facility IEs. This bit must be set in order for the Bridge Calls and Notify Transfer supplementary services to operate. For more information, see the AG ISDN Supplementary Services Developer's Reference Manual.
NS_IE_RELAY_BEHAVIOUR	This bit applies only when the NS_RELAY compile-time option is set to ON. The stack behaves as a relay regarding the Information Elements (the Layer 3 procedures are still in use): it passes IEs received from the line transparently (as in Incoming Transparent mode). The user may send IEs transparently to the line using a second buffer, possibly including unknown or unexpected IEs. NS does not consider unknown or unexpected IEs received from the line as erroneous.
NS_DISABLE_RESTART	This bit is used to disable the RESTART procedure in the stack. If this bit is set, the stack does not send RESTART messages when it is stopped, but it also does not respond to incoming RESTART messages. Do not set this bit unless you are certain that the remote end does not implement the RESTART procedure.
NS_BEHAVIOUR_NIL	This is the default value corresponding to the behavior of the stack when this field was not in configuration.
NS_SEND_USER_CONNECT_ACK	Setting this bit is only applicable when the configuration is ETS, EUROPE, TE-side, outgoing call. If this bit is set, then the ISDN stack will send a CONNECT_ACK message in response to a received CONNECT message.
NS_EXPLICIT_INTERFACE_ID	If this bit is set, outbound call control messages (for example, SETUP, PROCEEDING) will contain the NAI (in the channel ID IE), as defined in the configuration file. This bit should only be used for US variants.
NS_PRESERVE_EXT_BIT_IN_CHAN_ID	This bit applies when the configuration is DMS and USA, and for an incoming call. When it is set, the extension bit in the channel ID's octets 3.3 is set to the value used in the SETUP message, for use inside PROCEEDING or ALERT messages.

If ns_behaviour is set to 0 or not set at all, the ISDN protocol stack behaves as if the NS_IE_RELAY_BEHAVIOUR bit is set and all other bits are cleared.

qsig_source_party_nb_type Field

The qsig_source_party_nb_type field included in ISDN_PROTOCOL_PARMS_ Q931CC is used when the application is designed for a Q.SIG private ISDN exchange (PINX). Each node in a Q.SIG network has an address. This field is used in conjunction with qsig_source_type_of_nb and qsig_source_addr to specify the address of the node.

The qsig_source_party_nb_type field specifies the type of PINX node address. The following is a list of possible values:

Constant	Description/Notes
ACU_QSIG_PINX_NB_UNKNOWN	Unknown party number: type_of_nb field is meaningless.
ACU_QSIG_PINX_NB_PUBLIC	Public party number.
ACU_QSIG_PINX_NB_PRIVATE	Private party number.

qsig_source_type_of_nb Field

The qsig_source_type_of_nb field included in ISDN_PROTOCOL_PARMS_ Q931CC is used when the application is designed for a Q.SIG private ISDN exchange (PINX). Each node in a Q.SIG network has an address. This field is used in conjunction with qsig_source_party_nb_type and qsig_source_addr to specify the address of the node.

The qsig_source_type_of_nb field specifies the type of public or private PINX number.

If qsig_source_party_nb_type is set to ACU_QSIG_PINX_NB_PUBLIC, the following values are valid for qsig_source_type_of_nb:

Constant	Description/Notes
ACU_QSIG_PINX_PUB_NB_UNKNOWN	Public or private: unknown number.
ACU_QSIG_PINX_PUB_NB_INTERNATIONAL	Public: international number.
ACU_QSIG_PINX_PUB_NB_NATIONAL	Public: national number.
ACU_QSIG_PINX_PUB_NB_NETWORK_SPFC	Public: network specific number.
ACU_QSIG_PINX_PUB_NB_SUBSCRIBER	Public: subscriber number.
ACU_QSIG_PINX_PUB_NB_ABBREVIATED	Public or private: abbreviated number.

If qsig_source_party_nb_type is set to ACU_QSIG_PINX_NB_PRIVATE, the following values are valid for qsig_source_type_of_nb:

Constant	Description/Notes
ACU_QSIG_PINX_PRIV_NB_UNKNOWN	Public or private: unknown number.
ACU_QSIG_PINX_PRIV_NB_LEVEL2_REGIONAL	Private: level 2 regional number.
ACU_QSIG_PINX_PRIV_NB_LEVEL1_REGIONAL	Private: level 1 regional number.
ACU_QSIG_PINX_PRIV_NB_PTN_SPECIFIC	Private: PTN specific number.
ACU_QSIG_PINX_PRIV_NB_LOCAL	Private: local number.
ACU_QSIG_PINX_PRIV_NB_ABBREVIATED	Public or private: abbreviated number.

ISDN_PROTOCOL_PARMS_LAPD

The ISDN_PROTOCOL_PARMS_LAPD structure contains parameters which configure the ISDN protocol stack for LAPD. Either this structure or ISDN_PROTOCOL_PARMS_Q931CC is passed to isdnStartProtocol, depending upon how the ISDN protocol stack will be configured. For details, see Section 3.5.2. For a definition of the data structure, see Section 6.3.1.

Type	Parameter	Description	Default Value	Range of Values
DWORD	size	Size of the structure.	None.
WORD	rate	Data rate.	ISDN_RATE_ 64K	ISDN_RATE_ 64K, ISDN_RATE_ 56K
WORD	max_FEC_errors	Maximum number of framing errors allowed during the T198 interval.	20	0 or more ms.
timer_val_t	t101	ms. of bad framing before disabling sending D channel packets.	750	0 or more ms.
timer_val_t	t102	ms. of good framing before enabling sending D channel packets.	50	0 or more ms.
timer_val_t	t198	Observation period for frame error count.	5	0 or more sec.
WORD	tei_time_assignment	TEI time assignment.	0	(reserved)
WORD	tei_time_removal	TEI time removal.	0	(reserved)
BYTE	bpad1[2]	Padding for 8 byte alignment.	0	0
WORD	nfas_group	NFAS group number if duplicate NAI values.	0	ON/OFF