Vous pouvez générer un Programme, un Ecran ou un Serveur
depuis Pacbase ou Rational Programming Patterns
for System z (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
for System z, vous devez :
- 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 oui, 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 .cblmsp contenant
le code tagué des Macros.
Utilisez le choix Répartition
des Macros, accessible depuis le menu contextuel de la
vue Explorateur de designs, pour importer les
fichiers des Macros dans le référentiel. Si le fichier contient le
code de plusieurs Macros, un fichier .cblmsp sera
créé par Macro.
- Ensuite, vous devez générer votre Programme, Ecran ou Serveur
dans Pacbase puis
:
- Utiliser la fonction d'aide à la migration,
- Ou mettre manuellement le fichier .cbl généré
(par un glisser-déplacer ou un copier-coller) à l'emplacement
de la cible de génération Rational Programming Patterns for System
z (par défaut avec les fichiers de design, ou dans la cible COBOL
indiquée dans la Définition de l'instance
générée).
- Vous devez générer le design du Programme, Ecran ou
Serveur (fichier .cbl) dans Rational Programming
Patterns for System z. 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 for System z, 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 for System z 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 produit :
- Un fichier .cbl imbriqué sous l'instance
de Programme, Ecran ou Serveur dans la vue Explorateur de
designs.
- Pour un Ecran, un fichier de description de la map (.bms, .mfs ou .map)
imbriqué sous l'instance d'Ecran dans la vue Explorateur
de designs.
- Les fichiers de metadonnées du design généré (.cblpdp)
et de la map (.mappdp). Ces fichiers sont visibles
dans la vue Explorateur de packages.
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 :
- 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 :
- 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).
Remarque : L'éditeur LPEX System z pour COBOL PDP est toujours disponible
mais il est conseillé d'utiliser l'éditeur COBOL PDP.