Aller au contenu

DLTF

Supprimer un fichier

En bref

La commande DLTF (Supprimer un fichier) permet de supprimer du système un ou plusieurs fichiers.

Syntaxe minimale

DLTF FILE(…)

Paramètres

Astuce : dans une session 5250, tapez DLTF 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 : Sous conditions

La commande DLTF (Supprimer un fichier) permet de supprimer du système un ou plusieurs fichiers.

Si un fichier base de données (physique ou logique) est supprimé, tous les membres qu'il contient le sont également. Un fichier physique ne peut être supprimé que si aucun fichier logique ne lui est associé. Si un fichier ICF (Intersystem Communications Function) est supprimé, toutes les unités programme qu'il contient le sont aussi. Il est impossible de supprimer un fichier en cours d'utilisation (ouvert).

Une opération de suppression par nom générique permet de supprimer chaque fichier dont le nom générique remplit les conditions requises pour une suppression. Un message de diagnostic est envoyé pour chaque fichier ne pouvant pas être supprimé. Les fichiers peuvent ne pas remplir les conditions requises pour une suppression pour les raisons suivantes :

  • Les fichiers logiques doivent être supprimés avant les fichiers physiques de base associés.
  • Les vues SQL doivent être supprimées avant les fichiers physiques, les tables SQL ou les vues SQL de base associées.

Restrictions :

  • Vous devez disposer de droits d'existence (*OBJEXIST) et d'exécution (*OBJOPR) sur l'objet pour le fichier. Vous avez également besoin du droit d'accès d'exécution (*EXECUTE) sur la bibliothèque qui contient le fichier.
  • Si un fichier physique doit être supprimé et que ses données sont utilisées par un fichier logique, ce dernier doit être supprimé en premier.
  • Si un fichier physique ou une vue SQL est référencée dans la liste de sélection d'une table de requêtes matérialisée, la commande DLTF n'est pas admise. La table de requêtes matérialisée doit être supprimée en premier.
  • Si la commande DLTF est entrée lors du débogage et que UPDPROD(*NO) a été indiqué à la commande STRDBG (Démarrer le débogage) ou CHGDBG (Modifier le débogage), un fichier physique contenant des données et figurant dans une bibliothèque de production ne peut pas être supprimé.
  • Cette commande est à unités d'exécution protégées sous certaines conditions. Dans le cas de travaux à unités d'exécution multiples, cette commande n'admet pas l'utilisation d'unités d'exécution multiples pour les fichiers répartis utilisant une base de données relationnelle de type *SNA. En outre, elle n'admet pas l'utilisation d'unités d'exécution protégées pour les fichiers DDM (Gestion de fichiers éloignés) de type *SNA lorsque SYSTEM(*RMT) ou SYSTEM(*FILETYPE) est indiqué.

Paramètres

Mot-clé Description Valeurs possibles Remarques
FILE Fichier Nom d'objet qualifié Obligatoire, positionnel 1
Qualificatif 1: Fichier Nom générique, nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB, *USRLIBL, *ALL, *ALLUSR
SYSTEM Système *LCL, *RMT, *FILETYPE Facultatif
RMVCST Enlever contrainte *RESTRICT, *REMOVE, *KEEP Facultatif

Fichier (FILE)

Ce paramètre est obligatoire.

Indique le ou les fichiers à supprimer. Un fichier particulier ou générique peut être spécifié.

Les fichiers qui sont définis ou établis comme fichiers parents ou dépendants d'une contrainte référentielle peuvent être supprimés. Si le fichier supprimé est un fichier dépendant, les éléments suivants sont également supprimés :

  • Toutes les associations de contrainte du fichier dépendant
  • Tous les chemins d'accès à clé associée et toutes les clés associées du fichier dépendant

Si le fichier supprimé est un fichier parent, le paramètre Enlever contrainte (RMVCST) permet de demander la suppression des associations de contrainte.

Qualificatif 1 : Fichier

nom-générique
Indiquez le nom générique du fichier à supprimer. Un nom générique est une chaîne de un ou plusieurs caractères suivis d'un astérisque (*).
nom
Entrez le nom du fichier à supprimer.

Qualificatif 2: Biblio

*LIBL
La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.
*CURLIB
La recherche porte sur la bibliothèque en cours du travail. Si celle-ci ne figure pas dans la liste des bibliothèques, la recherche s'effectue dans QGPL.
*USRLIBL
S'il existe un poste de bibliothèque en cours dans la liste des bibliothèques de l'unité d'exécution en cours, la recherche porte sur celle-ci ainsi que sur les bibliothèques de la partie utilisateur de la liste des bibliothèques. Dans le cas contraire, la recherche porte uniquement sur les bibliothèques de la partie utilisateur de la liste des bibliothèques.
*ALL
La recherche porte sur toutes les bibliothèques du système, y compris QSYS. Si vous indiquez un nom d'objet précis (au lieu d'un nom générique), le premier objet trouvé avec ce nom est supprimé.
*ALLUSR
La recherche porte sur toutes les bibliothèques utilisateur. La recherche porte sur toutes les bibliothèques dont le nom ne commence pas par la lettre Q, à l'exception des bibliothèques suivantes :

#CGULIB     #DSULIB     #SEULIB
#COBLIB     #RPGLIB
#DFULIB     #SDALIB

Bien que les bibliothèques Qxxx suivantes soient fournies par IBM, elles contiennent généralement des données utilisateur qui sont fréquemment modifiées. Par conséquent, ces bibliothèques sont considérées comme des bibliothèques utilisateur et sont donc recherchées :

