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:
    SBMJOB CMD(CALL PGM(DLM/CPWR)
       JOB(CPWR)
       CURLIB(DLM)
       ALWMLTTHD(*YES)
  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:
    CHGCURLIB DLM
CALL DLM/DLMCV

    A screen similar to the following is displayed:

    ---DLMCV Main---

       Client
       License Service
Hit enter for previous menu or enter a command.
dlmcv>
  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---

        Applications
        Broadcast
        License path
        Pools
        Server loading
        Timeout
        Who
        Verify
Hit enter for previous menu or enter a command.
Enter '?' for help.
dlmcv>
  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---

Add
Remove

Hit enter for previous menu or enter a command.
dlmcv>

    (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:

      7188@myiseries.mydomain.com

    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               : 7188@myiseries.mydomain.com
feature/app          : USRVDB2
requested version    : 10.03
actual    version    : 10.01
expires              : 40 days
type                 : concurrent

Related Topics