Aller au contenu

RMVPTF

Enlever des PTF

En bref

La commande RMVPTF permet d'enlever les modifications provisoires du logiciel (PTF) propres au produit désigné.

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

Syntaxe minimale

RMVPTF LICPGM(…)

Paramètres

  • LICPGM Produit obligatoire
  • RLS Edition
  • SELECT Numéros de PTF à sélectionner
  • OMIT Numéros de PTF à omettre
  • RMV Type de modification
  • DELAYED PTF différées
  • IPLRMV Enlever à IPL sans opérateur
  • RMVDEP Enlever PTF dépendantes

Astuce : dans une session 5250, tapez RMVPTF 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 RMVPTF permet d'enlever les modifications provisoires du logiciel (PTF) propres au produit désigné. Si les PTF ont été appliquées provisoirement, les objets d'origine qu'elles remplaçaient sont renvoyés. Si les PTF sont enlevées provisoirement, les objets de PTF sont conservés dans la bibliothèque de PTF du produit et les PTF peuvent être de nouveau appliquées. Si les PTF sont enlevées définitivement, les objets de PTF sont enlevés de la bibliothèque de PTF du produit.

La commande RMVPTF est utilisée pour enlever des PTF immédiates au moment de son exécution, ou pour demander leur enlèvement lors du prochain IPL sans contrôle opérateur.

Restrictions :

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

Paramètres

