Aller au contenu

Service SQL IBM i (AS/400) · Fonction table

QSYS2.IFS_JOB_INFO

Objets IFS utilisés par un travail

Liste les objets de l'IFS référencés par un travail, avec leurs compteurs d'ouverture et de partage, son répertoire courant et son répertoire racine.

À quoi ça sert

La fonction de table prend un nom de travail (JOB_NAME, la valeur '*' désigne le travail courant) et renvoie, pour chaque objet de l'IFS qu'il référence, le chemin, le type de système de fichiers, les identifiants, le nombre de références et des compteurs détaillés : ouvertures en lecture seule, en écriture seule, en lecture/écriture ou en exécution, combinées au mode de partage (lecture, écriture, lecture et écriture, aucun). Elle indique aussi les verrous (attribut, sauvegarde, modifications de liens), les objets extraits (checked out), le répertoire courant et le répertoire racine.

On s'en sert pour comprendre pourquoi un travail garde un fichier ouvert, ou quels fichiers un traitement manipule. Le paramètre IGNORE_ERRORS (défaut YES) évite l'échec complet si un élément n'est pas lisible.

Pour la question inverse, c'est-à-dire quels travaux utilisent un objet donné, voir 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_JOB_INFO(JOB_NAME => '*'))

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

PATH_NAME Chemin FILE_SYSTEM_TYPE Type de système de fichiers FILE_IDENTIFIER_NUMBER Numéro d'identifiant du fichier GENERATION_IDENTIFIER Identifiant de génération FILE_SYSTEM_IDENTIFIER Identifiant du système de fichiers FILE_IDENTIFIER Identifiant du fichier REFERENCE_COUNT Nombre de références 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 Répertoire courant ROOT_DIRECTORY Répertoire racine 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 FILE_SERVER_REFERENCE Référence du serveur de fichiers FILE_SERVER_WORKING_DIRECTORY Répertoire de travail du serveur de fichiers NFS_SERVER_REFERENCE Référence au serveur NFS
/ ROOT 21 2914329620 141012366262273 0000000000000001ADB5241400000015 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 NO YES NO NO NO NO NO NULL NO NO NO
/home/UTIL232 ROOT 329630 2914330038 141012366262273 0000000000000001ADB525B60005079E 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 YES NO NO NO NO NO NO NULL NO NO NO

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 toutes les références IFS du travail courant.

-- Description: List all the IFS references for the current job. 
    SELECT * FROM TABLE(QSYS2.IFS_JOB_INFO(JOB_NAME => '*'));

Paramètres

ParamètreTypePar défautSignification
JOB_NAME VARCHAR(28) obligatoire Nom du travail
IGNORE_ERRORS VARCHAR(3) 'YES' Ignorer les erreurs

Colonnes renvoyées (38)

Afficher les 38 colonnes
ColonneTypeSignification
PATH_NAME DOUBLE-BYTE CHAR LARGE OBJECT Chemin
FILE_SYSTEM_TYPE VARCHAR(15) Type de système de fichiers
FILE_IDENTIFIER_NUMBER BIGINT Numéro d'identifiant du fichier
GENERATION_IDENTIFIER BIGINT Identifiant de génération
FILE_SYSTEM_IDENTIFIER BIGINT Identifiant du système de fichiers
FILE_IDENTIFIER BINARY(16) Identifiant du fichier
REFERENCE_COUNT INTEGER Nombre de références
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 VARCHAR(3) Répertoire courant
ROOT_DIRECTORY VARCHAR(3) Répertoire racine
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
FILE_SERVER_REFERENCE VARCHAR(3) Référence du serveur de fichiers
FILE_SERVER_WORKING_DIRECTORY VARCHAR(3) Répertoire de travail du serveur de fichiers
NFS_SERVER_REFERENCE VARCHAR(3) Référence au serveur NFS