Skip to content

Procedures

Follow the steps described in this section to apply your licenses and make them available to your Micro Focus/Serena products:

Step 1: Allocate the License File

If you already have a license file, skip this step and go to Step 2: Update Licenses.

Important

If you have multiple Micro Focus/Serena products using XML-format licenses, it is recommended that you use one license file and place it on shared DASD for all Micro Focus/Serena products to access from any system. Using separate license files may cause an abend.

The license file has the following attributes:

RECFM: VB
LRECL: 259 - 32760

A record length of 259 is recommended.

The JCL for allocating the license file can be found in:

somnode.SERCOMC.VnRnMn.CNTL(LICALLOC)

Before running the job, specify the license file name and change the attributes if needed.

Step 2: Update Licenses

The JCL for adding and updating licenses can be found in:

somnode.SERCOMC.VnRnMn.CNTL(LICUPDAT)

  1. Specify one of the following values using the PARM parameter on the JCL EXEC statement:

    Value Description
    ADD Merges new licenses into the existing licenses. Existing licenses are not changed; the new license information is appended onto the existing license. Also, expired licenses are removed from the file after the grace period has elapsed.
    REP Replaces all existing licenses for products in the input file with the new licenses.

    If no parameter is specified, the default is ADD.

    Refer back to Applying Licenses for more information about using ADD or REP.

  2. Specify the data set names as follows:

    DD Name Description
    STEPLIB Specify the name of the SERCOMC load library as the first library. The Language Environment runtime libraries, CEE.SCEERUN and CEE.SCEERUN2 must be specified if they are not included in the system link list.
    SYSLIB Specify the name of your license file.
    SYSNAME Specify the name of your names file.
    SYSIN This is the XML-formatted license document you received as an email attachment. You can cut and paste it into the JCL or copy it into a separate file.

  3. Run the job. Detailed program messages are written to the SYSPRINT DD.

A license report is available in SYSOUT. The following sample report was produced by running LICUPDAT with PARM=’REP’. The input license data for products 204 and 207 replaced the existing license data on the license file.

PRODUCT   ID: 204   Name: ChangeMan ZDD     License type: Demo
OPTION    ID: 0     Name: Base              Expiration: 2010/11/21
--------------------------------------------------------------------
PRODUCT   ID: 207   Name: ChangeMan ZMF     License type: Demo
OPTION    ID: 0     Name: Base              Expiration: 2010/11/21
          ID: 1     Name: DB2               Expiration: 2010/11/21
          ID: 8     Name: ERO               Expiration: 2010/11/21

Step 3: Make Licenses Available

You may use any or all of the methods described in this section to make the licenses available to your Micro Focus/Serena products. The instructions for each method are described in the following topics:

Important

It is important to understand how license validation works before proceeding with this step. Refer back to Validating Licenses for an explanation of the different methods, the pros and cons of each method, and the search order used by the application program when validating licenses.

Create a LICDSN Module

A default LICDSN module is provided in:

somnode.SERCOMC.VnRnMn.LOAD

You can update this LICDSN module using the JCL in:

somnode.SERCOMC.VnRnMn.CNTL(LICDSN)

  1. Specify the following data set names:

    • In the SYSIN DD data of the ASM step, specify the name of your license file.

    • In the SYSLMOD DD of the LINK step, specify the name of your product load library.

  2. Run the job.

  3. Make sure the library specified in SYSLMOD is in the system link list or in the JOBLIB or STEPLIB of the product JCL.

Note

If there is a SERLIC DD statement coded in the application JCL, it will take precedence over the license file named in the LICDSN module. Otherwise, the license file named in the LICDSN module takes precedence over the licenses in CSA.

Add a SERLIC DD Statement to Your JCL

If your Micro Focus/Serena product runs as an application under a SERNET started task, you can code the SERLIC DD statement in the started task JCL. Otherwise, you will have to code the SERLIC DD statement in all of the application JCL.

The SERLIC DD is allocated by specifying the data set name, without any member name, as follows:

//SERLIC DD DSN=somnode.LICENSE.DATA,DISP=SHR

Note

The license file coded on the SERLIC DD takes precedence over both the license file named in the LICDSN module and the licenses in CSA.

Load Licenses into Common Storage

When you applied your licenses with the ADD or REP parameter, they were not automatically loaded into CSA; you must run LICUPDAT a second time with the LOAD parameter to update the licenses cached in CSA.

Note

Licenses in CSA are the last order of search during license validation. Therefore, if there is a SERLIC DD statement coded in the application JCL, or a license file is named in the LICDSN module, licenses in CSA will not be accessed.

The LICLOAD JCL member loads licenses for all products in the license file into CSA. This JCL can be found in:

somnode.SERCOMC.VnRnMn.CNTL(LICLOAD)

  1. Specify PARM=’LOAD’ on the JCL EXEC statement.

  2. Specify the data set names as follows:

    DD Name Description
    STEPLIB Specify the name of the SERCOMC load library as the first library. The Language Environment runtime libraries, CEE.SCEERUN and CEE.SCEERUN2 must be specified if they are not included in the system link list.
    SYSLIB Specify the name of your license file.
    SYSNAME Specify the name of your names file.

  3. Run the job. Program messages are written to the SYSPRINT DD. A license report is available in SYSOUT.

Step 4: Verify Licenses (Optional)

Your licenses should now be available. You can use the LICTEST utility to validate your licenses before using your Micro Focus/Serena product. See License Test Utility.