CHGLICINF

La commande CHGLICINF permet à l'utilisateur de modifier, pour un produit ou un dispositif, les informations de licence suivantes :

• La limite d'utilisation des produits dont la conformité n'est pas vérifiée par une clé de licence (pour les autres produits, vous devez vous procurer une clé de licence logicielle auprès du fournisseur de logiciel afin de modifier la limite d'utilisation des informations de licence)
• Le seuil
• Les utilisateurs devant être avertis lors d'un dépassement de seuil, ou encore d'une tentative de dépassement de la limite d'utilisation ou de sa modification
• La consignation des demandes d'utilisation.

Restriction : Cette commande est livrée avec le droit public *EXCLUDE.

Paramètres

Identificateur du produit (PRDID)

Indique l'identificateur (ID) à 7 caractères du produit pour lequel les informations de licence doivent être modifiées.

Ce paramètre est obligatoire.

Terme de la licence (LICTRM)

Indique le terme pour lequel les informations de licence doivent être modifiées.

*ONLY

Un seul terme de licence existe sur le système pour le produit et ce terme identifie le produit à modifier.

terme-licence

Le terme de la licence peut être transmis dans l'un des deux formats suivants :

Indiquez le terme de licence dans le format Vx, VxRy ou VxRyMz, dans lequel x et y sont un chiffre de 0 à 9, et z un chiffre de 0 à 9 ou une lettre de A à Z.

Précisez le terme de la licence au format vv, vvrr ou vvrrmm, où les valeurs de vv et rr sont des nombres compris entre 00 et 35 et les valeurs de mm sont des nombres compris entre 00 et 09 ou entre 0A et 0Z. Ce format doit être utilisé si la version ou l'édition du produit est supérieure à 9.

Utilisez la commande WRKLICINF (Gérer les informations de licence) pour déterminer le terme de la licence.

Dispositif (FEATURE)

Indique le dispositif du produit spécifié au paramètre Identificateur du produit (PRDID) pour lequel les informations de licence doivent être modifiées. Vous pouvez déterminer le numéro de dispositif à l'aide de la commande WRKLICINF (Gérer les informations de licence).

5001

Les informations de licence du dispositif 5001 doivent être modifiées.

dispositif

Indiquez le dispositif pour lequel les informations de licence doivent être modifiées. Les valeurs admises sont comprises entre 5001 et 9999.

Limite d'utilisation (USGLMT)

Indique le nombre maximal d'utilisateurs (limite d'utilisation) de ce produit ou dispositif. Le fournisseur du logiciel définit la limite d'utilisation autorisée. Pour une utilisation simultanée, il s'agit du nombre maximum de travaux pouvant accéder au produit ou au dispositif à un moment donné. Pour une utilisation réglementée, il s'agit du nombre maximum de détenteurs de licences pouvant être inscrits pour utiliser ce produit ou ce dispositif.

Remarque :Pour modifier la limite d'utilisation des produits protégés par une clé de licence, vous devez utiliser la commande ADDLICKEY.

*SAME

La valeur reste inchangée.

*NOMAX

Le nombre des utilisateurs n'est pas limité.

*ALTUSGLMT

La limite d'utilisation est constituée par la somme de l'utilisation identifiée et de l'utilisation non identifiée spécifiées au paramètre Autre limite d'utilisation (ALTUSGLMT).

limite-utilisation

Indiquez le nombre maximal d'utilisateurs de ce produit ou dispositif. Les valeurs admises sont comprises entre 0 et 999999.

Autre limite d'utilisation (ALTUSGLMT)

La limite d'utilisation spécifie l'utilisation identifiée et l'utilisation non identifiée de ce produit ou de cette fonction. Elle prend comme valeur la somme de ces deux utilisations.

L'utilisation identifiée peut voir les valeurs suivantes :

*SAME

La valeur reste inchangée.

utilisation-identifiée

Indiquez le nombre maximal d'utilisateurs dénombrés par ce produit ou cette fonction. Les valeurs admises sont comprises entre 0 et 999999.

L'utilisation non identifiée peut avoir les valeurs suivantes :

*SAME

La valeur reste inchangée.

utilisation-non-identifiée

Indiquez le nombre maximal d'utilisateurs non dénombrables par ce produit ou cette fonction. Les valeurs admises sont comprises entre 0 et 999999.

Remarque :Le nombre d'utilisateurs indiqué pour l'utilisation non identifiée fait définitivement partie de l'utilisation normale de ce produit ou de cette fonction.

Seuil (THRESHOLD)

Indique le seuil applicable à ce produit ou dispositif. Lorsque le nombre d'utilisateurs du produit dépasse le seuil, un message est envoyé à la file d'attente de messages de l'opérateur système (QSYS/QSYSOPR) ainsi qu'aux files d'attente de messages spécifiées au paramètre File attente messages (MSGQ).

Remarque :Si vous indiquez une valeur égale à la limite d'utilisation, aucun message n'est envoyé. Des messages sont envoyés uniquement lors d'une tentative de dépassement de la limite d'utilisation, ou lorsque cette dernière est modifiée.

