ADDPRDLICI

Ajouter informations de licence

Add License Information

En bref

La commande ADDPRDLICI permet d'ajouter des informations de licence au produit ou au dispositif.

ADDPRDLICI se lit ADD (Ajouter) + PRDLICI. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

ADDPRDLICI PRDID(…) RLS(…)

Paramètres

PRDID ID produit obligatoire
RLS Edition obligatoire
FEATURE Dispositif
USGTYPE Type d'utilisation
COMPLIANCE Type de conformité
DFTUSGLMT Limite utilis. par défaut
LICTRM Terme de la licence
MSGID ID message dispositif
ALWLICRLS Edition licence admise
VNDPWD Mot de passe fournisseur
GRACE Délai de grâce

Astuce : dans une session 5250, tapez ADDPRDLICI puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande ADDPRDLICI permet d'ajouter des informations de licence au produit ou au dispositif. Cette commande peut être utilisée avant ou après que le produit ou les options appartenant à un dispositif soient préparés à l'aide de la commande PKGPRDOPT, mais avant que le produit ou les options appartenant à un dispositif soient installés. Si le produit est à conformité *KEYED, un descripteur des informations de licence produit est inclus dans le message d'achèvement reçue de cette commande.

Pour plus d'informations, consultez l'API Add Product License Information (QLZADDLI).

Restrictions :

Cette commande est fournie avec le droit public d'exclude (*EXCLUDE). Les profils utilisateur QPGMR, QSYSOPR, QSRV et QSRVBAS possèdent des droits privés sur cette commande.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
PRDID	ID produit	Valeur caractère	Obligatoire, positionnel 1
RLS	Edition	Valeur caractère	Obligatoire, positionnel 2
FEATURE	Dispositif	Valeur caractère, 5001	Facultatif
USGTYPE	Type d'utilisation	CONCURRENT, REGISTERED	Facultatif
COMPLIANCE	Type de conformité	OPRACTION, WARNING, *KEYED	Facultatif
DFTUSGLMT	Limite utilis. par défaut	0-999999, 1, *NOMAX	Facultatif
LICTRM	Terme de la licence	VERSION, RELEASE, *MOD	Facultatif
MSGID	ID message dispositif	Nom, *BASEOPT	Facultatif
ALWLICRLS	Edition licence admise	NO, YES	Facultatif
VNDPWD	Mot de passe fournisseur	Nom simple, *NONE	Facultatif
GRACE	Délai de grâce	Liste d'éléments	Facultatif
	Élément 1: Jours	0-999, 0
	Élément 2: Admis pour limite util défaut	NO, YES

ID produit (PRDID)

Indique l'identificateur à 7 caractères du produit pour lequel les informations de licence sont ajoutées.

Edition (RLS)

Indique la version, l'édition et le niveau de modification du produit ou du dispositif auxquels les informations de licence sont ajoutées.

Les valeurs possibles sont :

valeur-alphanumérique

Indiquez la version, l'édition et le niveau de modification du produit ou du dispositif dans lesquels les informations de licence sont ajoutées. Indiquez le niveau d'édition dans l'un des formats suivants :

VxRyMz, où Vx représente le numéro de version, Ry le numéro d'édition et Mz le niveau de modification. Les variables x et y peuvent être un nombre de 0 à 9. La variable z peut être un nombre de 0 à 9 ou une lettre de A à Z.
vvrrmm, où la version vv et l'édition rr doivent être des nombres compris entre 00 et 35, et la modification mm doit être un chiffre compris entre 00 et 09 ou une lettre comprise entre 0A et 0Z. Les zéros de début sont obligatoires. Ce format doit être utilisé si la version ou l'édition du produit est supérieure à 9.

Dispositif (FEATURE)

Indique le dispositif (ID de chargement) pour lequel les informations de licence sont ajoutées. Les informations de licence sont ajoutées à tous les chargements de produit portant l'ID produit et le dispositif spécifiés.

5001: Les informations de licence relatives au dispositif 5001 du produit spécifié au paramètre PRDID sont ajoutées.
ID-chargement: Indiquez un ID de chargement de code compris 5001 et 9999.

Type d'utilisation (USGTYPE)

Indique le type d'utilisation de licence.

Les valeurs possibles sont :

*CONCURRENT: La limite d'utilisation concerne le nombre de travaux uniques accédant simultanément au produit ou au dispositif.
*REGISTERED: La limite d'utilisation concerne le nombre d'utilisateurs de licence uniques enregistrés par le produit ou le dispositif.

