Vous pouvez générer un Programme, un Ecran ou un Serveur
depuis Pacbase ou Rational Programming Patterns
(génération locale). Si vous générez dans Pacbase, vous obtenez un
généré complet, incluant à la fois le code provenant de la génération
du design et le code provenant de la génération des insertions de
spécifique. Si vous générez localement, vous ne générez que le code
provenant de la génération du design. Si vous mettez le fichier provenant
de la génération Pacbase avec
les fichiers de design (par défaut), ou dans la cible COBOL indiquée
dans la Définition de l'instance générée,
et si vous générez l'instance localement, le code spécifique
sera différencié du code généré dans l'éditeur COBOL PDP. Vous pourrez alors
modifier le code spécifique ou ajouter des changements spécifiques.
Vous pourrez aussi modifier le design de l'instance et regénérer.
La génération conservera votre code spécifique, tout en prenant en
compte les modifications de design : ce processus est nommé réconciliation.
Procédure
- Si vous
créez un Programme, Ecran ou Serveur dans Rational Programming Patterns,
vous devez effectuer les actions suivantes :
- Spécifier son design dans son éditeur de design dédié.
Vous ouvrez cet éditeur en faisant un clic droit sur une instance
et en sélectionnant Ouvrir. Vous pouvez aussi
double-cliquer sur l'instance.
- Générer l'instance dans la vue Explorateur
de designs en faisant un clic droit dessus et en choisissant (ou , ou ).
- Vous pouvez aussi générer et modifier un Programme, Ecran
ou Serveur qui existe déjà dans Pacbase.
- Pour voir et modifier le design dans son éditeur formaté,
vous devez l'avoir importé depuis Pacbase ou chargé depuis
Rational Team Concert.
- Vous devez générer dans Pacbase pour obtenir un
généré complet, incluant le code provenant de la génération du design
et le code provenant de la génération des insertions de spécifique.
- Vous devez d'abord voir si l'instance appelle des Macros.
Si c'est le cas, vous devez en premier lieu générer ces Macros
dans Pacbase. La
génération préalable du code des Macros est obligatoire. Vous obtenez
un fichier contenant le source des Macros.
Remarque : Le choix Répartition
des Macros, accessible depuis le menu contextuel de la
vue Explorateur de designs, vous permet d'importer
les fichiers des Macros dans le référentiel. Si le fichier contient
le code de plusieurs Macros, un fichier source sera créé par Macro.
- Ensuite, vous devez générer votre Programme, Ecran ou Serveur
dans Pacbase puis
utilisez l'une des commandes suivantes :
- La commande de migration automatique. Cette commande permet de
déclencher une migration dans son intégralité. Elle permet l'enchaînement
de l'import, la répartition des Macros...
- La commande d'aide à la migration.
- Vous devez générer le design du Programme, Ecran ou
Serveur (fichier .cbl) dans Rational Programming
Patterns. Cette génération est obligatoire et ne supprime pas le fichier .cbl produit
par la génération Pacbase.
Pour générer dans Rational Programming Patterns, faites un clic droit
dessus dans la vue Explorateur de designs et
sélectionnez (ou , ou ).
Remarque : La langue du squelette de
génération de l'instance est identique à celle de Pacbase car 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.
Une fois les
générations Pacbase et
Rational Programming Patterns effectuées, le généré (provenant du
design) peut être différencié du spécifique. Vous pouvez alors modifier
le design d'une instance contenant du spécifique. A l'issue
d'une regénération, le nouveau code prendra en compte le code
provenant de la génération du design et inclura le code provenant
de la génération des insertions de spécifique. De plus, les insertions
de spécifique seront déplacées automatiquement de façon à être adaptées
au mieux au nouveau design. Ce mécanisme s'appelle la réconciliation.
Résultats
La génération d'un Programme, Ecran ou
Serveur produit les fichiers suivants :
- Un fichier .cbl imbriqué sous l'instance
de Programme, Ecran ou Serveur dans la vue Explorateur de
designs. Si vous faites un clic droit dessus et sélectionnez , les instances ayant participé à sa génération s'affichent
dans la vue Références.
- Un fichier de description de la map pour un Ecran, (.map, .bms ou .mfs),
imbriqué sous l'instance d'Ecran dans la vue Explorateur
de designs. Si vous faites un clic droit dessus et sélectionnez , les instances ayant participé à sa génération s'affichent
dans la vue Références.
- Un fichier de metadonnées du design généré (.cblpdp),
et un fichier de métadonnées de la map pour les Ecrans (.mappdp, .bmspdp ou .mfspdp).
Ces fichiers sont visibles dans la vue Explorateur de packages :
Ils ne doivent pas être modifiés mais ils doivent être versionnés
en même temps que les autres fichiers générés.
Important : Les fichiers sont générés sous le nom indiqué
dans la zone Code programme généré de la Définition de
l'instance. Le nom du fichier généré peut donc être différent
du nom de l'instance.
Les fichiers générés sont stockés par
défaut dans le même dossier que les fichiers de design. Vous pouvez
cependant les séparer des fichiers de design dans le projet de génération.
Vous pouvez aussi changer le projet et le dossier de génération. Pour
plus d'informations, cliquez sur le lien consacré à l'emplacement
des fichiers générés.
Pour voir et pouvoir modifier le code
généré, développez le Programme, Ecran ou Serveur dans la vue Explorateur
de designs. Faites un clic droit sur le fichier .cbl et
sélectionnez . Vous voyez alors les éléments suivants :
- Le code généré dans l'éditeur COBOL PDP. Cet éditeur offre
des fonctions additionnelles, en plus de celles déjà disponibles dans
l'éditeur COBOL standard, pour vous aider à modifier le code.
- Le design de l'instance dans l'arbre de la vue Vue
du Design. Des assistants spécialisés vous aident à modifier
le design de l'instance.
- Les noeuds générés dans la vue Structure du code généré.
Vous pouvez accepter ou rejeter les choix faits par la réconciliation.
Toutes les éventuelles incohérences sont affichées dans la
vue Problèmes.
Si le code généré ne satisfait
pas pleinement vos besoins, vous pouvez le modifier en insérant du
code, ou en supprimant ou écrasant certaines parties. Les modifications
apportées s'appellent des changements spécifiques.
Remarque : Des
micro-patterns et des fragments, comparables à des micro-générateurs,
offrent un masque de saisie pour indiquer certains changements spécifiques.
Si
sous effectuez un changement spécifique dans l'
Editeur
COBOL PDP,
ce changement est immédiatement visible dans la vue
Structure
du code généré. Sauvegardez le nouveau code. Pour restaurer
le code d'origine, ouvrez la vue
Structure du code
généré et sélectionnez
Restaurer le code généré dans
le menu contextuel.
PDP reconnaîtra
alors que le code correspond à un code généré et grisera les lignes
correspondantes.
Pour indiquer des améliorations ou des corrections
d'anomalies nécessitant une modification du design, effectuez
les actions suivantes :
- Ouvrez la Vue du Design. Modifiez le design,
sauvegardez-le et regénérez le programme ou l'Ecran pour lancer
la réconciliation
- Ouvrez la vue Structure du code généré pour
voir si des erreurs ou des avertissements ont été signalés par la
réconciliation. Vous devez corriger les erreurs et statuer sur les
avertissements (c'est à dire valider ou rejeter les choix faits
par la réconciliation).