Rational Developer for System z, Version 7.6

Lignes -D d'un Etat

L'onglet Lignes -D permet de définir la composition de la maquette d'un Etat. Vous créez la liste des catégories et des lignes d'édition qui composent la maquette d'un Etat et indiquez leurs caractéristiques d'édition.

Définition d'une catégorie

Pour définir une catégorie, vous devez lui attribuer un identifiant, indiquer son type, les conditions d'édition, et enfin un commentaire qui s'affiche après l'identifiant de la catégorie dans la liste des lignes -D de l'Etat.

Identifiant catégorie
Saisissez ici le code de la catégorie. Il doit être constitué de deux caractères alphabétiques de AB à ZY. ZZ est interdit. Ce code permet de différencier les catégories. Les lignes d'Etat sont regroupées en fonction des conditions sous lesquelles elles seront éditées (lignes de totaux, lignes détails...). Il est recommandé de laisser des trous dans la séquence des catégories pour pouvoir insérer de nouvelles catégories par la suite. Les catégories contenant une ligne détail avec des éléments à totaliser (Type of totalisation=> Détail éditable ou Détail non éditable :
  • ne peuvent contenir qu'une ligne détail,
  • ne peuvent pas contenir de ligne de total,
  • ne peuvent pas être répétitives,
  • mais peuvent contenir d'autres lignes ordinaires.
Les catégories utilisées pour les lignes de totaux (Type de totalisation=> Totalisation (niveau de rupture de 1 à 9)) :
  • ne peuvent pas contenir de lignes détails,
  • ne peuvent pas être répétitives,
  • peuvent contenir d'autres lignes ordinaires.
  • peuvent contenir plusieurs lignes de totaux,
Type
Dans cette zone, vous indiquez le type de caégorie : standard, en-tête, répétitive ou pied de page.
Valeurs Commentaires
Standard

Option par défaut.

A : en-tête

Cette valeur s'applique uniquement aux catégories itératives. Elle repère la première ligne d'un début de page d'une catégorie itérative (en-tête).

Les en-têtes sont automatiquement édités en début de page dans un Etat. Ils sont également édités lorsque le nombre de lignes répétées (ou itératives) dépasse le nombre de lignes par page autorisé pour l'Etat, entraînant ainsi l'édition d'une nouvelle page.

I : répétitive

Indique la première ligne d'une catégorie éditée plusieurs fois (catégorie itérative). Cette valeur provoque la génération d'un indice qui contrôle le nombre de répétitions. Ce nombre peut être fixe ou variable.

Z : pied de page

Indique la première ligne d'une catégorie pied de page. Les pieds de page sont automatiquement édités quand les lignes de la catégorie répétée (ou itérative) dépassent le nombre de lignes par page autorisé pour l'Etat.

Commentaire
Le commentaire saisi dans cette zone se rapporte à la catégorie à éditer. Le commentaire est affiché avec le code de la catégorie dans la liste des catégories. Vous pouvez par exemple saisir dans le commentaire la nature de la catégorie : en-tête, pied de page par exemple.
Répétition
La valeur que vous saisissez ici provoque la génération d'un indice qui contrôle le nombre de répétitions.
Cette valeur est un nombre fixe ou variable de répétitions.
  • Pour un nombre fixe de répétitions, saisissez un nombre absolu.
  • Pour un nombre variable, saisissez le code sur trois caractères défini dans l'onglet Lignes -CD du Programme qui appelle l'Etat ou utilisez l'indice standard VA Pac généré pour la catégorie (jrrrcc) :
    • .rrr = code de l'Etat,
    • .cc = catégorie de l'Etat (répétitive).
    Ce code doit être renseigné avant l'édition.
Condition
Vous indiquez dans cette zone les conditions nécessaires à l'édition de l'Etat. Pour les conditions IF, utilisez le format COBOL mais ne saisissez pasIF. Pour AND, OR, etc., utilisez le format COBOL. Le point est généré automatiquement. Vous ne devez donc pas le saisir.
Maquette
Cliquez sur Maquette pour afficher une simulation de maquette d'édition pour la catégorie sélectionnée.

Définition d'une ligne d'édition

Cette section permet de saisir ou modifier la définition d'une ligne d'édition d'une categorie. Vous devez indiquer l'identifiant de la structure, du libellé mais aussi le type de saut, le nombre de lignes à sauter, la fonction à exécuter avant l'édition, et le type de lignes contenant des zones à cumuler dans une totalisation et la zone de totalisation.

