Global Address Object:Licensing

From Melissa Data Wiki
Revision as of 00:38, 11 September 2014 by Admin (talk | contribs) (Created page with "← Global Address Object Reference {| class="mw-collapsible" cellspacing="2" style="background-color:#f9f9f9; border:1px solid #aaaaaa...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

← Global Address Object Reference

Global Address Object Navigation
Using Global Address Object
Platforms and Methods
Address Handling
Interface Use
Setup Methods
Input Methods
Processing Methods
Output Methods
Input Parameters
Output Parameters
Result Codes
Result Code Use
Returned Result Codes
Other Codes


The license string is a software key that unlocks the full functionality of the component. Without the license string, Global Address Object will not function.There are two methods of setting the license string, using an environment variable called MD_LICENSE or passing it as a parameter using the SetLicenseString function. Global Address Object employs a shared license 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 string as long as that license string is enable for all the products you intend to use.

Environment Variable

You can set the license string 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 string 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 string 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 string.


You can also pass in the license string as a parameter to the SetLicenseString function.

As mentioned above, it is recommended to use an environment variable. If you set the license string 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 string.

Demo License

If you have an existing MD_LICENSE but was given a demo license 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