Vous pouvez générer une instance de Programme, Ecran ou
Serveur depuis Pacbase ou Rational Programming Patterns
(génération locale). Si vous générez dans Pacbase, vous obtenez un
source complet, incluant à la fois le code provenant de la génération
du design et le code provenant des insertions de spécifique. Vous
devez ensuite utiliser l’aide à la migration pour migrer le source
dans votre espace de travail local. A l’issue de la migration, le
source complet est disponible dans votre espace de travail local.
Le code spécifique est différencié du code généré dans l'éditeur
COBOL PDP.
Procédure
- Pour générer
le COBOL d’un Programme, Ecran ou Serveur créé dans Rational Programming
Patterns, vous devez effectuer l’une des actions suivantes :
- Faites un clic droit sur une instance de Programme, Ecran
ou Serveur dans la vue Explorateur de designs et
sélectionnez , ou , selon le type d'entité.
- Saisissez une ligne de commande rpp –generate à
partir de l'invite de commande.
- Cliquez sur
dans la barre
d’outils de la vue Design de l’instance. Pour
cela, vous devez avoir généré l’instance une première fois et avoir
ouvert son code dans l’éditeur COBOL PDP.
- Pour générer le COBOL d’un Programme, Ecran ou Serveur
qui existe déjà dans Pacbase,
vous devez effectuer les actions suivantes :
- Générez l’instance dans Pacbase pour obtenir un
généré complet, incluant le code provenant de la génération du design
et le code provenant des insertions de spécifique.
- Si l'instance appelle des Macros, générez ces Macros dans Pacbase avec la procédure MIMA.
Vous devez ensuite importer le fichier résultat avec la fonction
de répartition des Macros. A l'issue de cette étape, les sources des
Macros sont répartis dans les Macros correspondantes des différents
projets de votre espace de travail local.
- Générez l'instance dans Pacbase avec la procédure MIA1 (pour
les Programmes), MIA2 (pour les Ecrans), MIA3 (pour
les Clients TUI), ou MIA4 (pour les Serveurs).
- Migrez le design de l’instance dans votre espace de
travail pour pouvoir le voir et le modifier dans son éditeur formaté.
Pour cela, vous devez exécuter la procédure MIBA, MIBR ou MIBJ et
importer le fichier résultat.
Remarque : La commande
rpp --automaticMigration permet
de déclencher une migration dans son intégralité. Elle permet d'enchaîner
l'import, la répartition des Macros et l’aide à la migration.
- Utilisez la fonction d’aide à la migration (rpp --migrationHelp) pour migrer le code de l’instance dans l’espace
de travail local. Cette étape est obligatoire car elle produit tous
les fichiers nécessaires à une génération correcte.
La
fonction d’aide à la migration copie le fichier .cbl Pacbase dans votre espace
de travail et lance la génération locale. Elle prend en compte le
code généré dans Pacbase,
lance la chaîne de génération locale et effectue les post-traitements
et la réconciliation de code. Elle produit aussi le fichier de métadonnées
associé contenant des données requises pour la génération.
La
fonction d’aide à la migration compare ensuite le contenu de la génération
Pacbase et de la génération
locale. Si des différences autres qu’un formatage ou un commentaire
sont détectées, elle positionne des avertissements. Vous devez valider
le résultat. Le résultat de la génération locale est enregistré dans
un bac à sable. Son contenu ne remplacera pas le contenu du fichier
.cbl déjà
copié dans votre espace de travail sans demande explicite de votre
part.
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'import.
Elle est stockée au niveau de la Bibliothèque.
Après
avoir validé le résultat de l’aide à la migration, vous pouvez travailler
sur le design ou le code de votre instance, puis la générer à nouveau
pour prendre en compte les modifications.
Résultats
La génération locale 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 mappe pour un Ecran, (.map, .bms ou .mfs),
imbriqué sous l'instance d'Ecran dans la vue Explorateur
de designs.
- Un fichier de métadonnées du design généré (.cblpdp),
et un fichier de métadonnées de la mappe 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.