Aller au contenu

DSPPTF

Afficher les PTF

En bref

La commande DSPPTF permet d'afficher les modifications provisoires du logiciel (PTF) apportées à un produit donné.

DSPPTF se lit DSP (Afficher) + PTF. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

DSPPTF

Paramètres

Astuce : dans une session 5250, tapez DSPPTF 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 DSPPTF permet d'afficher les modifications provisoires du logiciel (PTF) apportées à un produit donné.

Restrictions :

  • Cette commande est fournie avec le droit public d'exclude (*EXCLUDE) et les profils utilisateur QPGMR, QSYSOPR, QSRV et QSRVBAS disposent de droits privés sur cette commande.

Paramètres

Mot-clé Description Valeurs possibles Remarques
LICPGM Produit Valeur caractère, *ALL, *FMW Facultatif, positionnel 1
SELECT Numéros de PTF à sélectionner Valeur caractère, *ALL, *PTFSAVF, *ONORDER, *ACTRQD, *NOTAPY, *SAVFONLY, *ONORDONLY, *COVERONLY Facultatif, positionnel 2
RLS Edition Valeur caractère, *ALL Facultatif
COVERONLY Lettre d'accompagnement seule *NO, *YES Facultatif
OUTPUT Sortie *, *PRINT, *OUTFILE Facultatif
OUTFILE Fichier recevant la sortie Nom d'objet qualifié Facultatif
Qualificatif 1: Fichier recevant la sortie Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
OUTMBR Options pour membre de sortie Liste d'éléments Facultatif
Élément 1: Membre recevant la sortie Nom, *FIRST
Élément 2: Remplacement ou ajout enregs *REPLACE, *ADD

Produit (LICPGM)

Indique le produit correspondant aux PTF affichées. Si LICPGM(*ALL) est indiqué, les PTF de tous les produits installés et pris en charge sont affichées.

*ALL
Les PTF de tous les produits installés et pris en charge sont affichées.
*FMW
Les PTF de tous les microprogrammes du serveur installés et pris en charge sont affichées.
logiciel-sous-licence
Indiquez le produit pour lequel des PTF sont affichées.

Numéros de PTF à sélectionner (SELECT)

Indique quelle PTF est affichée pour le produit désigné. *ALL ne peut pas être spécifié pour le paramètre Produit (LICPGM) si un numéro de PTF est spécifié pour ce paramètre.

Lorsque LICPGM(*ALL) et SELECT(*ALL) sont indiqués, toutes les PTF relatives aux produits installés et pris en charge sont affichées.

Lorsque LICPGM(logiciel-sous-licence) et SELECT(*ALL) sont indiqués, les PTF relatives à toutes les éditions des produits indiqués sont affichées.

*ALL
Affichage de l'état de toutes les PTF relatives au produit indiqué.
*PTFSAVF
Affichage de l'état de toutes les PTF relatives au produit indiqué qui ont un fichier sauvegarde dans la bibliothèque QGPL. Cette valeur spéciale est utile pour déterminer les fichiers d'enregistrement de PTF qui ne sont plus requis. Elle permet également au prestataire de maintenance de déterminer les PTF qui peuvent être distribuées.
*ONORDER
Affichage de l'état de toutes les PTF relatives au produit indiqué qui ont fait l'objet d'une commande.
*ACTRQD
Affichage des PTF pour lesquelles des actions requises sont en instance. Cette valeur spéciale permet à l'utilisateur de déterminer quelles sont les PTF qui nécessitent une action pour être activées.

Remarque :Si *ACTRQD est précisé, l'exécution des programmes d'exit dure plus longtemps, ce qui diffère l'affichage du premier écran.

*NOTAPY
Toutes les PTF qui ne sont pas déjà appliquées ou remplacées pour le produit spécifié sont affichées.
*SAVFONLY
Toutes les PTF qui possèdent le statut En fichier sauvegarde sont affichées pour le produit spécifié.
*ONORDONLY
Toutes les PTF qui possèdent le statut En commande sont affichées pour le produit spécifié.
*COVERONLY
Toutes les PTF à l'état Lettre d'accompagnement seule s'affichent pour le produit désigné.
caractère-valeur
Indiquez le numéro d'identification de la PTF affichée.

Edition (RLS)

Indique le niveau d'édition des PTF affichées.

*ALL
Affichage des PTF de toutes les éditions des produits pris en charge et installés.
caractère-valeur
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.

Lettre d'accompagnement seule (COVERONLY)

Indique si seule la lettre d'accompagnement est affichée.

