Global Address Object:Licensing

From Melissa Data Wiki
Jump to navigation Jump to search

← Global Address Object Reference

Global Address Object Navigation
System Requirements
Address Handling
Interface Use
Setup Methods
Input Methods
Processing Methods
Output Methods
Input Parameters
Output Parameters
Result Codes
Global Address Object Result Codes
Other Codes


The License Key is a software key that unlocks the full functionality of the component. Without the License Key, Global Address Object will not function.There are two methods of setting the License Key, using an environment variable called MD_LICENSE or passing it as a parameter using the SetLicenseString function. Global Address Object employs a shared License Key and environmental variable with the rest of the Melissa Data product line of programming tools. This is important to consider if you are using Global Address Object with other Melissa Data products. If you are using multiple products, you only need one License Key as long as that License Key is enabled for all the products you intend to use.

Environment Variable

You can set the License Key using an environment variable called MD_LICENSE. If MD_LICENSE is set, it will override any value set using the SetLicenseString function.

Using an environment variable is the recommended best practice. It is much easier to manage and update the License Key when it is stored in an environment variable.

The environment variable is shared with the Melissa Data product line of programming tools.

Windows users can set environment variables using the following steps:

  1. Select Start > Settings, and then click Control Panel.
  2. Double-click System and then click the Advanced tab.
  3. Click Environment Variables, and then select either System Variables or Variables for the user X.
  4. Click New.
  5. Enter “MD_LICENSE” in the Variable Name box.
  6. Enter the License Key in the Variable Value box, and then click OK.

Please remember that these settings take effect only upon initialization of the application. It may be necessary to stop and restart the program to utilize the License Key.


You can also pass in the License Key as a parameter to the SetLicenseString function.

As mentioned above, it is recommended to use an environment variable. If you set the License Key in a parameter you run the risk of needing to edit and recompile any application using the Global Address Object any time you need to manage or update the License Key.

Demo License Key

If you have an existing MD_LICENSE but was given a demo License Key to try out Global Address Object, you can use the environment variable MD_LICENSE_DEMO. This avoids conflicts or confusion if you already have active subscriptions to other Melissa Data object products.

Minimum Inputs

The Global Address Object has a set of minimum values it needs to have a chance at verifying an address record. The minimum fields required are as follows:

  • Address Line 1
  • Country

Within those minimum required fields, the minimum required content are:

  • Delivery address
  • (Locality and Administrative Area) or Postal Code†
  • Country Name or Country Code

†Not required for all countries but are for most