QDSNX       QRCLxxxxx   QUSRDIRDB   QUSRVI
QGPL        QSRVAGT     QUSRIJS     QUSRVxRxMx
QGPL38      QSYS2       QUSRINFSKR  QWQCENT
QMGTC       QSYS2xxxxx  QUSRNOTES   QWQREPOS
QMGTC2      QS36F       QUSROND
QMPGDATA    QUSER38     QUSRPOSGS
QMQMDATA    QUSRADSM    QUSRPOSSA
QMQMPROC    QUSRBRM     QUSRPYMSVR
QPFRDATA    QUSRDIRCF   QUSRRDARS
QRCL        QUSRDIRCL   QUSRSYS

  1. 'xxxxx' représente le numéro de l'ASP principal.
  2. L'utilisateur peut créer une bibliothèque de nom différent, au format QUSRVxRxMx, pour chacune des éditions précédentes prises en charge par IBM, afin d'y stocker les commandes utilisateur à compiler dans un programme CL pour une édition précédente. En ce qui concerne la bibliothèque utilisateur QUSRVxRxMx, VxRxMx correspond à une version, édition et niveau de modification précédents encore admis par IBM.

Système (SYSTEM)

Indique si le fichier est supprimé sur un système local ou un système éloigné.

*LCL
Le fichier est supprimé sur le système local.
*RMT
Le fichier est supprimé sur un système éloigné. Un fichier DDM doit être spécifié pour le paramètre Fichier (FILE). Il sert à identifier le fichier à supprimer ainsi que le système éloigné.
*FILETYPE
Le fichier est supprimé sur le système local si aucun fichier DDM n'est spécifié pour le paramètre FILE. Si un fichier DDM est spécifié pour le paramètre FILE, l'identificateur de fichier éloigné contenu dans le fichier DDM est supprimé du système éloigné.

Enlever contrainte (RMVCST)

Indique dans quelle mesure les associations de contrainte sont supprimées de l'ensemble des fichiers dépendants associés en cas de suppression d'un fichier parent d'une contrainte référentielle.

*RESTRICT
Le fichier parent n'est pas supprimé et l'association de contrainte n'est pas enlevée si celle-ci est définie ou établie entre un fichier parent et un fichier dépendant. Ni le chemin d'accès à clé associée, ni la clé associée du fichier dépendant n'est supprimé.
*REMOVE
L'association de contrainte existant entre le fichier parent et un fichier dépendant est enlevée. Le chemin d'accès à clé associée correspondant (s'il en existe un et s'il n'est pas partagé) et la clé associée d'un fichier dépendant sont enlevés.
*KEEP
L'association de contrainte n'est plus établie mais sa définition n'est pas enlevée. Ni le chemin d'accès à clé associée, ni la clé associée du fichier dépendant n'est supprimé.

Exemples

Exemple 1 : Suppression d'un fichier spécifique

DLTF   FILE(BILLING/ORDERS)

Cette commande permet de supprimer le fichier ORDERS de la bibliothèque BILLING. Le fichier est recherché uniquement dans la bibliothèque BILLING.

Exemple 2 : Suppression d'un fichier parent d'une contrainte référentielle

DLTF   FILE(BILLING/QUERIES)  RMVCST(*KEEP)

Cette commande permet de supprimer le fichier QUERIES de la bibliothèque BILLING. Dans la mesure où le fichier QUERIES est un fichier parent d'une contrainte référentielle, la contrainte référentielle établie est supprimée mais pas la définition de la contrainte.

Messages d'erreur

*ESCAPE Messages

CPF0601
Opération sur le fichier &1 de &2 non autorisée.
CPF0605
Fichier unité &1 dans &2 sauvegardé avec libération mémoire.
CPF0607
Fichier supprimé par un autre travail.
CPF0610
Fichier &1 de &2 non disponible.
CPF0675
Fichier unité &1 de &2 en cours d'utilisation.
CPF2105
Objet &1 de &2 type *&3 non trouvé.
CPF2110
Bibliothèque &1 non trouvée.
CPF2114
Impossible d'allouer objet &1 de &2 type *&3.
CPF2117
&4 objet(s) de type *&3 supprimé(s). &5 objet(s) non supprimé(s).
CPF2125
Aucun objet supprimé.
CPF2182
Non autorisé à utiliser la bibliothèque &1.
CPF2189
Utilisation de l'objet &1 de &2, type *&3 non autorisée.
CPF2190
La suppression ou le changement de nom ne peut pas être demandé à distance.
CPF320B
Opération incorrecte pour le fichier base de données &1.
CPF3202
Fichier &1 de &2 en cours d'utilisation.
CPF3203
Allocation de l'objet impossible pour le fichier &1 de &2.
CPF3219
Impossible de supprimer fichier ou membre &1 de &2.
CPF3220
Impossible d'effectuer l'opération sur le fichier &1 de &2.
CPF323C
Impossible d'allouer la bibliothèque QRECOVERY.
CPF324B
Impossible d'allouer le dictionnaire pour le fichier &1.
CPF3252
Nombre maximal de verrouillages atteint pour la machine.
CPF326A
L'opération a échoué pour le fichier &1 de la bibliothèque &2.
CPF327F
L'opération a échoué pour le fichier &1 de la bibliothèque &2.
CPF3273
Fichier ou membre ni créé, ni supprimé, ni modifié.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.