Type de conformité (COMPLIANCE)

Indique l'action à entreprendre lorsque la limite d'utilisation est dépassée.

Les valeurs possibles sont :

*OPRACTION: La limite d'utilisation ne peut pas être dépassée. Si vous essayez d'utiliser le produit ou le dispositif après que la limite d'utilisation est atteinte, vous ne pouvez pas accéder au produit ou au dispositif tant que l'action appropriée n'est pas entreprise par l'administrateur système afin d'augmenter la limite d'utilisation.
*WARNING: Si vous essayez d'utiliser le produit ou le dispositif après que la limite d'utilisation est atteinte, votre accès est autorisé. Un message d'avertissement indiquant que la limite d'utilisation est dépassée est envoyé au propriétaire des informations de licence pour notification.
*KEYED: Il est demandé d'obtenir une clé de licence auprès du fournisseur de logiciel pour installer ou augmenter la limite d'utilisation du produit ou du dispositif. Le logiciel fourni peut offrir un délai de grâce qui permet de dépasser la limite d'utilisation d'un produit ou d'un dispositif n jours avant qu'une nouvelle clé de licence ne soit requise pour autoriser d'autres utilisateurs à accéder au produit. Si une nouvelle clé dotée d'une limite d'utilisation supérieure n'est pas installée avant la fin du délai de grâce, la limite d'utilisation du produit est redéfinie sur la limite d'utilisation habilitée.

Limite utilis. par défaut (DFTUSGLMT)

Indique la limite d'utilisation qui est en vigueur lors de l'installation initiale du produit ou du dispositif pour un terme de licence.

Remarque :Pour la conformité par clé (*KEYED), il s'agit du nombre d'utilisateurs qui peuvent utiliser le produit ou le dispositif avant que la clé de licence ne soit installée à l'aide de la commande ADDLICKEY ou de l'API QLZAADDK. Pour empêcher l'accès au produit ou au dispositif sans clé, il est nécessaire de définir la limite d'utilisation sur 0.

Les valeurs possibles sont :

1: Un utilisateur est autorisé à accéder au produit ou au dispositif.
*NOMAX: Un nombre indéterminé d'utilisateurs est autorisé à accéder au produit ou au dispositif.
limite-utilisation-par-défaut: Indiquez le nombre de la limite d'utilisation par défaut. Les valeurs admises sont comprises entre 0 et 999999.

Terme de la licence (LICTRM)

Indique les niveaux de produit ou de dispositif qui partagent les informations de licence.

Les valeurs possibles sont :

*VERSION: La limite d'utilisation autorisée est valide pour la version intégrale du produit ou du dispositif. Chaque fois qu'une nouvelle version est installée, la limite d'utilisation autorisée doit être définie à l'aide de la commande WRKLICINF ou de la commande CHGLICINF. Pour une conformité de type *KEYED, une nouvelle clé de licence doit également être obtenue auprès du fournisseur de logiciel. Toutefois, les produits avec une conformité par clé doivent définir la limite d'utilisation à l'aide de la commande ADDLICKEY. Cette commande exige également qu'une clé de licence soit obtenue du fournisseur de logiciel pour autoriser l'utilisation du produit.
*RELEASE: La limite d'utilisation autorisée est valide pour l'édition intégrale du produit ou du dispositif. Chaque fois qu'une nouvelle édition est installée, la limite d'utilisation autorisée doit être définie à l'aide de la commande WRKLICINF ou de la commande CHGLICINF. Pour une conformité de type *KEYED, une nouvelle clé de licence doit également être obtenue auprès du fournisseur de logiciel. Toutefois, les produits avec une conformité par clé doivent définir la limite d'utilisation à l'aide de la commande ADDLICKEY. Cette commande exige également qu'une clé de licence soit obtenue du fournisseur de logiciel pour autoriser l'utilisation du produit.
*MOD: La limite d'utilisation autorisée est valide pour une modification du produit. Chaque fois qu'une nouvelle modification est installée, la limite d'utilisation autorisée doit être définie à l'aide de la commande WRKLICINF ou de la commande CHGLICINF. Toutefois, les produits avec une conformité par clé doivent définir la limite d'utilisation à l'aide de la commande ADDLICKEY. Cette commande exige également qu'une clé de licence soit obtenue du fournisseur de logiciel pour autoriser l'utilisation du produit.

ID message dispositif (MSGID)

