Rational Programming Patterns

Assistant de génération des Copybooks

Cet assistant vous permet d'obtenir des descriptions COBOL de Structures de Données dans un fichier. Dans cet assistant, vous devez donc sélectionner la Structure de Données ou certains Segments, , indiquer un fichier de destination et valoriser des paramètres tels que le type de génération, l'emplacement COBOL, le type de format... Chaque description ainsi obtenue est stockée dans une bibliothèque de sources et peut alors être récupérée dans les programmes par utilisation de l'ordre COPY.

Pour voir le contenu du fichier contenant la description , faites un clic droit dessus et sélectionnez Ouvrir avec > Editeur COBOL.
Une même Structure de Données peut donner lieu à la génération de plusieurs descriptions différentes. Chaque description est adaptée à un besoin particulier d'utilisation dans les programmes : en FILE SECTION ou en WORKING-STORAGE SECTION, en tenant compte des formats internes, d'entrée... Pour voir l' exemple d'un Format Guide DATA généré dans :
  • La FILE SECTION, cliquez ici,
  • La WORKING-STORAGE SECTION, cliquez ici.
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.
Structures de Données sélectionnées
Vous voyez ici un arbre avec la Structure de Données à partir de laquelle vous avec ouvert l'assistant, et tous ses Segments constitutifs.

La Structure de Données est sélectionnée par défaut. Les Copybooks indiqués dans tous ses Segments sont donc générés par défaut.

Pour générer les Copybooks de certains Segments uniquement, sélectionnez les Segments appropriés.

Destination
Cette zone doit contenir le chemin complet du fichier de destination qui contiendra les descriptions COBOL générées.

Ce fichier doit avoir une extension .cpy. Le nom du fichier est par défaut le nom de cette Structure de Données.

Type de génération
Vous indiquez ici si la description générée doit inclure les Textes ventilés ou si elle sera exploitée par VAP Connector.
Tableau 1. Valeurs du type de génération
Valeurs Signification
DC1 Génération de la description de la Structure de Données sans prise en compte des textes ventilés
DC2 Génération de la description de la Structure de Données avec prise en compte des textes ventilés
DC3 Génération, en plus du source COBOL des Segments, des lignes de description des Rubriques et des Segments sous forme de commentaires qui seront exploités par VAP Connector
DSQC3 Génération, en plus du source COBOL des Segments, des lignes de description des Rubriques et des Segments sous forme de commentaires qui seront exploités par VAP Connector
Code Structure de Données
Ceci est le code de la Structure de Données dans la description.

La valeur par défaut de cette zone est la valeur saisie dans la zone Nom de l'onglet Définition.

Nom externe de la Structure de Données
Saisissez ici le nom du fichier connu dans les programmes et utilisé dans l'instruction COPY.

Ce nom est de 8 caractères maximum.

Code pour emplacement COBOL
Sélectionnez ici l'emplacement de la description dans le programme généré.
Tableau 2. Valeurs possibles du code pour l'emplacement COBOL
Valeurs Signification
W WORKING-STORAGE SECTION ou LINKAGE SECTION.

Les diverses structures d'enregistrement sont redéfinies de manière explicite

F FILE SECTION

Les diverses structures d'enregistrement ne comporteront pas de clause REDEFINES, cette dernière étant implicite.

V Génération d'un fichier variable.
Variante
Vous précisez ici à quelle variante de langage il faut adapter la description générée. Cette adaptation ne concerne pas les clauses USAGE.
Remarque : Certaines variantes ne sont pas supportées ou sont obsolètes.
Tableau 3. Valeurs possibles de la variante COBOL
Valeurs Signification
0 Adaptation au COBOL ANS IBM MVS
1 Adaptation au COBOL ANS IBM VSE
3 Adaptation au COBOL MICROFOCUS
4 Adaptation au COBOL GCOS7
5 Adaptation au COBOL GCOS8
7 Adaptation au COBOL HP-3000
8 Adaptation au COBOL UNISYS Série A
F Adaptation au COBOL TANDEM
I Adaptation au COBOL DEC/VAX VMS
K Adaptation au COBOL ICL 2900
M Adaptation au COBOL GCOS6
O Adaptation au COBOL AS 400
U Adaptation au COBOL UNISYS série 2200
X Adaptation au COBOL IBM for OS/390
Type de format
Vous indiquez ici quel type de format de Rubrique sera utilisé dans la description.
Tableau 4. Valeurs possibles du type de format
Valeurs Signification
E Description tenant compte des formats d'entrée.
I Description tenant compte des formats internes avec les usages associés
S Description tenant compte des formats d'édition.
Type de description
Cette zone vous permet d'obtenir plusieurs modes d'agencement des enregistrements d'une S.D. à partir d'une description unique.
Tableau 5. Valeurs possibles du type de description
Valeurs Signification
  Enregistrements redéfinis implicitement ou explicitement.
1 Enregistrements à la suite (partie commune suivie des différentes parties spécifiques) sans valeurs initiales ni répétition d'enregistrement.

Si la description de la S.D. apparaît en FILE SECTION COBOL, le nombre niveau de description doit être 2.

2 Enregistrements à la suite avec prise en compte des valeurs initiales spécifiées sur les lignes d'appel des Rubriques dans les Segments, ou à défaut initialisation à blanc ou zéro selon le format. (Option réservée aux utilisations de description en WORKING-STORAGE SECTION).
3 Enregistrements à la suite avec prise en compte du nombre de postes spécifié sur la Définition des Segments.

Si la description de la S.D. apparaît en FILE SECTION COBOL, le nombre niveau de description doit être 2.

Ce type de description ne peut être employé pour une S.D. ayant un nombre de postes sur la partie commune.

4 Enregistrements à la suite avec prise en compte du nombre de postes spécifié sur la Définition des Segments. Le niveau de description associé doit être 3.

Le niveau 2 permet d'accéder à la table constituée par la répétition d'un même enregistrement (FFEET).

Le niveau 1 regroupe l'ensemble des informations de la S.D. (partie commune et parties spécifiques répétées ou non).

Ce type de description ne peut être employé pour une S.D. ayant un nombre de postes sur la partie commune.

Niveau de description
Cette zone, employée en relation avec la précédente, définit le nombre niveau des descriptions de S.D., d'enregistrements ou de Rubriques. Dans les descriptions ci-après, on entend par niveau S.D. la zone dd00.
Tableau 6. Valeurs possibles du niveau de description
Valeurs Signification
1 Niveau 01 pour S.D. et enregistrements.

Si la description de la S.D. apparaît en FILE SECTION COBOL, les enregistrements doivent obligatoirement être redéfinis.

Si la S.D. est sans partie commune avec une description étalée, le niveau fichier n'apparaît pas.

2 Niveau 01 pour S.D. et 02 pour enregistrements. Le niveau 01 n'apparaît pas si le type de description est à blanc.
3 Niveau 02 pour S.D. 03 pour enregistrements, lorsqu'il est associé à un type de description à 1, 2 ou 3.

Niveau 01 pour S.D. 03 pour enregistrements, lorsqu'il est associé à un type de description à 4.

Niveau 03 pour S.D et enregistrements, lorsqu'il est associé à un type de description à blanc.

Sélection enregistrement
En l'absence de sélection, tous les Segments rattachés à la Structure de Données seront sélectionnés.

La sélection est la suite des différents codes enregistrements désirés. Ces codes ne sont pas obligatoirement classés

La sélection de la partie commune d'un fichier multistructure doit être explicitement précisée.


Conditions d'utilisation | Commentaires en retour

Ce centre de documentation utilise la technologie Eclipse. (http://www.eclipse.org)