Rational Programming Patterns for System z

Définition de la catégorie

Cette section vous permet d'indiquer le type, la position, le nombre de répétitions et la présentation de la catégorie.

Pour afficher le contenu de cette section, vous devez sélectionner une ligne de catégorie dans le tableau de l'onglet ou cliquer sur le bouton Ajouter une catégorie.

Une catégorie est un groupe de Rubriques, consécutives dans la liste définissant l'Ecran, mais situées à un emplacement quelconque, correspondant à un ensemble logique de traitements. Un Ecran peut se composer de trois catégories :
  • L'en-tête de l'écran, automatiquement initialisée à la création de l'Ecran,
  • La partie répétitive, facultative.
  • Le bas d'écran, facultatif.

Chacune de ces catégories ne peut apparaître qu'une seule fois dans un Ecran donné.

La répartition des Rubriques dans les catégories définit la présentation de l'Ecran (répétition des Rubriques de la partie répétitive) et l'ordre de traitement des Rubriques dans la transaction générée (Rubriques de l'en-tête, puis Rubriques de la partie répétitive autant de fois qu'il y a de répétitions, puis Rubriques du bas de l'Ecran).

Pour chaque catégorie, vous pouvez définir :
  • Une position,
  • Une option de présentation qui s'applique par défaut à tous les éléments de la catégorie,
  • Pour la catégorie répétitive, une position verticale et une position horizontale déterminant le nombre de lignes d'une instance.
Type
Sélectionnez ici le type de catégorie :
  • Catégorie en-tête (obligatoire, mais automatiquement initialisée lors de la création de l'Ecran)
  • R: Catégorie Répétitive (facultative)
  • Z: Catégorie Bas d'écran (facultative)
Code
Cette zone sert à saisir le code que vous allez donner à la catégorie avec un maximum de 6 caractères. Il indiquera le début de la catégorie et sera affiché dans l'arbre sur la ligne de la catégorie.

Position

Type de position
Cette zone permet de typer le positionnement de l'élément.
  • : Positionnement relatif :
    Les numéros de ligne et de colonne indiqués correspondent à un déplacement par rapport à la zone précédente dans la liste. Le calcul du déplacement par rapport à la zone précédente est de deux types, en fonction de la nature de cette zone :
    • Rubrique (élémentaire ou répétée, quelle que soit sa présentation) : le déplacement est calculé à partir de la position située en haut et à droite du contenu de la Rubrique précédente (et non du libellé).
    • Appel d'Ecran.: le déplacement est calculé à partir de la position située en bas et à droite du rectangle que forme un Ecran appelé dans l'Ecran appelant.
  • A: Positionnement Absolu :
    Le numéro de ligne et le numéro de colonne correspondent à l'adresse absolue de la Rubrique dans l'Ecran.
    Remarque sur le positionnement : La position définie par le type de positionnement, le numéro de ligne et le numéro de colonne est celle du premier caractère du :
    • Contenu si l'option de présentation est Rubrique seule ou Rubrique surmontée du libellé en-tête de colonne ;
    • Libellé sinon.
Ligne
Renseignez ici, sur deux caractères numériques, le numéro de ligne numérique déterminant la position de l'élément :
  • En positionnement relatif, c'est le nombre d'interlignes entre les deux éléments. Si le type de présentation correspond à un en-tête de colonne, le nombre de lignes de l'en-tête est automatiquement ajouté, en génération, au nombre indiqué dans le numéro de ligne.
  • En positionnement absolu, c'est le numéro de ligne dans l'Ecran.

Le dépassement du nombre de lignes est automatiquement vérifié.

Si le numéro de ligne et le numéro de colonne sont tous les deux égaux à zéro, l'élément est automatiquement positionné sur le prochain point de tabulation libre.

Colonne
Renseignez ici, sur trois caractères numériques, le numéro de colonne déterminant la position de l'élément :
  • En positionnement relatif, c'est le nombre d'espaces qui séparent deux éléments sur une même ligne. Si le numéro de ligne est supérieur à zéro, le numéro de colonne correspond à un positionnement absolu.
  • En positionnement absolu, c'est l'adresse de l'élément dans la ligne. La valeur zéro correspond par défaut à la colonne 2 en génération, le colonne 1 étant réservée à l'attribut . La valeur 1 est possible : dans ce cas, l'attribut est situé sur la ligne précédente.

Le dépassement de longueur pour une ligne et la superposition de zones sont automatiquement détectés. En revanche, la présence d'un espace libre pour l'attribut devant chaque zone n'est pas vérifiée.

Si le numéro de ligne et le numéro de colonne sont tous les deux égaux à zéro, l'élément est automatiquement positionné sur le prochain point de tabulation libre.

Répétitions
Le nombre de répétitions horizontales de la Rubrique de début de la catégorie répétitive sert à déterminer le nombre de lignes de chaque instance.
Nombre de lignes par répétition
L'ensemble des Rubriques et des libellés de la partie répétitive, qui peut comporter plusieurs lignes, est répété verticalement.
Présentation
Cette zone vous permet de choisir le libellé associé à chaque Rubrique dans l'Ecran.
Il existe quatre libellés possibles :
  • Le libellé (36 positions), indiqué dans l'onglet Définition de la Rubrique.
  • Le libellé court (18 positions), indiqué dans l'onglet Lignes -D de la Rubrique.
  • Le libellé relationnel (18 positions), indiqué dans l'onglet Lignes -D de la Rubrique.
  • Le libellé colonne, indiqué dans l'onglet Lignes -D de la Rubrique.

Les différentes valeurs de cette zone sont une association entre la Rubrique et la manière de présenter ces libellés (cadré à droite, à gauche,...).

Vous devez sélectionner une des valeurs suivantes :
Tableau 1. Valeurs pour l'affichage du libellé de la Rubrique
Valeur Commentaire
Valeur par défaut La valeur par défaut est indiquée au niveau Dialogue.
F: Rubrique seule Rubrique affichée sans libellé.
L: Libellé long cadré à gauche et Rubrique Rubrique précédée du libellé long cadré à gauche sur 36 positions.
M: Libellé long cadré à droite et Rubrique Rubrique précédée du libellé long cadré à droite sur 36 positions.
N: Libellé long utile et Rubrique Rubrique précédée du libellé long utile (suppression des blancs à droite).
R: Libellé relationnel cadré à gauche et Rubrique Rubrique précédée du libellé relationnel cadré à gauche sur 18 positions.
S: Libellé court cadré à gauche et Rubrique Rubrique précédée du libellé court cadré à gauche sur 18 positions.
T: Libellé court cadré à droite et Rubrique Rubrique précédée du libellé court cadré à droite sur 18 positions.
U: Libellé court utile et Rubrique Rubrique précédée du libellé court utile (suppression des blancs à droite).
1: Libellé colonne 1 ligne et Rubrique Rubrique surmontée de l'en-tête de colonne sur une seule ligne.
2: Libellé colonne 2 lignes et Rubrique Rubrique surmontée de l'en-tête de colonne sur deux lignes.
3: Libellé colonne 3 lignes et Rubrique Rubrique surmontée de l'en-tête de colonne sur trois lignes.
Remarque : Le caractère '.' est généré pour les Rubriques précédées par un libellé court, long ou relationnel. Pour les Rubriques surmontées par un libellé colonne, la longueur prise en compte pour les positionnements relatifs est la plus grande des longueurs du contenu des libellés.