RMVLICKEY

Enlever info clé de licence

En bref

La commande RMVLICKEY permet de supprimer du référentiel des licences les informations relatives aux clés de licence logicielle pour les produits dont la conformité est vérifiée par une clé.

RMVLICKEY se lit RMV (Retirer) + LICKEY. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

RMVLICKEY

Paramètres

LICKEYINP Entrée clé de licence
PRDID Identificateur du produit
LICTRM Terme de la licence
FEATURE Dispositif
SERIAL Numéro de série du système
LICKEYFILE Fichier de clés de licence
LICKEYMBR Membre de clés de licence

Astuce : dans une session 5250, tapez RMVLICKEY 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 RMVLICKEY permet de supprimer du référentiel des licences les informations relatives aux clés de licence logicielle pour les produits dont la conformité est vérifiée par une clé. Pour ces produits, vous devez obtenir une clé auprès du fournisseur de logiciel pour modifier la limite d'utilisation ou la date de péremption des informations de licence.

Le fait d'enlever des informations de licence du référentiel n'a aucune incidence sur les licences déjà installées. Toute licence actuellement utilisée pour accéder au produit sur ce système reste telle quelle.

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

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
LICKEYINP	Entrée clé de licence	LICKEYFILE, PROMPT	Facultatif, positionnel 1
PRDID	Identificateur du produit	Valeur caractère, *ALL	Facultatif, positionnel 2
LICTRM	Terme de la licence	Valeur caractère, *ALL	Facultatif, positionnel 3
FEATURE	Dispositif	Valeur caractère, *ALL	Facultatif, positionnel 4
SERIAL	Numéro de série du système	Valeur caractère, LOCAL, REMOTE, *ALL	Facultatif
LICKEYFILE	Fichier de clés de licence	Nom d'objet qualifié	Facultatif
	Qualificatif 1: Fichier de clés de licence	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
LICKEYMBR	Membre de clés de licence	Nom, FIRST, LAST	Facultatif

Entrée clé de licence (LICKEYINP)

Indique comment sont fournies les informations de clé de licence logicielle à supprimer.

*LICKEYFILE: Les informations de clé de licence sont extraites du fichier indiqué dans le paramètre LICKEYFILE.
*PROMPT: Les informations de clé de licence sont fournies via la fonction d'invite.

Identificateur du produit (PRDID)

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

*ALL: Les informations de clé de licence sont supprimées pour tous les identificateurs de produit.
nom-générique*-identificateur-produit: Indiquez l'identificateur générique des produits à supprimer. Un identificateur de produit générique est spécifié de la même manière qu'un nom générique.
Un nom générique est une chaîne de caractères contenant un ou plusieurs caractères suivis d'un astérisque (*) (ABC*, par exemple). L'astérisque se substitue à n'importe quel caractère admis. Un nom générique spécifie tous les objets dont les noms commencent par le préfixe générique sur lesquels l'utilisateur dispose de droits. Si le nom générique ne comporte pas d'astérisque, le système considère qu'il s'agit du nom complet de l'objet.
identificateur-produit: Indiquez en sept caractères l'identificateur du produit.

Terme de la licence (LICTRM)

Indique le terme de la licence pour lequel les informations de clé de licence logicielle sont supprimées.

*ALL

Les informations de clé de licence sont supprimées pour tous les termes de licence trouvés dans le système.

terme-licence

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

Indiquez le terme de la licence au format Vx, VxRy ou VxRyMz, dans lequel les valeurs de "x" et de "y" peuvent être comprises entre 0 et 9 et les valeurs de "z" peuvent être comprises entre 0 et 9 ou entre A et 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.

Dispositif (FEATURE)

Indique le dispositif du produit désigné au paramètre PRDID pour lequel les informations de clé de licence logicielle sont supprimées.

*ALL: Les informations de clé de licence sont supprimées pour tous les dispositifs du produit.
dispositif: Indiquez le numéro du dispositif pour lequel les informations de clé de licence sont supprimées.

Numéro de série du système (SERIAL)

Indiquez le numéro de série du système pour lequel les informations de clé de licence logicielle sont supprimées.

*LOCAL

Les informations de clé de licence sont supprimées pour le système local.

*REMOTE

Les informations de clé de licence logicielle ne sont supprimées que dans le cas de systèmes éloignés et dépendent de la valeur spécifiée au paramètre Entrée clé de licence (LICKEYINP).

Si vous indiquez LICKEYINP(*PROMPT), les informations de clé de licence sont supprimées pour tous les systèmes éloignés.
Si vous indiquez LICKEYINP(*LICKEYFILE), les informations de clé de licence logicielle sont supprimées pour les systèmes éloignés mentionnés dans le fichier indiqué au paramètre LICKEYFILE.

*ALL

Les informations de clé de licence logicielle sont supprimées pour tous les systèmes et dépendent de la valeur spécifiée au paramètre LICKEYINP.

Si vous indiquez LICKEYINP(*PROMPT), les informations de clé de licence sont supprimées pour tous les systèmes.
Si vous indiquez LICKEYINP(*LICKEYFILE), les informations de clé de licence logicielle sont supprimées pour tous les systèmes mentionnés dans le fichier indiqué dans le paramètre LICKEYFILE.

numéro-série-système

Indiquez le numéro de série du système pour lequel les informations de clé de licence logicielle sont supprimées.

Fichier de clés de licence (LICKEYFILE)

Indique le nom qualifié du fichier qui contient les informations de clé de licence logicielle à supprimer. Ce fichier en entrée doit être au format QSYS/QALZAKEY et peut être créé à l'aide du paramètre LICKEYFILE dans la commande DSPLICKEY (Afficher les informations de clé de licence).

Le nom du fichier contenant les informations de clé de licence 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.

La seule valeur possible est la suivante :

fichier-clés-licence: Indiquez le nom du fichier contenant les informations de clé de licence.

Membre de clés de licence (LICKEYMBR)

Désigne le membre contenant les informations de clé de licence logicielle à supprimer. Ce membre se trouve dans le fichier désigné au paramètre LICKEYFILE.

*FIRST: Le membre le plus ancien du fichier est utilisé.
*LAST: Le membre le plus récent du fichier est utilisé.
membre-clés-licence: Indiquez le nom du membre contenant les informations de clé de licence.

Exemples

Exemple 1 : suppression d'informations de clé de licence depuis l'invite

RMVLICKEY   LICKEYINP(*PROMPT)  PRDID(1MYPROD)
            LICTRM(V3)  FEATURE(5001)
            SERIAL(1234567)

Cette commande supprime du référentiel de licences les informations de clé de licence logicielle concernant le produit 1MYPROD, le terme de licence V3 et le dispositif 5001 pour le système portant le numéro de série 1234567.

Exemple 2 : suppression d'informations de clé de licence depuis un fichier en entrée

RMVLICKEY   LICKEYINP(*LICKEYFILE)  SERIAL(*REMOTE)
            LICKEYFILE(*LIBL/MYKEYFILE)  LICKEYMBR(*LAST)

Cette commande supprime du référentiel de licences les informations de clé de licence logicielle de tous les systèmes éloignés qui se trouvent dans le dernier membre créé du fichier MYKEYFILE.

Messages d'erreur

Messages *ESCAPE

CPF9E55: Objet référentiel de licences endommagé.
CPF9E57: &1 enreg d'informations de clé de licence enlevés, &2 non enlevés.
CPF9E58: Informations de clé de licence non trouvées.
CPF9E69: Informations de clé de licence non trouvées dans fichier de clés de licence.