Configure a DLM License on iSeries

For DLM licenses, you can use the DLMCV License Administration Utility to configure a license for use by Uniface. It enables you to identify the license file or the license service for the Uniface license.

  • If you are using the DLM license server on iSeries, start the server (or ensure that it is running), and then use DLMCV to configure the license.
  • For a license server on a platform other than iSeries, consult the DLM Installation and Configuration Guide (DLMInstall.pdf) on how to install and configure the DLM service for that other platform.

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.

Transfer License Files to the Desired Location

You can transfer a license file to the iSeries using FTP in ASCII mode, because they are text (XML) files. You can also transfer it to the iSeries via a File Share of an IFS directory mapped as a drive to your Windows workstation, using drag and drop in the Windows explorer.

However, because license files are in UTF-8 and may have a leading UTF-8 Byte Order Marker, it is necessary to change the CCSID of the license file on the iSeries to 1208. To do so:

  1. Edit the file with EDTF.
  2. Press F15.
  3. Type 3 in the Selection field and 1208 in the 3. Change CCSID of file field.
  4. Press Enter and then F3 three times to save the file.

Start the DLM Server on iSeries

Note:  The following instructions assume that the installation library of DLM is DLM and the IFS directory is /DLM.

To start the DLM server on iSeries:

  1. Transfer all the license files that you wish this DLM server to serve into the /DLM/cpwr/license IFS subdirectory of the DLM installation, as descibed above.
  2. Start the license service by entering the following command:
  3. Verify that the license server is running by using WRKACTJOB.

    A job called CPWR will be shown under subsystem QBATCH.

    Note:  You can add the submission of the license server job to Uniface's STARTUP CL program so that the Uniface Router and the DLM license server are started at the same time and in the same subsystem when Uniface's subsystem is started.

Configure a DLM License File or License Server

  1. Start the License Administration Utility by entering the following command:

    A screen similar to the following is displayed:

    ---DLMCV Main---
           License Service
    Hit enter for previous menu or enter a command.
  2. Enter c and press Enter to choose the Client submenu, since you are configuring Uniface as a DLM client.

    The following sub-menu is displayed:

    ---Client command list---
            License path
            Server loading
    Hit enter for previous menu or enter a command.
    Enter '?' for help.
  3. Enter an l and press Enter to choose the License path submenu.

    The following screen is displayed:

    Current setting(s):
            not set
     ---[License path] Command list---
    Hit enter for previous menu or enter a command.

    (The not set setting indicates that no license file or license server has been set yet.)

  4. Enter a and press Enter to Add a license file or service.
    • If you have a local license file, enter its absolute path and press Enter.
    • If a license service is serving your licenses, enter the port number it is listening to, followed by an @ and then the hostname or IP address of the machine. For example:

    Press Enter. (Instead of not set, the path you just entered will be displayed.)

  5. Press Enter again to return to the previous menu.
  6. Enter v to choose Verify.

    You can now test whether a license checkout would work using the current setting.

    It is important that you do this, because if you cannot successfully verify a license, then Uniface cannot check out the license. For a typical iSeries installation, you can verify license feature USRVDB2, or UDB2, with the version of Uniface you are installing, for example 10.03. If everything works correctly, you will see a screen similar to this:

    This feature is working properly
    source               :
    feature/app          : USRVDB2
    requested version    : 10.03
    actual    version    : 10.01
    expires              : 40 days
    type                 : concurrent

Related Topics