GENLICKEY

La commande GENLICKEY permet de générer une clé de licence pour permettre aux utilisateurs d'accéder à un produit ou un dispositif d'un produit. Cette clé est spécifique au produit et aux informations système entrées dans cette commande. La clé générée sera une combinaison de 18 caractères et chiffres, A à F et 0 à 9. Pour pouvoir exécuter cette commande, il est nécessaire que la définition du produit pour lequel vous générez cette clé existe sur le système.

Cette commande permet également d'ajouter les informations de licence au référentiel de licences. Les clés sont sauvegardées dans le référentiel afin de conserver un historique de toutes les clés générées. Vous pouvez afficher le référentiel afin de voir les clés qui ont été générées pour un produit ou un système spécifique. Pour gérer le référentiel de licences, vous pouvez utiliser les commandes DSPLICKEY, ADDLICKEY et RMVLICKEY.

Vous pouvez utiliser l'API QLZAADDK ou QLZADDLI pour ajouter des informations de licence.

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

ID produit (PRDID)

Indique l'identificateur à 7 caractères du produit pour lequel la clé de licence doit être générée.

Terme de la licence (LICTRM)

Indique le terme de licence pour lequel la clé de licence doit être générée.

Les valeurs possibles sont :

terme-licence

Indiquez le terme de licence du produit 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 la clé de licence doit être générée.

Les valeurs possibles sont :

dispositif

Indiquez le dispositif pour lequel une clé de licence doit être générée. Les valeurs admises sont comprises entre 5001 et 9999.

Mot de passe fournisseur (VNDPWD)

Indique le mot de passe du fournisseur de logiciels. Ce mot de passe sera chiffré et stocké avec le produit. Il est utilisé pour valider la demande de génération de clé de licence et il doit être identique au mot de passe que vous utilisez dans la commande ADDPRDLICI.

Les valeurs possibles sont :

*NONE

Aucun mot de passe fournisseur n'est nécessaire pour générer une clé de licence.

mot-de-passe-fournisseur

Indiquez le mot de passe fournisseur. Celui-ci doit commencer par un caractère alphabétique (A à Z, $, # ou à) suivi de 9 caractères alphanumériques (A à Z, 0 à 9, $, #, à ou _) au maximum.

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

Indiquez le numéro de série du système pour lequel est générée la clé de licence.

Les valeurs possibles sont :

numéro-série-système

Indique le numéro de série du système pour lequel est générée la clé de licence.

Groupe de processeur (PRCGRP)

Indique le groupe de processeur du système pour lequel est générée la clé de licence.

Les valeurs possibles sont :

*ANY

La clé de licence en cours de génération sera compatible avec n'importe quel groupe de processeur.

groupe-processeur

Indique le groupe de processeur du système pour lequel est générée la clé de licence. Utilisez la commande WRKLICINF sur le système pour lequel est générée la clé afin d'afficher le groupe de processeur.

Date d'expiration (EXPDATE)

Indique la d'expiration de la licence relative au produit. Après cette date, les utilisateurs ayant dépassé la limite d'utilisation par défaut ne seront pas autorisés à accéder au produit ou au dispositif. Une nouvelle clé de licence doit être obtenue auprès du fournisseur de logiciel afin de permettre une prolongation de l'utilisation du produit.

Les valeurs possibles sont :

*NONE

Aucune date de péremption n'est définie pour le produit ou dispositif.

date-expiration

Indiquez la date à laquelle le produit ou le dispositif arrive à expiration.

Limite d'utilisation (USGLMT)

Indique le nombre maximal d'utilisateurs (limite d'utilisation) du produit ou dispositif pour lequel la licence de clé est générée. Pour une utilisation simultanée, il s'agit du nombre maximum de travaux pouvant simultanément accéder au produit ou au dispositif. 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.

Les valeurs possibles sont :

1

Un utilisateur est autorisé à accéder au produit ou au dispositif.

*NOMAX

Le nombre des utilisateurs n'est pas limité.

limite-utilisation

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