Indique l'identificateur de message du message qui décrit le dispositif de produit. Le fichier message relatif à cet ID message est spécifié dans la définition de produit.

Les valeurs possibles sont :

*BASEOPT: Aucun message ne décrit ce dispositif produit. Le message utilisé pour la description de l'option de base de ce produit est utilisé.
ID-message-dispositif: Indiquez l'identificateur de message du message qui décrit le dispositif de produit.

Edition licence admise (ALWLICRLS)

Indique si une licence préalablement demandée peut être libérée à l'aide de la commande WRKLICINF. Lorsque la licence est libérée, le nombre d'utilisations est décrémenté. Cette valeur ne peut être spécifiée que pour un type de licence enregistré.

S'il est nécessaire que le produit soit notifié qu'une licence est libéré, la valeur *NO doit être spécifié et le produit doit fournir son propre mécanisme pour la libération d'une licence.

Les valeurs possibles sont :

*NO: Une licence ne peut pas être libérée à l'aide de la commande WRKLICINF.
*YES: Une licence peut être libérée à l'aide de la commande WRKLICINF.

Mot de passe fournisseur (VNDPWD)

Indique le mot de passe du fournisseur de logiciels. Ce mot de passe est chiffré et stocké avec le produit. Il est utilisé dans la validation des demandes d'ajout de licence de clé et il doit être identique au mot de passe utilisé pour générer les clés de ce produit et dispositif dans la commande GENLICKEY.

Les valeurs possibles sont :

*NONE: Aucun mot de passe fournisseur n'est nécessaire pour la commande GENLICKEY.
mot-de-passe-fournisseur: Indiquez le mot de passe fournisseur. Ce mot de passe doit commencer par un caractère alphabétique, par exemple A à Z, $, # ou à, suivi de 9 caractères alphanumériques au maximum, par exemple A à Z, 0 à 9, $, # à ou _.

Délai de grâce (GRACE)

Indique le nombre de jours accordé après qu'un produit a dépassé pour la première fois sa limite d'utilisation et que vous devez obtenir une nouvelle clé de licence. Si aucune clé n'est obtenue auprès du fournisseur de logiciels avant expiration du délai de grâce, aucun utilisateur au-delà de la limite d'utilisation n'est autorisé à accéder au produit ou au dispositif. Lorsque la limite d'utilisation est dépassée une première fois, l'expiration du délai de grâce est calculée en ajoutant le nombre de jours du délai de grâce à la date du jour.

Les valeurs possibles pour le nombre de jours du délai de grâce sont :

0: Il n'y a pas de délai de grâce. L'utilisateur n'est pas autorisé à dépasser la limite d'utilisation.
délai-grâce: Indiquez le nombre de jours du délai de grâce. Ce nombre doit être compris entre 0 et 999.

Les valeurs possibles pour l'autorisation d'une limite d'utilisation par défaut sont :

*NO: Aucun délai de grâce n'est autorisé en plus de la limite d'utilisation par défaut. Cela signifie que vous n'êtes pas autorisé à dépasser la limite d'utilisation par défaut jusqu'à l'installation de la clé de licence à l'aide de la commande ADDLICKEY ou de l'API QLZAADDK.
*YES: Un délai de grâce est autorisé en plus de la limite d'utilisation par défaut. Cela signifie que pouvez dépasser la limite d'utilisation par défaut pendant le nombre de jours du délai de grâce avant installation de la clé de licence.

Exemples

Exemple 1 : Ajout d'informations de licence produit

ADDPRDLICI   PRDID(1MYPROD)  RLS(V1R2M0)

Cette commande permet d'ajouter des informations de licence pour le produit avec l'ID de produit 1MYPROD et l'édition V1R2M0.

Exemple 2 : Ajout d'informations de licence produit pour l'édition V1R2M0

ADDPRDLICI   PRDID(1MYPROD)  RLS(V1R2M0)  COMPLIANCE(*KEYED)
             VNDPWD(PRODUCTPWD)  GRACE(30 *YES)

Cette commande permet d'ajouter des informations de licence pour le produit avec l'ID de produit 1MYPROD et l'édition V1R2M0. Ce produit prend en charge la protection par clé de licence. Il peut dépasser sa limite d'utilisation et son utilisation par défaut pendant 30 jours. Le mot de passe PRODUCTPWD est utilisé dans la validation des demandes d'ajout de licence de clé.

Messages d'erreur

Messages *ESCAPE

CPF9899: Erreur lors du traitement de la commande.