QM  5.2.5
Model-Based Design Tool
No Matches
QM License Certificate File

QM Session FileCurrent Item

Every QP commercial license comes with the QM License Certificate file, which stores the commercial license information for the QM code generator. The QM License Certificate file is always named exactly the same as the corresponding commercial license. For example, a commercial license with the license number QPC-SP-221115A will be accompanied by the license file named QPC-SP-221115A.qlc (extension .qlc).

The QM License Certificate file is specific to the commercially licensed QP framework type and therefore it is highly recommended to store it in the directory where you installed QP. For example, if you installed the QP/C framework in the directory C:\qp\qpc, you should copy your QM License Certificate file to this directory as well.

If you are a commercial licensee and for some reason you did not receive your QM License Certificate file, please send email with your license number to support@state-machine.com to request your copy.

Contents of QM License Certificate File

The QM License Certificate file is a plain-text file, which you can open in any editor and inspect (but you cannot change without corrupting it). Here is an example of a QM License Certificate file:

File name: QPC-SP-221115A.qlc

Bamboozle Technologies, Inc.
Single Products:
eGizmo Bamboozle 2nd Generation
FooBar X123

The QM License Certificate file the following information:

  • The license number (the file name of the certificate file)
  • The name of the commercial Licensee (company or individual)
  • The licensed QP framework type(s) (qpc/qpcpp)
  • The expiration date of the Support Term associated with the license
  • The licensed Single Product / Product Line/etc. of the Licensee
  • The cryptographic hash over the contents of the file and the file name, which prevents tampering with it.
The full name of the certificate file (QPC-SP-221115A.qlc) is tied to the license number and is included in the computation of the cryptographic hash. Therefore, changing the name (including the .qlc extension) of the certificate file is considered tampering with the file.

Registering QM License Certificate

The QM License Certificate file must be registered in QM by means of the Code Generation License Dialog Box. The file is specific to the model file, and different models can have different QM License Certificates associated with them. In other words, you can have multiple QM License Certificates present on your machine, associated with your various models (e.g., License Certificates for different Single Products of your Company).

Code Generation License Dialog (Commercial License)

Generated Code

After registering the QM License Certificate, the QM tool will generate top-level file comments with the commercial license information.

The following code snippet shows the top-level file comment generated from the QM license certificate example discussed above.

/*$file${.::egizmo.c} vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv*/
* Model: egizmo.qm
* File: ${.::egizmo.c}
* This code has been generated by QM 5.2.5 <www.state-machine.com/qm>.
* DO NOT EDIT THIS FILE MANUALLY. All your changes will be lost.
* This code is covered by the following QP license:
* License # : QPC-SP-221115A
* Issued to : Bamboozle Technologies, Inc.
* Framework(s) : qpc
* Support ends : 2023-11-15
* License scope:
* Single Products:
* eGizmo Bamboozle 2nd Generation
* FooBar X123
/*$endhead${.::egizmo.c} ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
. . .
The top-level comments generated with a registered QM License Certificate contain no references to any open-source license because the code will be proprietary.

QM Session FileCurrent Item