INSPTF
Installer des PTF
En bref
La commande INSPTF permet à l'utilisateur de charger et d'appliquer des PTF pour plusieurs produits en une seule opération.
INSPTF se lit INS
(Installer) + PTF.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
INSPTF LICPGM(…)
Paramètres
-
LICPGMDescription de produit obligatoire -
DEVUnité -
INSTYPType d'application de PTF -
OMITListe des PTF à omettre -
HIPERPTF HIPER uniquement -
ENDOPTOption de fin de support -
RESTARTType de redémarrage -
PMTMEDInvite pour support -
CPYPTFCopier les PTF
Astuce : dans une session 5250, tapez INSPTF 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 INSPTF permet à l'utilisateur de charger et d'appliquer des PTF pour plusieurs produits en une seule opération. Des groupes de PTF sont copiés sur le système lorsqu'ils n'existent pas déjà ou lorsque le niveau des groupes de PTF sur le support est supérieur à celui sur le système. Si LICPGM(*ALL) est spécifié, les PTF de traitement spécial répertoriées dans les groupes de PTF sont utilisées lors de l'installation.
Les paramètres OMIT et HIPER sont fournis pour permettre à l'utilisateur de la commande INSPTF d'être plus sélectif. Ces paramètres ne s'appliquent qu'à l'opération de chargement de PTF. Toute PTF déjà chargée sur le système est appliquée.
Le paramètre INSTYP contrôle l'application des PTF. L'utilisation de ses différentes valeurs permet de combiner l'application immédiate et différée de PTF ainsi que le démarrage d'un IPL.
La commande INSPTF ne permet pas le chargement de PTF à partir d'une bande pour les produits dont les options de base sont installées sous différentes éditions sur le système. Dans ce cas, le chargement de PTF n'est pas effectué et la commande renvoie une erreur.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| LICPGM | Description de produit | Values (jusqu'à 300 répétitions): Liste d'éléments | Obligatoire, positionnel 1 |
| Élément 1: Produit | Valeur caractère, *ALL | ||
| Élément 2: Edition | Valeur caractère, *ONLY | ||
| DEV | Unité | Nom, *SERVICE, *NONE | Facultatif |
| INSTYP | Type d'application de PTF | *SRVATT, *DLYIPL, *DLYALL, *IMMONLY, *IMMDLY | Facultatif |
| OMIT | Liste des PTF à omettre | Values (jusqu'à 50 répétitions): Liste d'éléments | Facultatif |
| Élément 1: Produit | Valeur caractère | ||
| Élément 2: Identificateur de PTF | Valeur caractère | ||
| Élément 3: Edition | Valeur caractère, *ONLY | ||
| HIPER | PTF HIPER uniquement | *YES, *NO | Facultatif |
| ENDOPT | Option de fin de support | *REWIND, *LEAVE, *UNLOAD | Facultatif |
| RESTART | Type de redémarrage | *IPLA, *SYS, *FULL | Facultatif |
| PMTMED | Invite pour support | *SNGVOLSET, *MLTVOLSET, *MLTSRV | Facultatif |
| CPYPTF | Copier les PTF | *SRVATT, *YES, *NO | Facultatif |
Description de produit (LICPGM)
Indique l'ID, la version, l'édition et le niveau de modification des produits pour lesquels des PTF doivent être installées.
Ce paramètre est obligatoire.
Vous pouvez spécifier 300 valeurs pour ce paramètre.
Elément 1 : Produit
- *ALL
- Les PTF de tous les produits présents sur le système sont installées. *ALL n'admet l'indication d'aucune autre valeur. Aucune valeur indiquée à la suite n'est prise en compte.
- caractère-valeur
- Indiquez l'ID produit des PTF à installer.
Elément 2 : Edition
- *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.
- 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.
Unité (DEV)
Indique l'unité à partir de laquelle les PTF sont chargées. Le nom de l'unité doit déjà être connu sur le système par une description d'unité.
- *SERVICE
- Les PTF envoyées par le système du service de maintenance sont installées.
- *NONE
- Aucune PTF n'est chargée. Toute PTF déjà chargée sur le système est appliquée. Cette valeur spéciale est utilisée après l'IPL, à la suite d'une installation de PTF incomplète. Les PTF de gestion spéciales d'un groupe de PTF sur le point d'être installé doivent être appliquées et actives avant que le reste des PTF du groupe ne puisse être appliqué.
- nom
- Spécifiez le nom de l'unité de bande ou du lecteur de disque optique à partir duquel les PTF sont installées.
Type d'application de PTF (INSTYP)
Indique le type d'installation à effectuer.
- *SRVATT
- Le type d'installation dépend de la définition des attributs de maintenance.
Attention :
L'attribut de maintenance livré par défaut est *DLYIPL. Utilisez la commande Modifier attributs maintenance (CHGSRVA) pour modifier la valeur par défaut.
- *DLYIPL
- Toutes les PTF sont marquées pour une application différée et un IPL est effectué sur le système.
- *DLYALL
- Toutes les PTF sont marquées pour une application différée et aucun IPL n'est effectué sur le système.
- *IMMDLY
- Toutes les PTF immédiates sont appliquées et les PTF différées sont marquées pour une application au cours du prochain IPL.
- *IMMONLY
- Toutes les PTF sont chargées, mais seules les PTF immédiates sont appliquées et aucun IPL n'est effectué sur le système.
Liste des PTF à omettre (OMIT)
Indique l'ID produit, la version, l'édition, le niveau de modification et l'ID des PTF qui ne doivent pas être chargées. L'état en cours de la PTF n'est pas vérifié avant transmission à LODPTF. Si la PTF est déjà chargée, elle est appliquée. Jusqu'à 50 PTF peuvent être ignorées.
Elément 1 : Produit
- caractère-valeur
- Indiquez l'ID produit des PTF qui ne doivent pas être chargées.
Elément 2 : Identificateur de PTF
- caractère-valeur
- Indiquez l'ID des PTF qui ne doivent pas être installées.
Elément 3 : Edition
- *ONLY
- Edition unique du produit indiqué au paramètre LICPGM.
- caractère-valeur
- Indiquez le niveau d'édition de l'option de base du produit ou le niveau d'édition de PTF en ce qui concerne toutes les PTF qui ne doivent pas être chargées. 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.
PTF HIPER uniquement (HIPER)
Indique si seules les PTF HIPER (erreur généralisée à impact élevé) doivent être chargées lorsque l'installation s'effectue à partir d'un support.
Remarque :Ce paramètre est ignoré lorsque *SERVICE est spécifié pour le paramètre Unité (DEV). Ce paramètre n'est valide que lors de l'installation de modules de PTF IBM cumulatifs.
- *NO
- Toutes les PTF, à l'exception de celles répertoriées sur la liste d'omission, doivent être installées.
- *YES
- Seules les PTF HIPER ne figurant pas sur la liste d'omission doivent être installées.
Option de fin de support (ENDOPT)
Indique l'opération automatiquement effectuée après une opération de PTF sur le volume de bande ou le volume optique.
Remarque :Ce paramètre n'est admis que si un nom d'unité de bande ou d'unité optique est précisé au paramètre DEV. Pour les unités optiques, seule la valeur spéciale *UNLOAD est acceptée. Les valeurs *REWIND et *LEAVE ne seront pas prises en compte.
- *REWIND
- A la fin de l'opération, la bande est rebobinée automatiquement, mais elle n'est pas déchargée.
- *LEAVE
- La bande n'est pas rembobinée ou déchargée à la fin de l'opération. Elle conserve sa position.
- *UNLOAD
- La bande est automatiquement rembobinée et déchargée à la fin de l'opération. Certaines unités optiques éjecteront le volume une fois l'opération terminée.
Type de redémarrage (RESTART)
Indique le point à partir duquel l'IPL redémarre lorsque le paramètre de type d'application de PTF (INSTYP) précise qu'un IPL va être effectué.
Remarque :Cette option n'est admise que si INSTYP a pour valeur *DLYIPL ou si INSTYP(*SRVATT) est indiqué et que l'attribut de maintenance de type d'installation de PTF (PTFINSTYP) a pour valeur *DLYIPL.
- *IPLA
- La valeur indiquée dans la commande Modifier les attributs d'IPL (CHGIPLA) est utilisée. Pour déterminer cette valeur, utilisez la commande Afficher les attributs d'IPL (DSPIPLA).
- *SYS
- Le système détermine la partie du système à redémarrer.
Le système d'exploitation est toujours redémarré. Le matériel ne redémarre que si une PTF requérant un redémarrage est appliquée. D'autres fonctions matérielles qui s'exécutent lors d'un IPL *FULL, par exemple, certaines modifications de configuration, ne sont pas traitées.
*SYS peut vous permettre d'obtenir une durée d'IPL plus courte que si *FULL était indiquée.
- *FULL
- Tout le système, y compris le matériel, est redémarré.
Invite pour support (PMTMED)
Indique si vous souhaitez que le programme demande des définitions de volume de PTF supplémentaires et vous invite à charger des PTF à partir de *SERVICE après le chargement des PTF à partir d'une unité.
Remarque :Ce paramètre est ignoré lorsque *SERVICE ou *NONE est spécifié pour le paramètre Unité (DEV).
- *SNGVOLSET
- L'utilisateur sera invité à monter chaque volume individuellement dans une définition de volume au moment du chargement des PTF. Si une unité optique virtuelle est définie dans le paramètre DEV, tous les volumes de PTF montés seront traités.
- *MLTVOLSET
- L'utilisateur sera invité à monter les volumes dans plusieurs définitions de volume au moment du chargement des PTF.
- *MLTSRV
- L'utilisateur sera invité à monter les volumes dans plusieurs définitions de volume au moment du chargement des PTF. Une fois que les PTF seront chargées à partir du dernier volume, elles seront chargées à partir du service de maintenance (*SERVICE).
Copier les PTF (CPYPTF)
Permet d'indiquer si les fichiers sauvegarde et les lettres d'accompagnement des PTF doivent être copiés dans *SERVICE lorsque celles-ci sont chargées. Les fichiers sauvegarde de PTF doivent se trouver dans *SERVICE lors de la distribution de PTF sur d'autres systèmes ou lors de l'utilisation de la commande SAVSYSINF.
Remarque :Ce paramètre est ignoré si DEV(*SERVICE) ou DEV(*NONE) est précisé.
- *SRVATT
- L'attribut de maintenance CPYPTF précise si les fichiers sauvegarde et les lettres d'accompagnement des PTF seront copiés dans *SERVICE une fois les PTF chargées. La commande DSPSRVA affiche des informations sur la configuration du système. Ces informations indiquent notamment si les fichiers sauvegarde et les lettres d'accompagnement des PTF seront copiés dans *SERVICE lorsque celles-ci seront chargées. La commande CHGSRVA peut être utilisée pour modifier l'attribut de maintenance CPYPTF.
- *YES
- Les fichiers sauvegarde et les lettres d'accompagnement des PTF qui n'existent pas encore sont copiés dans *SERVICE lorsque celles-ci sont chargées.
- *NO
- Les fichiers sauvegarde et les lettres d'accompagnement des PTF ne sont pas copiés dans *SERVICE lorsque celles-ci sont chargées.
Exemples
Exemple 1 : omission de PTF
INSPTF LICPGM((*ALL)) DEV(*SERVICE) INSTYP(*IMMDLY)
OMIT((57xx999 MF12345 VxRyMz) (57xxSS1 SI12345 VxRyMz))
Cette commande va charger toutes les PTF qui se trouvent dans *SERVICE pour tous les produits installés sur le système, à l'exception de MF12345 et SI12345. Elle applique ensuite toutes les PTF dont chargées pouvant être appliquées immédiatement et marquent les autres pour une application différée.
Exemple 2 : installation de HIPER uniquement
INSPTF LICPGM((57xxPT1 VxRyMz)) DEV(TAP01) INSTYP(*IMMONLY)
HIPER(*YES)
Cette commande permet de rechercher dans la section HIPER du support les PTF relatives à l'édition VxRyMz du produit Performance Tools. Toutes les PTF pouvant être appliquées immédiatement le seront. Les PTF différées seront chargées mais pas marquées pour application.
Exemple 3 : installation des PTF immédiates uniquement
INSPTF LICPGM((*ALL)) DEV(TAP01) INSTYP(*IMMONLY)
ENDOPT(*LEAVE)
Cette commande va charger toutes les PTF pour tous les produits installés sur le système, à partir de l'unité TAP01. Toutes les PTF chargées du système pouvant être appliquées immédiatement seront appliquées. Aucune PTF différée ne sera définie pour application.
Messages d'erreur
Messages *ESCAPE
- CPF358A
- Édition non valide. Release not valid.
- CPF358F
- Le paramètre LICPGM contient des entrées en double.
- CPF35EB
- Plusieurs éditions du produit &1 installées.
- CPF3586
- Liste de PTF incorrecte.
- CPF36BF
- Procédure d'installation des PTF incomplète ; IPL obligatoire.
- CPF3606
- Produit &1 &3 non installé.
- CPF361A
- Les PTF ont été installées mais il y a des actions en instance.
- CPF361B
- L'installation des PTF a échoué et il y a des actions en instance.
- CPF361C
- Aucune PTF n'a été installée.
- CPF3615
- L'installation des PTF a échoué.
- CPF3618
- Le mode n'est pas en position Normal.
- CPF362E
- IPL obligatoire pour terminer le processus d'installation des PTF.
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.