MatchUp Object:Licensing

From Melissa Data Wiki
Jump to navigation Jump to search

← MatchUp Object Reference

MatchUp Object Introduction Navigation
System Requirements
Getting Started

Entering Your MatchUp Object License Key

The License Key is a software key that unlocks the functionality of the component. Without this key, the object does not function. You set the License Key using an environment variable called MD_LICENSE. If you are just trying out MatchUp Object and have a demo License Key, you can use the environment variable MD_LICENSE_DEMO for this purpose. This avoids conflicts or confusion if you already have active subscriptions to other Melissa Data object products.

In earlier versions of MatchUp Object, you would set this value with a call to the SetLicenseString function. Using an environment variable makes it much easier to update the License Key without having to edit and re-compile the application.

It used to be necessary, even when employing an environment variable, to call the SetLicenseString function without passing the License Key value. This is no longer true. MatchUp Object will still recognize the SetLicenseString function, but you should eventually remove any reference to it from your code.


Windows users can set environment variables by doing the following:

  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 start of the program. It may be necessary to quit and restart the application to incorporate the changes.


Unix-based OS users can simply set the License Key via the following (use the actual License Key, instead):

export MD_LICENSE=A1B2C3D4E5

If this setting is placed in the profile, remember to restart the shell.

MatchUp Object also used to employ its own environment variable, mdMatchUp_LICENSE. The MD_LICENSE variable is shared across the entire Melissa Data product line of programming tools. MatchUp Object will still use the old License Key variable for the time being, but you should transition to using MD_LICENSE as soon as possible.