Rational Developer for System z, Version 7.6

Assistant de génération des Copybooks

Cet assistant vous permet d'obtenir des descriptions COBOL de Structures de Données ou de Blocs Base de Données SQL dans un fichier. Dans cet assistant, vous devez donc sélectionner une ou plusieurs Structures de Données, 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.

Le fichier contenant la description est générée dans la vue Navigateur. Pour voir son contenu, faites un clic droit dessus et sélectionnez Ouvrir avec > Editeur LPEX system z.
Une même Structure de Données peut donner lieu à la génération de plusieurs descriptions différentes, chacune étant 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.

Quand vous générez la description d'un Bloc Base de Données SQL, deux niveaux de clauses COPY sont générés : un pour les host variables et un pour les indicateurs de présence.

Structures de Données sélectionnées
Si vous avez demandé la génération de Copybooks depuis le niveau référentiel ou entité, toutes les Structure de Données sont sélectionnées par défaut, alors que si vous l'avez demande depuis une Structure de Données, seule cette Structure est sélectionnée par défaut.
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. Si vous avez ouvert l'assistant de génération des Copybooks depuis une Structure de Données particulière, le nom du fichier est par défaut le nom de cette Structure de Données. En revanche, si vous avez ouvert l'assistant depuis le référentiel ou le niveau entité Structure de Données, le nom du fichier est par défaut la première Structure de Données du référentiel.

Le fichier de destination est créé dans la vue Navigateur. Par défaut, il est créé dans le projet et le package qui contiennent déjà la ou les Structure(s) de Données correspondante(s).

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.

Pour obtenir la description d'un Bloc SQL, vous devez sélectionner une des valeurs DSQC possibles. Deux niveaux de clauses COPY sont générés : un pour les host variables et un pour les indicateurs de présence.

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
DSQC1 Génération de la description du Bloc SQL sans prise en compte des textes ventilés
DSQC2 Génération de la description du Bloc SQL avec prise en compte des textes ventilés
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é.
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.
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.
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.
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.
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)