License basics

During the product installation, you are prompted to license the software. A license must be entered before you can use the product.

What to look for

Note: The information provided in this topic gives a brief explanation of how licensing works generally. For more specific details, please see your license agreement, or contact your nearest Four Js sales office.

Four Js provides a license number and license key with the product package, as well as a maintenance key with your maintenance contract.

Genero Business Development Language (BDL) license numbers start with the letter T. For example:
  • License number: TAB#X35006TG
  • License key: RFAL8FS73XDT
  • Maintenance key: M9A3R5UCLMGH
Genero Mobile license numbers start with the letter M. For example:
  • License number : MAC#AAP00014
  • License key : QYBW9RXAQ0DF
  • Maintenance key: WAGQRSYFL8S7
Genero Report Writer license numbers start with the letter R. For example:
  • License number: R4Z#X34006TG
  • License number key: GFAS9FD78XDT
  • Maintenance key: M0ST5VXLMFH

How to install licenses

You can install your license as a local license using the license controller included with your Genero product. You can also use the Four Js License Manager (FLM) to install licenses for multiple Genero products installed on machines across your network.

License Controller
A license can be installed locally on the computer where the Genero programs execute using the license controller provided in the product package. For more information see License Controller.
License Manager
A license manager is a Genero product that provides a complete solution for managing Four Js licenses where multiple Genero products are installed on the same machine as the License Manager or on machines on the same network as the License Manager. Each Genero product's FGLPROFILE file needs to be configured with its license number and license key and it also must contain the details of the license manager it needs to use to validate the license. See License Manager.
Important: Installing Genero on a Remote File Systems (such as NFS or Samba) with a local license is not supported, in this case you must use a license manager configuration instead.

Maintenance key

An active maintenance contract is required to license a product. A maintenance key is provided with your maintenance contract. The maintenance key determines which version of the Genero product you are authorized to use with your license, and the date that the maintenance contract expires. When you are licensing a product, you will be prompted for the maintenance key during the licensing process.

What happens when my license expires?

Licenses apply to the version or build of the product you have installed. If your license is date-limited, then the date when the license expires will be shown when you run the license controller command, for example, fglWrt -a info license.
C:\Program Files\FourJs\Genero_Studio_3_00_22\fgl\bin>fglWrt.exe -a info license
License      : THM#AAF00ZSE
License key  : JIEG6GN8P065
Product      : Four Js Universal Compiler
Type         : Development version
Users        : 5
Extension(s) :
        - Open Database Interface
        - Enhanced license key format
This license is date limited and expires the 2016/03/31 (Year/Month/Day).
Warning! This is a temporary license, installation number is 'CLXANYVAFML8'.
This temporary installation will expire in 28 day(s).
WARNING! Your maintenance key has expired. Please contact your vendor.
End of maintenance date: 2016/03/03 (Year/Month/Day).

What happens when my maintenance contract expires?

If you see the following message, then your maintenance key has expired.
WARNING! Your maintenance key has expired. Please contact your vendor.
You can continue to use your Genero product after the expiration of the maintenance contract but this will have an impact on how you can use your Genero product.

Contact your local sales office to purchase a new maintenance contract. With a valid maintenance contract, you have full use of the product and can continue to install any new product update or patch that is provided by Four Js.

My maintenance contract has expired, can I still use the installed versions of Genero?

You can continue to use your Genero product after the expiration of the maintenance contract but you can not install any new update or patch where the Genero product build date is later than the expiration date of the maintenance key, without installing a new maintenance key. If you try to run a product version built after the expiration of your maintenance contract, for example:
 C:\fjs\fgl\2.20-9999\demo>fglrun demo.42r
You will get an error message like the following when you run applications:
Program stopped at 'demo.4gl', line number 20.
        FORMS statement error number -6144.
        The DVM build date is greater than the maintenance key expiration date.
        Contact your nearest FourJ's sales representative to update the maintenance key.
Genero BDL
For Genero Business Development Language (BDL) product licensing, your are allowed continued use of the product as follows:
  • You can continue to run the product version built prior to the expiration date of the maintenance key.
  • You can continue to run applications that you have already packaged and deployed before the maintenance contract expired, these will remain valid and will continue to work.
  • You can continue to run your applications with all the versions of the Genero product that were built before the end of maintenance date.
Genero Report Engine (GRE) under DVM Maintenance
For Genero Report Engine licensing under DVM maintenance with your Genero BDL installation, applications will continue to work for a grace period of two months after the end of the maintenance contract.
At the beginning of the third month the following notice will be printed on the first page of each report the GRE generates.
ERROR(-33015) : Please contact your sales office regarding licensing.
The GRE stops functioning at the end of the third month and you will need to purchase a maintenance contract. To check the status of your product's maintenance contract or other license information, see the topic on Get license information.
Note: If you have a Genero Report Writer installed, the GRE will not be limited under the DVM maintenance but instead will function under the Genero Report Writer installation maintenance.
Genero Report Writer
For Genero Report Writer product licensing, your are allowed continued use of the product as follows:
  • You can continue to run the product version built prior to the expiration date of the maintenance key.
  • You can continue to run applications that you have already packaged and deployed before the maintenance contract expired, these will remain valid and will continue to work.
  • You can continue to run your applications with all the versions of the Genero product that were built before the end of maintenance date.

What hardware or software changes affect licensing?

Some hardware changes affect licensing. If, for example, a network card is used for license locking to a server and you have to change your network card on the machine where the license was installed, you have to reapply your Four Js product license. Network cards are used if found because they allow a license to be restored to the same location, on the same hardware when you need to do a restore from backup.

On devices or systems that have no network card, license locking may rely on inodes in Linux®/UNIX™, device-id (MAC address), or file indexes used in Windows® NTFS filesystem. If, for example, a directory change is required, for example an inode structure change, this may impact the license.

The path where the license has been installed should not change, even though latest versions of the licensing software take symbolic links into account, but older versions may not. If, for example, you have to move your Genero runtime FGL directory, it requires you to reapply the license. To reapply the license:
  1. Delete the existing license: run the license controller command, for example fglWrt -d, to uninstall the existing license. See Uninstall a local license.
  2. Apply the license: run the command, fglWrt -l to install the license. See Install the license number and key.
Note: If you are unsure of what impact a server hardware or software change may have on licensing, please contact your local Four Js support center.