Vous pouvez générer un Programme, un Ecran ou un Serveur
depuis Pacbase ou Rational Programming Pattern
for System z (RPPz). 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 dans RPPz, 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 à l'endroit
requis dans RPPz (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), et si vous générez l'instance dans
RPPz, le code spécifique sera différencié du code généré dans l'éditeur
LPEX pour 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 RPPz, 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 .cblgen 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 .cblgen sera
créé par Macro.
- Ensuite, vous devez générer votre Programme, Ecran ou Serveur
dans Pacbase puis
:
- Vous devez générer le design du Programme/Ecran/Serveur
(fichier .cbl) dans RPPz. 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 RPPz, faites un clic droit dessus dans la vue Explorateur
de designs et sélectionnez (ou , ou ).
Une fois les générations Pacbase et RPPz 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 Navigateur.
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'information,
cliquez sur le lien ci-dessous, consacré à la localisation 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 :
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. 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).