Installer des PTF sur IBM i, de Fix Central à l'IPL

Les types de PTF

On n'installe presque jamais une PTF seule : on installe des groupes, suivis par un numéro de niveau. Une PTF immédiate s'applique à chaud ; une PTF différée attend le prochain IPL. Toutes les PTF du microcode sont différées.

Les groupes proposés par Fix Central en 7.5

Le « Résumé » est le libellé affiché par Fix Central. Un groupe propre à un produit ne sert que si ce produit est installé.

En 7.4 et 7.6, les numéros changent : cumulatif SF99740 / SF99760, HIPER SF99739 / SF99969, Sécurité SF99738 / SF99968, Technology Refresh SF99737 / SF99956, Db2 SF99704 / SF99960. Les niveaux évoluent sans cesse : les lire sur Fix Central, jamais de mémoire.

Le côté A et le côté B du microcode

Le microcode (LIC, produit 5770999) est stocké en deux exemplaires. La « source de l'IPL » indique celui sur lequel la machine a démarré.

Sur un écran en français (CCSID 297), le caractère # s'affiche £ : ££MACH£B et ##MACH#B sont la même valeur. La HMC combine source et mode : B N = côté B, mode Normal (M = Manuel, l'IPL s'arrête sur les écrans DST).

Les statuts d'une PTF

Les prérequis

Avant de commander, lire le PSP (SNDPTFORD PTFID(SF98750)) et le PTF Guide hebdomadaire d'IT Jungle : un groupe publié la veille mérite cette vérification.

Étape 1 : l'état des lieux

Ces requêtes ne modifient rien. Le niveau installé de chaque groupe, par QSYS2.GROUP_PTF_INFO (le système garde l'historique des niveaux, d'où le MAX) :

SELECT PTF_GROUP_NAME, PTF_GROUP_DESCRIPTION,
       MAX(PTF_GROUP_LEVEL) AS NIVEAU_INSTALLE
  FROM QSYS2.GROUP_PTF_INFO
 WHERE PTF_GROUP_TARGET_RELEASE = 'V7R5M0'
   AND PTF_GROUP_STATUS = 'INSTALLED'
 GROUP BY PTF_GROUP_NAME, PTF_GROUP_DESCRIPTION
 ORDER BY PTF_GROUP_NAME;

Les produits installés, par QSYS2.SOFTWARE_PRODUCT_INFO :

SELECT PRODUCT_ID, TEXT_DESCRIPTION
  FROM QSYS2.SOFTWARE_PRODUCT_INFO
 WHERE PRODUCT_OPTION = '*BASE'
   AND INSTALLED = 'YES'
   AND PRODUCT_ID IN ('5770PT1', '5770BR1', '5770DG1', '5770JV1', '5770DBM');

Si la machine accède à Internet, SYSTOOLS.GROUP_PTF_CURRENCY fait la comparaison avec IBM en une requête :

SELECT PTF_GROUP_ID, PTF_GROUP_TITLE,
       PTF_GROUP_LEVEL_INSTALLED, PTF_GROUP_LEVEL_AVAILABLE,
       PTF_GROUP_CURRENCY
  FROM SYSTOOLS.GROUP_PTF_CURRENCY
 ORDER BY PTF_GROUP_ID;

Règle de décision : niveau disponible plus haut que l'installé, on prend ; niveaux égaux, on ne prend pas ; groupe jamais installé, on le prend seulement si le produit est présent. Le choix fait pour cette campagne :

Étape 2 : commander sur Fix Central

Le type de machine et le numéro de série se lisent sur l'IBM i : DSPSYSVAL QSRLNBR pour le numéro de série (7 caractères, sans tiret), WRKHDWRSC TYPE(*PRC) option 7 pour le type (4 chiffres, 9009 pour un Power S922). Sur une partition, ce sont les valeurs du serveur physique.

Choisir la livraison par Download Director : plusieurs connexions, reprise sur coupure. Les champs FTPS restent sans effet avec ce choix.

L'état Resume Pending signifie qu'IBM prépare les images : rien n'est téléchargeable avant l'heure de Commande disponible après, ici un quart d'heure. « Inclut des éléments prérequis : true » : IBM a pu ajouter des prérequis, à garder.

Étape 3 : télécharger avec Download Director

La commande livre trois fichiers : deux volumes .BIN et le manifeste .TXT. Télécharger sur le PC, puis autoriser IBM Download Director.

Étape 4 : transférer les images dans l'IFS

Un sous-répertoire par commande IBM, pour ne jamais mélanger les campagnes :

MKDIR DIR('/fixes/S7120')

Dans ACS, Système de fichiers intégré, y glisser les trois fichiers depuis le poste. La case Stocker dans un fichier texte UTF-8 doit rester décochée : cochée, elle convertirait les images.

Le contrôle à l'octet, par QSYS2.IFS_OBJECT_STATISTICS :

SELECT PATH_NAME, DATA_SIZE
  FROM TABLE(QSYS2.IFS_OBJECT_STATISTICS(
       START_PATH_NAME => '/fixes/S7120', SUBTREE_DIRECTORIES => 'NO'))
 ORDER BY PATH_NAME;

Étape 5 : contrôler avant l'installation

La machine doit tourner sur le côté B (DSPPTF) :

DSPPTF LICPGM(5770999)

Aucune PTF ne doit rester en attente d'une campagne précédente (QSYS2.PTF_INFO) :

SELECT COUNT(*) AS PTF_EN_ATTENTE
  FROM QSYS2.PTF_INFO
 WHERE PTF_LOADED_STATUS = 'LOADED';

Étape 6 : l'unité optique virtuelle

Le catalogue d'images s'insère dans une unité optique virtuelle, comme un DVD dans un lecteur. Le type 632B est l'unité virtuelle ; le type 632C, créé par autoconfiguration, est un lecteur virtualisé par le serveur hôte : ne pas y toucher.

Pour repartir d'une base propre, l'unité a été supprimée puis recréée :

/* Si un catalogue est « Prêt », le décharger d'abord */
LODIMGCLG IMGCLG(NOM_CATALOGUE) OPTION(*UNLOAD)

VRYCFG CFGOBJ(OPTVRT01) CFGTYPE(*DEV) STATUS(*OFF)
DLTDEVD DEVD(OPTVRT01)
CRTDEVOPT DEVD(OPTVRT01) RSRCNAME(*VRT) ONLINE(*YES) TEXT('Unité optique virtuelle PTF')
VRYCFG CFGOBJ(OPTVRT01) CFGTYPE(*DEV) STATUS(*ON)
WRKCFGSTS CFGTYPE(*DEV) CFGD(OPTVRT01)

CRTDEVOPT avec RSRCNAME(*VRT) crée une unité sans matériel ; ONLINE(*YES) la remet en fonction à chaque IPL. VRYCFG la met en ou hors fonction, WRKCFGSTS affiche son état.

Étape 7 : le catalogue d'images

Convention de nommage : PTF suivi du nom de la commande IBM, ici PTFS7120.

CRTIMGCLG IMGCLG(PTFS7120) DIR('/fixes/S7120') TYPE(*OPT) TEXT('PTF HIPER Secu HTTP')
ADDIMGCLGE IMGCLG(PTFS7120) FROMFILE('S7120V01.BIN') TOFILE(*FROMFILE)
ADDIMGCLGE IMGCLG(PTFS7120) FROMFILE('S7120V02.BIN') TOFILE(*FROMFILE)
LODIMGCLG IMGCLG(PTFS7120) DEV(OPTVRT01)
VFYIMGCLG IMGCLG(PTFS7120) TYPE(*PTF) SORT(*YES)
WRKIMGCLGE IMGCLG(PTFS7120)

• CRTIMGCLG crée le catalogue sur le répertoire des images. TYPE(*OPT) : la valeur *PTF n'existe pas ici.
• ADDIMGCLGE ajoute un volume ; dans l'ordre, V01 puis V02.
• LODIMGCLG insère le catalogue dans l'unité virtuelle.
• VFYIMGCLG TYPE(*PTF) vérifie que les images forment un jeu de PTF complet ; SORT(*YES) les remet dans l'ordre.
• WRKIMGCLGE affiche les volumes et leur état.

Étape 8 : installer

Certaines PTF du groupe HTTP refusent de s'appliquer tant que QHTTPSVR tourne. On l'arrête (ENDSBS), et on reçoit en direct les messages importants de QSYSOPR (CHGMSGQ) :

ENDSBS SBS(QHTTPSVR) OPTION(*CNTRLD) DELAY(10)
CHGMSGQ MSGQ(QSYSOPR) DLVRY(*BREAK) SEV(70)

Puis l'installation, par INSPTF :

INSPTF LICPGM(*ALL) DEV(OPTVRT01) INSTYP(*IMMDLY)

Phase 1, le chargement : les PTF sont copiées depuis les images, produit par produit. Le clavier est verrouillé : ne rien toucher, ne pas fermer la session.

Phase 2, l'application : seules les PTF immédiates s'appliquent à chaud, 11 ici. Les autres attendent l'IPL.

Étape 9 : contrôler avant l'IPL

SELECT PTF_GROUP_NAME, PTF_GROUP_LEVEL, PTF_GROUP_STATUS
  FROM QSYS2.GROUP_PTF_INFO
 WHERE PTF_GROUP_NAME IN ('SF99959','SF99958','SF99952')
 ORDER BY PTF_GROUP_NAME, PTF_GROUP_LEVEL DESC;

SELECT PTF_PRODUCT_ID, PTF_IPL_REQUIRED, PTF_IPL_ACTION, COUNT(*) AS NB
  FROM QSYS2.PTF_INFO
 WHERE PTF_LOADED_STATUS = 'LOADED'
 GROUP BY PTF_PRODUCT_ID, PTF_IPL_REQUIRED, PTF_IPL_ACTION
 ORDER BY PTF_PRODUCT_ID;

Étape 10 : l'IPL sur le côté B

PWRDWNSYS OPTION(*CNTRLD) DELAY(600) RESTART(*YES) IPLSRC(B)

PWRDWNSYS : arrêt contrôlé, 600 secondes laissées aux travaux pour finir, redémarrage automatique sur le côté B. Sur une machine de formation, le délai a été ramené à 10 secondes : sans risque pour les PTF, mais à éviter en production.

Pendant l'IPL, la machine ne répond plus au ping : TCP/IP ne redémarre qu'en fin d'IPL. Ici, le ping est revenu quatre minutes après l'arrêt. Un IPL avec PTF est plus long qu'un IPL normal : ne jamais l'interrompre.

Étape 11 : vérifier après l'IPL

Puis les messages (DSPMSG QSYSOPR : aucun CPF35xx) et les services (WRKACTJOB). Relancer ce qui n'est pas reparti :

STRTCPSVR SERVER(*SSHD)
STRSBS SBSD(QSYS/QHTTPSVR)

Les sous-systèmes redémarrés automatiquement

À l'IPL, le système démarre le sous-système de contrôle, qui lance le programme de démarrage ; c'est lui qui démarre les autres sous-systèmes.

DSPSYSVAL SYSVAL(QCTLSBSD)    /* en général QCTL ou QBASE */
DSPSYSVAL SYSVAL(QSTRUPPGM)   /* en général QSYS/QSTRUP   */

La liste des STRSBS du programme de démarrage, par RTVCLSRC (créer QGPL/QCLSRC s'il n'existe pas) :

RTVCLSRC PGM(QSYS/QSTRUP) SRCFILE(QGPL/QCLSRC) SRCMBR(QSTRUP)
DSPPFM FILE(QGPL/QCLSRC) MBR(QSTRUP)

Les travaux lancés par les sous-systèmes eux-mêmes (QSYS2.AUTOSTART_JOB_INFO), puis l'état réel (QSYS2.SUBSYSTEM_INFO) :

SELECT * FROM QSYS2.AUTOSTART_JOB_INFO ORDER BY 1;

SELECT SUBSYSTEM_DESCRIPTION_LIBRARY, SUBSYSTEM_DESCRIPTION, STATUS
  FROM QSYS2.SUBSYSTEM_INFO
 ORDER BY STATUS, SUBSYSTEM_DESCRIPTION;

Un sous-système prévu par le programme de démarrage mais INACTIVE n'a pas redémarré : chercher la cause dans DSPLOG ou QSYSOPR. Voir aussi Travaux et sous-systèmes.

Finaliser : permanent et nettoyage

Après quelques semaines sans incident, appliquer les PTF en permanent : cela libère de l'espace, recopie les PTF LIC sur le côté A et évite le CPF3575 aux campagnes suivantes. C'est irréversible.

APYPTF LICPGM(*ALL) SELECT(*ALL) APY(*PERM) DELAYED(*YES)

LODIMGCLG IMGCLG(PTFS7120) OPTION(*UNLOAD)
DLTIMGCLG IMGCLG(PTFS7120) KEEP(*NO)    /* supprime aussi les .BIN */

DLTIMGCLG KEEP(*YES) supprime un ancien catalogue en gardant ses fichiers. Conserver le manifeste .TXT et les résultats des requêtes avant et après.

Les erreurs à ne pas commettre

Les messages cités : CPF3583, CPF3575, CPF3632, CPF0006.

Sources

Consultées le 28 octobre 2026.

1. Fix Central, IBM. La commande des groupes de PTF et la livraison par Download Director.
2. IBM i Group PTFs with level, IBM Support. Les numéros et les derniers niveaux des groupes de PTF par version.
3. PTFs FAQs : question and answers, IBM Support. PTF immédiates et différées, application temporaire et permanente.
4. IT Jungle, IT Jungle. Le PTF Guide hebdomadaire : nouveaux groupes et PTF défectueuses.

Questions fréquentes