Données fournisseur (VNDDTA)

Indique une zone de données à 8 caractères qui doit être définie et utilisée par le fournisseur.

Les valeurs possibles sont :

*NONE

Il n'y a pas de données de fournisseur pour ce produit ou dispositif.

données-fournisseur

Indique les 8 caractères qui permettent de définir d'autres informations relatives au produit ou au dispositif.

Sortie (OUTPUT)

Indique si la clé de licence qui est générée est affichée dans un message d'achèvement, imprimée dans un fichier spoule ou sauvegardée dans un fichier.

Les valeurs possibles sont :

*

La clé de licence est affichée uniquement dans un message d'achèvement.

*PRINT

La clé de licence est imprimée dans un fichier spoule.

*LICKEYFILE

Les informations de clé de licence sont sauvegardées dans le fichier spécifié au paramètre LICKEYFILE. Ce fichier peut ensuite être utilisé en tant que fichier de clés pour le support DSLO (Distributed Systems License Option).

Fichier de clés de licence (LICKEYFILE)

Indique le fichier dans lequel les informations de clé de licence sont sauvegardées. Si ce fichier n'existe pas, le système le crée. Si un fichier est créé, le système de fichiers QALZAKEY de la bibliothèque du système QSYS avec le nom de format LZAKEYR est utilisé comme modèle.

Les valeurs possibles sont :

*LIBL

La liste des bibliothèques est utilisée pour localiser le fichier dans lequel sauvegarder la clé de licence.

*CURLIB

Le fichier dans lequel sauvegarder la clé de licence est recherché dans la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est prise par défaut.

nom-bibliothèque

Indiquez le nom de la bibliothèque dans laquelle la clé de licence doit être sauvegardée.

La valeur possible pour le nom de fichier est la suivante :

nom-fichier

Indiquez le nom du fichier dans lequel les informations de clé de licence doivent être sauvegardées.

Membre de clés de licence (LICKEYMBR)

Indique le membre dans lequel les informations de clé de licence sont sauvegardées et comment ces informations sont sauvegardées.

Remarque :

Vous pouvez également utiliser l'API QLZAGENK pour créer les informations de clé de licence.

Les valeurs possibles pour le membre en sortie sont les suivantes :

*FIRST

La sortie est placée dans le premier membre du fichier. Si LICKEYMBR(*FIRST) est indiqué et que le membre n'existe pas, le système crée un membre portant le nom du fichier indiqué au paramètre LICKEYFILE.

nom-membre

Indiquez le nom du membre de fichier destiné à recevoir la sortie. Si le nom de membre de fichier est indiqué alors que le membre n'existe pas, le système le crée. Si le membre existe, vous avez la possibilité d'ajouter un nouvel enregistrement à la fin du membre existant ou de le mettre à blanc et de lui ajouter les nouveaux enregistrements.

L'opération que vous pouvez exécuter sur les valeurs du membre est la suivante :

*ADD

Si le membre existe, le système ajoute le nouvel enregistrement à la fin des enregistrements existants.

*REPLACE

Si le membre existe, le système le supprime et ajoute les nouvel enregistrement.

Exemples

GENLICKEY   PRDID(1MYPROD)  LICTRM(V1R2M0)  FEATURE(5001)
            VNDPWD(PRODUCTPWD)  EXPDATE(*NONE)
            SERIAL(1234567)  PRCGRP(P30)  USGLMT(25)

Cette commande permet de générer une clé de licence pour le produit 1MYPROD, terme de licence V1R2M0 et dispositif 5001. Cette clé permet d'autoriser 25 utilisateurs à utiliser ce produit, et il n'y a pas de date d'expiration. Il est ainsi possible d'indiquer que le produit ne doit être utilisé que sur un système dont le numéro de série est 1234567 et le groupe de processeur P30 ou inférieur.

Messages d'erreur

Messages *ESCAPE

CPF9860

Erreur lors du traitement du fichier de sortie.

CPF9899

Erreur lors du traitement de la commande.