ADDPGM

Ajouter programme au débogage

En bref

La commande ADDPGM (Ajouter un programme au débogage) permet d'ajouter jusqu'à vingt programmes au groupe de programmes en cours de débogage.

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

Syntaxe minimale

ADDPGM PGM(…)

Paramètres

PGM Programme obligatoire
DFTPGM Programme par défaut

Astuce : dans une session 5250, tapez ADDPGM 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 ADDPGM (Ajouter un programme au débogage) permet d'ajouter jusqu'à vingt programmes au groupe de programmes en cours de débogage. Il est possible de définir des points d'arrêt et des traces pour les nouveaux programmes, une fois qu'ils sont en mode débogage, ceci afin de contrôler et de tracer leur traitement. Les valeurs des variables de programme peuvent également être affichées ou modifiées.

Lorsqu'un travail est débogué à partir d'un autre travail, seule l'exécution des programmes du travail en cours de débogage s'en trouve affectée. Vous pouvez exécuter des programmes dans un travail effectuant le débogage ; ces programmes, toutefois, ne seront pas débogués.

Restrictions :

Vous pouvez utiliser cette commande uniquement en mode débogage. Pour démarrer le mode débogage, utilisez la commande STRDBG.
Vous ne pouvez pas utiliser cette commande si vous faites la maintenance d'un autre travail et si celui-ci est dans une file d'attente de travaux, ou bien s'il est suspendu, interrompu ou arrêté.

Un maximum de 20 programmes peuvent être débogués en même temps.
Plusieurs programmes portant le même nom ne peuvent être débogués en même temps.
Cette commande ne peut pas être utilisée pour ajouter des programmes liés.
Vous devez disposer soit du droit *CHANGE, soit du droit *USE sur le programme et du droit spécial *SERVICE.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
PGM	Programme	Values (jusqu'à 20 répétitions): Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Programme	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
DFTPGM	Programme par défaut	Nom, SAME, NONE	Facultatif, positionnel 2

Programme (PGM)

Indique un ou plusieurs programmes à déboguer. Le nombre de programmes pouvant être indiqués ici dépend du nombre de programmes déjà en cours de débogage, sachant que le nombre total de programmes pouvant être débogués simultanément est limité à 20. Il n'est pas possible de déboguer simultanément des programmes ayant le même nom.

Ce paramètre est obligatoire.

Qualificatif 1 : Programme

nom: Indiquez le nom du programme à déboguer.

Qualificatif 2 : Biblio

*LIBL: La liste des bibliothèques permet de localiser le programme à déboguer.
*CURLIB: La bibliothèque en cours du travail est utilisée pour rechercher le programme à déboguer. Si celle-ci n'est pas précisée, QGPL est utilisée par défaut.
nom: Indiquez le nom de la bibliothèque contenant le programme.

Programme par défaut (DFTPGM)

Indique le programme qui doit être pris par défaut en mode débogage. Ce programme sera également utilisé comme programme par défaut dans toutes les autres commandes de débogage pour lesquelles *DFTPGM figure au paramètre Programme (PGM).Ainsi, si un programme par défaut a précédemment été spécifié, ce paramètre peut le modifier.

*SAME: Le programme défini comme programme par défaut ne change pas.
*NONE: Aucun programme n'est défini en tant que programme par défaut ; si un programme a été précédemment identifié comme programme par défaut, il n'est plus pris en tant que tel. En l'absence de programme par défaut pour le travail, le paramètre Programme (PGM) ne peut prendre la valeur *DFTPGM pour aucune autre commande de débogage.
nom: Entrez le nom du programme qui doit être pris par défaut en mode débogage. Ce nom doit également être entré pour le paramètre PGM de cette commande ou de la commande STRDBG (Démarrer le débogage) ou d'une commande ADDPGM (Ajouter un programme au débogage) antérieure.

Exemples

ADDPGM   PGM(QGPL/MYPROG)

Cette commande permet d'ajouter le programme MYPROG, situé dans la bibliothèque QGPL, au mode débogage en cours. Des points d'arrêt et des traces peuvent être placés dans MYPROG, et ses variables peuvent être affichées et modifiées via d'autres commandes de débogage. DFTPGM n'ayant pas été défini, le programme par défaut n'est pas modifié.

Messages d'erreur

Messages *ESCAPE

CPF1999: Erreurs dans la commande.