APYPTF

La commande APYPTF permet d'appliquer des PTF (modifications provisoires du logiciel) à un produit donné. Avant qu'une PTF ne puisse être appliquée, elle doit d'abord être chargée par la commande Charger des PTF (LODPTF).

Lorsqu'une PTF est appliquée, elle remplace intégralement l'objet du produit affecté. Les PTF peuvent être appliquées provisoirement ou définitivement. Dans le cas de PTF provisoires, les objets remplacés sont sauvegardés par le système et peuvent être restaurés ultérieurement sur le produit à l'aide de la commande Enlever des PTF (RMVPTF). Dans le cas de PTF appliquées définitivement, les objets remplacés sont retirés du système.

La commande APYPTF est utilisée pour appliquer des PTF immédiates au moment de son exécution, ou pour demander l'application des PTF lors du prochain IPL sans contrôle opérateur. Lors d'un IPL sous contrôle opérateur, l'écran Gestion des PTF permet de demander que des PTF soient appliquées au démarrage du système.

Certains IPL peuvent être plus lents que d'autres lors de l'application de PTF. Pour plus d'informations sur l'application des PTF, consultez le Rubriques IBM i et logiciels associés de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Restrictions :

• Pour utiliser cette commande, vous devez disposer du droit *ALLOBJ sur tous les objets.

Paramètres

Produit (LICPGM)

Indique l'identificateur à 7 caractères du produit auquel les PTF doivent être appliquées.

Remarque :LICPGM(*ALL) n'est admis que si SELECT(*ALL) est précisé et si OMIT ne figure pas dans cette commande.

Ce paramètre est obligatoire.

*ALL

Les PTF sont appliquées à tous les produits installés sur le système.

caractère-valeur

Indiquez en 7 caractères l'identificateur du produit auquel les PTF sont appliquées.

Edition (RLS)

Indique le niveau d'édition du produit logiciel. Ce niveau doit être spécifié lorsque plusieurs éditions sont installées.

*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. Les PTF associées à toutes les options installées du produit sont appliquées, quel que soit le niveau d'édition de l'option.

*ALL

Les PTF de toutes les éditions des produits installés sont appliquées. Cette valeur est admise uniquement lorsque le paramètre LICPGM(*ALL) est spécifié.

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.

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

Indique que les PTF précédemment chargées doivent être appliquées au produit désigné. Aucune valeur ne doit être indiquée au paramètre OMIT (Numéros de PTF à omettre) si des numéros de PTF sont précisés au paramètre SELECT.

Valeurs uniques

*ALL

Toutes les PTF qui ont été chargées doivent être appliquées au produit. S'il est impossible de les appliquer toutes, des messages signalent celles qui ne l'ont pas été et les raisons pour lesquelles elles ne l'ont pas été (les PTF obligatoires n'ont pas encore été appliquées, par exemple).

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

valeur-alphanumérique

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

Numéros de PTF à omettre (OMIT)

Indique les numéros de PTF qui ne sont pas appliqués. Vous pouvez indiquer jusqu'à 300 numéros.

Remarque :Le paramètre OMIT ne peut pas être spécifié si des numéros de PTF simples sont spécifiés pour le paramètre Numéros de PTF à sélectionner (SELECT).

valeur-alphanumérique

Spécifiez le numéro d'identification de chaque PTF à omettre.

Type de modification (APY)

Indique si les PTF sont appliquées de manière provisoire ou définitive. Les PTF appliquées de manière définitive ne peuvent pas être enlevées, alors que celles qui sont appliquées provisoirement peuvent l'être au moyen de la commande Enlever des PTF (RMVPTF).

*TEMP

Les PTF sont appliquées provisoirement.

*PERM

Les PTF sont appliquées définitivement.

PTF différées (DELAYED)

Indique si des PTF immédiates sont appliquées lors du traitement de la commande ou si des PTF immédiates ou différées sont appliquées au cours du prochain IPL sans contrôle opérateur.

*NO

