Configure a Sentinel License on iSeries

The Uniface license can be made available as a local license file or via the Sentinel RMS License Manager (Server) running on another platform accessible via the network. It is not possible to run the Sentinel RMS License Manager on iSeries.

For more information, see Uniface License Management.

If you are using a local license file instead of a license server, make sure that it is located in the IFS, in a location that the Uniface user has read access to.

To configure a DLM license, see Configure a DLM License on iSeries

Configure a Local License File

You are given an Entitlement ID when you register with Uniface, which allows you to access the Sentinel EMS customer portal, where you can lock your license to a specific machine and obtain the actual license file.

While connected to the EMS portal, you will need to obtain a locking code, which is the unique machine identification that locks the license file to your machine. To obtain your locking code, you need the echoid utility and echoid.dat file provided in the \common\bin subdirectory of your Uniface installation directory in IFS.

The echoid.dat file contains a number of examples for different locking criteria. You'll need to specify the locking criteria number (a hexadecimal number) that Uniface License Management has indicated. The number 0x8 is used in the steps that follow.

To activate and configure a Sentinel license file:

  1. On the iSeries command line, specify the locking criteria in echoid.dat using EDTF:
    1. Press F15.
    2. Change the CCSID to 819, if it is not already, and press F3 twice to save.
  2. Obtain a locking code by running echoid. Since it is an AIX executable, you need to use PASE:
    1. Run CALL QP2TERM.

      This will start PASE.

    2. Enter cd <uniface_install>/common/bin
    3. Run echoid to view the locking code. The locking code it returns must start with your locking criteria number followed by a *. If it starts with something else, contact Uniface License Management.
    4. Copy the generated locking code from the * to the end.

      For example, if the returned code is 8*18G 6SXR 8V54 LTLS, copy *18G 6SXR 8V54 LTLS.

  3. Log in to the EMS portal with your Entitlement ID and click Activate. The activation screen lists the required locking criteria in Client 1 criteria (in hex).
  4. Paste the copied locking code into the Client 1 info field and click Activate. This creates a license file that you can download.
  5. Download the license file named lservrc and make a note of the saved location.
  6. Copy the license file to <license_dir_on_AS400>/lservrc.
    1. If you can access the Uniface installation directory via a share, you can use the Windows explorer to drag and drop it into the IFS directory you need it to be in. This can be any directory, Uniface does not prescribe a specific location other than that it is in the IFS root / filesystem or QOpenSys filesystem.

      Alternatively, you can ftp lservrc onto the iSeries into an IFS directory.

    2. Check the CCSID of lservc with EDTF'<license_dir_on_AS400>/lservrc'. It should be the same as echoid.dat, for example 00819.
  7. Configure Uniface to use the license file in one of the following ways:
    1. Supply the license file path when prompted during installation.
    2. Reference the license file in usys.asn as follows:
      $license_options=LM_LICENSE_FILE=IFS:<license_dir_on_AS400>/lservrc

You are now ready to use Uniface. If you are using a Uniface subsystem, start it using STRSBS.

Related Topics