Global Address Object:Licensing

← Global Address Object Reference

Licensing

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.

Parameter

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