*NO
Aucune lettre d'accompagnement n'est affichée.
*YES
La lettre d'accompagnement est affichée.

Sortie (OUTPUT)

Indique si la sortie générée par la commande doit être affichée sur le poste de travail demandeur, ou imprimée avec la sortie spoule du travail.

*
La sortie est affichée (s'il s'agit d'un travail interactif) ou imprimée avec la sortie spoule du travail (s'il s'agit d'un travail par lots).
*PRINT
le résultat est imprimé avec la sortie spoule du travail. Le nom du fichier spoule en sortie est QSYSPRT.
*OUTFILE
La sortie est dirigée vers le fichier base de données indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE).

Fichier recevant la sortie (OUTFILE)

Indique le fichier base de données physique dans lequel les enregistrements de PTF sont envoyés. Si le fichier de sortie existe déjà, le système cherche à l'utiliser. Dans le cas contraire, le système crée un fichier base de données physique (dont le nom est indiqué dans le paramètre OUTFILE) dans la bibliothèque désignée. Un membre est créé pour le fichier précisé au paramètre OUTMBR (Options pour membre de sortie). Si un nouveau fichier est créé, le fichier système QADSPPTF de la bibliothèque QSYS et de format QSCPTF est utilisé comme modèle.

Qualificatif 1 : Fichier recevant la sortie

nom
Indiquez le nom du fichier de base de données vers lequel la sortie générée de la commande est dirigée.

Qualificatif 2 : Biblio

*LIBL
Le fichier est recherché dans la liste des bibliothèques. Si le système ne le trouve pas, il en crée un dans la bibliothèque en cours. S'il n'existe pas de bibliothèque en cours, le fichier est créé dans la bibliothèque QGPL.
*CURLIB
Bibliothèque de l'unité d'exécution en cours utilisée pour localiser le fichier. Si aucune bibliothèque n'est indiquée comme bibliothèque en cours, la bibliothèque QGPL est utilisée.
nom
Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Options pour membre de sortie (OUTMBR)

Indique le nom du membre de fichier base de données dans lequel est envoyée la sortie de la commande.

Elément 1 : Membre recevant la sortie

*FIRST
Le premier membre du fichier reçoit la sortie. Si OUTMBR(*FIRST) est indiqué et que le membre n'existe pas, le système en crée un du nom indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE). Si le membre existe, vous avez la possibilité d'ajouter de nouveaux enregistrements à la fin du membre existant ou de le mettre à blanc et de lui ajouter les nouveaux enregistrements.
nom
Indiquez le nom du membre de fichier destiné à recevoir la sortie. Si aucun membre de ce nom n'existe, le système le crée.

Elément 2 : Remplacement ou ajout enregs

*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

Exemple 1 : impression de l'état des PTF

DSPPTF   LICPGM(57xxSS1)  OUTPUT(*PRINT)

Cette commande permet de générer une impression contenant l'état des PTF pour le produit 57xxSS1.

Exemple 2 : Impression des informations

DSPPTF   LICPGM(57xxSS1)  SELECT(SI00034)  OUTPUT(*PRINT)

Cette commande permet de générer une impression contenant des informations détaillées sur la PTF SI00034 pour le produit 57xxSS1.

Messages d'erreur

Messages *ESCAPE

CPF0C4B
Product availability object &2/&1 recovery required.
CPF0C4C
Impossible d'allouer l'objet &1 de la bibliothèque &2. Cannot allocate object &1 in library &2.
CPF0C4D
Une erreur s'est produite lors du traitement de l'objet &1 de la bibliothèque &2. Error occurred while processing object &1 in library &2.
CPF24B4
Severe error while addressing parameter list.
CPF35BE
Produit &1 &4 non accepté ni installé.
CPF35F5
Lettre d'accompagnement non trouvée pour la PTF &1-&2 &4.
CPF358A
Édition non valide. Release not valid.
CPF3925
Cannot open file &1.
CPF3950
Le message d'erreur &2 a été reçu pour le fichier &1. La demande a pris fin. Error message &2 received for file &1. Request ended.
CPF6601
Aucune activité PTF pour le produit &1.
CPF6602
PTF &1-&2 &4 non trouvée.
CPF6603
Aucune PTF trouvée.
CPF6613
Aucune PTF ne correspond aux critères de sélection.
CPF8191
Définition de produit &4 de &9 endommagée.
CPF8193
Objet de chargement de produit &4 de &9 endommagé.
CPF9860
Erreur lors du traitement du fichier de sortie.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.