Aller au contenu

STRISDB

Démarrer ISDB

En bref

STRISDB se lit STR (Démarrer) + ISDB. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

STRISDB PGM(…)

Paramètres

  • PGM Programme obligatoire
  • UPDPROD MàJ fichiers de production
  • INVPGM Appeler le programme
  • PARM Paramètres d'appel
  • CMD Commande d'appel
  • SRCMBR Membre source
  • SRCF Fichier source
  • SRVJOB Travail à traiter

Astuce : dans une session 5250, tapez STRISDB 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 QPDA)

Où s'exécute : Environnements interactifs (*INTERACT *IPGM *IMOD *IREXX *EXEC)
Compatible multitâche : Non

Démarrer Débogueur source interactif

Le produit Débogueur source interactif (ISDB) fournit un environnement de débogage interactif pour les programmes CL, COBOL et RPG.

Remarque :La bibliothèque QTEMP est requise pour l'exécution d'ISDB. ISDB utilise cette bibliothèque pour accéder à des fichiers tel que le fichier de consignation.

Pour démarrer le produit :

  1. Indiquez les paramètres STRISDB nécessaires à votre programme.
  2. Appuyez sur ENTREE. ISDB est lancé.

Le source du programme est affiché dans l'écran SOURCE ISDB et vous pouvez déboguer le programme à l'aide des options qui y figurent.

Messages d'erreur pour STRISDB

Aucun

Paramètres

Mot-clé Description Valeurs possibles Remarques
PGM Programme Nom d'objet qualifié Obligatoire, positionnel 1
Qualificatif 1: Programme Nom
Qualificatif 2: Bibliothèque Nom, *CURLIB, *LIBL
UPDPROD MàJ fichiers de production *YES, *NO Facultatif, positionnel 2
INVPGM Appeler le programme *YES, *NO, *CMD Facultatif, positionnel 3
PARM Paramètres d'appel Values (jusqu'à 40 répétitions): Valeur caractère Facultatif, positionnel 4
CMD Commande d'appel Chaîne de commandeCommand string Facultatif, positionnel 5
SRCMBR Membre source Nom, *PGM Facultatif, positionnel 6
SRCF Fichier source Nom d'objet qualifié Facultatif, positionnel 7
Qualificatif 1: Fichier source Nom
Qualificatif 2: Bibliothèque Nom, *CURLIB, *LIBL
SRVJOB Travail à traiter *, *SELECT Facultatif, positionnel 8

Programme

Ce paramètre permet d'indiquer le nom du programme à déboguer et celui de la bibliothèque où il se trouve.

Les valeurs possibles pour la bibliothèque sont les suivantes :

