DSPPTFAPYI

L'écran de la commande DSPPTFAPYI indique si les PTF sélectionnées peuvent être appliquées immédiatement à partir de *SERVICE. Toutes les PTF sélectionnées et les PTF requises associées qui ne sont pas appliquées sont affichées. Si une PTF est à l'état Remplacée, la PTF de remplacement est affichée à sa place. Pour chaque PTF affichée, la zone Type application est définie avec l'une des valeurs suivantes :

• *IMMED - La PTF peut être appliquée immédiatement. Pour le microcode sous licence, les PTF correspondantes doivent être installées à partir du source IPL ##MACH#B.
• *DELAYED - Un IPL est nécessaire pour l'application de la PTF car celle-ci est de type Différée.
• *PRECND - La PTF peut être appliquée immédiatement si toutes les préconditions qui lui sont associées sont satisfaites.
• *ACTRQD - Une action est requise pour la PTF si les PTF sélectionnées ont été installées.
• *DLYSPR - Un IPL est nécessaire pour l'application de la PTF immédiate car celle-ci remplace une PTF différée qui n'est pas appliquée de façon provisoire ou définitive.
• *REQIPLRQD - La PTF est liée à une PTF requise dont l'application nécessite un IPL.
• *REQPRECND - La PTF est liée à une PTF requise associée à une précondition.

Les PTF sélectionnées et les PTF requises à installer doivent exister dans *SERVICE. Des fichiers sauvegarde doivent exister pour les PTF sélectionnées qui n'ont pas été chargées. Le groupe de PTF spécifié doit exister sur le système, de même que ses PTF et ses PTF requises qui ne sont pas encore installées. Si les PTF et les groupes de PTF se trouvent sur un support physique ou dans un catalogue d'images de CD-ROM, utilisez l'une des méthodes suivantes pour copier les fichiers sauvegarde de PTF et les groupes de PTF dans *SERVICE avant d'exécuter cette commande :

• Utilisez l'API QPZCPYSV pour copier les fichiers sauvegarde de PTF et les groupes de PTF dans *SERVICE.
• Utilisez la commande CPYPTF pour copier les fichiers sauvegarde de PTF à partir d'un support dans *SERVICE. Utilisez la commande CPYPTFGRP pour copier les groupes de PTF dans *SERVICE.

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

Produit (LICPGM)

Indique le produit des PTF sélectionnées.

*ALL

Les PTF sélectionnées pour tous les produits installés sont affichées.

logiciel-sous-licence

Indiquez le produit des PTF sélectionnées.

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

Indique les PTF utilisées pour déterminer les informations d'application de PTF. *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.

Valeurs uniques

*NOTAPY

Les informations d'application de PTF sont affichées pour toutes les PTF présentes dans *SERVICE qui ne sont pas appliquées.

*PTFGRP

Le paramètre Groupe de PTF (PTFGRP) indique le nom du groupe de PTF contenant les PTF utilisées pour déterminer les informations d'application de PTF.

Autres valeurs (jusqu'à 300 répétitions)

valeur-alphanumérique

Indiquez le numéro d'identification de chaque PTF à afficher.

Groupe de PTF (PTFGRP)

Indique le groupe de PTF contenant les PTF utilisées pour déterminer les informations d'application de PTF.

*NONE

Aucun groupe de PTF n'est spécifié.

nom

Indiquez le nom du groupe de PTF. Les informations d'application de PTF sont affichées pour toutes les PTF du groupe de PTF spécifié. Le paramètre PTFGRPLVL indique le niveau du groupe de PTF à utiliser. Les PTF du groupe de PTF non installées, mais destinées à des produits installés, sont utilisées pour déterminer les informations d'application de PTF.

Edition (RLS)

Indique le niveau d'édition des PTF sélectionnées. Ce paramètre est ignoré si la valeur *ALL est indiquée au paramètre Produit (LICPGM).

*ONLY

Cette valeur n'est admise que lorsqu'une seule édition de l'option de base du produit est installée sur le système.

caractère-valeur

Indiquez le niveau d'édition de l'option de base du produit en utilisant 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.

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).

PTFGRPLVL (Niveau du groupe de PTF)

Indique le niveau du groupe de PTF.

Remarque :Ce paramètre ne s'applique que lorsqu'un groupe de PTF est spécifié au paramètre PTFGRP.

*LATEST

Le dernier niveau du groupe de PTF qui existe sur le système est utilisé pour afficher les informations d'application de PTF.

1-99999

Indiquez le niveau du groupe de PTF qui est utilisé pour afficher les informations d'application de PTF.

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 QADSPAPY de la bibliothèque système QSYS ayant QPZDSAPY pour nom de format, 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: Affichage des informations relatives aux PTF non appliquées

DSPPTFAPYI   LICPGM(*ALL)  SELECT(*NOTAPY)

Cette commande permet d'afficher les informations d'application de PTF pour toutes les PTF présentes dans *SERVICE qui ne sont pas appliquées.

Exemple 2: Impression des informations relatives à un groupe de PTF

DSPPTFAPYI   LICPGM(*ALL)  SELECT(*PTFGRP)  PTFGRP(SF99709)
             OUTPUT(*PRINT)

Cette commande permet de générer une impression des informations d'application de PTF pour toutes les PTF présentes dans le dernier niveau du groupe de PTF SF99709 qui ne sont pas appliquées.

Exemple 3: Affichage des informations relatives à une PTF spécifique

DSPPTFAPYI   LICPGM(57xxSS1)  SELECT(SI12345)

Cette commande permet d'afficher les informations d'application de PTF pour la PTF SI12345 et pour toutes ses PTF requises qui ne sont pas appliquées.

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.

CPF35EB

Plusieurs éditions du produit &1 installées.

CPF35F5

Lettre d'accompagnement non trouvée pour la PTF &1-&2 &4.

CPF358A

Édition non valide. Release not valid.

CPF3586

Liste de PTF incorrecte.

CPF3598

Fonction PTF déjà en cours.

CPF36A4

Groupe de PTF &1 non trouvé.

CPF36A6

Nom de groupe de PTF &1 incorrect.

CPF3606

Produit &1 &3 non installé.

CPF3610

Toutes les PTF sélectionnées sont déjà appliquées.

CPF362F

Fichiers sauvegarde requis manquants pour des PTF sélectionnées.

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.

CPF8191

Définition de produit &4 de &9 endommagée.

CPF8193

Objet de chargement de produit &4 de &9 endommagé.

CPF9845

Erreur lors de l'ouverture du fichier &1.

CPF9860

Erreur lors du traitement du fichier de sortie.