QSYS2.IFS_OBJECT_STATISTICS

À quoi ça sert

La fonction de table part d'un chemin (START_PATH_NAME) et renvoie une ligne par objet : type, lien symbolique, numéro d'ASP, description, horodatages de création, d'accès, de modification des données et de l'objet, dernière utilisation et nombre de jours d'utilisation, taille allouée et taille des données, CCSID, page de codes, nombre de liens physiques, attributs (lecture seule, masqué, temporaire), propriétaire, identifiants numériques d'utilisateur et de groupe, groupe principal et liste d'autorisation.

Quatre paramètres encadrent le parcours : SUBTREE_DIRECTORIES (défaut YES) pour descendre ou non dans les sous-répertoires, OBJECT_TYPE_LIST pour limiter les types, OMIT_LIST pour exclure des éléments et IGNORE_ERRORS (défaut YES). L'exemple d'IBM liste d'abord /usr seul, puis son arbre complet.

Avec SQL, on trie par taille pour trouver les plus gros fichiers, on filtre par date pour ménager un nettoyage, ou on contrôle les propriétaires, ce que WRKLNK ne fait pas en une seule requête.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

SELECT PATH_NAME, OBJECT_TYPE, DATA_SIZE, OBJECT_OWNER 
    FROM TABLE (QSYS2.IFS_OBJECT_STATISTICS(START_PATH_NAME => '/usr', 
                                    SUBTREE_DIRECTORIES => 'NO'))

Ce que l'IBM i a renvoyé le 01/10/2026 (5 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

Lister les informations de base de tous les objets du répertoire /usr, avec ou sans ses sous-répertoires.

-- Description: List basic information for all the objects in directory /usr. 
    SELECT PATH_NAME, OBJECT_TYPE, DATA_SIZE, OBJECT_OWNER 
    FROM TABLE (QSYS2.IFS_OBJECT_STATISTICS(START_PATH_NAME => '/usr', 
                                    SUBTREE_DIRECTORIES => 'NO')); 
        -- Description: List basic information for  all the objects in /usr, processing all 
  -- subdirectories as well. 
    SELECT PATH_NAME, OBJECT_TYPE, DATA_SIZE, OBJECT_OWNER 
    FROM TABLE (QSYS2.IFS_OBJECT_STATISTICS(START_PATH_NAME => '/usr', 
                                    SUBTREE_DIRECTORIES => 'YES'));

Paramètres

Colonnes renvoyées (90)