Les PTF immédiates qui ne remplacent pas des PTF différées sont appliquées lors de l'exécution de la commande. Les PTF différées et les PTF immédiates avec des PTF préalables ou simultanées différées sont ignorées lors de la commande APYPTF et ne sont pas appliquées. Les PTF immédiates qui ont des préconditions non satisfaites ne sont pas appliquées. Les PTF immédiates qui remplacent des PTF différées ne sont appliquées que lorsque les PTF remplacées différées sont à l'état Appliquée de façon définitive ou Remplacée qui prévoit que la PTF de remplacement est à l'état Appliquée de façon définitive. Un message est envoyé pour chaque PTF qui n'est pas appliquée.

*YES

Les PTF identifiées, qu'elles soient différées ou immédiates, sont appliquées lors du prochain IPL sans contrôle opérateur. Le paramètre Appliquer à IPL sans opérateur (IPLAPY) permet de déterminer si c'est effectivement le cas, ou si toute demande précédemment émise à cet égard a été annulée.

*IMMDLY

Toutes les PTF immédiates qui ne remplacent pas de PTF différées sont appliquées et les PTF différées ou les PTF préalables ou simultanées différées sont prévues pour être appliquées lors du prochain IPL automatique. Les PTF immédiates qui ont des préconditions non satisfaites sont définies pour être appliquées lors du prochain IPL automatique. Les PTF immédiates qui remplacent des PTF différées sont appliquées si les PTF remplacées différées sont à l'état Appliquée de façon définitive ou Remplacée qui prévoit que la PTF de remplacement est à l'état Appliquée de façon définitive. Sinon, les PTF immédiates qui remplacent des PTF différées sont prévues pour être appliquées lors du prochain IPL automatique.

Options d'application à l'IPL (IPLAPY)

Indique l'action qui sera entreprise pour les PTF différées ou immédiates lors du prochain IPL sans contrôle opérateur.

Valeurs uniques

*NO

Annulation de toute demande précédemment émise en vue de l'application, lors du prochain IPL sans contrôle opérateur, des PTF identifiées.

Elément 1 : Appliquer à IPL sans opérateur

*YES

Les PTF identifiées sont appliquées lors du prochain IPL sans contrôle opérateur. Le paramètre Type de modification (APY) détermine l'état de l'application : provisoire ou définitif.

Elément 2 : PTF microcode préalables

Le microcode sous licence préalable est appliqué immédiatement ou lors du prochain IPL selon les valeurs indiquées au paramètre DELAYED.

*APYPERM

Si LICPGM(*ALL) est indiqué ou si APYREQ(*YES) est spécifié et que les PTF d'un produit comportent des modifications du microcode préalables, ces modifications seront appliquées définitivement.

*NOAPY

Les PTF préalables du microcode sous licence ne seront pas appliquées au cours du prochain IPL sans contrôle opérateur. Si une PTF de ce type n'est pas appliquée définitivement, l'exécution de cette commande est interrompue.

Appliquer PTF préalables (APYREQ)

Indique si les PTF préalables et les PTF simultanées indiquées au paramètre SELECT, et faisant partie du même produit et de la même édition, sont appliquées avec les PTF spécifiées dans la liste du paramètre SELECT.

Ce paramètre est valide uniquement lorsque *ALL n'est pas défini dans le paramètre SELECT.

*NO

Les PTF simultanées et préalables ne sont pas appliquées avec celles incluses dans la liste du paramètre SELECT. Aucune PTF n'est appliquée si l'une des PTF spécifiées dans la liste comporte des PTF requises ne se trouvant pas dans la liste ou déjà appliquées. Des messages identifient les PTF requises manquantes et celles qui les requièrent.

*YES

Les PTF sont appliquées avec celles incluses dans la liste du paramètre SELECT.

Exemples

Exemple 1 : application provisoire de PTF

APYPTF   LICPGM(57xxSS1)  DELAYED(*YES)

Cette commande permet d'appliquer tous les correctifs de programmation qui affectent le système d'exploitation (57xxSS1). Ces PTF sont appliquées provisoirement à l'IPL suivant.

Exemple 2 : application définitive de PTF

APYPTF   LICPGM(57xxSS1)  SELECT(SI00003 SI00008 SI00012)
         APY(*PERM)  DELAYED(*YES)

Cette commande applique définitivement les PTF SI00003, SI00008 et SI00012 au système d'exploitation dans la bibliothèque QSYS à l'IPL suivant.

