QSYS2.SAVE_FILE_OBJECTS

À quoi ça sert

Ce service existe sous deux formes : une vue et une fonction de table. Les deux renvoient, pour chaque objet sauvegardé, le fichier de sauvegarde (SAVE_FILE_LIBRARY, SAVE_FILE), la bibliothèque, le nom, le type et l'attribut de l'objet, le texte, l'horodatage de sauvegarde, la taille, le propriétaire et les informations d'ASP, ainsi que le nom et le chemin pour les objets de bibliothèque de documents.

La fonction de table se pilote avec SAVE_FILE et SAVE_FILE_LIBRARY (*LIBL par défaut), les filtres OBJECT_NAME_FILTER et OBJECT_TYPE_FILTER (*ALL par défaut) et DETAILED_INFO (NONE par défaut). Avec DETAILED_INFO à ALL, on obtient des détails supplémentaires, comme les fichiers spoule sauvegardés dans une file de sortie. IGNORE_ERRORS vaut YES par défaut.

Le SQL permet de retrouver dans quel fichier de sauvegarde se trouve un objet, par exemple pour préparer une restauration, ce que l'affichage de chaque fichier avec DSPSAVF ne permet pas de faire en une seule requête.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

SELECT OBJECT_NAME, OBJECT_TYPE, LIBRARY_NAME FROM TABLE(QSYS2.SAVE_FILE_OBJECTS(SAVE_FILE => 'DEMOSAVF', SAVE_FILE_LIBRARY => 'JOBISQL'))

Ce que l'IBM i a renvoyé le 01/10/2026 (3 lignes au plus) :

Données anonymisées : les noms de système, de profils, de bibliothèques, de postes et les adresses IP ont été remplacés. Les objets du schéma JOBISQL sont des objets de démonstration créés pour ce site.

L'exemple d'IBM

Trouver tous les fichiers de sauvegarde qui contiennent des objets *FILE dont le nom commence par CUST, en soumettant la requête en traitement par lots (vue), ou lister les fichiers spoule sauvegardés dans le fichier de sauvegarde MYLIB/SAVF1 (fonction de table).

-- Description: Find all the save files used to save any *FILE objects with names  
  -- that begin with 'CUST'. Since this can be a long-running query, submit it as a  
  -- batch job. The RUNSQL CL command is used to run the SQL statement and return the  
  -- results in a table in MYLIB. 
 QSYS/SBMJOB CMD(QSYS/RUNSQL 
   SQL('CREATE TABLE MYLIB.SAVF_CUST AS ( 
     SELECT SAVE_FILE_LIBRARY, SAVE_FILE, LIBRARY_NAME, OBJECT_NAME, SAVE_TIMESTAMP  
        FROM QSYS2.SAVE_FILE_OBJECTS  
        WHERE OBJECT_NAME LIKE ''CUST%'') WITH DATA')  
 COMMIT(*NONE)) JOB(SAVFLIST)

-- Description: List all the spooled files saved in the MYLIB/SAVF1 save file. 
 SELECT LIBRARY_NAME CONCAT '/' CONCAT OBJECT_NAME AS OUTPUT_QUEUE, SPOOLED_FILE_NAME, 
       SPOOLED_FILE_NUMBER, CREATE_TIMESTAMP 
  FROM TABLE (QSYS2.SAVE_FILE_OBJECTS(SAVE_FILE => 'SAVF1', SAVE_FILE_LIBRARY => 'MYLIB', 
                                    OBJECT_TYPE_FILTER => '*OUTQ', DETAILED_INFO => 'ALL'));

Paramètres

Colonnes renvoyées (15)