Rational Programming Patterns for System z

Lignes -G d'une Bibliothèque

Cet onglet contient deux sous-onglets : les Lignes -GC dédiées aux commentaires sur la Bibliothèque; et les Lignes -GO pour les options de génération.

Lignes -GC

Ces lignes sont utilisées à des fins documentaires. Les commentaires sont disponibles pour toutes les entités et vous permettent d'écrire et d'éditer un texte en relation avec l'instance sélectionnée. Vous pouvez écrire, modifier, déplacer ou supprimer des lignes de texte en utilisant les fonctions du traitement de texte.

Erreur
Cette colonne affiche un point pour toute ligne de description existante non vide.

De plus, si la ligne n'est pas correcte, cette colonne affiche aussi le symbole d'une erreur ou d'un avertissement, selon la gravité de l'erreur. Une infobulle vous informe de l'origine de l'erreur.

Type
Pour ajouter une ligne, cliquez sur Ajouter puis cliquez dans la zone Type et sélectionnez l'une des valeurs suivantes :
Tableau 1. Type des lignes GC
Valeur Commentaires
* ou blanc Ligne de documentation standard.
A Alias pour le nom du Segment
Description
Positionnez votre curseur dans la zone Description et saisissez votre commentaire :

Sur une ligne de type "blanc", entrez un commentaire libre.

Sur une ligne de type "A", entrez le nom COBOL du Segment.

Remarque : Un double clic entraîne la sélection du mot.

Lignes -GO

Erreur
Cette colonne affiche un point pour toute ligne de description existante non vide.

De plus, si la ligne n'est pas correcte, cette colonne affiche aussi le symbole d'une erreur ou d'un avertissement, selon la gravité de l'erreur. Une infobulle vous informe de l'origine de l'erreur.

Les Lignes -GO ne peuvent être mises à jour que par l'administrateur. Pour une Bibliothèque, les options sont les suivantes :
  • Environnement SCM d'import à la génération ,
  • Non écrasement de la transformation de date (F9520) ,
  • Modification des formats des indices générés.
  • demande de génération d'un 'Cursor for Update',
  • Subdivision des Rubriques Date.

Environnement SCM d'import à la génération

Vous saisissez ici l'environnement SCM d'import -- par défaut ou obligatoire et par type d'entité -- pris en compte au moment de la génération. Vous pouvez également préciser à ce niveau le code Application associé.

EEE DE RE DEFAULTAPP REQUIREDAP

avec :
  • EEE : type d'entité
  • DE : code court par défaut de l'environnement,
  • RE : code court obligatoire de l'environnement,
  • DEFAULTAPP : code de l'application par défaut (10 carac. max.),
  • REQUIREDAP : code de l'application obligatoire.

Non écrasement de la transformation de date

Cette option est utile dans le contexte suivant :
  • Pour le module Batch uniquement,
  • Vous utilisez une transformation de date, générée par défaut en F9520,
  • L'option DATPRO n'est pas utilisée au niveau Programme,
  • Vous avez des lignes spécifiques en F95 .
Vous pouvez alors demander avec l'option 'Lignes spécifiques F95 n'écrasent pas la transformation de date' (F9520=N) que la sous-fonction standard F9520 soit générée et que les lignes spécifiques saisies en F95 soient conservées. L'option F9520=N est donc recommandée.

Avec l'option contraire ('Lignes spécifiques F95 écrasent la transformation de date' (F9520=Y)), la sous-fonction standard F9520 n'est pas générée, elle est écrasée par les lignes spécifiques saisies en F95.

Remarque : Si vous avez des lignes spécifiques en F9520, la sous-fonction standard de transformation de date n'est pas générée quelle que soit l'option choisie ici. Elle ne sera générée que si vous positionnez l'option DATPRO dans les Lignes -GO du Programme concerné.

Format des indices générés

Cette option s'applique aux indices qui sont générés au début de la Working Storage Section des Programmes, sous le niveau 01 INDICES.

Le format de ces indices est le format prévu par défaut par la variante de génération du Programme. Ce format est affiché dans le Programme généré, sur la ligne 01 INDICES .

Si vous voulez modifier ce format (pour augmenter la taille des indices, optimiser le temps de traitement...), sélectionnez l'option "Format des indices générés" et, dans la zone "Ligne option", saisissez en entier le nouveau format des indices (ex : COMPUTATIONAL-3).

Exemple :
	Type   Description
  O      INDIC=COMPUTATIONAL-3

Génération de CURSOR UPDATE

Si vous saisissez l'option CURSUPDT=YES, les déclarations Select seront remplacées par Cursor for Update dans un accès en mise à jour.

Subdivision des dates

Avec l'option 'Subdivision des Rubriques' (BREAKDATE=YES), les Rubriques au format Date seront décomposées en zones élémentaires lors de la génération. La subdivision des dates générées en zones élémentaires sera prise en compte :
  • Dans les Programmes : sur les Rubriques élémentaires des Segments présents dans l'Appel de Structures de Données (onglet Lignes -CD), et dans les zones de travail sur des lignes de type F.
  • Dans les Dialogues et Ecrans : sur les Rubriques élémentaires des Segments présents dans l'onglet Complément du Dialogue, dans l'Appel de Segments de l'onglet Lignes -CS et dans les zones de travail sur des lignes de type F.
  • Dans les Rubriques appelées dans les zones de travail, sur des lignes de type I, E ou S.

Si vous indiquez cette option, les Rubriques définies avec un format date seront décomposées en zones élémentaires correspondant au jour, au mois et à l'année avec éventuellement le séparateur (si celui-ci est inclus dans le format).

Une date ne sera décomposée que si le niveau généré correspondant au champ date est inférieur ou égal à 47.

Si une valeur initiale a été indiquée, elle sera générée sur la zone groupe.

Toute information supplémentaire (valeur initiale...) doit être saisie sur la même ligne que l'appel de la Rubrique, sur des lignes de type I, E ou S des zones de travail. Si une ligne suite a été indiquée, la date ne sera pas décomposée.