La vue Structure constitue une excellente ressource pour éditer le source IL, RPG COBOL ou DDS dans l'éditeur LPEX de systèmes distants. Elle affiche un plan structuré des éléments définis dans le fichier ouvert dans l'éditeur LPEX de systèmes distants. Avec l'éditeur actif, vous pouvez développer la structure du fichier dans la vue Structure et cliquer sur différents éléments dans la vue pour accéder à l'emplacement correspondant dans le code source.
Voici certaines méthodes pour que la vue Structure puisse faciliter et accélérer l'édition du source :
- Lorsque vous codez des calculs dans l'éditeur LPEX de systèmes distants, vous pouvez gagner du temps en vérifiant les définitions dans la vue Structure. Cela vous évite de basculer dans le source entre les calculs et les définitions.
- Si vous remarquez qu'une définition est incorrecte, vous pouvez cliquer dessus dans la vue Structure pour accéder rapidement à l'emplacement correspondant dans votre source.
- Vous pouvez rapidement visualiser les valeurs renvoyées et résolues en regard de vos
prototypes de procédure.
- Lorsque vous utilisez la vue Structure, vous devez régulièrement régénérer le code source en cliquant sur le bouton
dans la partie supérieure de la vue.
La vue Structure est activée pour trois types de source iSeries natif :
ILE RPG
Lorsque vous éditez un source ILE RPG, vous devez régénérer le source pour que la vue Structure affiche jusqu'à trois noeuds de haut niveau :
- Définitions globales : pour les instructions de la procédure principale et de la sous-procédure.
- Procédure principale : paramètres et sous-programmes.
- Sous-procédures : toutes les procédures définies dans le programme, chacune avec trois noeuds pour les paramètres, les définitions locales et les sous-programmes :
Selon la manière dont vous avez codé votre source RPG, le noeud
Définitions globales et
Définitions locales de la vue Structure peut afficher jusqu'à six ou sept types d'élément lorsqu'il est développé :
- Des fichiers (seulement dans la section Définitions globales)
- Des structures de données
- Des indicateurs
- Des constantes
- Des zones
- Des prototypes
- Des listes de clés
En cliquant sur un élément dans cette arborescence, vous vous placez à l'endroit où l'élément est défini dans le source. Si vous cliquez sur une sous-procédure dans la section
Sous-procédures de la vue Structure, le positionnement dans le code source fractionnera toute la section de définition de la procédure.
Remarques sur la vue Structure pour le code source ILE RPG :- Toute valeur renvoyée ou résolue pour un prototype de procédure s'affiche en regard du nom du prototype.
- Si votre définition de procédure est un membre /copy, la barre verticale du source mis en évidence est positionnée sur l'emplacement /copy qui contient la définition de procédure. Si vous cliquez sur un prototype, le curseur est placé au début de la ligne où la procédure est prototypée.
- Si un mot clé utilise une constante nommée, la vue Structure affiche la valeur réelle de cette constante.
- Pour conserver la distinction entre les majuscules et les minuscules : les noms figurant dans la vue Structure utilisent la casse déjà utilisée lors de leur codage dans le source. Par exemple, si une entité est extraite d'une description externe, comme un fichier à description externe, les formats d'enregistrement et les noms de zones sont en majuscules lorsqu'ils sont affichés sous le noeud Fichier. Cependant, s'ils sont utilisés dans le programme dans une casse différente, ils apparaissent avec la casse préservée sous le noeud Zone.
- Les listes de clés KFLD peuvent contenir des zones clés acceptant les valeurs nulles, ce qui signifie que les clés peuvent contenir elles-mêmes des valeurs nulles. Pour indiquer
que vous voulez rechercher une clé à valeur nulle, vous devez spécifier un indicateur en Facteur 2. Généralement, les vérificateurs de programme considèrent la présence de Facteur 2 comme une erreur si vous n'avez pas codé le mot clé ALWNULL(*USRCTL) dans votre source. La zone n'apparaîtra pas non plus comme acceptant les valeurs nulles dans la vue Structure. Pour modifier ce comportement, vous pouvez coder ALWNULL(*USRCTL) dans votre source ou modifier l'option du vérificateur de programme pour indiquer que vous voulez toujours pouvoir utiliser des zones acceptant les valeurs nulles dans vos programmes. Pour définir cette option :
- Cliquez sur Fenêtre > Préférences.
- Dans la fenêtre Préférences, développez Systèmes distants > iSeries > Vérificateurs de programme > ILE RPG et cliquez sur l'onglet Données.
- Remplacez le paramètre Autoriser les valeurs NULL par *USRCTL pour indiquer que vous voulez rechercher des clés à valeur nulle avec Facteur 2 dans KFLD.
- Cliquez sur OK.
COBOL
Vous pouvez manipuler le code source COBOL dans la vue Structure comme vous le faites pour le code ILE RPG :
- La vue affiche quatre noeuds qui représentent les quatre divisions de niveau supérieur du code source COBOL :
Division d'identification, Division d'environnement, Division de données et Division de procédures.
- Développez l'un de ces noeuds pour afficher les éléments qu'il contient. Cliquez sur chaque élément pour placer le curseur à l'emplacement correspondant dans le code source.
Source DDS
Vous pouvez utiliser les membres source DDS dans la vue Structure. La vue contient davantage d'informations pour reproduire la structure des membres source DDS. Par exemple, des icônes sont affichées pour indiquer le type d'élément du source, comme un enregistrement ou un mot clé. La vue affiche la hiérarchie des fichiers, des enregistrements, des zones, des spécifications d'aide, des clés et des mots clés dans l'objet DDS sélectionné.
Dans la vue Structure, le noeud racine de l'objet DDS correspond au nom du fichier associé à une icône indiquant le type de fichier (également spécifié par l'extension du nom du fichier). Le reste des éléments situés sous le noeud racine représente la structure de l'objet DDS, par exemple un groupe d'enregistrements ou un ensemble de mots clés.
Lorsque vous cliquez deux fois sur l'un de ces éléments, le curseur apparaît à l'emplacement correspondant dans le source DDS.
Remarques sur la vue Structure pour le source DDS :- Les enregistrements peuvent être conservés au niveau du fichier, sous le noeud racine ou apparaître sous forme d'enfants d'un noeud Groupe d'enregistrements.
- Les libellés de référence des zones nommées résolues affichent la longueur des données résolues et les positions décimales de la zone. Si la référence de la zone n'est pas résolue, un incrément ou un espace apparaît en regard de la zone dans la vue Structure (en fonction de la présence ou de l'absence d'un incrément dans le source).
- Les conditions d'indicateur comprennent un libellé booléen particulier. Si la condition de l'indicateur
possède le format Condition d'indicateur 07 08 O 09,
les espaces entre les jeux de valeurs indiquent que la condition est booléenne et la présence d'un O indique or. Dans ce cas, la condition indique que 7 et 8 sont ON ou que 9 est ON.
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.