Rational Developer for System z, Version 7.5

Onglet Lignes -D

Cet onglet correspond à la Description de la Rubrique.

Il peut contenir un texte explicatif et présente les valeurs ou plage des valeurs autorisées pour cette Rubrique, ainsi que leur signification.

Il fournit également des informations spécifiques qui seront exploitées là où la Rubrique est utilisée (libellés et format d'Ecran, nom de bases de données relationnelles...).

Chaque valeur ou plage de valeurs est saisie avec un code et un libellé ; ce libellé sera utilisé pour la documentation utilisateur. Vous pouvez, si vous le désirez, utiliser les valeurs ou plages de valeurs pour les contrôles sur Rubrique dans les programmes batch et TP.

Caractéristiques spécifiques au module Dialogue:

Pour l’utilisation de la Rubrique dans les Ecrans on définit à ce niveau, si nécessaire, le libellé court, le libellé en-tête de colonne, un exemple de valeur et éventuellement un format conversationnel.

Le format conversationnel est prioritaire sur les autres. Pour les dates, on peut utiliser les formats symboliques pour définir le format conversationnel.

La valeur des délimiteurs des libellés peut être paramétrée, si la valeur par défaut du délimiteur est contenue dans le libellé à définir.

Un délimiteur est obligatoire pour le libellé colonne. Il est facultatif pour le libellé court.

Si la Rubrique est un code action ou opération, ses valeurs et les valeurs internes correspondantes peuvent être indiquées à ce niveau (sinon elles sont indiquées au niveau de la description de l’entité Ecran).

Type de ligne
Valeur Signification
blanc Ligne de description complémentaire.

Les lignes de ce type permettent de saisir un texte décrivant la Rubrique ainsi que ses valeurs possibles avec leurs significations.

D Valeur par défaut de la Rubrique.

L’une des valeurs indiquées peut être repérée comme étant la valeur par défaut ; elle peut alors être attribuée comme valeur initiale dans les descriptifs de Segments (onglet Lignes -CE).

Types spéciaux (Modules Dialogue, Pacbench C/S et Pactables)
P Exemple de valeur de la Rubrique.

La valeur est saisie dans la zone Description. Elle est utilisée lors de la simulation d’un Ecran.

L Libellé court de la Rubrique.

Le libellé est saisi dans la zone Description.

Longueur maximum : 18 caractères.
Note: Le délimiteur peut être paramétré (il est saisi dans le premier caractère de la zone Valeurs autorisées; si aucun délimiteur n’est saisi, le caractère ’/’ est pris par défaut).
C Libellé en-tête de colonne.

Le Libellé est saisi dans la zone Description et peut utiliser jusqu'à 3 lignes. Un délimiteur indique un changement de ligne. La longueur effective du libellé est celle de la longueur des lignes

Le libellé doit être obligatoirement borné par au moins un délimiteur et ne pas excéder 18 caractères, les délimiteurs inclus.

Le délimiteur est saisi dans le premier caractère de la zone Valeurs autorisées. Si aucun délimiteur n'est saisi, le caractère "/" est pris par défaut.

F Format conversationnel.

Ce format est utilisé en entrée et sortie de programme.

Si aucun format conversationnel n’est défini, VA Pac prend par défaut le format interne étendu ou le format d’édition selon la nature de la Rubrique dans l’écran ;
  • Pour une Rubrique de type date, le format doit être précisé dans la zone Valeurs autorisées.
  • Dans les autres cas, vous devez préciser le format dans la zone Description.

Le format est saisi sous la forme d’un format d’édition ; le format interne correspondant est automatiquement calculé.

Pour les Rubriques numériques, la clause Blank when zero s’obtient en entrant un Z après le format (exemple : 9(4) Z).

O Déclaration des valeurs de code opération.

Vous pouvez déclarer les valeurs prises par le code opération en fonction de la valeur de la Rubrique. La valeur de la Rubrique doit être indiquée dans la zone Valeurs autorisées, et la valeur du code opération dans la zone Plus d'infos. Il est également possible de déclarer ces valeurs directement sur la description de l’Ecran.

Note: Voir la zone Plus d'infos et consulter les manuels Dialogue et Pacbench C/S - Services applicatifs et Clients TUI, chapitre Client TUI).

http://www-1.ibm.com/support/docview.wss?rs=37&context=SSEP67&uid=swg27005478

I Déclaration des valeurs de code action.

Vous pouvez déclarer les valeurs prises par le code action en fonction de la valeur de la Rubrique. La valeur de la Rubrique doit être indiquée dans la zone Valeurs autorisées, et la valeur du code action dans la zone Plus d'infos. Il est également possible de déclarer ces valeurs directement sur la description de l’Ecran.

Note: Voir la zone Plus d'infos et consulter les manuels Dialogue et Pacbench C/S - Services applicatifs et Clients TUI, chapitre Client TUI).

http://www-1.ibm.com/support/docview.wss?rs=37&context=SSEP67&uid=swg27005478

Types spécifiques aux Bases de Données Relationnelles
R Valeur permettant de générer le libellé relationnel de la Rubrique sur 18 caractères. Ce libellé doit être indiqué dans la zone Description.
Le libellé relationnel défini au niveau d’une Rubrique mère n’est pas repris pour les Rubriques filles lors de la génération
Note: Dans le cas de TurboImage, cette zone permet de générer un nom d’item différent du code Rubrique ; dans ce cas, seuls les 16 premiers caractères sont reconnus.
E Valeur permettant de saisir des formats date non standard dans la zone Description.

Le format indiqué sur l'onglet Définition de la Rubrique, doit être X(n) avec n < 28 (ou n < 15 pour une base de données ORACLE pour la gestion automatique des dates dans Dialogue et Pacbench C/S).

Ce format est pris en compte:
  • Dans la génération SQL (pour générer le type de données Date pour Oracle, Sybase et SQL Server, et Datetime pour Nonstop SQL),
  • Dans la génération Dialogue et Pacbench C/S (pour les accès SQL par exemple en générant les fonctions TOCHAR et TODATE pour Oracle)
Aucun contrôle de date non standard n’est effectué dans les programmes générés ; seules les dates standard (types C, D, E, G, I, M, S) sont contrôlées. L’opérateur de date (AD) ne peut pas non plus s’appliquer à ce format non standard.

Un contrôle syntaxique est effectué à la saisie mais uniquement sur les éléments eux-mêmes du format et non sur leur assemblage (ex : MD sera rejeté mais MMMMMM et YY-DD/MM seront acceptés).

Type spécifique aux Rubriquse issues de Reverse engineering
S Qualifie une Rubrique issue de Reverse engineering ; les noms COBOL de la donnée Reverse associée figurent dans la zoneDescription.
Reprise de l’existant
A Rubrique de type ALIAS ; ce type est positionné de façon automatique lors d’un passage ″Reprise de l’existant″.
Base Adabas
A Rubrique utilisée dans une Base de Données Adabas. Permet de saisir les valeurs associées pour alimenter la génération du Format-Buffer.
Liste des classes Turboimage
T Valeurs de la liste des classes Turboimage
Plus d'infos
Cette zone sert ä indiquer :
  • Un saut de ligne ou de page (pris en compte lors de l'impression d'un Manuel),
  • La suite d'une plage de valeurs quand une plage de valeurs ne tient pas sur une seule ligne,
  • Un code action ou opération (voir aussi la zone Type de ligne).
Valeur Signification
Saut
blanc ou 1 Nouvelle ligne
2 1 ligne blanche + 1 nouvelle ligne
3à 9 De 2 à 8 lignes blanches + 1 nouvelle ligne
* Edition des Manuels : Saut de page
Suite de valeurs
+ Repère la suite d’une plage de valeurs au cas où elle ne peut être indiquée sur une seule ligne.
Action (Dialogue et Pacbench C/S Clients TUI)

Deux catégories de valeurs suivant le Type de ligne sélectionné :

  Avec un Type de ligne égal à I :
C Création
M Modification
A ou D Suppression
X Type de mouvement ’4’ (mise à jour implicite)
  Avec un Type de ligne égal à O :
A Affichage
M Mise à jour
S Suite
E Abandon de la conversation
P Même page
O Appel d’un autre écran
Valeurs autorisées
Cette zone permet de décrire les valeurs possibles du contenu de la Rubrique.

Ces valeurs peuvent faire l’objet d’un contrôle de validité automatique, dans les Programmes ou les Ecrans

Elles doivent être décrites sous forme de littéraux numériques ou alphanumériques (entre simples guillemets pour ces derniers).

Un intervalle se décrit par deux valeurs situées entre parenthèses et séparées par au moins un espace. Une parenthèse inversée (fermante à gauche ou ouvrante à droite) indique que la valeur ne fait pas partie de l’intervalle.
Exemples:

(’E’ ’Z’) pour un intervalle de E inclus à Z inclus,

)0 100( pour un intervalle de 0 exclu à 100 exclu.

Si la signification associée à une valeur comporte plusieurs lignes, la valeur ne doit figurer que sur la première.

Les valeurs attribuées à une Rubrique mère sont reprises pour chacune de ses Rubriques filles.

Valeurs Signification
Valeurs spécifiques aux modules Dialogue et Pacbench C/S

Dans tous les cas, la désignation du contrôle est automatiquement affichée dans la zone Description.

*9 Contrôle de numéricité de type COBOL (IF NOT NUMERIC)
*B Contrôle de numéricité de type COBOL, après remplacement des blancs à gauche par des zéros.
*Z Contrôle de numéricité de type COBOL, après remplacement de tous les blancs par des zéros
*A Contrôle de classe alphabétique
*L Contrôle de classe alphabétique qui n’accepte que les minuscules
*U Contrôle de classe alphabétique qui n’accepte que les majuscules
  Avec un Type de ligne égal à F :
I Date sans siècle (picture x(6)) en AAMMJJ
S Date avec siècle (picture x(8)) en SSAAMMJJ
D Date sans siècle (picture x(6)) en MMJJAA ou JJMMAA selon le format date indiqué dans la zone Position Jour/Mois dans la date de l'onglet Définition de la Bibliohèque.
C Date avec siècle (picture x(8)): en MMJJSSAA ou JJMMSSAA selon le format date indiqué dans la zone Position Jour/Mois dans la date de l'onglet Définition de la Bibliohèque
G Date avec siècle (picture x(10)) en SSAA-MM-JJ, format grégorien
E Date sans siècle (picture x(8)) en MM/JJ/AA ou JJ/MM/AA
M Date avec siècle (picture x(10)) en MM/JJ/SSAA ou JJ/MM/SSAA
T TIME
TS TIMESTAMP
  Avec un Type de ligne égal à C :

Un caractère quelconque saisi dans cette zone et cadré à gauche représente le délimiteur des lignes du libellé. Si aucun caractère n’a été saisi, la valeur par défaut du délimiteur est /.

  Avec un Type de ligne égal à L :

Un caractère quelconque saisi dans cette zone et cadré à gauche représente le délimiteur du libellé. Si aucun caractère n’a été saisi, la valeur par défaut du délimiteur est /.

  Avec un Type de ligne égal à O ou I :

Valeur de saisie possible, associée à la valeur interne indiquée dans la zone Plus d'infos.

Description
Le contenu de cette zone dépend du Type de ligne :
  • Pour les valeurs ’ ’, D, O, I: Saisie d’un commentaire (facultatif).
  • Pour les valeurs L, C, ou P: Saisie d’un libellé (avec ses bornes) ou d’une valeur de présentation.
  • Pour la valeur A: Saisie du code du Segment dans lequel la Rubrique mère est appelée.
  • Pour la valeur R: Saisie du nom de la colonne relationnelle
  • Pour la valeur E : Saisie d’un format date non standard décrit avec un ou plusieurs des éléments suivants :
    • YY : année (YYYY avec le siècle)
    • MM : mois
    • MON : trois premiers caractères du mois
    • DD : jour
    • HH : heure 00 à 23 sauf pour SQL Oracle
    • HHAM ou HHPM: heure 00 à 12 + indicateur am/pm
    • HH24 : heure 00 à 23 pour SQL Oracle
    • MI : minutes
    • SS : secondes
    • FF : millisecondes
    • delimiters / . : - blank
    • Pour plus de détails, consultez la documentation de votre SGBD.
  • Pour NONSTOP SQL : Saisie du champ de départ et du champ de fin.
  • Pour la valeur F (pour les Rubriques qui ne sont pas des dates) : Saisie de la liste des classes TurboImage selon la terminologie TurboImage.
    Note: pour générer une clause BLANK WHEN ZERO avec des Rubriques numériques, le format doit être suivi par un blanc puis un Z (Exemple: 9(4) Z).

Saisissez $OFF ou $ON pour exclure ou inclure la Rubrique d'une édition.

Lorsque la Description de la Rubrique est imprimée dans un Rapport avec l’option d’édition EO, la commande $OFF cadrée à gauche permet d’exclure les lignes de Description suivantes. Pour mettre fin à cette exclusion, il suffit de créer une ligne comportant la commande $ON cadrée à gauche, après la dernière ligne à exclure.
Attention: Cette exclusion n’est pas effective lorsque la Description fait partie de l’aide en ligne générée. Seules les lignes portant les commandes $OFF et $ON sont exclues. Pour plus de détails sur l’option EO et ces deux commandes, consultez le Manuel de 'Gestionnaire de documentation personnalisée' :

http://www-1.ibm.com/support/docview.wss?rs=37&context=SSEP67&uid=swg27005478

Related reference
Onglet Vue d'ensemble
Onglet Définition
-G Lines tab
Onglet Mots clés
Documentation tab

Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)