2.7. Working with Country Specific Parameters

The country-specific configuration parameters behave differently from other configuration parameters. Rather than being stored in individual configuration parameters, the country-specific configuration parameters are concatenated together in a comma-separated string. This string is stored in the Features configuration parameter. The countries for which country-specific configuration parameters can be set are stored in the Country configuration parameter.

Working with country-specific configuration parameters differs from other configuration parameters in the following ways:

• You can use special functions for reading country-specific configuration parameters. A distinct set of functions enables you to read the country-specific configuration parameters contained in the Features parameter. These functions are:
  • NCM_GetCspFeaturesValue( ), to get the value of a particular country-specific configuration parameter from the system configuration (such as Frequency Resolution or Analog Signaling) from within Features.
  • NCM_GetCspFeaturesValueRange( ), to get the valid value range for a specific country-specific configuration parameter code from the DCM Catalog.
  • NCM_GetCspFeaturesVariables( ), to get all country-specific configuration parameters contained in the DCM Catalog.
• You must set the Features configuration parameter using the normal DCM API write functions. Although you can read the individual country-specific configuration parameters using the parameters outlined above, the Feature configuration parameter must be set using the functions described in Section 2.3.3, Reading and Writing Configuration Parameter Values. To change the value of any particular country-specific configuration parameter, your application must modify the parameter within the pointer to a comma-separated list of country-specific configuration parameters and write this string to the Feature configuration parameter using the NCM_SetValue( ) function.
• The country-specific configuration parameters retrieved for the Country property vary with the value of the Country parameter. For all other properties, the configuration parameters are retrieved with the NCM_GetVariables( ) function; the configuration parameters retrieved in this way are those that are applicable to the device name input to this function. For example, the System property for a D/41D device contains the D41DAddress, D41DInterrupt, and ISABusWidth parameters, whereas the same property for a D/240SC device contains BLTAddress, BLTInterrupt, BLTId, and ISABusWidth. In the case of country-specific configuration parameters, however, it is the value of the Country configuration parameter that determines which country-specific configuration parameters belong to the property. You can retrieve a list of valid country-specific configuration parameters for a given country with the NCM_GetCspFeaturesVariables( ) function.
• The valid values for the Country configuration parameter must be determined using special functions. A distinct set of functions enables you to work with country codes and country names. You can use these functions to help set the Country configuration parameter, which contains the ISO country code for the country you want to set. The functions are:
  • NCM_GetCspCountries( ), to get a list of supported countries from the DCM Catalog.
  • NCM_GetCspCountryCode( ), to get the country code for a country from the DCM Catalog.
  • NCM_GetCspCountryName( ), to get the country name for a given country code from the DCM Catalog.

Click here to contact Telecom Support Resources