DLTPGM

Supprimer un programme

En bref

La commande DLTPGM (Supprimer un programme) permet de supprimer un programme ou un groupe de programmes compilé.

DLTPGM se lit DLT (Supprimer) + PGM. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

DLTPGM PGM(…)

Paramètres

PGM Programme obligatoire

Astuce : dans une session 5250, tapez DLTPGM 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 DLTPGM (Supprimer un programme) permet de supprimer un programme ou un groupe de programmes compilé. Si le programme est en cours d'exécution, il prend fin anormalement sauf si une commande ALCOBJ (Allouer un objet) spécifique est en cours dans un autre travail. Tout programme HLL (langage évolué) ou CL (langage de contrôle) peut être supprimé.

Restrictions :

Vous devez disposer des droits *OBJEXIST (existence sur les objets) sur le programme et des droits *EXECUTE sur la bibliothèque dans laquelle figure le programme.
Une anomalie de fonctionnement se produit si le programme à supprimer est en cours de débogage et qu'une référence implicite est faite au programme, par exemple, si la commande CHGVAR (Modifier une variable) indique PGM(*DFTPGM). Pour éviter cette anomalie de fonctionnement, utilisez la commande RMVPGM (Enlever programme du débogage) pour retirer le programme de la session de débogage avant de le supprimer. Si le programme est recompilé en mode débogage, retirez-le de ce mode à l'aide de la commande RMVPGM, supprimez-le du système à l'aide de la commande DLTPGM (Supprimer un programme), modifiez-le et recompilez-le, puis ajoutez la nouvelle version au mode débogage à l'aide de la commande ADDPGM (Ajouter programme au débogage).

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
PGM	Programme	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Programme	Nom générique, nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB, USRLIBL, ALL, *ALLUSR

Programme (PGM)

Indique le programme à supprimer. Un nom de programme spécifique ou générique peut être indiqué ; dans chacun des cas, ce nom peut être qualifié par un nom de bibliothèque.

Ce paramètre est obligatoire.

Qualificatif 1 : Programme

nom: Indiquez le nom du programme à supprimer.
nom-générique: Indiquez le nom générique des programmes à supprimer. Un nom générique est une chaîne alphanumérique contenant un ou plusieurs caractères suivis d'un astérisque (*).

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 s'effectue dans la bibliothèque en cours du travail. Si celle-ci ne figure pas dans la liste des bibliothèques, QGPL est prise par défaut.

*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.

*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

'xxxxx' représente le numéro de l'ASP principal.
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.

Exemples

DLTPGM   PGM(LIB1/PROG1)

Cette commande supprime le programme PROG1 de la bibliothèque LIB1 si l'utilisateur dispose des droits appropriés sur le programme et la bibliothèque.

Messages d'erreur

Messages *ESCAPE

CPF210F: L'opération n'a pas abouti pour &1, &2, type *&3.
CPF2105: Objet &1 de &2 type *&3 non trouvé.
CPF2110: Bibliothèque &1 non trouvée.
CPF2113: Impossible d'allouer la bibliothèque &1.
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é.
CPF2160: Objet de type *&1 incorrect pour la fonction demandée.
CPF2176: Bibliothèque &1 endommagée.
CPF2182: Non autorisé à utiliser la bibliothèque &1.
CPF2189: Utilisation de l'objet &1 de &2, type *&3 non autorisée.
CPFA030: Objet déjà en cours d'utilisation.
CPFE007: Une erreur s'est produite lors du traitement de la commande. Error occurred processing command.
CPF9803: Impossible d'allouer l'objet &2 de la bibliothèque &3.