CHGDBG

La commande CHGDBG (Modifier le débogage) permet de modifier les attributs de la session de débogage en cours pour un travail. Tous les attributs peuvent être modifiés, sauf la sélection des programmes à déboguer. Utilisez les commandes ADDPGM (Ajouter un programme au débogage) et RMVPGM (Enlever un programme du débogage) pour augmenter ou réduire la liste des programmes en mode débogage.

Restrictions :

• Cette commande ne peut être utilisée qu'en mode débogage. Pour démarrer le mode de débogage, reportez-vous à la commande STRDBG (Démarrer le débogage).
• Si le travail en cours fait la maintenance d'un autre travail en cours d'arrêt, cette commande n'est pas admise.

Paramètres

Programme par défaut (DFTPGM)

Indique le nom du programme OPM (Original Program Model) à utiliser comme programme par défaut en mode de 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, il remplace tout programme par défaut préalablement défini.

Ce paramètre ne s'applique qu'à l'environnement OPM.

*SAME

Le même programme, défini comme programme par défaut, est utilisé.

*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. Il doit être identique au nom entré pour le paramètre PGM de la commande STRDBG (Démarrer le débogage) ou ADDPGM (Ajouter un programme au débogage).

Nb maxi d'instructions trace (MAXTRC)

Indique le nombre maximum d'instructions de trace que le système place dans le fichier trace du travail avant d'arrêter la trace ou de reprendre le traitement du fichier trace (bouclage). Lorsque le fichier trace contient le nombre maximal d'instructions, le système effectue les actions définies par la valeur entrée au paramètreTrace pleine (TRCFULL).

Remarque :Pour traiter pas à pas les instructions d'un programme dans le cadre d'un débogage interactif, il convient de fixer le nombre maximal d'instructions de trace à 1 et d'indiquer *STOPTRC au paramètre Trace pleine ( TRCFULL).

Ce paramètre ne s'applique qu'à l'environnement OPM.

*SAME

Le nombre maximal d'instructions de trace dans le fichier n'est pas modifié.

entier

Indiquez le nombre maximal d'instructions tracées que peut contenir le fichier trace.

Trace pleine (TRCFULL)

Indique ce qui se produit lorsque le fichier trace du travail est plein, c'est-à-dire lorsqu'il contient le nombre maximal d'instructions de trace défini au paramètre Nb maxi d'instructions trace (MAXTRC).

Ce paramètre ne s'applique qu'à l'environnement OPM.

*SAME

L'action déclenchée lorsque le fichier trace est plein n'est pas modifiée.

*STOPTRC

Dans le cadre d'un traitement par lots, la fonction trace s'arrête mais le programme poursuit le traitement. En mode interactif, le contrôle est donné à l'utilisateur dès qu'un point d'arrêt est atteint. Si l'utilisateur décide de continuer le traitement, un point d'arrêt est observé avant le traitement de chaque instruction suivante dans la plage de trace et la taille du fichier trace est augmentée pour recevoir la nouvelle donnée.

*WRAP

Le contenu du fichier trace est remplacé au fur et à mesure par les nouvelles instructions de trace, ce qui entraîne le bouclage du fichier. L'exécution du programme se poursuit ; aucun message ne signale qu'un bouclage a eu lieu. Ainsi, le fichier trace ne contient jamais plus du nombre maximal d'instructions et il s'agit toujours des dernières instructions enregistrées.

MàJ fichiers de production (UPDPROD)

Indique si les fichiers base de données d'une bibliothèque de production peuvent être ouverts en vue d'une mise à jour (ajout, suppression ou modification d'enregistrements) lorsque le travail est en mode débogage. Dans la négative, les fichiers doivent être copiés dans une bibliothèque de test avant d'exécuter un programme faisant intervenir ces fichiers.

Ce paramètre est applicable dans les environnements OPM et ILE.

*SAME

La valeur précédemment spécifiée pour ce paramètre n'est pas modifiée.

*NO

Les fichiers base de données des bibliothèques de production ne peuvent être modifiés en cours de débogage. Ainsi, les fichiers base de données sont protégés contre des mises à jour intempestives pendant le débogage d'un programme.

*YES

Les fichiers base de données des bibliothèques de production peuvent être modifiés lorsque le travail est en mode débogage.

Débogage de niveau source OPM (OPMSRC)

Indique si les programmes OPM sont débogués à l'aide du support de débogage source du système (identique au débogage source ILE).

Ce paramètre est valable pour les programmes OPM CL, OPM RPG et OPM COBOL créés avec OPTION(*SRCDBG) et les commandes CRTCLPGM, CRTRPGPGM et CRTCBLPGM. En outre, ce paramètre est valable pour les programmes OPM CL, OPM RPG et OPM COBOL créés avec OPTION(*LSTDBG) et les options CRTCLPGM, CRTRPGPGM, CRTCBLPGM CRTSQLRPG, CRTSQLCBL et CRTRPTPGM. Si le programme OPM n'est pas de type CL, RPG ou COBOL et n'a pas été compilé avec une option de débogage admise, ce paramètre est ignoré.

Les programmes OPM ajoutés au débogage avant l'exécution de la commande CHGDBG vont continuer à être actifs dans l'environnement de débogage (ILE ou OPM) dans lequel ils se trouvent. Ceux ajoutés au débogage après l'exécution de la commande CHGDBG sont affectés par le paramètre OPMSRC.

Ce paramètre s'applique aux environnements OPM et ILE.

*SAME

La valeur ne change pas.

*NO

Les fonctions de débogage OPM sont utilisées pour les programmes OPM.

*YES

Les fonctions de débogage ILE sont utilisées pour les programmes OPM.

Exemples

CHGDBG   MAXTRC(400)  TRCFULL(*STOPTRC)

Cette commande permet de fixer à la valeur 400 le nombre maximal d'instructions tracées que peut contenir le fichier trace. Le traçage s'arrête lorsque le fichier est plein.

Messages d'erreur

Messages *ESCAPE

CPF1999

Erreurs dans la commande.