Chapter 9: License Support
This chapter explains what the Databridge License Support library is and how to use it. The Databridge License Support library (DBLicenseSupport) ensures compliance with the licensed features of Databridge.
Installing License Support
The Install WFL will register DBLicenseSupport as a system library with the function name DBLICENSESUPPORT. To install a new version of DBLicenseSupport use the following command:
where usercode is the usercode where Databridge is installed and family is the pack family. You will
also need to do a jobnumber AX QUIT where jobnumber is the mix number of the old
DBLicenseSupport. The previous copy of DBLicenseSupport will not terminate until all Databridge
programs terminate that are linked to it.
If you DS DBLicenseSupport, it will DS all Databridge programs.
License Key File
DATA/DATABRIDGE/LICENSE contains one or more license keys indicating the purchased features
and allowed number of hosts for each feature. This file must be under the same usercode and pack
family as DBLicenseSupport. This file cannot be edited directly and can only contain the license key(s).
Use the DBLicenseManager program to add or inquire on license keys. Run it using the following CANDE command.
R DATABRIDGE/LICENSEMANAGER
License Expiration
Licenses expire at the end of a month. There is no grace period. During the month a license will expire, DBLicenseSupport will display a warning message that the key will expire.
Example (2) [0923]>>> Warning: Databridge license expires at month end <<<
If a product is accessed after its key has expired, DBLicenseSupport will display an error message and return an error code to the Databridge Accessory.
Example 9-2 #40784 DBLicenseSupport: ERROR: License for Enterprise expired 2/2015
If you attempt to run a Databridge product from more host computers than are licensed, DBLicenseSupport will display an error message listing the release number and names of the hosts already using the license and return an error code to the Databridge Accessory. For example, if you have a one-host DBEnterprise license and you attempt to run release 6.6 DBEnterprise on host Saturn but DBEnterprise has already been run host Earth, you will see the following message:
Example 9-3 #40523 DBLicenseSupport: ERROR: Enterprise max installs: 1 [Earth 6.6] ==> no license for Saturn 6.6
To resolve a license problem, secure a new license key from Micro Focus and add it to the license file using the DBLicenseManager program License Key File. The next connection to Databridge will automatically use the new key. You can run DBLicenseManager at any time to see the licensed products and what hosts are using them.
License Support AX Commands
You can use the following AX commands with DBLicenseSupport.
The jobnumber in the AX command is the mix number of DBLicenseSupport.
To find the mix number, use the ODT or MARC command LIBS NAME =LICENSESUPPORT=.
AX QUIT |
DBLicenseSupport will unfreeze. When the last linked Accessory, e.g. DBServer, terminates, DBLicenseSupport will also terminate. |
AX STATUS |
DBLicenseSupport will display the licenses in use by each host and when they expire. For example, the response to a 1791 AX STATUS command might be: |