Structure
Cette zone affiche l'identifiant de la Structure lorsque celle-ci est déjà définie. L'identifiant est constitué du code de la structure et du nom de la Rubrique qui représente le libellé. L'identifiant de la structure est calculé automatiquement en séquence continue de 1 à 99. Vous pouvez ajouter, modifier ou supprimer l'identifiant.
Pour sélectionner un identifiant, cliquez sur Modifier, une boîte de dialogue affiche la liste des identifiants créés dans les Lignes -D de l'Etat. Une fois sélectionné, l'identifiant de la Structure s'affiche sur la ligne d'édition et dans la zone Structure sous forme de lien hypertexte. Un clic sur ce lien fait basculer vers la fenêtre Lignes -CE de l'Etat, sur la définition de la Structure.
Pour supprimer un identifiant, cliquez sur Supprimer, ainsi le code de la Structure disparaît de la zone et sur la ligne d'édition.
Identifiant libellé
Cette zone affiche l'identifiant du libellé sur la ligne d'édition. Pour sélectionner un identifiant, cliquez sur Modifier. Une boîte de dialogue s'ouvre et présente la liste des libellés créés sous l'onglet Lignes -L de l'Etat. Sélectionnez un libellé et cliquez sur OK pour valider. L'identifiant du libellé s'affiche dans la zone sous forme de lien hypertexte. Cliquez sur le lien pour basculer sur la définition du libellé dans l'onglet Lignes -L de l'Etat. L'identifiant s'affiche également sur la ligne d'édition dans la liste des lignes -D de l'Etat.
Si vous cliquez sur Supprimer, vous supprimez l'appel de l'identifiant du libellé dans la zone et sur la ligne d'édition.
Saut
Indiquez dans cette zone le nombre de lignes à sauter avant l'édition de la ligne si celle-ci n'est pas la première de la catégorie. L'option par défaut est 01. Le saut est pris en compte lors de la génération de l'Etat.
Type de saut
Indiquez dans cette zone le type de saut qui sera inséré avant la génération. La valeur par défaut correspond à un saut de ligne, vous pouvez autrement choisir un saut de page.
Type de totalisation
De nombreux Etats affichent, après l'en-tête, des lignes détails. Quelques-unes de ces lignes détails contiennent des zones qui doivent être totalisées. D'autres lignes contiennent des zones qui servent à afficher les totaux.
Options Commentaires
Pas de totalisation  
* : Détail éditable

La ligne détail contenant les zones dont les valeurs seront totalisées sera imprimée dans l'Etat.

Les Rubriques seront totalisées si les conditions d'édition spécifiées pour la catégorie contenant la ligne détail sont satisfaites.

T : Détail non éditable

La ligne détail contenant les zones dont les valeurs seront totalisées ne sera pas imprimée dans l'Etat.

Un Programme contient au maximum 6 lignes non éditables. Une catégorie contenant une ligne détail :
  • ne peut contenir qu'une ligne détail,
  • ne peut contenir de ligne de totalisation,
  • ne peut être itérative,
  • peut comporter d'autres lignes ordinaires.
0 : Totalisation globale

Une ligne affichera le résultat général.

Totalisation niveau de rupture = 1 à niveau de rupture = 9 Une ligne de totalisation sera éditée au niveau de rupture correspondant à une valeur de 1 à 9.
Fonction appelée
Dans cette zone, vous indiquez le code (sur quatre caractères) de la fonction et sous-fonction à exécuter avant édition de la structure portée par cette ligne, et avant la commande WRITE.
Il ne faut pas mentionner plusieurs fois la même fonction pour une même structure, si celle-ci figure dans plusieurs catégories. Il suffit de la mentionner dans l'une des catégories. En revanche, il est possible de mentionner plusieurs fonctions pour une même structure; il faut cependant noter que l'ordre de leurs exécutions sera aléatoire. Si la ligne ne comporte pas de numéro de structure, la fonction sera exécutée une seule fois, avant l'édition de toutes les lignes de l'Etat, et juste avant le WRITE.
L'exécution de cette fonction dépend du positionnement de la structure correspondante et donc du type ou du conditionnement de la catégorie dans laquelle est appelée cette structure.
Etat de totalisation
Sur une ligne contenant des zones à totaliser ou une ligne de totalisation dont la ligne détails est décrite dans un autre Etat, saisissez le numéro de structure. Quelques lignes détails peuvent être définies dans un autre Etat : par exemple, un Etat récapitulatif basé sur des totaux contenus dans d'autres Etats. Seules les Rubriques totalisées seront éditées, au niveau de rupture approprié.

Conditions d'utilisation | Commentaires en retour

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