Display License Key Info (DSPLICKEY)

The Display License Key Information (DSPLICKEY) command can be used to show the 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.

The license repository is used to store 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.

The information shown includes the processor group, the serial number, the software license key, the usage limit, the expiration date, and the vendor data.

The Display License Key Information (DSPLICKEY) command also can be used to create an output file, which can be used as input to the Add License Key Information (ADDLICKEY) command or the Remove License Key Information (RMVLICKEY) command.

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

Parameters

Keyword	Description	Choices	Notes
PRDID	Product identifier	Character value, *ALL	Optional, Positional 1
LICTRM	License term	Character value, *ALL	Optional, Positional 2
FEATURE	Feature	Character value, *ALL	Optional, Positional 3
SERIAL	System serial number	Character value, LOCAL, REMOTE, *ALL	Optional
OUTPUT	Output	, PRINT, *LICKEYFILE	Optional
LICKEYFILE	License key file	Qualified object name	Optional
	Qualifier 1: License key file	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
LICKEYMBR	License key member	Element list	Optional
	Element 1: Member to receive output	Name, *FIRST
	Element 2: Replace or add records	REPLACE, ADD

Top

Product identifier (PRDID)

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

*ALL: The software license key information for all product identifiers is shown.
generic*-product-identifier: Specify the generic identifier for the products to be shown. 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.
product-identifier: Specify the seven-character identifier of the product.

License term (LICTRM)

Specifies the license term for which software license key information is shown.

*ALL: The software license key information for all license terms found on the system is shown.
license-term: Specify the license term in Vx, VxRy, or VxRyMz format, where x or y can be a number from 0 through 9, and z can be a number 0 through 9 or a letter A through Z.

Feature (FEATURE)

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

*ALL: The software license key information for all features of the product specified on the PRDID parameter is shown.
feature: Specify the number of the feature for which software license key information is shown.

System serial number (SERIAL)

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

*LOCAL: The software license key information for the local system is shown.
*REMOTE: The software license key information for all systems except the local system is shown.
*ALL: The software license key information for all systems is shown.
system-serial-number: Specify the serial number of the system for which software license key information is shown.

Output (OUTPUT)

Specifies whether the output from this command is displayed, printed, or directed to a database file.

*: The output is shown on the display if requested by an interactive job, or printed with the job's spooled output if requested by a batch job.
*PRINT: The output is printed with the job's spooled output.
*LICKEYFILE: The software license key information is written to an output file.

License key file (LICKEYFILE)

Specifies the qualified name of the file where the software license key information is written. If this file does not exist, it is created using the file QSYS/QALZAKEY as a template. If this file exists it must be in the format of QSYS/QALZAKEY.

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

*LIBL: All libraries in the library list for the current thread are searched until the first match is found.

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

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

The possible value is:

license-key-file: Specify the name of the file to which the software license key information is written.

License key member (LICKEYMBR)

Specifies the name of the database file member to which the output is written. The member is used or created, as follows:

If the member exists, the system uses the second element of this parameter to determine whether the member is cleared before the new records are added.
If the member does not exist and a member name is not specified, the system creates a member with the name of the output file specified on the LICKEYFILE parameter.
If the member does not exist and a database file member name is specified, the system creates the member.

The possible Member to Receive Output values are:

*FIRST: The first member in the file receives the output.
member-to-receive-output: Specify the name of the member to receive the output.

The possible Operation to Perform on Member values are:

*REPLACE: The system clears the existing member and adds the new records.
*ADD: The system adds the new records to the end of the existing records.

Examples

DSPLICKEY   PRDID(*ALL)  LICTRM(*ALL)  FEATURE(*ALL)
            SERIAL(*REMOTE)  OUTPUT(*LICKEYFILE)
            LICKEYFILE(KEYS)  LICKEYMBR(REMOTE *REPLACE)

This command shows the software license key information for all of the products, features, and license terms for all of the systems except this system. The output is put in the member REMOTE of the file KEYS. Any existing records are replaced.