Vous pouvez générer une instance de Programme, Ecran ou Serveur depuis Pacbase ou Rational
Programming Patterns (génération locale). Un Serveur désigne aussi, dans ce contexte, un Moniteur de
Communication ou un Dossier. 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 :
- 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 : 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'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, Serveur, Moniteur de Communication ou
Dossier produit les fichiers suivants :
- Un fichier .cbl imbriqué sous l'instance 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. Pour des explications sur les constantes, variables et fonctions
générées, référez-vous à Description du COBOL généré à partir d'un Programme, Ecran ou Serveur.
- 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.