*LIBL
Le programme est recherché dans la liste des bibliothèques. Si aucun nom de bibliothèque n'est indiqué, cette valeur est utilisée par défaut.
*CURLIB
Le programme est recherché dans la bibliothèque en cours de la liste des bibliothèques. (Si vous n'avez pas indiqué de bibliothèque en cours, la valeur QGPL est utilisée par défaut.)
nom-bibliothèque
Indiquez le nom de la bibliothèque contenant le programme à déboguer.

Remarque :Pour déboguer les programmes COBOL avec ISDB, assurez-vous qu'ils sont compilés avec l'option *SRCDBG.

Mettre à jour les fichiers de production (UPDPROD)

Utilisez ce paramètre pour préciser si les fichiers des bibliothèques de production peuvent être modifiés lorsqu'ils sont en mode débogage.

Les valeurs possibles sont les suivantes :

*NO
Les fichiers ne peuvent pas être mis à jour lorsqu'ils sont en mode débogage.
*YES
Les fichiers peuvent être mis à jour lorsqu'ils sont en mode débogage.

Il vous est possible de modifier la valeur de mise à jour des fichiers de production à partir de l'écran SOURCE. Pour cela, vous devez procéder comme suit :

  1. Sélectionnez l'option DEBOGAGE dans la barre de menus de l'écran SOURCE.
  2. Dans le menu déroulant DEBOGAGE, sélectionnez l'option 1 (MODIFIER LE DEBOGAGE). La fenêtre DEFINIR LES OPTIONS DE DEBOGAGE s'affiche.
  3. Sélectionnez l'option 1 (METTRE A JOUR LES FICHIERS DE PRODUCTION) ou l'option 2 (NE PAS METTRE A JOUR LES FICHIERS DE PRODUCTION) et appuyez sur ENTREE.

Appeler le programme

Ce paramètre vous permet d'indiquer si vous voulez que ISDB appelle votre programme, effectue auparavant d'autres préparations ou utilise une commande pour appeler votre programme.

Les valeurs possibles sont les suivantes :

*YES
ISDB appelle votre programme à l'aide des paramètres indiqués dans la zone PARM.

Remarque :Vous ne pouvez pas utiliser ce paramètre pour les tâches en cours de demande interactive.

*NO
Aucune commande n'est émise pour lancer le programme. L'écran d'entrée de commandes (QCMD) vous permet d'effectuer toute préparation requise avant l'envoi de la commande qui lancera le programme.

Si vous lancez votre programme à partir de l'écran d'entrée de commandes, le contrôle reviendra à cet écran après l'exécution du programme. Pour mettre fin à ISDB ou le relancer, vous devez d'abord sortir de l'écran d'entrée de commandes (F3 ou F12). Vous accédez ensuite à l'écran FIN DU PROGRAMME à partir duquel vous pouvez choisir de mettre fin à ISDB ou de le relancer.

Remarque :Pour traiter d'autres travaux, c'est la seule option que vous pouvez utiliser mais le panneau QCMD n'est pas appelé.

*CMD
ISDB exécute la commande indiquée dans le paramètre CMD. (Cette commande doit appeler votre programme).

Paramètres

Ce paramètre permet d'indiquer tous les paramètres requis pour appeler votre programme.

Ce paramètre n'est pas destiné aux commandes d'appel INVPGM(*NO) et INVPGM(*CMD).

Remarque : Les littéraux (par exemple, 500) et les chaînes numériques contenant des caractères indéfinis (X'00') ne sont pas admis dans cette zone. Utilisez plutôt le paramètre INVPGM(*CMD) et indiquez la commande CALL appropriée pour le paramètre CMD. Par exemple, au lieu d'entrer la commande :

STRISDB PGM(MYPGM) INVPGM(*YES) PARM(123 X'00')

utilisez la commande suivante :

STRISDB PGM(MYPGM) INVPGM(*CMD) CMD(CALL PGM(MYPGM)
PARM(123 X'00'))

Commande d'appel

Ce paramètre permet d'indiquer la commande que vous voulez utiliser pour appeler votre programme.

Ce paramètre n'est pas destiné aux commandes d'appel INVPGM(*NO) et INVPGM(*YES).

Membre source

Ce paramètre est facultatif dans la mesure où vous ne devez l'indiquer que s'il diffère de celui qui figure dans la description d'objet du programme. Le source du membre que vous indiquez s'affiche dans l'écran SOURCE quand vous appelez le programme.

Vous devrez utiliser ce paramètre dans les cas suivants :

  • Les noms de la bibliothèque, du fichier et du membre ont été modifiés depuis la dernière compilation du programme. (Assurez-vous que le membre contient le source de programme correct afin d'éviter des résultats imprévus.)
  • Le programme est un programme RPG d'auto-édition. La commande CRTRPTPGM possède un paramètre qui vous permet de placer le source développé dans un fichier physique source.
  • Le source est situé sur une autre machine serveur et le programme correspondant n'a pas été créé à l'aide d'un fichier DDM.

Les valeurs possibles sont les suivantes :

*PGM
Les informations source sont extraites de la description de l'objet à l'aide de la commande DSPOBJD.
nom-membre
Indiquez le nom du membre source que vous voulez afficher ainsi que les noms de fichier et de bibliothèque correspondants dans les paramètres prévus à cet effet.

Fichier et bibliothèque source

Ces paramètres vous permettent d'indiquer les noms de fichier et de bibliothèque du membre source précisé dans l'invite MEMBRE SOURCE. Vous devez indiquer les deux noms si l'un des deux diffère de celui qui figure dans la description d'objet du programme.

La valeur possible pour le nom du fichier source est la suivante :

nom-fichier
Indiquez le nom du fichier contenant le membre source que vous voulez afficher.

Les valeurs possibles pour le nom de la bibliothèque source sont les suivantes :

*LIBL
Le fichier source est recherché dans la liste des bibliothèques.
*CURLIB
Le fichier source est recherché dans la bibliothèque en cours. (Si vous n'avez pas indiqué de bibliothèque en cours, la valeur QGPL est utilisée par défaut.)
nom-bibliothèque
Indiquez le nom de la bibliothèque contenant le fichier source que vous voulez afficher.

Travail à traiter (SRVJOB)

Ce paramètre permet de déboguer un programme s'exécutant dans un travail différent de celui traité dans la session en cours. Il est utile pour le débogage de travaux par lots ou d'autres travaux interactifs.

Les valeurs possibles sont les suivantes :

*
Débogage dans le travail en cours.
*SELECT
Affiche l'écran CHOIX D'UN TRAVAIL A TRAITER PAR ISDB qui vous permet de choisir un travail dans la liste des travaux actifs. La sélection d'un travail entraîne le lancement de la commande STRSRVJOB et le passage du travail en mode débogage.

Remarque :SRVJOB(*SELECT) n'est pas admis avec INVPGM(*YES) ou INVPGM(*CMD).

Exemples

None

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