GENLICKEY (Generate License Key)

Note: To use this command, have the 5722-SM1 (System Manager for iSeries) licensed program installed.

GENLICKEY Command syntax diagram

 

Purpose

The Generate License Key (GENLICKEY) command generates a license key to enable users to access a product or a feature of a product. This key is specific to the product and system information entered in this command. The resulting key is a combination of 18 characters and numbers ranging from A-F and 0-9. To run this command, the product definition of the product you are generating the key for must exist on the system.

This command also adds the license information to the license repository. The keys are saved in the repository to keep a history of all the keys generated. You can display the repository to see what keys were generated for a specific product or system. To work with the license repository, you can use the DSPLICKEY, ADDLICKEY, and RMVLICKEY commands.

Use the Add License Key Information (QLZAADDK) API or the Add Product License Information (QLZADDLI) API to add license information. For more specific details about these APIs, see the Application Program Interfaces (APIs) topic in the Information Center.

Restriction: This command is shipped with public *EXCLUDE authority.

 

Required Parameters

PRDID

Specifies the 7-character identifier (ID) of the product for which the license key is to be generated.

LICTRM

Specifies the license term for which the license key is to be generated.

license-term: Specify the license term of the product in one of the following formats:

Vx

VxRy

VxRyMz

where values for x and y range from 0 through 9, and values for z range from 0 through 9 and from A through Z. A license term of Vx means the authorized usage limit is valid for the entire version of the product or feature. A license term of VxRy means the authorized usage limit is valid for the entire release of the product or feature. A license term of VxRyMz means the authorized usage limit is valid only for a modification of the product.

FEATURE

Specifies the feature of the product specified on the PRDID parameter for which the license key is to be generated.

feature: Specify the feature for which a license key is to be generated. Valid values range from 5001 through 9999.

VNDPWD

Specifies the software vendor's password. This password is encrypted and stored with the product. It is used to validate the generate license key request and must be the same password you use on the Add Product License Information (ADDPRDLICI) command.

*NONE: There is no vendor password needed to generate a license key.

vendor-password: Specify the vendor password. It must begin with an alphabetic character (A through Z, $, #, or @) followed by no more than 9 alphameric characters (A through Z, 0 through 9, $, #, @, or _).

SERIAL

Specify the system serial number of the system the license key is being generated for.

system-serial-number: Specifies the system serial number of the system the license key is being generated for.

PRCGRP

Specifies the processor group of the system the license key is being generated for.

*ANY: The license key being generated works with any processor group.

processor-group: Specify the processor group of the system the license key is being generated for. Use the Work with License Information (WRKLICINF) command on the system the key is being generated for to display the processor group.

 

Optional Parameters

EXPDATE

Specifies the date the product license expires. After this date, users over the default usage limit are not allowed to access the product or feature. A new license key must be obtained from the software vendor to allow further use of the product.

*NONE: There is no expiration date for the product or feature.

expiration-date: Specify the date that the product or feature expires.

USGLMT

Specifies the maximum number of users (usage limit) for the product or feature for which the license key is being generated. For concurrent usage, specifies the maximum number of jobs allowed to access the product or feature at the same time. For registered usage, this is the maximum number of license users that can be registered to use this product or feature.

1: One user is allowed to access the product or feature.

*NOMAX: The number of users is not limited.

usage-limit: Specify the maximum number of users for this product or feature. Valid values range from 0 through 999999.

VNDDTA

Specifies an 8-character data field to be defined and used by the vendor.

*NONE: There is no vendor data for this product or feature.

vendor-data: Specifies 8 characters that help define further information on the product or feature.

OUTPUT

Specifies whether the license key that is generated is displayed in a completion message, printed in a spooled file, or saved in a file.

*: The license key is only shown in a completion message.

*PRINT: The license key is printed in a spooled file.

*LICKEYFILE: The license key information is saved to the file specified on the LICKEYFILE parameter. This file can then be used as a key file for Distributed Systems License Option (DSLO) tapes.

LICKEYFILE

Specifies the file in which the license key information is saved. If this file does not exist, the system creates it. If it does exist, it must be in the format of QSYS/QALZAKEY.

The possible library values are:

*LIBL: The library list is used to locate the file in which to save the license key.

*CURLIB: The current job library is used to locate the file in which to save the license key. If no library is specified as the current library, the QGPL library is used.

library-name: Specify the name of the library where the license key is to be saved.

file-name: Specify the name of the file into which the license key information is to be saved.

LICKEYMBR

Specifies which member the license key information is saved into and how the information is saved.

Note:

You can also use the Generate License Key (QLZAGENK) API to create the license key information. See the Application Program Interfaces (APIs) topic in the Information Center for more information about this API.

Element 1: Member to Receive Output

*FIRST: The first member in the file receives the output. If LICKEYMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified on the LICKEYFILE parameter.

member-name: Specify the name of the file member that receives the output. If the name of the file member is specified and the member does not exist, the system creates it. If the member already exists, you have the option of either adding a new record to the end of the existing member or clearing the member and then adding the new record.

Element 2: Option to Perform on Member

*ADD: If the member exists, the system adds the new record to the end of the existing records.

*REPLACE: If the member exists, the system clears it and then adds the new record.

Example for GENLICKEY

GENLICKEY  PRDID(2MYPROD) LICTRM(V5R2M0) FEATURE(5001)
  VNDPWD(PRODUCTPWD) EXPDATE(*NONE) SERIAL(1234567)
  PRCGRP(P30) USGLMT(25)

This command generates a license key for product 2MYPROD, license term V5R2M0 and feature 5001. The key allows 25 users to be authorized to use this product and there is no expiration date. The key allows the product to only be used on a system with a serial number of 1234567 and a processor group of 01 and a processor group of P30 or less.

Error messages for GENLICKEY

*ESCAPE Messages

None