Rational Developer for System z

Vue Explorateur de designs

Cette vue vous permet de voir et modifier le design de vos applications. Elle vous permet d'effectuer de multiples tâches sur les instances qui les composent : création, modification, import/export, recherches, générations....

Si vous avez choisi d'afficher les types d'entité en tant qu'Eléments de niveau supérieur dans l'arbre (choix par défaut, modifiable avec le triangle inversé blanc de la barre d'outils), vous verrez s'afficher un contenu similaire à celui-ci :
Figure 1. Vue Explorateur de designs affichant les entités comme Eléments de niveau supérieur
Vue Explorateur de designs
La vue Explorateur de designs contient des arbres.

Création de référentiels ou d'instances

Si vous faites un clic droit sur un référentiel ouvert, une entité ou une instance, le menu contextuel vous permet de :
  • Créer un référentiel (Nouveau > Référentiel...).
  • Créer des instances (Nouveau > Rubrique Pac..., ou Nouveau > Programme Pac..., ... ou toute autre entité).
    Depuis l'assistant de création qui s'ouvre, vous pouvez aussi créer une instance dérivée de Programme, Ecran, Structure de Données ou Dialogue en cochant la boîte Dériver. Cette instance, qui pointe vers son instance de référence, ne contiendra aucun élément de design mais, selon le type de dérivation sélectionné :
    • Elle vous permettra de générer l'instance de référence depuis une autre bibliothèque, sans dupliquer son design.
    • Pour les entités pouvant contenir du code spécifique (Programmes et Ecrans), elle vous permettra de générer le Programme ou l'Ecran de référence : le code source complet (le code généré et le code spécifique) de l'instance de référence deviendra le code généré dans l'instance dérivée et ce code généré sera ensuite réconcilié avec le code spécifique de l'instance dérivée.

Consultation/modification du chemin de compilation Design

Ce chemin représente la hiérarchie des projets qui sera explorée de façon ascendante afin de résoudre les liens dynamiques et les références entre les instances des différents projets du référentiel courant.

Pour voir et modifier ce chemin, double-cliquez sur un référentiel ouvert et sélectionnez Propriétés.

Import/export, copier/coller d'instances

Si vous faites un clic droit sur un référentiel ouvert, une entité ou une instance, le menu contextuel vous permet :
  • D'importer/exporter un groupe d'instances, rassemblées dans un fichier.
  • De copier, coller ou supprimer des instances.

Rafraîchissement, reconstruction de l'espace de travail

Si vous faites un clic droit sur un référentiel ouvert, une entité ou une instance, le menu contextuel vous permet de :
  • Rafraîchir l'affichage de l'espace de travail après mise à jour.
  • Reconstruire votre environnement, afin de vous assurer de sa cohérence. Tous les fichiers et les projets de votre espace de travail sont ouverts et, si les fichiers contiennent des instances, ils sont analysés et réparés (l'existence des instances, leurs références, leurs liens vers les mots-clés... sont vérifiés et mis à jour si nécessaire).
  • Recréer les liens entre designs et générés.

Ouverture, renommage, déplacement, comparaison d'instances

Si vous faites un clic droit sur une instance (quelle que soit l'entité), vous pouvez :
  • Ouvrir l'instance. L'instance s'affiche alors dans son éditeur PDP dédié.
  • Ouvrir l'instance avec... différents éditeurs.
    • Le premier éditeur est l'éditeur de design dédié à l'entité. Cet éditeur est l'éditeur par défaut.
    • Trois autres éditeurs sont proposés par défaut : éditeur de texte, éditeur système et éditeur en place. Vous pouvez aussi indiquer d'autres éditeurs dans vos préférences, accessibles par le menu Fenêtre, choix Préférences > Général > Editeurs > Associations de fichiers.
  • Reconcevoir l'instance. Vous pouvez :
    • Renommer l'instance. Le nouveau nom sera automatiquement propagé dans tous les liens de l'instance (références, mots-clés appels d'instances, listes...). Ceci évite toute incohérence.
    • Déplacer une ou plusieurs instances sélectionnées dans la liste vers un autre projet et/ou package, tout en conservant tous leurs liens (références, mots-clés, appels d'instances...).
Vous pouvez ouvrir l'éditeur de comparaison sur des instances PDP en sélectionnant Comparer à dans le menu contextuel. Vous pouvez comparer :
  • Deux ou trois instances entre elles.
  • Deux ou trois versions d'une même instance. Ces versions peuvent être extraites de l'historique local ou d'un référentiel distant.
Remarque : Une comparaison tridirectionnelle n'est possible que si vous devez déclarer une des instances ou versions en tant qu'ancêtre commun.
Dans l'éditeur de comparaison qui s'affiche alors dans la zone de l'éditeur, vous pouvez parcourir les différences. Pour activer les boutons permettant de copier ces différences, double-cliquez sur les différences dans le panneau supérieur de l'éditeur de comparaison.

Recherche d'instances ou de références

Vous pouvez rechercher :
  • Des instances en cliquant sur le bouton Recherche de la barre d'outils ou le menu Rechercher et en sélectionnant l'onglet Recherche de designs.
  • Les Références d'une instance en faisant un clic droit sur l'instance (quelle que soit l'entité) et en sélectionnant ce choix. Vous pouvez rechercher ses super-références (les instances dans lesquelles elle est appelée) ou ses sous-références (les instances qu'elle appelle). La sélection d'un de ces choix vous fait basculer vers la vue Références, qui présente les résultats de la recherche.

Différents types de génération

Vous pouvez générer :
  • Le design d'une instance sélectionnée, c'est à dire :
    • Un Programme en faisant un clic droit sur un Programme et en sélectionnant Générer > Génération Programme Pac,
    • ou un Ecran en faisant un clic droit sur un Ecran et en sélectionnant Générer > Génération Ecran Pac,
    • Un Serveur en faisant un clic droit sur un Serveur et en sélectionnant Générer > Génération Serveur Pac,
    La génération produit un fichier d'extension .cbl, imbriqué sous l'instance dans la vue Explorateur de designs. Faites un clic droit sur ce fichier et choisissez Ouvrir avec > Editeur LPEX System z pour COBOL PDP pour accéder à l'éditeur de COBOL PDP et à ses vues qui vous permettent de travailler sur le code et le design de l'instance. (Une aide est accessible à partir de cet éditeur et de ses vues).
  • Un Bloc Base de Données. Pour cela, faites un clic droit sur un Bloc de Données et sélectionnez Générer > Génération Bloc Base de Données. Vous pouvez alors choisir l'emplacement du fichier résultat, d'extension .txt.
  • Les libellés d'erreur de vos applications, c'est à dire les libellés d'erreur :
    • Batch en sélectionnant Générer > Génération des libellés d'erreur depuis le niveau référentiel ou Structure de Données (entité ou instance).
    • Dialogue en sélectionnant Générer > Génération des libellés d'erreur associés depuis une instance de Dialogue ou d'Ecran.
    La génération produit un fichier d'extension .txt que vous devrez intégrer dans le fichier des libellés d'erreur utilisé par les applications.
  • Des descriptions COBOL d'une ou plusieurs Structures de Données dans un fichier (copybook) en sélectionnant Générer > Génération des COPYBOOKS depuis le niveau référentiel ou Structure de Données (entité ou instance).

    Chaque description ainsi obtenue est mémorisée sous sa forme COBOL dans une bibliothèque de sources et peut alors être récupérée dans les programmes par utilisation de l'ordre COPY.

    Une même Structure de Données peut donner lieu à la génération de plusieurs descriptions différentes, chacune étant adaptée à un besoin particulier d'utilisation dans les programmes (en FILE SECTION ou en WORKING-STORAGE SECTION en tenant compte des formats internes, d'entrée...).

    La génération produit un fichier d'extension .cpy. Pour voir son contenu, ouvrez la vue Navigateur, sélectionnez le projet/package approprié, faites un clic droit sur le fichier et choisissez Ouvrir avec > Editeur LPEX System z pour COBOL PDP.

  • Les fichiers qui vont contenir les lignes de code d'une ou plusieurs Macros en sélectionnant le choix Générer > Génération des cblgen depuis le niveau référentiel ou Macro (entité ou instance). Vous utilisez ce choix si vous voulez :
    • Saisir les lignes de code d'une Macro quand celles-ci n'existent pas encore.
    • Ecraser les lignes de code d'une Macro qui existent déjà (saisies dans Pacbase et importées dans Rational Programming for System z (par un glisser-déplacer ou un copier/coller) dans la vue Navigateur, ou directement saisies dans Rational Programming for System z). Si des lignes de code existent déjà, un message vous prévient que le contenu du fichier .cblgen sera ré-initialisé.
    La génération produit des fichiers d'extension .cblgen. Pour voir leur contenu, ouvrez la vue Navigateur, sélectionnez le projet/package approprié, faites un clic droit sur un fichier .cblgen et choisissez Ouvrir avec > Editeur PDP de Macro (modèle batch) ou Ouvrir avec > Editeur PDP de Macro (modèle batch). Selon votre choix, vous accèderez alors à l'éditeur .cblgen et à la vue Arbre des tags de la Macro, dans lesquels vous pourrez saisir les lignes de code de la Macro. (Une aide est accessible à partir de cet éditeur et de cette vue).

Répartition des Macros

Le choix Répartition des Macros est disponible depuis le niveau référentiel ou le niveau Macro (entité ou instance).

Il est conseillé de l'utiliser si vos Macros existent déjà dans Pacbase et si elles ont été générées dans un seul fichier par la procédure de migration batch des Macros.

Si vous n'utilisez pas ce choix, vous devrez alors mettre ce fichier dans la vue Navigateur (par un glisser-déplacer ou un copier-coller) et lui attribuer une extension .cblgenl. Ce fichier contiendra alors les lignes de code de toutes les Macros générées.

En revanche, si vous répartissez les Macros, un fichier .cblgen est automatiquement créé pour chaque Macro contenue dans le fichier généré de Pacbase. Les fichiers cblgen sont créés dans les packages de la vue Navigateur en fonction de la bibliothèque de génération Pacbase.

Vous pouvez faire un clic droit sur un de ces fichiers et sélectionner Ouvrir avec > Editeur PDP de Macro pour accéder à l'Arbre des tags de la Macro et à l'Editeur de Macros, dans lesquels vous pouvez voir et modifier le code de la Macro.

Aide à la migration

Le choix Aide à la migration est disponible depuis le niveau instance des Programmes ou Ecrans.

Cette fonction est utile lors de la migration dans Rational Programming for System z du code généré depuis Pacbase. Elle positionne des avertissements sur les lignes générées à partir du design de l'instance dès qu'elle détecte des différences entre le code généré depuis Pacbase et le code généré en local.

La barre d'outils

La vue Explorateur de designs a sa propre barre d'outils qui contient les commandes suivantes :
  • Précédent (icône Précédent). Cette commande affiche la hiérarchie affichée immédiatement avant l'affichage actuel. Ce bouton est activable dès que vous avez double-cliqué sur une ligne d'entité pour visualiser ses instances seules dans la vue Explorateur de designs. Cliquer sur ce bouton renvoie la hiérarchie à partir de laquelle vous avez activé la commande. Si vous survolez le bouton, vous verrez où vous mènera la commande.
  • Suivant (icône Suivant). Cette commande affiche la hiérarchie affichée immédiatement après l'affichage actuel.. Par exemple, si vous avez sélectionné la commande Précédent et que vous sélectionnez la commande Suivant dans la sortie résultante, la vue est renvoyée vers la hiérarchie à partir de laquelle vous avez activé la commande Précédent. Si vous survolez le bouton, vous verrez où vous mènera la commande.
  • Haut (icône Haut). Cette commande permet de remonter jusqu'au niveau référentiel. Si vous survolez le bouton, vous verrez où vous mènera la commande.
  • Tout développer (icône Tout développer). Cette commande développe tous les noeuds de l'arbre de la vue Explorateur de designs.
  • Tout réduire (icône Tout réduire). Cette commande réduit tous les noeuds de l'arbre de la vue Explorateur de designs.
  • Lier à un éditeur (icône Lier à un éditeur). Cette commande permet de lier la sélection de la vue Explorateur de designs à un éditeur actif. Si le bouton n'est pas cliqué, le changement de l'éditeur actif ne fera pas passer la sélection, dans l'arbre de la vue Explorateur de designs, sur l'instance en cours d'édition.
  • Modifier l'affichage et le tri des instances dans l'arbre de la vue Explorateur de designs.. Cliquez sur le triange blanc et sélectionnez :
    • Eléments de niveau supérieur pour indiquer quel type d'élément constituera l'élément le plus haut de la hiérarchie dans l'arbre de chaque référentiel : les dossiers (par défaut. Il s'agit des types d'entités), les packages ou les projets.
    • Trier pour indiquer un nouveau critère de tri : par nom (par défaut), package ou projet.
    • Afficher pour afficher des informations supplémentaires sur la ligne de chaque instance dans l'arbre : package, projet et/ou libellé. Les trois valeurs peuvent être combinées. Pour supprimer l'affichage de l'une des informations sélectionnées, sélectionnez-la à nouveau dans le menu et elle se décochera.
    Ce nouveau paramétrage sera automatiquement sauvegardé et associé à la vue Explorateur de designs, jusqu'à ce que vous le changiez.

Conditions d'utilisation | Commentaires en retour

Ce centre de documentation utilise la technologie Eclipse. (http://www.eclipse.org)