Aller au contenu

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

  • LICPGM Description de produit obligatoire
  • DEV Unité
  • INSTYP Type d'application de PTF
  • OMIT Liste des PTF à omettre
  • HIPER PTF HIPER uniquement
  • ENDOPT Option de fin de support
  • RESTART Type de redémarrage
  • PMTMED Invite pour support
  • CPYPTF Copier 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.