DSPLICKEY

La commande DSPLICKEY permet d'afficher les informations de clé de licence logicielle figurant dans le référentiel des licences et relatives aux 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.

Les informations affichées comprennent le groupe de processeur, le numéro de série, la clé de licence logicielle, la limite d'utilisation, la date de péremption et les données fournisseur.

La commande DSPLICKEY permet également de créer un fichier en sortie qui peut être utilisé en entrée dans la commande ADDLICKEY ou RMVLICKEY.

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

Paramètres

Identificateur du produit (PRDID)

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

*ALL

Les informations de clé s'affichent pour tous les identificateurs de produit.

nom-générique*-identificateur-produit

Indiquez l'identificateur générique des produits à afficher. 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 affichées.

*ALL

Les informations de clé s'affichent pour tous les termes de licence trouvés sur 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 s'affichent.

*ALL

Les informations de clé s'affichent pour tous les dispositifs du produit indiqué au paramètre PRDID.

dispositif

Indiquez le numéro du dispositif pour lequel les informations de clé s'affichent.

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 s'affichent.

*LOCAL

Les informations de clé de licence s'affichent pour le système local.

*REMOTE

Les informations de clé de licence s'affichent pour tous les systèmes à l'exception du système local.

*ALL

Les informations de clé de licence s'affichent pour tous les systèmes.

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 s'affichent.

Sortie (OUTPUT)

Indique si la sortie de cette commande est affichée, imprimée ou dirigée vers un fichier base de données.

*

S'il s'agit d'un travail interactif, la sortie s'affiche à l'écran. Dans le cas d'un travail par lots, elle s'imprime avec la sortie spoule du travail.

*PRINT

le résultat est imprimé avec la sortie spoule du travail.

*LICKEYFILE

Les informations de clé de licence logicielle sont écrites dans un fichier en sortie.

Fichier de clés de licence (LICKEYFILE)

Indique le nom qualifié du fichier dans lequel les informations de clé de licence logicielle sont écrites. Si ce fichier n'existe pas, il peut être créé en utilisant le fichier modèle QSYS/QALZAKEY. Si le fichier existe, il doit être au format QSYS/QALZAKEY.

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 dans lequel les informations de clé de licence sont écrites.

Membre de clés de licence (LICKEYMBR)

Désigne le membre du fichier base de données dans lequel la sortie est écrite. Ce membre est utilisé ou créé comme suit :

• Si le membre existe, le système utilise le second élément de ce paramètre pour déterminer si le membre est effacé avant l'ajout de nouveaux enregistrements.
• Si le membre n'existe pas et qu'aucun nom de membre n'est indiqué, le système en crée un à l'aide du nom du fichier en sortie désigné au paramètre LICKEYFILE.
• Si le membre n'existe pas et qu'un nom de membre de fichier base de données est indiqué, le système le crée.

Les valeurs possibles pour le membre recevant la sortie sont les suivantes :

*FIRST

La sortie est envoyée dans le premier membre du fichier.

membre-recevant-sortie

Indiquez le nom du membre recevant la sortie.

Les valeurs possibles pour l'opération à exécuter sur le membre sont les suivantes :

*REPLACE

Le système met à blanc le membre existant et ajoute les nouveaux enregistrements.

*ADD

Le système ajoute les nouveaux enregistrements à la suite des enregistrements existants.

Exemples

DSPLICKEY   PRDID(*ALL)  LICTRM(*ALL)  FEATURE(*ALL)
            SERIAL(*REMOTE)  OUTPUT(*LICKEYFILE)
            LICKEYFILE(KEYS)  LICKEYMBR(REMOTE *REPLACE)

Cette commande affiche les informations de clé de licence logicielle pour tous les produits, dispositifs et termes de licence pour tous les systèmes à l'exception de celui-ci. La sortie est placée dans le membre REMOTE du fichier KEYS. Tous les enregistrements existants sont remplacés.

Messages d'erreur

Messages *ESCAPE

CPF9E58

Informations de clé de licence non trouvées.