La vue Structure constitue une excellente ressource pour éditer le source ILE RPG, COBOL, CL 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'Editeur 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 ILE RPG :
- Lorsque vous codez des calculs dans l'Editeur 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.
- Vous pouvez cliquer sur une définition dans la vue Structure
pour accéder rapidement à l'emplacement correspondant dans votre
source, sans devoir rechercher la définition.
- 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 pouvez actualiser votre source en cliquant
sur le bouton d'actualisation
,
dans la partie supérieure de la vue ou en appuyant sur les touches Ctrl+Maj+F5.
La vue Structure est activée pour les types de source
IBM® i natifs suivants :
ILE RPG
Lorsque vous éditez une source ILE RPG, la
vue Structure affiche jusqu'à trois noeuds de haut niveau :
- Définitions globales : définitions qui sont visibles dans tout le programme
- Procédure principale : paramètres et sous-programmes.
- Sous-procédures : toutes les procédures définies dans le programme, chacune avec jusqu'à 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 les types d'élément suivants lorsqu'il est développé :
- Fichiers
- Structures de données
- Indicateurs
- Constantes
- Zones
- Prototypes
- 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.
La vue Structure ILE RPG se régénère en arrière-plan ; vous pouvez continuer à utiliser
l'éditeur ou l'Explorateur de systèmes distants pendant cette mise à jour. Lorsque la vue de structure se régénère, l'action de régénération est désactivée.
Si la préférence Mettre à jour la vue Structure lorsque du texte est changé dans l'éditeur est activée sur la page des préférences
,
le contenu de la vue Structure est automatiquement mis à jour lorsque le texte est modifié dans l'éditeur. Pour mettre à jour
des informations externes qui sont modifiées, telles que des fichiers de base de données, cliquez sur le bouton Actualiser.
Si cette préférence n'est pas activée, il faut cliquer sur le bouton Actualiser pour mettre à jour le contenu de la vue Structure. La modification des préférences
n'affectera pas les fichiers source déjà ouverts dans l'éditeur.
Lorsque la préférence
Mettre à jour la vue Structure lorsque du texte est changé dans l'éditeur est activée, il y a quelques modifications dans la vue Structure :
- Les éléments sont répertoriés dans l'ordre où ils apparaissent dans la source.
- Un bouton Trier trie les éléments alphabétiquement.
- Un bouton Réduire tout réduit tous les éléments développés.
- Des listes de paramètres sont affichées.
Lorsque cette préférence est modifiée, on constate quelques modifications lors de l'utilisation de l'éditeur :
- Les informations relatives à l'élément situé sous la souris sont affichées dans une infobulle.
- Lorsque vous cliquez sur Ctrl à l'aide de la souris sur un élément représentant une référence, un lien est affiché. Si vous cliquez sur ce lien, vous vous placez à l'endroit où l'élément est défini dans le source.
- Les informations d'assistant de contenu sont mises à jour automatiquement, à l'exception des informations externes. Pour mettre à jour
des informations externes qui sont modifiées, cliquez sur le bouton Actualiser.
Pour des informations supplémentaires sur la vue Structure lorsque la préférence est activée, voir
http://www.ibm.com/support/docview.wss?uid=swg21592728
Remarques sur la vue Structure pour le code source ILE RPG :- Les références de description de fichier externe ou les fichiers de copie ne sont pas résolus s'ils dépendent de la liste de bibliothèques de la connexion hôte et s'ils résident dans une bibliothèque ne faisant pas partie de la liste. Vous pouvez modifier la liste des bibliothèques en y incluant ces bibliothèques.
Pour modifier la liste des bibliothèques de la session en cours, accédez à la vue Explorateur de systèmes distants. Sous le sous-système Objets associé à la connexion, sélectionnez le noeud Liste des bibliothèques et cliquez sur le bouton droit de la souris pour ouvrir le menu contextuel. Sélectionnez l'action Ajouter une entrée à la liste des bibliothèques.
Vous pouvez également définir la liste des bibliothèques initiale associée à la connexion pour les sessions ultérieures en ouvrant les propriétés de la connexion ou le sous-système Objet et en modifiant les paramètres Liste de bibliothèques initiale.
Une fois la liste des bibliothèques modifiée, vous devez actualiser la Vue Structure pour récupérer les références manquantes.
- Lorsque la préférence Mettre à jour la vue Structure lorsque du texte est changé dans l'éditeur est activée,
il se peut qu'une source ILE RPG avec des erreurs empêche la mise à jour de la vue Structure. Dans ce cas,
des icônes d'avertissement sont affichées dans l'éditeur.
- 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. Ceci ne s'applique pas si la préférence Mettre à jour la vue Structure lorsque du texte est changé dans l'éditeur est activée.
- 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 .
- Dans la fenêtre Préférences, développez 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.
CL
Vous pouvez utiliser les membres source CL dans la vue Structure. Cette vue affiche les libellés et les sous-routines dans le 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 indiqué 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
concernant 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.