Onglet Définition

Dans cet onglet, vous devez compléter les informations indiquées lors de la création du Copybook. Ces informations servent à préciser le contenu de la description générée.

Option de génération

La valeur de cette zone a été indiquée lors de la création de l'instance de Copybook. Elle ne peut pas être modifiée.

Les options de génération suivantes sont disponibles.
Tableau 1. Valeurs de l'option de génération
Valeurs Signification
DC1 : DATA option C1 Génération de la description d'une Structure de Données.
DC3 : DATA option C3 Génération de la description d'une Structure de Données.

Génération du source COBOL des Segments avec indication du nom et du libellé des Rubriques et des Segments sous forme de commentaires.

Structures de Données

La valeur de cette zone a été indiquée lors de la création de l'instance de Copybook. Elle ne peut pas être modifiée.

Par défaut, tous les Segments de cette Structure de Données feront partie de la description générée. L'onglet Sélection de l'éditeur de Copybook vous permet cependant de ne sélectionner que les Segments appropriés.

Localisation de la cible COBOL

Les fichiers COBOL générés sont stockés par défaut avec les fichiers de design, dans un dossier dont le nom par défaut est modifiable. Vous pouvez cependant les séparer des fichiers de design ou même changer le projet et le dossier de génération.

Dans une Bibliothèque, les valeurs par défaut du Projet COBOL et du Dossier COBOL sont celles du projet courant.

Projet COBOL
Les fichiers générés à partir de cette instance seront stockés dans le projet affiché dans cette zone.

Le projet du fichier de design correspondant est le projet par défaut. S'il a été conservé, valeur par défaut est affichée entre parenthèses après le projet. S'il a été explicitement changé dans l'instance, seul le projet est affiché ici, sans autre indication. S'il a été explicitement changé dans la Bibliothèque de génération, hérité de la Bibliothèque est affiché entre parenthèses après le dossier. Vous pouvez écraser, dans l'instance, la valeur héritée de la Bibliothèque.

Vous pouvez sélectionner un nouveau projet dans la liste déroulante.

Si vous changez le projet, le dossier COBOL est automatiquement valorisé à la valeur par défaut (rpp). Le nouveau projet sera pris en compte lors de la génération suivante.

Dossier COBOL
Les fichiers générés à partir de cette instance seront stockés dans le dossier affiché dans cette zone, à l'intérieur du projet affiché dans la zone précédente

Le dossier du fichier de design correspondant est le dossier par défaut. S'il a été conservé, valeur par défaut est affichée entre parenthèses après le dossier. S'il a été explicitement changé dans l'instance, seul le dossier est affiché ici, sans autre indication. S'il a été explicitement changé dans la Bibliothèque de génération, hérité de la Bibliothèque est affiché entre parenthèses après le dossier. Vous pouvez écraser, dans l'instance, la valeur héritée de la Bibliothèque.

Si le dossier par défaut a été conservé, vous pouvez indiquer un chemin racine pour les fichiers générés dans l'assistant des propriétés du projet (ouvert à partir du bouton Changer les propriétés du projet). Ce chemin s'affichera alors automatiquement dans cette zone, au début du dossier.

Vous pouvez sélectionner un nouveau dossier dans la liste déroulante. Il est impossible de créer un dossier à ce niveau. Les dossiers doivent avoir été créés auparavant dans le projet, par exemple depuis la perspective Ressource.

Si vous changez le dossier COBOL il sera pris en compte lors de la génération suivante.

Changer les propriétés du projet
Ce bouton ouvre l'assistant des propriétés du projet, où vous pouvez effectuer les actions suivantes :
  • Modifier le dossier par défaut. Ce dossier contient les fichiers de design et est l'emplacement par défaut des fichiers générés et des fichiers de métadonnées.
  • Indiquer un chemin racine pour les fichiers générés, si le dossier de génération par défaut a été conservé.
  • Indiquer un chemin racine pour les fichiers de métadonnées, stockés par défaut dans le même dossier que les autres fichiers générés.
Remarque : Une aide détaillée est disponible depuis l'assistant des propriétés du projet.
Générer avec les paramètres du Format Guide DATA
Si vous cochez cette case, le Copybook sera généré avec les paramètres du Format Guide DATA appelé dans les Lignes -GC de la Structure de Données.
Remarque : Si un Format Guide DATA est appelé dans les Lignes -GC d'un Segment de la Structure de Données, il ne sera pas pris en compte.

Si vous ne cochez pas cette case, le Copybook sera généré avec les valeurs indiquées dans son onglet Définition.

Il est impossible de mélanger la prise en compte des paramètres du Format Guide DATA de la Structure de Données et les paramètres du Copybook.

