ADDPRDLICI (Add Product License Information)

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

ADDPRDLICI Command syntax diagram

 

Purpose

The Add Product License Information (ADDPRDLICI) command adds license information to the product or feature. This command can be used before or after the product or options belonging to a feature are packaged using the Package Product Option (PKGPRDOPT) command, but before the product or options belonging to a feature are installed. If the product has keyed (*KEYED) compliance, a product license information handle is included in the completion message received from this command.

The Add Product License Information (QLZADDLI) API is also available in the Application Program Interfaces (APIs) topic in the Information Center.

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

 

Required Parameters

PRDID

Specifies the product identifier of the product loads to which the license information is being added.

Note:

The identifier must be exactly 7 characters long.

RLS

Specifies the version, the release, and the modification level of the product or feature to which the license information is being added.

version-release-modification: Specify the version, release, and modification level of the product or feature where the license information is being added. The release level must be in the format VxRyMz, where valid values for x and y range from 0 through 9 and valid values for z range from 0 through 9 and A through Z.

 

Optional Parameters

FEATURE

Specifies the feature for which the license information is being added. The license information is added to all product loads with the specified product ID and feature.

5001: License information for the 5001 feature of the product specified on the PRDID parameter is added.

load-ID: Specify that the license information for the feature on the PRDID parameter associated with this number is to be added. Valid values range from 5001 through 9999.

USGTYPE

Specifies the type of license usage.

*CONCURRENT: The usage limit is for the number of unique jobs accessing the product or feature at one time.

*REGISTERED: The usage limit is for the number of unique license users registered by the product or feature.

COMPLIANCE

Specifies the action that must be taken when the usage limit is exceeded.

*OPRACTION: The usage limit cannot be exceeded. If you attempt to use the product or feature after the usage limit has been reached, you are prevented from accessing the product or feature until the appropriate action is taken by the system administrator to increase the usage limit.

*WARNING: If you attempt to use the product or feature after the usage limit has been reached, you are allowed access. A warning message indicating that the usage limit has been exceeded is sent to the licensing information owner for notification.

*KEYED: A license key is required from the software provider to install or to increase the usage limit of the product or feature. The software provided can permit a grace period that allows the usage limit of a product or feature to be exceeded for n days before a new license key is required to allow additional users access to the product. If a new key with an increased usage limit is not installed prior to the end of the grace period, the usage limit of the product reverts back to the entitled usage limit.

DFTUSGLMT

Specifies the usage limit that is in effect the first time the product or feature is installed for a license term.

Note:

For *KEYED compliance, this is the number of users that are able to use the product or feature before the license key is installed using the Add License Key Information (ADDLICKEY) command or Add License Key Information (QLZAADDK) API. To prevent any access to the product or feature without a key, the default usage limit should be set to 0.

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

*NOMAX: Any number of users are allowed to access the product or feature.

default-usage-limit: Specify the default usage limit number. The valid values range from 0 through 999 999.

LICTRM

Specifies which levels of the product or feature share license information.

*VERSION: All VxRx levels of the product, where Vx is the version level and Rx is the release level. When the version level of the product or feature changes, customers installing the new release must use the Change License Information (CHGLICINF) command for a compliance type of *WARNING or *OPRACTION, or the Add License Key Information (ADDLICKEY) command for a compliance type of *KEYED to set the license information.

*RELEASE: All VxRx levels of the product, where Vx is the version level and Rx is the release level, specified on the RLS parameter whose license term is also *RELEASE share the same license information. When the version level or the release level of the product or feature changes, customers installing the new release must use the Change License Information (CHGLICINF) command for a compliance type of *WARNING or *OPRACTION or the Add License Key Information (ADDLICKEY) command for a compliance type of *KEYED to set the license information.

*MOD: Each level of the product or feature is licensed. No license information is shared between levels. Customers installing a new level of the product or feature must use the Change License Information (CHGLICINF) command for compliance type of *WARNING or *OPRACTION, or the Add License Key Information (ADDLICKEY) command for compliance type of *KEYED to set the license information.

MSGID

Specifies the message identifier of the message that describes the product feature. The message file for this message ID is specified in the product definition.

*BASEOPT: There is no message describing this product feature. The message used for describing the base option of this product is used instead.

feature-message-id: Specify the message identifier of the message that describes this product feature.

ALWLICRLS

Specifies whether a license that is previously requested can be released using the WRKLICINF command. When the license is released, the usage count is decreased. This value can only be specified for a registered license type.

If it is necessary for the product to be notified that a license has been released, *NO should be specified and the product must provide its own mechanism for releasing a license.

*NO: A license cannot be released using the WRKLICINF command.

*YES: A license can be released using the WRKLICINF command.

VNDPWD

Specifies the software vendor's password. This password is encrypted and stored with the product. It is used in validating Add License Key requests and must be the same password used to generate keys for this product and feature on the Generate License Key (GENLICKEY) command.

*NONE: There is no vendor password needed for the Add License Key Information (ADDLICKEY) command.

vendor-password: Specify the vendor password. It must begin with an alphabetic character such as A through Z, $, # or @. It is then followed by no more than 9 alphanumeric characters such as A through Z, 0 through 9, $, # @ or _.

GRACE

Specifies the number of days after a product first exceeds its usage limit that you have to obtain a new license key. If a new license key is not obtained from the software vendor by the time the grace period is expired, no users over the usage limit are allowed to access the product or feature. When the usage limit is first exceeded, the date the grace period expires is calculated by adding the number of days in the grace period to today's date.

Element 1: Number of Days

0: There is no grace period. The user is not allowed to exceed the usage limit.

grace-period: Specify the number of days in the grace period. Valid values range from 0 through 999.

Element 2: Allow for Default Usage Limit

*NO: The grace period is not allowed for use with the default usage limit. This means that you are not allowed to exceed the default usage limit before the license key is installed using the Add License Key Information (ADDLICKEY) command or Add License Key Information (QLZAADDK) API.

*YES: The grace period is allowed for use with the default usage limit. This means that you can exceed the default usage limit for the number of days in the grace period before the license key is installed.

Examples for ADDPRDLICI

Example 1: Adding Product License Information

ADDPRDLICI  PRDID(1MYPROD) RLS(V5R2M0)

This command adds product license information to the product with product identifier 1MYPROD for release V5R2M0.

Example 2: Adding Product License Information for the V5R2M0 Release

ADDPRDLICI   PRDID(2MYPROD)  RLS(V5R2M0)  COMPLIANCE(*KEYED)
  VNDOWD(PRODUCTPWD)  GRACE(30 *YES)

This command adds product license information to the product with the product identifier 1MYPROD for release V5R2M0. This product supports keyed compliance. It can exceed its usage limit and default usage for 30 days.

Error messages for ADDPRDLICI

*ESCAPE Messages

CPF9E1A

License information conflict found.