RTVDIRINF

Extraire infos répertoire

En bref

La commande RTVDIRINF permet de collecter des attributs pour les répertoires et les fichiers du système de fichiers intégré.

RTVDIRINF se lit RTV (Extraire (récupérer)) + DIRINF. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

RTVDIRINF DIR(…)

Paramètres

DIR Répertoire obligatoire
SUBTREE Branche du répertoire
INFFILEPFX Préfixe fichier d'informations
INFLIB Bibliothèque d'informations
OMIT Omettre

Astuce : dans une session 5250, tapez RTVDIRINF 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 RTVDIRINF permet de collecter des attributs pour les répertoires et les fichiers du système de fichiers intégré. Les informations collectées sont stockées dans les fichiers base de données nommés à l'aide du préfixe du fichier d'informations indiqué par le paramètre INFFILEPFX. Les fichiers sont créés dans la bibliothèque indiquée par le paramètre INFLIB.

Vous pouvez exécuter la commande PRTDIRINF pour imprimer des rapports à l'aide des informations de répertoire extraites.

Pour obtenir des résultats plus pointus, cette commande doit être exécutée lorsque l'activité est faible pour les fichiers du répertoire indiqué. Si SUBTREE(*ALL) est indiqué, essayez d'exécuter cette commande lorsque l'activité est faible pour les fichiers de tous les sous-répertoires du répertoire indiqué.

Remarque :S'il existe plus d'un membre dans les fichiers, les résultats de l'exécution de cette commande sont imprévisibles.

La fonction de table QSYS2.IFS_OBJECT_STATISTICS renvoie des informations similaires.

Restrictions :

