Rational Programming Patterns 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 Dossiers en tant qu'Eléments de niveau supérieur dans l'arbre, 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, 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, Ecrans ou Serveurs), elle vous permettra de générer l'instance 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 et 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 et export, copier et 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.

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 :
  • 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'un Programme, Ecran ou Serveur en faisant un clic droit sur une instance et en sélectionnant Générer > Génération Programme (ou Ecran, 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 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 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 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, faites un clic droit sur le fichier et choisissez Ouvrir avec > Editeur 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 cblmsp 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à. Ces lignes ont été saisies dans Pacbase et importées dans Rational Programming for System z avec la fonction de répartition des Macros, 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 .cblmsp sera ré-initialisé.
    La génération produit des fichiers d'extension .cblmsp. Pour voir le contenu de l'un d'eux, faites un clic droit dessus et sélectionnez Ouvrir avec et le l'éditeur de modèle approprié. . Selon votre choix, vous accèderez alors à l'éditeur .cblmsp 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).
Remarque : Pour les instances importées depuis Pacbase, la langue du squelette de la génération locale est identique à celle de Pacbase. En effet, cette information est reprise lors de l'extraction des modèles Pacbase et de l'importation. Elle est stockée au niveau de la Bibliothèque et s'applique à toutes les entités générables de cette Bibliothèque (Programme, Dialogue, Ecran, Dialogue Serveur, Serveur, Bloc Base de Données, Structure de Données).

Répartition des Macros

Le choix Répartition des Macros est disponible depuis un clic droit n'importe où dans le référentiel..

Il est conseillé de l'utiliser si vos Macros existent déjà dans Pacbase et si le fichier généré par la procédure de migration batch des Macros contient le code de plusieurs Macros.

Lors de la répartition des Macros, un fichier .cblmsp est automatiquement créé pour chaque Macro contenue dans le fichier généré de 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, Ecrans et Serveurs.

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.

Vérouiller une instance

Le choix Vérouiller est disponible dans le menu contextuel Equipe depuis une instance générée COBOL (.cbl) partagée. Ce choix apparaît uniquement si l'instance en question est sur le serveur connecté.

La barre d'outils

La vue Explorateur de designs a sa propre barre d'outils qui contient les commandes suivantes :
  • Tout réduire (icône Tout réduire). Cette commande réduit tous les noeuds de l'arbre de la vue Explorateur de designs.
  • Actualiser (icône Actualiser). Cette commande permet d'actualiser l'affichage de l'espace de travail après mise à jour.
  • 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 triangle blanc (Afficher le menu) 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.