Exemple 3 : application de toutes les PTF chargées

APYPTF   LICPGM(*ALL)  DELAYED(*IMMDLY)

Cette commande applique définitivement toutes les PTF pouvant être appliquées immédiatement et définit le reste de sorte les appliquer à l'IPL suivant.

Exemple 4 : application des PTF immédiates et de leurs PTF simultanées et préalables à l'exécution de la commande

APYPTF   LICPGM(57xxSS1)  SELECT(SI00003 SI00008 SI00012)
         APYREQ(*YES)

Cette commande applique les PTF identifiées et leurs PTF simultanées et préalables au moment où la commande est exécutée si elles sont définies comme immédiates. Les PTF définies comme différées ou possédant des PTF simultanées ou préalables définies comme différées sont ignorées conjointement aux conditions différées.

Exemple 5 : application des PTF et de leurs PTF simultanées et préalables à l'IPL suivant

APYPTF   LICPGM(57xxSS1)  SELECT(SI00003 SI00008 SI00012)
         DELAYED(*YES)  APYREQ(*YES)

Cette commande applique les PTF identifiées et leurs PTF simultanées et préalables à l'IPL suivant, indépendamment du fait qu'elles sont définies comme différées ou immédiates.

Exemple 6 : application des PTF et de leurs PTF simultanées et préalables dès que possible

APYPTF   LICPGM(57xxSS1)  SELECT(SI00003 SI00008 SI00012)
         DELAYED(*IMMDLY)  APYREQ(*YES)

Cette commande applique les PTF identifiées et leurs PTF simultanées et préalables au moment où la commande est exécutée si elles sont définies comme immédiates. Les PTF définies comme différées ou possédant des PTF simultanées ou préalables définies comme différées sont appliquées à l'IPL suivant conjointement aux conditions différé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.

CPF2150

Erreur dans la fonction d'informations sur objet.

CPF2151

Erreur de l'opération sur &2 de &1 type *&3.

CPF35AA

La PTF microcode &2 est déjà appliquée.

CPF35AB

PTF microcode &2 non appliquée.

CPF35A0

La bibliothèque &1 ne peut pas être attribuée.

CPF35A1

Mauvais exemplaire du microcode sous licence utilisé.

CPF35A2

Modifications préalables du matériel non installées pour PTF &2.

CPF35A3

PTF microcode &2 non appliquée provisoirement.

CPF35A5

PTF microcode &2 non appliquée définitivement.

CPF35A9

Erreur lors du traitement de la PTF microcode.

CPF35CF

PTF &1-&2 non appliquée.

CPF35D0

PTF microcode &1-&2 &4 non définie pour retrait définitif.

CPF35EB

Plusieurs éditions du produit &1 installées.

CPF35E3

Erreur d'interface détectée.

CPF35E4

Informations manquantes pour la PTF &1-&2 &4.

CPF35FA

PTF &1-&2 non appliquée.

CPF3544

L'action d'application à l'IPL ne peut pas être enlevée pour la PTF &1-&2 &4.

CPF3558

Impossible d'allouer &1 dans &3 de type *&2. Cannot allocate &1 in &3 type *&2.

CPF3564

PTF &1-&2 endommagée.

CPF3583

PTF non appliquée par suite d'erreur.

CPF3576

Erreur lors de l'application de PTF pour le produit &1.

CPF3596

Numéros de PTF non permis dans liste de sélection/omission.

CPF3598

Fonction PTF déjà en cours.

CPF3602

PTF &2 non enlevée car appliquée définitivement.

CPF3606

Produit &1 &3 non installé.

CPF361D

L'ordre d'application des PTF ne peut pas être déterminé.

CPF3612

Bibliothèque &1 non trouvée.

CPF362C

Mémoire secondaire insuffisante pour PTF microcode.

CPF362D

PTF appliquées mais certaines nécessitent des actions supplémentaires.

CPF3640

Aucune PTF immédiate appliquée.

CPF3660

Aucune PTF identifiée.

CPF3693

Service function ended because error occurred.

CPF3931

Programmes requis non trouvés. PTF incomplète.

CPF3945

Enregistrement des PTF supprimé pour logiciel sous licence.

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.

CPF9846

Erreur lors du traitement du fichier &1 de &2.