CL Command Reference - ADDLICKEY
CL Command List > ADDLICKEY Reference
Description:
The Add License Key Information (ADDLICKEY) command can be used to add the software license key information to the license repository for products with keyed compliance. Products with ¡åkeyed compliance¡å require that you have a software license key from the software provider in order to change the usage limit or the expiration date of the license information.
The license repository stores product license information for each unique product, license term, feature, and system. The repository can contain licenses for any system, and the product need not be installed.
If the product is installed on the system and the license is for this system, this command installs the license, which changes the usage limit from the product¡¯s default usage limit to the licensed usage limit. The expiration date is also set.
If a software license key already exists in the repository for the unique product, license term, feature, and system, the software license key information is replaced.
If a license does not exist on the system, the added software license key uses the default values for its threshold (90 percent of the usage limit), message queue (*OPSYS), and log (usage limit violations are not logged) attributes. If a license exists, the values on these attributes do not change. To change any of these values, you can use the Change License Information (CHGLICINF) command.
Restrictions: This command is shipped with public *EXCLUDE authority.
Examples:
Example 1: Adding License Key Information from Prompt Input
ADDLICKEY LICKEYINP(*PROMPT) PRDID(1MYPROD)
LICTRM(V3) SERIAL(1234567)
PRCGRP(P20) LICKEY(123456 7890AB CDEF12)
USGLMT(30) EXPDATE(*NONE) VNDDTA(12345678)
This command uses prompting to add the software license key information for feature 5001 of the product 1MYPROD to the license repository. The license term is Version 3. The license allows 30 users to use the system with serial number 1234567. That system is in the processor group of 20 or less. There is no expiration date on the license. Because the product is installed on a system with the specified serial number, the license also is installed.
Example 2: Adding All License Key Information from File Input
ADDLICKEY LICKEYINP(*LICKEYFILE) SERIAL(*ALL)
LICKEYFILE(*LIBL/MYKEYFILE) LICKEYMBR(*LAST)
This command adds the software license key information for all of the systems in the newest member of the file MYKEYFILE to the license repository. If the product is installed on the system, and the license is for this system, the license also is installed.
Example 3: Adding Local License Key Information from a License Key File
ADDLICKEY LICKEYINP(*LICKEYFILE) SERIAL(*LOCAL)
LICKEYFILE(*LIBL/MYKEYFILE) LICKEYMBR(*FIRST)
This command adds the software license key information found in the oldest member of the file MYKEYFILE to the license repository for this system only. If the product is installed on this system, the license is also installed.
Example 4: Adding Local License Key Information from Tape
ADDLICKEY LICKEYINP(*TAPE) DEV(TAP01)
This command searches the mounted volume on device TAP01 for the label QFILEPGMKEY. This data file is used and all software license keys for the local system are added to the repository. The tape is rewound after the operation.