ADDLICKEY

La commande ADDLICKEY permet d'ajouter au 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é de licence. 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 référentiel des licences permet de stocker les informations de licence relatives à chaque produit, terme de licence, dispositif et système. Il peut contenir les licences de n'importe quel système et le produit ne nécessite aucune installation.

Si la licence s'applique au système sur lequel est installé le produit, elle est elle-même installée grâce à cette commande et la limite d'utilisation par défaut du produit est alors remplacée par la limite d'utilisation de la licence. La date de péremption est également fixée.

Si une clé de licence logicielle existe déjà dans le référentiel pour ce produit, terme de licence, dispositif et système, elle est remplacée.

Si aucune licence n'existe sur le système, la clé de licence logicielle ajoutée utilise les valeurs par défaut pour ses attributs de seuil (90 pour cent de la limite d'utilisation), de file d'attente de messages (*OPSYS) et d'historique (les violations de la limite d'utilisation ne sont pas consignées). Si une licence existe, les valeurs de ces attributs ne changent pas. Pour modifier l'une de ces valeurs, vous pouvez utiliser la commande CHGLICINF (Modifier les informations de licence).

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

Paramètres

Entrée clé de licence (LICKEYINP)

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

*PROMPT

Les informations de clé de licence sont fournies via la fonction d'invite.

*LICKEYFILE

Les informations de clé de licence sont extraites du fichier indiqué dans le paramètre LICKEYFILE.

*TAPE

Les informations de clé de licence logicielle sont extraites d'un fichier de données identifié par le label QFILEPGMKEY sur l'unité de bande indiquée au paramètre DEV. Vous devez créer ce fichier de données sur la bande à l'aide de la commande CPYTOTAP (Copier sur une bande) en spécifiant un fichier sous la forme QSYS/QALZAKEY au paramètre FROMFILE.

Identificateur du produit (PRDID)

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

Terme de la licence (LICTRM)

Indique le terme de la licence pour lequel les informations de clé de licence logicielle sont ajoutées. Ces informations sont livrées par le fournisseur de logiciel.

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

Précisez le terme de la licence au format Vx, VxRy ou VxRyMz, où les valeurs de "x" et "y" sont comprises entre 0 et 9 et les valeurs de "z" sont 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 ajoutées.

5001

Les informations de clé du dispositif 5001 sont ajoutées.

dispositif

Indiquez le numéro du dispositif pour lequel les informations de clé sont ajoutées. Les valeurs admises sont comprises entre 5001 et 9999.

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

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

Remarque :Les valeurs *REMOTE et *ALL sont admises uniquement lorsque *LICKEYFILE ou *TAPE est indiqué au paramètre Entrée clé de licence (LICKEYINP).

*LOCAL

Les informations de clé relatives au système local sont ajoutées.

*REMOTE

Les informations de clé relatives à tous les systèmes éloignés figurant dans le fichier défini au paramètre LICKEYFILE ou dans le fichier bande dont le label est QFILEPGMKEY sont ajoutées.

*ALL

Les informations de clé relatives à tous les systèmes figurant dans le fichier indiqué au paramètre LICKEYFILE ou dans le fichier bande dont le label est QFILEPGMKEY sont ajoutées.

numéro-série-système

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

Groupe de processeur (PRCGRP)

Indique le groupe de processeur du système pour lequel les informations de clé de licence logicielle sont ajoutées. Ces informations sont livrées avec la clé de licence logicielle par le fournisseur de logiciel.

*ANY

Les informations de clé sont ajoutées pour n'importe quel groupe de processeur.

groupe-processeur

Indiquez le groupe de processeur du système pour lequel les informations de clé sont ajoutées.

Clé de licence (LICKEY)

Indique la clé de licence logicielle livrée par le fournisseur de logiciel. La clé de licence est constituée de trois éléments de six caractères chacun. Les caractères admis sont les lettres de A à F et les chiffres de 0 à 9, présentés selon le format suivant : cccccc cccccc cccccc, où c est un caractère admis.

Limite d'utilisation (USGLMT)

Indique la limite d'utilisation de ce produit ou dispositif. Le fournisseur du logiciel définit la valeur autorisée pour la limite d'utilisation. 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.

1

Le nombre des utilisateurs est limité à un.

*NOMAX

Le nombre des utilisateurs n'est pas limité.

limite-utilisation

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

Date d'expiration (EXPDATE)

Indique la date de péremption de la licence relative au produit. Après cette date, aucun utilisateur ne peut accéder au produit ou dispositif protégé par cette clé de licence logicielle au delà de la limite d'utilisation par défaut.

Le fournisseur du logiciel fixe la date de péremption lorsqu'il livre la clé de licence logicielle. Si vous souhaitez utiliser le produit après la date de péremption, procurez-vous une nouvelle clé auprès de votre fournisseur.

*NONE

Il n'existe aucune date de péremption pour la licence.

date-péremption

Précisez la date de péremption de la licence relative au produit.

Données fournisseur (VNDDTA)

Indique les informations relatives au fournisseur. Ces informations sont livrées avec la clé de licence logicielle par le fournisseur de logiciel.

*NONE

Aucune donnée fournisseur n'est indiquée.

données-fournisseur

Indiquez des données fournisseur en huit caractères maximum.

Fichier de clés de licence (LICKEYFILE)

Indique le nom qualifié du fichier dont sont extraites les informations de clé de licence logicielle. 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 du fichier indiqué au paramètre LICKEYFILE dont sont extraites les informations de clé de licence logicielle.

*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 dont sont extraites les informations.

Unité (DEV)

Indique le nom de l'unité contenant la bande à partir de laquelle les informations de clé de licence logicielle sont copiées.

Identificateur de volume (VOL)

Indique l'identificateur de volume de bande à partir duquel les informations de clé de licence logicielle sont copiées.

*MOUNTED

Le volume présent sur l'unité est utilisé.

identificateur-volume

Indiquez l'identificateur de volume à partir duquel les informations de clé sont copiées.

Numéro de séquence (SEQNBR)

Indique le numéro de séquence du fichier de données à partir duquel les informations de clé de licence logicielle sont copiées.

*SEARCH

Une recherche est effectuée dans un fichier de données dont l'identificateur correspond au label QFILEPGMKEY.

*NEXT

Le numéro de séquence suivant est utilisé si ce numéro correspond à un fichier dont le label est QFILEPGMKEY.

numéro-séquence

Indiquez le numéro de séquence du fichier de données dont le label est QFILEPGMKEY à utiliser pour copier les informations de clé.

Option fin de bande (ENDOPT)

Indique l'opération de positionnement effectué automatiquement sur le volume de bande une fois les informations de clé de licence logicielle copiées.

*REWIND

A la fin de l'opération, la bande est rebobinée automatiquement, mais elle n'est pas déchargée.

*LEAVE

La bande n'est pas rembobinée ou déchargée à la fin de l'opération. Elle conserve sa position.

*UNLOAD

La bande est automatiquement rembobinée et déchargée à la fin de l'opération.

Exemples

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

ADDLICKEY   LICKEYINP(*PROMPT)  PRDID(1MYPROD)
            LICTRM(V3)  SERIAL(1234567)
            PRCGRP(P20)  LICKEY(123456 7890AB CDEF12)
            USGLMT(30)  EXPDATE(*NONE)  VNDDTA(12345678)

Cette commande utilise l'affichage de l'invite pour ajouter les informations de clé de licence logicielle pour le dispositif 5001 du produit 1MYPROD au référentiel de licences. Le terme de licence est Version 3. La licence autorise 30 utilisateurs à se servir du système sous le numéro de série 1234567. Ce système est compris dans le groupe de processeur de 20 ou moins. La licence n'est associée à aucune date de péremption. Etant donné que le produit est installé sur un système portant le numéro de série indiqué, la licence est également installée.

Exemple 2 : ajout de toutes les informations de clé de licence depuis un fichier en entrée

ADDLICKEY   LICKEYINP(*LICKEYFILE)  SERIAL(*ALL)
            LICKEYFILE(*LIBL/MYKEYFILE)  LICKEYMBR(*LAST)

Cette commande ajoute au référentiel de licences les informations de clé de licence logicielle de tous les systèmes qui se trouvent dans le dernier membre créé du fichier MYKEYFILE. Si la licence s'applique au système sur lequel est installé le produit, elle est également installée.

Exemple 3 : ajout d'informations de clé de licence locale depuis un fichier clé de licence

ADDLICKEY   LICKEYINP(*LICKEYFILE)  SERIAL(*LOCAL)
            LICKEYFILE(*LIBL/MYKEYFILE)  LICKEYMBR(*FIRST)

Cette commande ajoute au référentiel de licences les informations de clé de licence logicielle du système en cours qui se trouvent dans le plus ancien membre du fichier MYKEYFILE. Si la licence s'applique au système sur lequel est installé le produit, elle est également installée.

Exemple 4 : ajout d'informations de clé de licence locale depuis une bande

ADDLICKEY   LICKEYINP(*TAPE)  DEV(TAP01)

Cette commande recherche le label QFILEPGMKEY sur le volume monté sur l'unité TAP01. Ce fichier de données est utilisé et toutes les clés de licence logicielle du système local sont ajoutées au référentiel. Une fois l'opération terminée, la bande est rembobinée.

Messages d'erreur

Messages *ESCAPE

CPF9E2D

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

CPF9E56

&1 enreg d'informations de clé de licence ajoutés, &2 non ajoutés.

CPF9E6C

La clé de licence ne peut pas être utilisée pour le groupe de processeur &2.

CPF9E6E

Identificateur de produit &1 incorrect.

CPF9E69

Informations de clé de licence non trouvées dans fichier de clés de licence.

CPF9E80

Erreur lors de la restauration des clés de licence à partir d'une bande.

CPF9E83

Date d'expiration &2 incorrecte.