Codification spécifique
Cette zone permet d'indiquer une présentation spécifique des noms des Segments dans la description générée.
Code de la Structure de Données dans le Copybook
La valeur par défaut est la valeur affichée en consultation dans la zone Structure de Données de cet onglet.
Nom externe
Ce nom représente le nom du fichier connu dans les programmes et utilisé dans l'instruction COPY.

Sa valeur par défaut est le nom de l'instance mais vous pouvez modifier cette valeur.

Emplacement description
Vous devez sélectionner l'emplacement de la description dans le programme qui va appeler ce Copybook.
Tableau 2. Valeurs de l'emplacement de la description
Valeurs Signification
W : WORKING-STORAGE SECTION ou LINKAGE SECTION La description générée sera insérée dans la WORKING-STORAGE SECTION ou la LINKAGE SECTION du programme appelant.

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

F : FILE SECTION La description générée sera insérée dans la FILE SECTION du programme appelant.

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

V: Génération d'un fichier variable La description sera générée en tant que fichier variable.
Variante
Vous devez sélectionner la variante de langage à laquelle la description générée doit être adaptée. Cette adaptation ne concerne pas les clauses USAGE.

Par défaut, il s'agit de la variante indiquée sur la Bibliothèque contenant les paramètres de génération.

Remarque : Certaines variantes ne sont pas supportées ou sont obsolètes.
Type de format
Vous devez sélectionner le type de format de Rubrique qui sera utilisé dans la description.
Tableau 3. Valeurs du type de format
Valeurs Signification
E : Entrée Description tenant compte du format d'entrée des Rubriques.
I : Interne Description tenant compte du format interne des Rubriques, avec les usages associés
S : Sortie Description tenant compte du format d'édition des Rubriques.
Type de description
Cette zone permet d'obtenir plusieurs modes d'agencement des enregistrements d'une Structure de Données. à partir d'une description unique.
Tableau 4. Valeurs du type de description
Valeurs Signification
Enregistrements redéfinis Enregistrements redéfinis implicitement ou explicitement.
1 : Enregistrements sans valeurs initiales 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 Structure de Données apparaît en FILE SECTION, le Niveau de description doit être 2.

2 : Enregistrements avec valeurs initiales 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.

Cette option est réservée aux utilisations de description en WORKING-STORAGE SECTION.

3 : Enregistrements avec occurs (avec niveau 2) Enregistrements à la suite avec prise en compte du Nombre de postes spécifié sur la Définition des Segments.

Si la description de la Structure de Données apparaît en FILE SECTION, le Niveau de description doit être 2.

Ce type de description ne peut être employé pour une Structure de Données ayant un Nombre de postes sur la partie commune.

4 : Enregistrements avec occurs (avec niveau 3) 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 02 permet d'accéder à la table constituée par la répétition d'un même enregistrement.

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

Ce type de description ne peut être employé pour une Structure de Données 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 Structures de Données, Segments ou Rubriques.
Tableau 5. Valeurs du niveau de description
Valeurs Signification
1 : niveau COBOL 01 pour SD et Segments Niveau 01 pour Structure de Données et Segments.

Si la description de la Structure de Données apparaît en FILE SECTION, les Segments doivent obligatoirement être redéfinis.

Si la Structure de Données est sans partie commune avec une description étalée, le niveau fichier n'apparaît pas.

2 : niveau COBOL 01 pour SD et 02 pour Segments Niveau 01 pour Structure de Données et 02 pour Segments.

Le niveau 01 n'apparaît pas si le Type de description est Enregistrements redéfinis.

3 : niveau COBOL pour SD et Segments dépendant du type de description Niveau 02 pour Structure de Données et 03 pour Segments si le Type de description est 1, 2 ou 3.

Niveau 01 pour Structure de Données et 03 pour Segments si le Type de description est 4.

Niveau 03 pour Structure de Données et Segments si le Type de description est Enregistrements redéfinis.

4 : niveau COBOL 02 pour Rubriques, absence de niveau SD et Segment Niveau 02 pour les Rubriques groupe ou les Rubriques élémentaires n'appartenant pas à un groupe. Les Rubriques élémentaires appartenant à une Rubrique groupe apparaissent mais les niveaux Structure de Données et Segments disparaissent.

Le niveau 01 doit être défini dans la WORKING-STORAGE SECTION.

5 : niveau COBOL 01 pour Rubriques, absence de niveau SD et Segment Niveau 01 pour les Rubriques groupe ou les Rubriques élémentaires n'appartenant pas à un groupe. Les Rubriques élémentaires appartenant à un groupe apparaissent mais les niveaux Structure de Données. et Segments disparaissent.

Vos commentaires