Service SQL IBM i (AS/400) · Fonction table
QSYS2.IFS_OBJECT_REFERENCES_INFO
Références courantes d'un objet de l'IFS
Donne l'état d'utilisation d'un objet de l'IFS : nombre de références, ouvertures par mode et verrous en cours, tous travaux confondus.
À quoi ça sert
La fonction de table prend un chemin (PATH_NAME) et renvoie une seule ligne de synthèse : nombre de références, indicateur d'utilisation en cours (IN_USE), nombre d'ouvertures en lecture seule, écriture seule, lecture/écriture et exécution seule, nombre d'accès partagés, verrous d'attribut, de sauvegarde et de modification de liens, objet extrait et par qui.
Avec DETAILED_INFO => 'YES' (défaut NO), elle ajoute la ventilation entre mode d'ouverture et mode de partage, ainsi que les compteurs de répertoires courants, de répertoires racine et de références des serveurs de fichiers et NFS. IGNORE_ERRORS vaut YES par défaut.
Elle répond à la question : cet objet est-il utilisé en ce moment ? Pour savoir par quels travaux, utilise ensuite QSYS2.IFS_OBJECT_LOCK_INFO.
Résultat réel sur un IBM i 7.5
Ce que nous avons exécuté :
SELECT * FROM TABLE(QSYS2.IFS_OBJECT_REFERENCES_INFO(PATH_NAME => '/tmp/jobisql/bonjour.txt'))Ce que l'IBM i a renvoyé le 01/10/2026 (1 ligne au plus) :
| PATH_NAME Chemin | REFERENCE_COUNT Nombre de références | IN_USE En cours d'utilisation | RO_COUNT Nombre d'accès en lecture seule | WO_COUNT Nombre d'ouvertures en écriture seule | RW_COUNT Nombre d'accès en lecture/écriture | XO_COUNT Nombre d'ouvertures en exécution seule | SHARE_R_COUNT Nombre d'accès partagés en lecture | SHARE_W_COUNT Nombre d'accès partagés en écriture | SHARE_RW_COUNT Nombre d'accès partagés en lecture/écriture | SHARE_NONE_COUNT Nombre d'accès sans partage | ATTRIBUTE_LOCK Verrou d'attribut | SAVE_LOCK Verrou de sauvegarde | INTERNAL_SAVE_LOCK Verrou interne de sauvegarde | LINK_CHANGES_LOCK Verrou sur les modifications de liens | CHECKED_OUT Objet extrait | CHECKED_OUT_USER_NAME Nom de l'utilisateur ayant extrait l'objet | RO_SHARE_R_COUNT Nombre d'accès en lecture seule partagés en lecture | RO_SHARE_W_COUNT Nombre d'accès en lecture seule partagés en écriture | RO_SHARE_RW_COUNT Nombre d'accès en lecture seule partagés en lecture/écriture | RO_SHARE_NONE_COUNT Nombre d'accès en lecture seule sans partage | WO_SHARE_R_COUNT Ouvertures en écriture seule avec partage en lecture | WO_SHARE_W_COUNT Ouvertures en écriture seule avec partage en écriture | WO_SHARE_RW_COUNT Ouvertures en écriture seule avec partage lecture et écriture | WO_SHARE_NONE_COUNT Ouvertures en écriture seule sans partage | RW_SHARE_R_COUNT Nombre d'accès en lecture/écriture partagés en lecture | RW_SHARE_W_COUNT Nombre d'accès en lecture/écriture partagés en écriture | RW_SHARE_RW_COUNT Nombre d'accès en lecture/écriture partagés en lecture/écriture | RW_SHARE_NONE_COUNT Nombre d'accès en lecture/écriture sans partage | XO_SHARE_R_COUNT Ouvertures en exécution seule avec partage en lecture | XO_SHARE_W_COUNT Ouvertures en exécution seule avec partage en écriture | XO_SHARE_RW_COUNT Ouvertures en exécution seule avec partage lecture et écriture | XO_SHARE_NONE_COUNT Ouvertures en exécution seule sans partage | XR_SHARE_R_COUNT Ouvertures en lecture et exécution avec partage en lecture | XR_SHARE_W_COUNT Ouvertures en lecture et exécution avec partage en écriture | XR_SHARE_RW_COUNT Ouvertures en lecture et exécution avec partage lecture et écriture | XR_SHARE_NONE_COUNT Ouvertures en lecture et exécution sans partage | CURRENT_DIRECTORY_COUNT Nombre de répertoires courants | ROOT_DIRECTORY_COUNT Nombre de répertoires racine | FILE_SERVER_REFERENCE_COUNT Nombre de références du serveur de fichiers | FILE_SERVER_WORKING_DIRECTORY_COUNT Nombre de répertoires de travail du serveur de fichiers | NFS_SERVER_REFERENCE_COUNT Nombre de références au serveur NFS |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| /tmp/jobisql/bonjour.txt | 0 | NO | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | NO | NO | NO | NO | NO | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL | NULL |
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
Consulter les informations de référence actuelles de /usr/test1.
-- Description: Look at the current reference information for /usr/test1
SELECT * FROM TABLE(QSYS2.IFS_OBJECT_REFERENCES_INFO(PATH_NAME => '/usr/test1'));Paramètres
| Paramètre | Type | Par défaut | Signification |
|---|---|---|---|
PATH_NAME |
DOUBLE-BYTE CHAR LARGE OBJECT | obligatoire | Chemin |
DETAILED_INFO |
VARCHAR(3) | 'NO' | Informations détaillées |
IGNORE_ERRORS |
VARCHAR(3) | 'YES' | Ignorer les erreurs |
Colonnes renvoyées (42)
Afficher les 42 colonnes
| Colonne | Type | Signification |
|---|---|---|
PATH_NAME |
DOUBLE-BYTE CHAR LARGE OBJECT | Chemin |
REFERENCE_COUNT |
INTEGER | Nombre de références |
IN_USE |
VARCHAR(3) | En cours d'utilisation |
RO_COUNT |
INTEGER | Nombre d'accès en lecture seule |
WO_COUNT |
INTEGER | Nombre d'ouvertures en écriture seule |
RW_COUNT |
INTEGER | Nombre d'accès en lecture/écriture |
XO_COUNT |
INTEGER | Nombre d'ouvertures en exécution seule |
SHARE_R_COUNT |
INTEGER | Nombre d'accès partagés en lecture |
SHARE_W_COUNT |
INTEGER | Nombre d'accès partagés en écriture |
SHARE_RW_COUNT |
INTEGER | Nombre d'accès partagés en lecture/écriture |
SHARE_NONE_COUNT |
INTEGER | Nombre d'accès sans partage |
ATTRIBUTE_LOCK |
VARCHAR(3) | Verrou d'attribut |
SAVE_LOCK |
VARCHAR(3) | Verrou de sauvegarde |
INTERNAL_SAVE_LOCK |
VARCHAR(3) | Verrou interne de sauvegarde |
LINK_CHANGES_LOCK |
VARCHAR(3) | Verrou sur les modifications de liens |
CHECKED_OUT |
VARCHAR(3) | Objet extrait |
CHECKED_OUT_USER_NAME |
VARCHAR(10) | Nom de l'utilisateur ayant extrait l'objet |
RO_SHARE_R_COUNT |
INTEGER | Nombre d'accès en lecture seule partagés en lecture |
RO_SHARE_W_COUNT |
INTEGER | Nombre d'accès en lecture seule partagés en écriture |
RO_SHARE_RW_COUNT |
INTEGER | Nombre d'accès en lecture seule partagés en lecture/écriture |
RO_SHARE_NONE_COUNT |
INTEGER | Nombre d'accès en lecture seule sans partage |
WO_SHARE_R_COUNT |
INTEGER | Ouvertures en écriture seule avec partage en lecture |
WO_SHARE_W_COUNT |
INTEGER | Ouvertures en écriture seule avec partage en écriture |
WO_SHARE_RW_COUNT |
INTEGER | Ouvertures en écriture seule avec partage lecture et écriture |
WO_SHARE_NONE_COUNT |
INTEGER | Ouvertures en écriture seule sans partage |
RW_SHARE_R_COUNT |
INTEGER | Nombre d'accès en lecture/écriture partagés en lecture |
RW_SHARE_W_COUNT |
INTEGER | Nombre d'accès en lecture/écriture partagés en écriture |
RW_SHARE_RW_COUNT |
INTEGER | Nombre d'accès en lecture/écriture partagés en lecture/écriture |
RW_SHARE_NONE_COUNT |
INTEGER | Nombre d'accès en lecture/écriture sans partage |
XO_SHARE_R_COUNT |
INTEGER | Ouvertures en exécution seule avec partage en lecture |
XO_SHARE_W_COUNT |
INTEGER | Ouvertures en exécution seule avec partage en écriture |
XO_SHARE_RW_COUNT |
INTEGER | Ouvertures en exécution seule avec partage lecture et écriture |
XO_SHARE_NONE_COUNT |
INTEGER | Ouvertures en exécution seule sans partage |
XR_SHARE_R_COUNT |
INTEGER | Ouvertures en lecture et exécution avec partage en lecture |
XR_SHARE_W_COUNT |
INTEGER | Ouvertures en lecture et exécution avec partage en écriture |
XR_SHARE_RW_COUNT |
INTEGER | Ouvertures en lecture et exécution avec partage lecture et écriture |
XR_SHARE_NONE_COUNT |
INTEGER | Ouvertures en lecture et exécution sans partage |
CURRENT_DIRECTORY_COUNT |
INTEGER | Nombre de répertoires courants |
ROOT_DIRECTORY_COUNT |
INTEGER | Nombre de répertoires racine |
FILE_SERVER_REFERENCE_COUNT |
INTEGER | Nombre de références du serveur de fichiers |
FILE_SERVER_WORKING_DIRECTORY_COUNT |
INTEGER | Nombre de répertoires de travail du serveur de fichiers |
NFS_SERVER_REFERENCE_COUNT |
INTEGER | Nombre de références au serveur NFS |