About Licensing

You must install a license before you can use an installed product. The information provided on this page gives a complete explanation of how licensing works.

The information provided in the tabs below is an extract from the document below: “How License Management Works”.

For more specific details, please see your license agreement, or contact your nearest Four Js sales office.

Ordering & Licensing Procedures

How License Management Works

Basics

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

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.

What to look for

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

Before you begin Genero product licensing, locate your email message that contains the following:

product license key
product license number
product maintenance key
your customer code

If you do not have this email, contact your local Four Js sales office.

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.

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, you 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.

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, you 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:

Delete the existing license: run the license controller command, for example fglWrt -d, to uninstall the existing license.
Apply the license: run the command, fglWrt -l to install the license.

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

License Type

There is a different license needed for when Genero applications are executed (runtime license) to when the source files are compiled (development license).
You need a development license in a development environment to compile your source files. The development license also allows developers to run applications. For production environments, you need runtime licenses for users accessing applications you deploy on production sites.

Note: Depending on your requirements, you may also need runtime licenses for QA testers, document writers and other internal staff that need to run applications.

License types by product

Genero BDL (desktop or web) has two types of licenses:	You need a development license in a development environment. A development license is needed to compile your Genero Business Development Language (BDL) source (`4gl`) files. You need runtime licenses on production sites.
Genero Mobile has two types of licenses:	You need a development license in a development environment. Note: You do not need a separate Genero Mobile development license if you have a Genero BDL development license under maintenance. Otherwise, a license is required. The development license is free for personal use and suitable for applications whose p-code is under 64 KB. You can monitor the size of your apps using the `--program-size` and `--module-size` options of the `fglrun` command. For more information see Find your mobile app p-code size in the Install and License your Genero Products guide. For applications whose p-code exceeds 64 KB and/or to receive different levels of support, developer subscription plans are offered. See the Genero Mobile web site for details on the different plans. Important: When licensing Genero Mobile, your Genero Business Development Language (BDL) license must be for a Genero Mobile installation. If you receive an error message: ERROR(-6024) : Modules compiled with Genero Mobile require a Genero Mobile license at runtime. This means that the Genero BDL license you have is not valid for Genero Mobile. Please contact your local sales office for further information. You need a runtime license for each app deployed to a mobile device. Please contact your local sales office for details.
Genero Report Writer has two types of licenses:	You need a development license in a development environment. A development license is needed to compile your source files. You need runtime licenses on production sites.Note: For Genero Report Engine licensing: if your Genero BDL installation has a valid maintenance key, you do not need to install a license for the Genero Report Engine. Otherwise, a license is required.

Evaluation licenses

Evaluation licenses are issued to users trialing the software, for example, as part of the Genero Evaluation Program (GEP). These are fully-functional licenses allowing use of the Genero family of products (compiler, database, Studio, and runtime environments) to a specified number of users. The license are time limited for a period (typically 90 days) and can only be activated (registered) once.

Backup licenses

A backup license is a duplicate license installed on a “mirror” machine for secure installations requiring fault-tolerant or fail-over configurations. The backup license is a mirror of the active server license and must have an equal number of users and be of the same version.

Multi-user

A license is needed for every server where a Genero product is installed and for every user that can access it to run your applications.

For example, when an application is requested from a user agent (e.g desktop or Web browser), the dispatcher starts a Dynamic Virtual Machine (DVM) to handle the connection. It is the DVM that consumes the license. When the application is closed and the DVM is stopped, the license is freed. This license is then available for another user. In this way the license controller maintains a pool of licenses and only active users consume licenses.

This section describes the options you have for purchasing volume licenses to ensure that you have a sufficient pool of licenses available when users connect to a server to run your applications.

User Licenses

A User license creates a pool of available connections between each user’s workstation and the server.

This topic describes the User License option for ensuring that a sufficient pool of licenses is available where multiple users may connect to a server to run applications.

The size of this User License pool is defined by the number of licenses purchased, which is encrypted in the license key and verified by the license controller.

Typically, the number of users equals the number of connections, but it is recommended to anticipate a greater number because multiple connections may be needed by applications which open more than one active window or browser tab.

To determine the number of licenses used, run the license controller command, for example, fglWrt -u followed by fglWrt -a info users on the application server where the Genero runtime is installed. If you are using the Four Js License Manager, run the license manager command flmprg -u.

When the pool of connections is exhausted, the Dynamic Virtual Machine (DVM) will output a message blocking access to new users.

-6017 User limit exceeded. Cannot run this program.

If this occurs frequently, it is recommended to purchase more users and add them to the license. However, a better option may be to consider using CPU licenses instead. See CPU Licenses below.

CPU Licenses

A CPU license creates a pool of available connections, which allows for an unlimited number of user to make connections.