Les informations répertoire peuvent être extraites uniquement pour les systèmes de fichiers montés.
Les informations répertoire peuvent être extraites uniquement pour les systèmes de fichiers locaux.
Vous devez disposer du droit spécial sur tous les objets (*ALLOBJ) pour exécuter cette commande.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
DIR	Répertoire	Chemin d'accès	Obligatoire, positionnel 1
SUBTREE	Branche du répertoire	ALL, NONE	Facultatif
INFFILEPFX	Préfixe fichier d'informations	Nom simple, *GEN	Facultatif
INFLIB	Bibliothèque d'informations	Nom, QUSRSYS	Facultatif
OMIT	Omettre	Values (jusqu'à 300 répétitions): Chemin d'accès	Facultatif

Répertoire (DIR)

Indique le nom de chemin d'accès à l'objet du système de fichiers intégré pour lequel des informations sont collectées.

Pour obtenir de plus amples informations relatives à la spécification des noms de chemin, reportez-vous à "Object naming rules" dans la rubrique Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Ce paramètre est obligatoire.

nom-chemin-répertoire: Indique le nom de chemin de l'objet du système de fichiers intégré.

Branche du répertoire (SUBTREE)

Indique si la collecte des informations répertoire des sous-répertoires du répertoire indiqué par le paramètre DIR doit être effectuée.

*ALL: Les informations répertoire des sous-répertoires du répertoire indiqué seront collectées.
*NONE: Les informations répertoire seront uniquement collectées pour les fichiers du répertoire indiqué. Aucune information répertoire ne sera collectée pour les sous-répertoires.

Préfixe fichier d'informations (INFFILEPFX)

Indique le préfixe du nom de fichier des fichiers base de données dans lesquels les informations répertoire extraites doivent être stockées.

*GEN: Les fichiers base de données seront créés avec un préfixe unique généré par cette commande. Le préfixe commencera par les lettres QAEZD suivies de quatre chiffres. Les fichiers créés pour le stockage des informations collectées seront nommés à l'aide de ce préfixe suivi de la lettre "D" (pour le fichier contenant les informations répertoire) ou la lettre "O" (pour le fichier contenant les informations relatives aux objets des répertoires). Par exemple, la première fois que la commande est exécutée avec *GEN indiqué, les fichiers QAEZD0001D et QAEZD0001O seront créés dans la bibliothèque indiquée par le paramètre INFLIB. Le message informatif CPI1E30 sera envoyé au journal des travaux et contiendra le nom des fichiers créés.
préfixe-fichier-informations: Indiquez le préfixe de fichier à utiliser pour la création des fichiers base de données utilisés pour stocker les informations répertoire collectées. Le préfixe peut comporter jusqu'à neuf lettres. Les fichiers créés pour le stockage des informations collectées seront nommés à l'aide de ce préfixe suivi de la lettre "D" (pour le fichier contenant les informations répertoire) ou la lettre "O" (pour le fichier contenant les informations relatives aux objets des répertoires). Par exemple, si le préfixe indiqué est MYDIR, les fichiers base de données MYDIRD et MYDIRO seront créés dans la bibliothèque indiquée par le paramètre INFLIB.

Bibliothèque d'informations (INFLIB)

Indique la bibliothèque dans laquelle les fichiers base de données utilisés pour le stockage des informations répertoire seront créés.

QUSRSYS: Les fichiers seront créés dans la bibliothèque QUSRSYS.
nom-bibliothèque: Indiquez le nom de la bibliothèque pour créer les fichiers base de données.

Omettre (OMIT)

Indique un maximum de 300 répertoires de système de fichiers intégré pour lesquels les informations ne seront pas collectées.

nom-chemin

Indiquez le nom de l'objet à omettre des informations collectées.

Il est possible d'indiquer un modèle dans la dernière partie du nom de chemin. Un astérisque (*) correspond à un nombre quelconque de caractères, alors qu'un point d'interrogation (?) correspond à un seul caractère. Si le nom de chemin est qualifié ou contient un modèle, il doit figurer entre apostrophes. Les liens symboliques du nom de chemin ne seront pas suivis. S'il figure au début du nom de chemin, le caractère tilde indique que le chemin d'accès est relatif au répertoire personnel approprié. Lors de l'opération permettant de déterminer si un nom correspond à un modèle, on considère toujours que les modèles de noms relatifs se rapportent au répertoire de travail en cours.

Pour plus d'informations sur les modèles de noms de chemins, reportez-vous au manuel Rubriques Système de fichiers intégré de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Remarque :Ce paramètre est compatible Unicode. Pour plus d'informations, reportez-vous à la section sur la prise en charge Unicode dans CL, dans les Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Exemples

Exemple 1 : extraction des informations, y compris celles des sous-répertoires

RTVDIRINF   DIR('/MYDIR/MYDOCS')  SUBTREE(*ALL)
            INFFILEPFX(*GEN) INFLIB(QUSRSYS)

Cette commande extrait les informations répertoire relatives au répertoire /MYLIB/MYDOCS, y compris les informations de tous les sous-répertoires, et les stocke dans les fichiers base de données créés dans la bibliothèque QUSRSYS. Les fichiers base de données seront créés avec des noms uniques commençant par les lettres "QAEZD" suivies de quatre chiffres. Si c'est la première fois que la commande RTVDIRINF est exécutée, les noms de fichier seront QAEZD0001O et QAEZD0001D.

Exemple 2 : extraction d'informations uniquement pour le répertoire indiqué

RTVDIRINF   DIR('/')  SUBTREE(*NO)  INFFILEPFX(MYROOTDIR)
            INFLIB(MYLIB)

Cette commande extrait les informations répertoire relatives au répertoire racine sans inspection des sous-répertoires imbriqués et les stocke dans les fichiers base de données MYROOTDIRO et MYROOTDIRD de la bibliothèque MYLIB. Si des fichiers base de données portant l'un de ces noms existent déjà dans la bibliothèque MYLIB, un message d'erreur sera envoyé et aucune information répertoire ne sera extraite.

Exemple 3 : Extraction d'informations, inclusion de sous-répertoires et omission de certains répertoires

RTVDIRINF   DIR('/')  SUBTREE(*ALL)  INFFILEPFX(MYROOTDIR)
            INFLIB(MYLIB)  OMIT('/QSYS.LIB' '/QDLS' '/QOPT')

Cette commande permet d'extraire les informations de répertoire relatives au répertoire principal, y compris les informations sur tous les sous-répertoires imbriqués, mais pas les informations concernant les répertoires '/QSYS.LIB', '/QDLS' et '/QOPT' ni leurs sous-répertoires. Elle stocke ces informations dans les fichiers base de données MYROOTDIRO et MYROOTDIRD de la bibliothèque MYLIB. Si des fichiers base de données portant l'un de ces noms existent déjà dans la bibliothèque MYLIB, un message d'erreur sera envoyé et aucune information répertoire ne sera extraite.

Messages d'erreur

Messages *ESCAPE

CPFA08E: Plusieurs noms correspondent au masque.
CPFA093: Aucun nom ne correspond au masque indiqué.
CPFA09C: Aucun droit sur l'objet. L'objet est &1.
CPFA0A1: Erreur d'entrée ou de sortie.
CPFA0A3: La résolution du nom de chemin provoque une boucle.
CPFA0A6: Le nombre de liens dépasse la limite admise par le système de fichiers.
CPFA0A7: Le nom de chemin est trop long.
CPFA0A9: Objet introuvable. L'objet est &1.
CPFA0AA: Une erreur s'est produite pendant l'allocation d'espace.
CPFA0AB: Erreur d'opération pour l'objet. L'objet est &1.
CPFA0AD: Fonction non acceptée par le système de fichiers.
CPFA0B2: Aucun objet ne correspond à la demande.
CPF1ED2: Fichier &1 en cours d'utilisation ; accès impossible.
CPF1ED4: Vous n'êtes pas autorisé à collecter les informations du répertoire.
CPF1E99: Erreur non prévue.