Mot-clé Description Valeurs possibles Remarques
LICPGM Produit Valeur caractère Obligatoire, positionnel 1
RLS Edition Valeur caractère, *ONLY Facultatif
SELECT Numéros de PTF à sélectionner Valeurs uniques: *ALL
Autres valeurs (jusqu'à 300 répétitions): Valeur caractère
Facultatif
OMIT Numéros de PTF à omettre Values (jusqu'à 300 répétitions): Valeur caractère Facultatif
RMV Type de modification *TEMP, *PERM Facultatif
DELAYED PTF différées *NO, *YES Facultatif
IPLRMV Enlever à IPL sans opérateur *YES, *NO Facultatif
RMVDEP Enlever PTF dépendantes *NO, *YES Facultatif

Produit (LICPGM)

Indique en 7 caractères l'identificateur du produit dont les PTF sont enlevées.

Ce paramètre est obligatoire.

Edition (RLS)

Indique le niveau d'édition des PTF devant être retirées.

*ONLY
Cette valeur est admise 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 supprimées, quel que soit le niveau d'édition de l'option.
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.

Si le niveau d'édition indiqué est celui de l'option de base du produit, les PTF relatives à toutes les options installées du produit sont enlevées, quel que soit le niveau d'édition de l'option.

Si le niveau d'édition indiquée n'est pas celui de l'option de base du produit, seules sont enlevées les PTF relatives aux options installées à ce niveau d'édition.

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

Indique les PTF à enlever du produit désigné. Le paramètre Numéros de PTF à omettre (OMIT) ne peut pas être spécifié si des numéros de PTF sont spécifiés pour ce paramètre.

Valeurs uniques

*ALL
Toutes les PTF sont enlevées du produit. Toutefois, cette commande ne tient pas compte de celles qui ont été appliquées de manière définitive. Si toutes les PTF ne peuvent pas être enlevées, des messages signalent à l'opérateur celles qui n'ont pas été enlevées et les raisons pour lesquelles elles ne l'ont pas été.

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

valeur-alphanumérique
Entrez le numéro d'identification de chaque PTF à enlever.

Numéros de PTF à omettre (OMIT)

Indique que toutes les PTF sont à enlever, à l'exception de celles indiquées dans ce paramètre. Entrez les numéros des PTF à omettre (à laisser dans le système). Vous pouvez indiquer jusqu'à 300 numéros de PTF. Aucune valeur ne peut être indiquée au paramètre OMIT si des numéros de PTF sont spécifiés au paramètre SELECT (Numéros de PTF à sélectionner).

valeur-alphanumérique
Spécifiez le numéro d'identification de PTF de chaque PTF qui n'est pas supprimée.

Type de modification (RMV)

Indique si les PTF sont enlevées de manière provisoire ou définitive. Les objets de PTF enlevés définitivement sont enlevés de la bibliothèque de PTF du produit. Les objets de PTF enlevés provisoirement sont conservés dans la bibliothèque de PTF du produit de sorte que les PTF puissent être de nouveau appliquées ultérieurement.

*TEMP
Les PTF sont enlevées provisoirement et les objets de PTF sont conservés dans la bibliothèque de PTF du produit de sorte que les PTF puissent être de nouveau appliquées.
*PERM
Les PTF sont enlevées définitivement et les objets de PTF sont enlevés de la bibliothèque de PTF du produit.

PTF différées (DELAYED)

Indique si les PTF immédiates sont enlevées lors de l'exécution de la commande, ou si les PTF immédiates ou différées seront enlevées de manière différée 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 enlevées lors de l'exécution de la commande. Pour les PTF différées, si l'état de la PTF est Non appliquée et que vous avez spécifié RMV(*PERM), la PTF est retirée définitivement au moment de l'exécution de la commande. En revanche, toutes les autres PTF différées ne sont pas prises en compte lors de l'exécution de la commande et ne sont pas enlevées. Dans le cas des PTF immédiates qui sont retirées temporairement, elles ne le seront pas si des préconditions sont actives. Les PTF immédiates qui remplacent des PTF différées ne sont enlevé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 retirée.
*YES
Les PTF identifiées, qu'elles soient différées ou immédiates, sont enlevées lors du prochain IPL sans contrôle opérateur. Le paramètre IPLRMV (Enlever à IPL sans opérateur) permet de déterminer si c'est effectivement le cas, ou si toute demande précédemment émise à cet égard a été annulée.

Enlever à IPL sans opérateur (IPLRMV)

Indique l'action qui sera entreprise pour les PTF différées ou immédiates lors du prochain IPL sans contrôle opérateur. Ce paramètre n'est admis que si la valeur *YES est indiquée au paramètre DELAYED (PTF différées).

*YES
Les PTF identifiées sont enlevées lors du prochain IPL sans contrôle opérateur. Le paramètre RMV (Type de modification) permet de déterminer si le retrait est provisoire ou définitif.
*NO
Annulation de toute demande précédemment émise en vue d'enlever, lors du prochain IPL sans contrôle opérateur, les PTF identifiées.

Enlever PTF dépendantes (RMVDEP)

Indique si des PTF mutuellement dépendantes et des PTF dépendantes pour le même produit et la même option que celles spécifiées au paramètre SELECT sont traitées avec ces dernières. Le paramètre RMVDEP est valide uniquement lorsque *ALL n'est pas défini dans le paramètre SELECT.

*NO
Les PTF mutuellement dépendantes et les PTF dépendantes ne sont pas traitées avec la liste du paramètre SELECT. Aucune PTF n'est enlevée si une des PTF spécifiées dans la liste comporte des PTF dépendantes ne se trouvant pas dans la liste ou étant déjà appliquées. Des messages identifient les PTF dépendantes manquantes ainsi que les PTF spécifiées dont elles dépendent.
*YES
Les PTF mutuellement dépendantes et les PTF dépendantes sont enlevées avec la liste du paramètre SELECT.

Exemples

Exemple 1 : enlèvement provisoire de PTF

RMVPTF   LICPGM(57xxSS1)  DELAYED(*YES)

Cette commande permet d'enlever provisoirement toutes les PTF appliquées provisoirement à partir du système d'exploitation (57xxSS1) lors de l'IPL suivant. Les PTF peuvent être appliquées de nouveau, si nécessaire, au moyen de la commande APYPTF.

Exemple 2 : Retrait provisoire de PTF

RMVPTF   LICPGM(57xxSS1)  SELECT(SI10002 SI10005)  RMV(*PERM)

Cette commande permet d'enlever définitivement deux PTF (numéros SI10002 et SI10005) du système d'exploitation (57xxSS1). Les objets de PTF sont enlevés de la bibliothèque de PTF du produit, par conséquent, les PTF doivent être de nouveau chargées à l'aide de la commande LODPTF avant d'être appliquées.

Exemple 3 : Enlèvement de PTF et de leurs PTF mutuellement dépendantes

RMVPTF   LICPGM(57xxSS1)  SELECT(SI00003 SI00008 SI00012)
         DELAYED(*YES)  RMVDEP(*YES)

Cette commande enlève provisoirement les PTF SI00003, SI00008 et SI00012, ainsi que leurs PTF dépendantes et mutuellement dépendantes au sein du même produit et de la même option, du système d'exploitation et de la bibliothèque QSYS à l'IPL suivant.

Messages d'erreur

Messages *ESCAPE

CPF24B4
Severe error while addressing parameter list.
CPF35A0
La bibliothèque &1 ne peut pas être attribuée.
CPF35A1
Mauvais exemplaire du microcode sous licence utilisé.
CPF35A4
La PTF microcode &2 ne peut pas être enlevée.
CPF35A9
Erreur lors du traitement de la PTF microcode.
CPF35C0
Action à l'IPL ne peut être enlevée pour la PTF &1-&2 &4.
CPF35D0
PTF microcode &1-&2 &4 non définie pour retrait définitif.
CPF35D2
PTF &1-&2 non enlevée.
CPF35EB
Plusieurs éditions du produit &1 installées.
CPF35E4
Informations manquantes pour la PTF &1-&2 &4.
CPF35FB
PTF &1-&2 non enlevée.
CPF3558
Impossible d'allouer &1 dans &3 de type *&2. Cannot allocate &1 in &3 type *&2.
CPF3564
PTF &1-&2 endommagée.
CPF358A
Édition non valide. Release not valid.
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.
CPF3604
PTF non enlevée par suite d'erreur.
CPF3606
Produit &1 &3 non installé.
CPF361E
Une erreur s'est produite lors du retrait des PTF du produit &1.
CPF3612
Bibliothèque &1 non trouvée.
CPF3641
Aucune PTF immédiate enlevée.
CPF3658
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.
CPF3956
Erreur pendant le traitement des PTF.

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