RMVLICKEY (Remove License Key Information)

RMVLICKEY Command syntax diagram

 

Purpose

The Remove License Key Information (RMVLICKEY) command can be used to remove software license key information from 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.

Removing license information from the repository does not affect installed licenses. Any license that is currently being used to access the product on this system remains valid and usable.

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

 

Optional Parameters

LICKEYINP
Specifies how the software license key information to be removed is supplied by the user.

*LICKEYFILE: The software license key information is taken from the file specified on the LICKEYFILE parameter.

*PROMPT: The software license key information is entered through prompting.

PRDID
Specifies the seven-character identifier of the product for which software license key information is removed.

*ALL: The software license key information for all product identifiers is removed.

generic*-product-identifier: Specify the generic identifier of the products to be removed. A generic product identifier is specified in the same manner as a generic name.

A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete object name. For more information on the use of generic names, refer to generic names.

product-identifier: Specify the seven-character identifier of the product.

LICTRM
Specifies the license term for which software license key information is removed.

*ALL: The software license key information for all product identifiers is removed.

license-term: Specify the license term in Vx, VxRy, or VxRyMz format, where x and y can be a number from 0 through 9, and z can be a number from 0 through 9 or a letter from A through Z.

FEATURE
Specifies the feature of the product specified on the PRDID parameter for which the software license key information is removed.

*ALL: The software license key information for all features of the product is removed.

feature: Specify the number of the feature for which software license key information is removed.

SERIAL
Specify the serial number of the system for which software license key information is removed.

*LOCAL: The software license key information for the local system is removed.

*REMOTE: The software license key information to be removed is for remote systems only and depends on the value specified on the LICKEYINP parameter.

  • If LICKEYINP(*PROMPT) is specified, the software license key information for all remote systems is removed.

  • If LICKEYINP(*LICKEYFILE) is specified, the software license key information for the remote systems named in the file specified on the LICKEYFILE parameter is removed.

*ALL: The software license key information to be removed is for all systems and depends on the value specified on the LICKEYINP parameter.

  • If LICKEYINP(*PROMPT) is specified, the software license key information for all systems is removed.

  • If LICKEYINP(*LICKEYFILE) is specified, the software license key information for all the remote systems named in the file specified on the LICKEYFILE parameter is removed.

system-serial-number: Specify the serial number of the system for which software license key information is removed.

LICKEYFILE
Specifies the qualified name of the file in which the software license key information to be removed is located. This input file must be in the format of QSYS/QALZAKEY, and can be created by using the LICKEYFILE parameter on the Display License Key Information (DSPLICKEY) command.

The name of the license key file can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

license-key-file: Specify the name of the file that contains the software license key information.

LICKEYMBR
Specifies the name of the member in which the software license key information to be removed is located. This member is in the file specified on the LICKEYFILE parameter.

*FIRST: The oldest member in the file is used.

*LAST: The newest member in the file is used.

license-key-member: Specify the name of the member that contains the software license key information.

Examples for RMVLICKEY

Example 1: Removing License Key Information from Prompt Input 

RMVLICKEY   LICKEYINP(*PROMPT)  PRDID(1MYPROD)
  LICTRM(V3)  FEATURE(5001)  SERIAL(1234567)

This command removes from the license repository the software license key information for the product 1MYPROD, the license term V3, and the feature 5001 for the system with serial number 1234567.

Example 2: Removing License Key Information from File Input 

RMVLICKEY   LICKEYINP(*LICKEYFILE)
  SERIAL(*REMOTE)  LICKEYFILE(*LIBL/MYKEYFILE)
  LICKEYMBR(*LAST)

This command removes from the license repository the software license key information for all the remote systems found in the newest created member of the file MYKEYFILE.

Error messages for RMVLICKEY

*ESCAPE Messages

CPF9E55
License Repository object damaged.
CPF9E57
&1 license key information records removed, &2 not removed.
CPF9E58
License key information not found.
CPF9E69
License key information not found in license key file.