Difference between revisions of "MatchUp Object:Licensing"

From Melissa Data Wiki
Jump to navigation Jump to search
(Created page with "{{MatchUpObjectIntroNav |IntroductionCollapse= }} {{CustomTOC}} ==Entering Your MatchUp Object License== The license string is a software key that unlocks the functionality ...")
 
 
Line 5: Line 5:
{{CustomTOC}}
{{CustomTOC}}


==Entering Your MatchUp Object License==
==Entering Your MatchUp Object License Key==
The license string is a software key that unlocks the functionality of the component. Without this key, the object does not function. You set the license string using an environment variable called MD_LICENSE. If you are just trying out MatchUp Object and have a demo license, 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.
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 string without having to edit and re-compile the application.
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 string 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.
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===
===Windows===
Line 19: Line 19:
#Click '''New'''.
#Click '''New'''.
#Enter “MD_LICENSE” in the ''Variable Name'' box.
#Enter “MD_LICENSE” in the ''Variable Name'' box.
#Enter the license string in the ''Variable Value'' box, and then click '''OK'''.
#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.
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.


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


<pre>
<pre>
Line 32: Line 32:
If this setting is placed in the profile, remember to restart the shell.
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 variable for the time being, but you should transition to using MD_LICENSE as soon as possible.
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.




[[Category:MatchUp Object]]
[[Category:MatchUp Object]]

Latest revision as of 21:45, 19 December 2016

← MatchUp Object Reference

MatchUp Object Introduction Navigation
Introduction
System Requirements
Licensing
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

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.

Linux

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.