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
-
LICPGMProduit -
SELECTNuméros de PTF à sélectionner -
RLSEdition -
COVERONLYLettre d'accompagnement seule -
OUTPUTSortie -
OUTFILEFichier recevant la sortie -
OUTMBROptions pour membre de sortie
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).
- 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.