This topic describes the CPU License option you have for purchasing licenses to ensure that a sufficient pool of licenses is available for users connecting to a server to run your applications.

A CPU license provides for an infinite pool of available connections. The CPU license is so called because the number of physical or virtual CPUs (cores/threads) in the server where the product is installed must match the number encrypted in the license when verified by the license controller.

Degraded Mode

CPU licenses operate in degraded mode if the physical CPUs on the server do not match the CPUs purchased on the license. The license controller will limit the size of the license pool to the number of CPUs purchased multiplied by 25. So, for example, if a server has 32 CPUs and the license is only for 16, then the available pool will be 400 connections. If you see the following message, it means that your CPU license is operating in degraded mode. To resolve this, you will need to contact your local Four Js sales office.

-6180 CPU limit exceeded. The users control is reactivated.

Important: Before ordering CPU licenses, you need to run the license controller command, for example, fglWrt -a cpu on the application server where the Genero runtime is installed, to determine the exact number of CPUs (cores/threads) for licensing. CPU licensing is recommended for the following:

Large sites	Large sites may potentially have many active users. CPU licenses are better suited than User licenses because they provide for an infinite pool of connections.
Genero Web Client (GWC) applications	For GWC applications, detecting when the user has left the application or simply closed the browser (as opposed to stopping the application by explicitly exiting it taking the appropriate action) has implications for licensing. If the user closes the browser without exiting the application, the DVM stays running and continues to consume a license. While the DVM will eventually timeout, timeout configuration is not as critical to license management when CPU licenses are used.
Web services applications	A Web Service consumes a license in the same way that a user does, with one notable difference. On reaching the available limit in the connections pool, Web services are queued rather than blocked as with users. However, the greater the number of connections you can allocate for the Web service pool, the greater the Web service throughput. This is why it is generally recommended to opt for CPU licenses for Web services.
Logical Partition (LPAR) and Virtualization	Where Genero is installed on LPAR or Workload Partitions (WPARs) using virtualization technology, such as that used on IBM® Advanced Interactive eXecutive (AIX®) systems, CPU licenses are recommended. In this case, you will need to provide the number of virtual CPUs allocated, not the number of physical CPUs in the server, to determine the exact number of CPUs for licensing.

License installation example

Genero product licensing involves a standard license installation process; requiring you to install the license number, license key, maintenance key, and installation key for the product.

Licensing steps

Note:

The example given here is valid for a local license only. For examples of licensing using the Four Js License Manager, see the Four Js License Manager usage scenarios topic.
For more detailed information on installing and managing licenses see the Install and License your Genero Products manual.

This example describes the licensing process of a BDL product using the command line tool. The same procedure can be applied to the licensing of all Genero products.

Tip: Another option is to use the Genero Licenser Application tool (see What is Genero Licenser?) to complete license installation.

The license controller appropriate for your product is provided in the product package.

Table 1. Genero Products and License Controllers
Genero product	License controller
Genero Enterprise	fglWrt
Genero Mobile	fglWrt
Genero Report Writer for Java, C# and PHP	grxWrt
Genero Report Engine	greWrt

With Internet Access

With internet access, you can complete the installation of your license and maintenance key via HTTP as shown.

At the prompts enter the license key and license number.

Figure: Installing and registering a license via HTTP with fglWrt

At the prompt:

Do you want to continue using HTTP ? (y/n)

Enter:
y .

At the prompt:
```
Enter your customer code > 
```
Enter:
customer_code .
If your access to the internet is through a proxy, you must take that option and provide the required information (server name/IP address and port) when prompted.

License installation is now completed.

Without Internet Access

If you do not have internet access from the machine you are installing the license, you can complete licensing manually as described in the following steps:

Install the license key and license number locally on your machine; (an installation number is generated and displayed in the output).

Figure: Installing license with fglWrt without internet access

At the prompt:

Do you want to continue using HTTP ? (y/n)

Enter:
n .

At the
prompt:
```
Enter your maintenance KEY (Empty to continue)
```
Enter
the maintenance key.
Your Genero product has now a temporary license as shown when you run the following command:
```
fglwrt -a info license
```
Figure: License information
Under a temporary license you have full access to all the product’s features for a limited period of 30 days.

Important: You also have 30 days to register the installation number and obtain an installation key.
Register your license by providing the installation number to the vendor over the phone or by registering on the Four Js website. You are given an installation key.
At the command line enter the command to install the installation key:
```
fglWrt -k 
```

About Licensing

Ordering & Licensing Procedures

How License Management Works

What to look for

How to install licenses

Maintenance key

What happens when my license expires?

What happens when my maintenance contract expires?

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

What hardware or software changes affect licensing?

User Licenses

CPU Licenses

Licensing steps

With Internet Access

Without Internet Access

Lastest news

Four Js Development Tools Inc.

Four Js around the world: