SYSTOOLS.PTF_COVER_LETTER

À quoi ça sert

Une lettre d'accompagnement décrit ce que corrige une PTF, les prérequis, les instructions spéciales et la nécessité d'un IPL. Cette fonction de table prend l'identifiant de la PTF (PTF_ID) et renvoie ses lignes dans LINE_NUMBER et PTF_COVER_LETTER_LINE.

Le paramètre IGNORE_ERRORS vaut YES par défaut : une PTF sans lettre disponible ne fait pas échouer toute la requête. L'exemple IBM lit les lettres de toutes les PTF chargées mais non appliquées, en joignant la fonction à QSYS2.PTF_INFO, ce qui permet de relire les consignes avant une installation.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

WITH PTFS (PTF_ID) AS ( 
    SELECT PTFID FROM QSYS2.PTF_INFO 
      WHERE PTF_COVER_LETTER = 'YES' AND  
            PTF_LOADED_STATUS = 'LOADED') 
 SELECT PTF_ID, C.* 
  FROM PTFS, TABLE (SYSTOOLS.PTF_COVER_LETTER(PTF_ID)) C 
  ORDER BY 1, 2

Aucune ligne : aucune PTF installée n'a de lettre d'accompagnement chargée.

L'exemple d'IBM

Renvoyer les lettres d'accompagnement de toutes les PTF chargées mais non appliquées.

-- Description: Return cover letters for any PTFs that have been loaded but not applied. 
  WITH PTFS (PTF_ID) AS ( 
    SELECT PTFID FROM QSYS2.PTF_INFO 
      WHERE PTF_COVER_LETTER = 'YES' AND  
            PTF_LOADED_STATUS = 'LOADED') 
 SELECT PTF_ID, C.* 
  FROM PTFS, TABLE (SYSTOOLS.PTF_COVER_LETTER(PTF_ID)) C 
  ORDER BY 1, 2;

Paramètres

Colonnes renvoyées (2)