| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change License Information (CHGLICINF) command allows a user to change the following license information for a product or feature:
Restriction: This command is shipped with public *EXCLUDE authority.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| PRDID | Product identifier | Character value | Required, Key, Positional 1 |
| LICTRM | License term | Character value, *ONLY | Optional, Key, Positional 2 |
| FEATURE | Feature | Character value, 5001 | Optional, Key, Positional 3 |
| USGLMT | Usage limit | 0-999999, *SAME, *NOMAX, *ALTUSGLMT | Optional |
| ALTUSGLMT | Alternate usage limit | Element list | Optional |
| Element 1: Identified usage | 0-999999, *SAME | ||
| Element 2: Unidentified usage | 0-999999, *SAME | ||
| THRESHOLD | Threshold | 0-999999, *SAME, *CALC, *USGLMT | Optional |
| MSGQ | Message queue | Single values: *SAME, *NONE, *OPSYS Other values (up to 5 repetitions): Qualified object name |
Optional |
| Qualifier 1: Message queue | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| LOG | Log | *SAME, *NO, *YES | Optional |
| Top |
Specifies the seven-character identifier (ID) of the product for which license information is to be changed.
This is a required parameter.
| Top |
Specifies the license term for which license information is to be changed.
| Top |
Specifies the feature of the product specified on the Product identifier (PRDID) parameter for which license information is to be changed. You can use the Work with License Information (WRKLICINF) command to identify the feature number of the product.
| Top |
Specifies the maximum number of users (usage limit) for this product or feature. The software provider authorizes the usage limit. For a concurrent usage limit, this is the maximum number of jobs allowed to access the product or feature at any given time. For a registered usage limit, this is the maximum number of license users that can be registered to use this product or feature.
Note: To change the usage limit for products using keyed compliance, you must use the Add License Key Information (ADDLICKEY) command.
| Top |
The alternate usage limit specifies the identified usage and the unidentified usage for this product or feature. The usage limit becomes the sum of the identified and unidentified usage.
The possible identified usage values are:
The possible unidentified usage values are:
Note: The number of users specified for unidentified usage will always exist as part of the current usage for this product or feature.
| Top |
Specifies the threshold for this product or feature. When the number of users for this product exceeds the threshold, a message is sent to the system operator's message queue (QSYS/QSYSOPR) and to the message queues specified on the Message queue (MSGQ) parameter.
Note: If you specify a value equal to the usage limit, no threshold messages are sent. Messages are sent only when an attempt to exceed the usage limit is made, or when the usage limit is changed.
| Top |
Specifies the qualified names of a maximum of five message queues to which messages are sent if (1) the threshold is exceeded, (2) an attempt to exceed the usage limit is made, or (3) the usage limit is changed. These messages are also sent to the system operator's message queue (QSYS/QSYSOPR).
The name of the message queue can be qualified by one of the following library values:
| Top |
Specifies whether to record requests to use the product or feature when the usage count is equal to the usage limit. If requests are recorded, they are recorded in the QLZALOG journal in QUSRSYS.
| Top |
Example 1: Changing the Usage Limit for a Product with One License Term on the System
CHGLICINF PRDID(1MYPROD) LICTRM(*ONLY)
USGLMT(35) THRESHOLD(30)
MSGQ(MYLIB/MYMSGQ) LOG(*NO)
This command allows you to change the usage limit for the product with product identifier 1MYPROD which has only one license term installed on this system. After this command is run, 35 users will be authorized to use this product. When the usage count reaches 31, messages will be sent to the system operator's message queue and the message queue MYMSGQ in the library MYLIB stating that the threshold has been exceeded. Requests for a license when the usage count is equal to the usage limit will not be recorded. However, changes to the usage limit will be recorded in the QLZALOG journal in QUSRSYS.
Example 2: Changing the Usage Limit for a Product with More Than One License Term on the System
CHGLICINF PRDID(2MYPROD) LICTRM(V2)
USGLMT(50) THRESHOLD(*USGLMT)
MSGQ(*NONE) LOG(*YES)
This command allows you to change the usage limit for the product with product identifier 2MYPROD and license term Version 2. After this command is run, 50 users will be authorized to use this product. No threshold messages will be sent. (However, messages will be sent to the system operator whenever the usage limit is changed or the usage count reaches or exceeds the usage limit.) A request for a license when the usage count is equal to the usage limit will be recorded in the QLZALOG journal in QUSRSYS.
| Top |
*ESCAPE Messages
| Top |