*SAME

La valeur reste inchangée.

*CALC

Le système calcule le seuil admis pour ce produit ou dispositif. Le seuil calculé est égal à 90 % de la limite d'utilisation (nombre maximal d'utilisateurs indiqué au paramètre Limite d'utilisation (USGLMT)). Si la limite d'utilisation est 1 ou *NOMAX, le seuil est égal à cette dernière.

*USGLMT

Le seuil pour ce produit ou dispositif est égal à sa limite d'utilisation.

seuil

Indiquez le seuil pour ce produit ou dispositif. Les valeurs admises sont comprises entre 0 et 999999.

File attente messages (MSGQ)

Indique les noms qualifiés de cinq files d'attente de messages au maximum, auxquelles des messages sont envoyés en cas de dépassement du seuil, de tentative de dépassement de la limite d'utilisation, ou de modification de la limite d'utilisation. Ces messages sont également envoyés à la file d'attente de messages de l'opérateur système (QSYS/QSYSOPR).

*SAME

La valeur reste inchangée.

*NONE

Les messages ne sont envoyés qu'à la file d'attente de messages de l'opérateur système (QSYS/QSYSOPR).

*OPSYS

Les messages sont envoyés aux files d'attente de messages définies dans les informations de licence du système d'exploitation.

Le nom de la file d'attente de messages peut être qualifié par l'une des valeurs de bibliothèque suivantes :

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

La recherche porte sur la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL.

nom-bibliothèque

Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

nom-file-attente-messages

Indiquez le nom de la file d'attente de messages à laquelle sont envoyés les messages.

Historique (LOG)

Indique s'il convient d'enregistrer les demandes d'utilisation du produit ou dispositif lorsque le nombre d'utilisations est égal à la limite d'utilisation. Le cas échéant, les demandes sont enregistrées dans le journal QLZALOG de QUSRSYS.

*SAME

La valeur reste inchangée.

*NO

Les demandes faites lorsque le nombre d'utilisations est égal à la limite d'utilisation ne sont pas enregistrées.

*YES

Les demandes faites lorsque le nombre d'utilisations est égal à la limite d'utilisation sont enregistrées. Lorsqu'une demande de licence est faite et que le nombre d'utilisations est égal à la limite d'utilisation, l'émetteur de la demande ainsi que tous les détenteurs de licences en cours sont enregistrés dans le journal QLZALOG de QUSRSYS.

Exemples

Exemple 1 : modification de la limite d'utilisation d'un produit associé à un seul terme de licence sur le système

CHGLICINF   PRDID(1MYPROD)  LICTRM(*ONLY)
            USGLMT(35)  THRESHOLD(30)
            MSGQ(MYLIB/MYMSGQ) LOG(*NO)

Cette commande vous permet de modifier la limite d'utilisation du produit associé à l'identificateur 1MYPROD pour lequel un seul terme de licence est installé sur ce système. Après l'exécution de cette commande, 35 utilisateurs seront autorisés à se servir de ce produit. Lorsque le compteur d'opérations atteint 31, des messages sont envoyés à la file d'attente de messages de l'opérateur système et à la file d'attente de messages MYMSGQ de la bibliothèque MYLIB pour indiquer que le seuil a été dépassé. Les demandes de licence faites lorsque le compteur d'opérations est égal à la limite d'utilisation ne sont pas enregistrées. Les modifications de la limite d'utilisation sont néanmoins enregistrées dans le journal QLZALOG de QUSRSYS.

Exemple 2 : modification de la limite d'utilisation d'un produit associé à plus d'un terme de licence sur le système

CHGLICINF   PRDID(2MYPROD)  LICTRM(V2)
            USGLMT(50)  THRESHOLD(*USGLMT)
            MSGQ(*NONE) LOG(*YES)

Cette commande vous permet de modifier la limite d'utilisation du produit associé à l'identificateur 2MYPROD et au terme de licence Version 2. Après l'exécution de cette commande, 50 utilisateurs seront autorisés à se servir de ce produit. Aucun message de dépassement de seuil n'est envoyé. (Des messages sont toutefois envoyés à l'opérateur système lorsque la limite d'utilisation est modifiée ou que le compteur d'opérations atteint ou dépasse la limite d'utilisation.) Lorsque le compteur d'opérations est égal à la limite d'utilisation, une demande de licence est enregistrée dans le journal QLZALOG de QUSRSYS.

Messages d'erreur

Messages *ESCAPE

CPF9E2C

Impossible d'indiquer LICTRM(*ONLY).

CPF9E2D

La limite d'utilisation ne peut pas être inférieure à l'utilisation en cours.

CPF9E27

Impossible de modifier limite d'utilisation pour produit à conformité *KEYED.

CPF9E28

File d'attente de messages *OPSYS non admise pour le système d'exploitation.

CPF9E30

Informations de licences non modifiées.

CPF9E88

La limite d'utilisation secondaire ne peut pas être inférieure à l'utilisation en cours.