Introduction

NSF IE Fields

net_id_type

action

serv_feature

Facility Coding

param_fld

Example

Introduction

The Network Specific Facilities Information Element (NSF IE) indicates which network facilities are being invoked. This Information Element is only supported for the 4ESS variant.

The following structure defines the NSF IE:

struct acu_ext_spf_fac_ie {
 struct u4_acu_ext_hdr hdr;     /* Extension header */
  pad4
  uchar  net_id[ACU_MX_SZ_NET_ID];  /* Network identification array    */
  uchar  net_id_lgth;               /* Length of network identification*/
  uchar  net_id_type;               /* Type of ID                      */
  uchar  action;                    /* Parameterized/binary indicator  */
  uchar  serv_feature;              /* Service/feature indicator       */
  uchar  facility_coding;           /* Facility coding                 */
  uchar  param_fld;                 /* Parameterized field             */
  pad5
};

The following macro should be used to access the fields of the data structure:

Acu_ext_spf_fac_ie ( field )

NSF IE Fields

The following tables show the valid settings for the fields of the NSF IE structure.

net_id_type

Setting	Value	Description
ACU_USER_SPECIFIED_TYPE	0	The net ID type is user specified.
ACU_NATIONAL_NETWORK_ID_TYPE	2	Use the national network net ID type.

action

Setting	Value	Description
ACU_SPF_FAC_PARAMETER	0	The provided parameters are associated with the facility.
ACU_SPF_FAC_BINARY	1	Use the binary facility.

serv_feature

Setting	Value	Description
ACU_FAC_SERVICE	1	Service
ACU_FAC_FEATURE	0	Feature

Facility Coding

If ACU_FAC_SERVICE was selected for serv_feature:

Setting	Value	Description
ACU_FAC_CPN_SID_PREFERRED	1	CPN (SID) preferred
ACU_FAC_BN_ANI_PREFERRED	2	BN (ANI) preferred
ACU_FAC_CPN_SID_ONLY	3	CPN (SID) only
ACU_FAC_BN_ANI_ONLY	4	BN (ANI) only
ACU_FAC_CALL_ASSOC_TSC	9	Call associated TSC
ACU_FAC_TSC_CLEAR_RU	10	Notification of call associated TSC clearing or resource unavailable
ACU_FAC_OPERATOR	5	Operator
ACU_FAC_PCCO	6	Pre-subscribed Common Carrier Operator

If ACU_FAC_FEATURE was selected for serv_feature:

Setting	Value	Description
ACU_FAC_SDN	1	ISDN including GSDN
ACU_FAC_MEGACOM_800	2	Access to MEGACOM 800
ACU_FAC_MEGACOM	3	Access to MEGACOM
ACU_FAC_ACCUNET	6	ACCUNET
ACU_FAC_LONG_DISTANCE	7	International long distance
ACU_FAC_INTERNATIONAL_800	8	International 800
ACU_FAC_ATT_MULTIQUEST	16	AT&T MultiQuest

param_fld

Setting	Value	Description
ACU_FAC_VARI_A_BILL	6	Vari-A-Bill (flexible billing)

The NSF IE structure is treated as an extended data structure. The acu_ext_descr structure is placed in the ACU message primitive. See the following example to learn how the structures should be filled in.

Example

The following code shows how to modify the NSF IE using the defined macro:

unsigned char *p_ext_data;
char nsf;

if (nsf)
{
  p_ext_data = Acu_conn_rq_a_ext_parms;
      Acu_conn_rq_ext_parms_nb ++;
      Acu_conn_rq_ext_parms_lgth = Acu_ext_spf_fac_ie_size; 
      Acu_ext_id   = ACU_EXT_SPF_FAC_IE;
 Acu_ext_lgth = Acu_ext_spf_fac_ie_size;
 Acu_ext_spf_fac_ie(net_id_lgth)     = strlen("288");
 Acu_ext_spf_fac_ie(net_id_type)     = ACU_NATIONAL_NETWORK_ID_TYPE;
 memcpy (Acu_ext_spf_fac_ie (net_id), "288", strlen("288"));
 Acu_ext_spf_fac_ie (action) = ACU_SPF_FAC_BINARY;     
 Acu_ext_spf_fac_ie (param_fld) =  0xFF; 
 Acu_ext_spf_fac_ie (serv_feature) = ACU_FAC_FEATURE;  
 Acu_ext_spf_fac_ie (facility_coding) =  ACU_FAC_BN_ANI_PREFERRED; 
}