Rational Programming Patterns for System z

Onglet Définition du Dialogue ou de l'Ecran

Cet onglet est commun au Dialogue et à tous ses Ecrans. Il vous permet d'indiquer les caractéristiques de présentation d'un Ecran et les valeurs par défaut des attributs des différents types de zones possibles. Les valeurs choisies au niveau du Dialogue deviennent les valeurs par défaut des Ecrans et sont indiquées par la mention 'Hérité' dans l'onglet Définition de l'Ecran. Vous pouvez écraser ces valeurs par défaut au niveau de l'Ecran.

Type de Dialogue
Cette zone vous permet d'indiquer que le type du Dialogue ou de l'Ecran est standard ou TUI.
Variante du COBOL à générer
Vous indiquez dans cette zone la variante COBOL pour les Ecrans générés.
Remarque : Certaines variantes ne sont pas supportées ou sont obsolètes.
Tableau 1. Valeurs de la variante de COBOL à générer
Valeur Signification
Default Valeur de la zone Langage généré de l'onglet Définition de la Bibliothèque.
N Pas de génération
X IBM MVS/ESA OS/390
0 IBM MVS/ESA AS/400
1 IBM DOS/VSE
3 UNIX, WINDOWS
4 COBOL BULL GCOS7
5 COBOL BULL GCOS8
6 COBOL BULL GCOS8, Ecran TP8
8 COBOL UNISYS SERIE A
F COBOL TANDEM
I COBOL DEC/VAX VMS
K COBOL ICL 2900
O COBOL IBM AS/400
Q ACUCOBOL
R COBOL TUXEDO
U COBOL UNISYS SERIE 2200
Variante du moniteur transactionnel
Vous indiquez dans cette zone la variante du moniteur transactionnel pour les Ecrans générés.
Tableau 2. Valeur de la variante du moniteur transactionnel
Valeur Signification
Défaut Reprise des options par défaut
N Pas de génération
0 Variantes 0, 1, X pour CICS (IBM) (programmes et map BMS).

Variante 3 pou PC/MICRO FOCUS (MS/DOS).

Variantes 4, 5, 6 pour QUESTAR.

Variante 8 pour UNISYS Series A SDF format.

Variante I pour DEC/VAX.

Variante Q pour UNIX, Windows (ACUCOBOL).

Variante U pour UNISYS 2200 (programme et map FLDP).

Variante O pour AS 400.

1 Variantes 0, X pour IMS (IBM) (programme et format MFS).

Variante 3 pour PC/MICRO FOCUS (OS2).

Variantes 4, 5, 6 pour VIP.

2 Variantes 0, 1, X pour CICS (IBM), map BMS couleur.

Variante 3 pour MICRO FOCUS (UNIX).

3 Variantes 0, X pour IMS (IBM), format MFS couleur.
4 Variantes 0, X pour moniteur IMS (IBM).

Variante 3 pour Programme IBM VISUALAGE COBOL.

5 Variantes 0, X pour moniteur CICS (IBM).
C Variantes 4, 5, 6, U pour multi-écrans.

Variantes 0, 1, X pour CICS multi-écrans.

Variante K pour ICL.

Variante 8 pour UNISYS Series A écran logique.

F Variante 4 pour TDS FORMS (BULL GCOS7).

Variante R pour Programmes 'service d'initialisation' ou 'service de terminaison.

R Variante F pour Programmes REQUESTER ou variante R pour Programme CLIENT.
S Variante F pour Programme SERVER ou variante R pour SERVICE'.

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.

Remarque : Des informations complémentaires sur l'emplacement des fichiers générés sont disponibles.
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é 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 projet. Vous pouvez écraser, dans l'instance, la valeur héritée de la Bibliothèque.

Vous pouvez sélectionner un nouveau projet en cliquant sur la flèche ou sur le bouton Changer le projet et le dossier COBOL.

Si vous changez le projet, il 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é ici, à 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é 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 en cliquant sur la flèche ou sur le bouton Changer le projet et le dossier COBOL.

Si vous changez le dossier, 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 :
  • 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.
Changer le projet et le dossier COBOL
Ce bouton ouvre une page de sélection affichant tous les projets et dossiers déjà présents dans votre espace de travail.

Développez le projet souhaité et sélectionnez un dossier ou créez un dossier. Cliquez sur OK. Le dossier sélectionné et le projet s'afficheront alors automatiquement ici, dans les zones correspondantes.

Valeur initiale pour 'Présentation du libellé'
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 etc...).

Au niveau de l'Ecran, vous pouvez écraser la sélection faite au niveau du Dialogue.

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.
Vous devez sélectionner une des valeurs suivantes :
Tableau 3. 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.
Code programme généré
Le nom contenu dans cette zone représente le nom du fichier généré à partir de l'instance. Le nom du fichier généré peut donc être différent du nom de l'instance.
Nom externe de la map
Cette zone n'est pas disponible dans un Dialogue.

Le nom indiqué dans cette zone représente le nom du fichier map (.bms, .mfs ou .map) généré à partir de cette instance. Le nom de la map générée peut donc être différent du nom de l'instance.

Si cette zone n'est pas renseignée, le nom de l'instance sera le nom de la map.

Pour CICS, vous indiquez ici le nom du Mapset.

Pour CICS, vous indiquez ici le nom du format.

Pour TANDEM, vous indiquez ici le nom du SERVER associé pour un écran de type R (REQUESTER).

Code transaction
Cette zone correspond :
  • dans le cas d'une variante CICS, au code transaction sur quatre caractères. C'est le code transaction du Dialogue par défaut.
  • dans le cas d'une variante IMS, au code transaction associé au Dialogue. Cette zone est précisée sur tous les Ecrans du Dialogue sauf si l'option MONITOFF (un code transaction par Ecran, pas de moniteur généré) est spécifiée.
Taille de l'écran - nombre de lignes
Cette zone indique le nombre de lignes dans l'Ecran. Elle doit être numérique et comprise entre 1 et 62, la valeur par défaut étant de 24 au niveau du Dialogue.
Taille de l'écran - nombre de colonnes
Cette zone indique de nombre de colonnes dans l'Ecran. Elle doit être numérique est comprise entre 1 et 80, la valeur par défaut étant de 80 au niveau du Dialogue.

Le format (nombre de lignes et nombre de colonnes) précise l'encombrement "hors tout" de l'écran.

Lors d'un appel d'Ecran par un autre, le format indique les dimensions de la zone occupée par l'Ecran appelé dans l'Ecran appelant. Le positionnement relatif de la Rubrique suivant immédiatement l'Ecran appelé dépend donc du format de celui-ci.

Valeur initiale pour 'Tabulation'
Cette zone permet de positionner automatiquement les Rubriques dans l'Ecran.

Les points de tabulation sont des points fictifs de l'Ecran qui divisent chaque ligne en parties égales.

Chaque Rubrique pour laquelle aucun positionnement n'est indiqué, vient se positionner automatiquement sur le prochain point de tabulation libre.

Valeur initiale pour 'Caractère'
Cette zone permet de préciser la valeur initiale par défaut des Rubriques saisissables de l'Ecran.

Cette valeur initiale est positionnée dans le programme transactionnel.

Caractère d'appel de documentation de l'écran
Ce caractère doit être cadré à gauche. Il est recommandé d'utiliser un caractère exclusivement réservé à cet usage.
La demande de documentation sera automatiquement prise en compte par le programme généré.
Remarque : Lorsque le type de génération défini sur l'onglet Définition de la Bibliothèque est COBOL II or 85, les tests générés en fonction F8150 pour détecter les caractères de demande de documentation portent uniquement sur le premier caractère de la zone et non sur la zone entière comme dans le cas du COBOL Standard.
Pour les matériels supportant les touches fonction, il est possible d'indiquer un numéro de touche fonction servant à appeler la documentation associée à l'Ecran.
Remarque : Il n'est pas possible d'utiliser dans un même Dialogue une touche fonction et un caractère pour les demandes de documentation.
Selon la variante de langage à générer, certaines spécificités s'ajoutent :
  • IBM CICS, IBM IMS, AS/400 : Si vous saisissez un caractère dans cette zone, les zones numériques ne seront plus générées comme telles au niveau de la grille d'Ecran.
  • CICS : Les valeurs suivantes sont de plus autorisées :
    • A1 pour la touche fonction AP1,
    • A2 pour la touche fonction AP2,
    • EN pour la touche Entrée,
    • 00 pour la touche Effacement.
  • BULL multi-écrans : L'utilisation des touches fonction est possible sur les écrans 3270 ; dans ce cas, leur utilisation est identique à celle du matériel IBM.
  • TANDEM : Il n'est pas possible d'utiliser un caractère ; seules les valeurs 01 à 32, correspondant aux touches fonction écran F1 à SF16, sont prises en compte.
  • DEC/VAX : Pour les touches fonction, seules les valeurs 01, 02, 03, 06 à 11 et 14 à 20 sont autorisées.
  • MICROFOCUS : Il est possible d'utiliser les valeurs 01 à 24 pour les touches fonction.
  • HP3000 : Seul l'appel par caractère de la fonction Aide en Ligne est permis.
Caractère d'appel de documentation du champ
Dans cette zone, vous pouvez saisir un caractère de votre choix. Ce caractère doit être cadré à gauche. Il est recommandé d'utiliser un caractère exclusivement réservé à cet usage.

La demande de documentation sera automatiquement prise en compte par le programme généré en reprenant le caractère de demande de documentation au niveau de la Rubrique choisie.

Remarque : Lorsque le type de génération défini sur l'onglet Définition de la Bibliothèque est COBOL II or 85, les tests générés en fonction F8150 pour détecter les caractères de demande de documentation portent uniquement sur le premier caractère de la zone et non sur la zone entière comme dans le cas du COBOL Standard.
Pour les matériels supportant les touches fonction, il est possible d'indiquer un numéro de touche fonction servant à appeler la documentation associée au champ.
Remarque : Il n'est pas possible d'utiliser, dans un même Dialogue une touche fonction et un caractère pour les demandes de documentation.

La demande de documentation sera automatiquement prise en compte par le programme généré en positionnant le curseur sur la Rubrique désirée et en appuyant sur la touche fonction définie à ce niveau.

Selon la variante de langage à générer, certaines spécificités s'ajoutent :
  • IBM CICS, IBM IMS, AS/400 : Si vous saisissez un caractère dans cette zone, les zones numériques ne seront plus générées comme telles au niveau de la grille d'Ecran.
  • CICS : Les valeurs suivantes sont de plus autorisées :
    • A1 pour la touche fonction AP1,
    • A2 pour la touche fonction AP2,
    • EN pour la touche Entrée,
    • 00 pour la touche Effacement.
  • BULL multi-écrans : L'utilisation des touches fonction est possible sur les écrans 3270 ; dans ce cas, leur utilisation est identique à celle du matériel IBM.
  • TANDEM : Il n'est pas possible d'utiliser un caractère ; seules les valeurs 01 à 32, correspondant aux touches fonction écran F1 à SF16, sont prises en compte.
  • DEC/VAX : Pour les touches fonction, seules les valeurs 01, 02, 03, 06, à 11 et 14 à 20 sont autorisées.
  • MICROFOCUS : Il est possible d'utiliser les valeurs 01 à 24 pour les touches fonction.
  • HP3000 : Seul l'appel par caractère de la fonction Aide en Ligne est permis. La réception écran ne permettant pas de situer le curseur, il serait impossible de déterminer la Rubrique choisie.

Attributs d'intensité

Vous sélectionnez ici les attributs d'intensité pour cinq types de zones : les libellés, les zones d'affichage, les zones de saisie, les libellés d'erreur, les champs en erreur.

Ces attributs peuvent être indiqués au niveau du Dialogue et pris par défaut ou écrasés au niveau de l'Ecran. Les valeurs possibles pour chaque attribut sont les mêmes, quel que soit le type de zone :
  • Valeur par défaut,
  • N: Normal,
  • B: Surbrillant,
  • D: Caché.
Libellé
Sélectionnez ici l'attribut d'intensité des zones de type 'libellés'.
Affichage
Sélectionnez ici l'attribut d'intensité des zones d'affichage de l'Ecran.
Saisie
Sélectionnez ici l'attribut d'intensité des zones de saisie de l'Ecran.
Libellés d'erreur
Sélectionnez ici l'attribut d'intensité des libellés d'erreur de l'Ecran.
Champs en erreur
Sélectionnez ici l'attribut d'intensité des champs en erreur de l'Ecran.

Attributs de présentation

Vous sélectionnez ici les attributs de présentation pour cinq types de zones : les libellés, les zones d'affichage, les zones de saisie, les libellés d'erreur, les champs en erreur.

Ces attributs peuvent être indiqués au niveau du Dialogue et pris par défaut ou écrasés au niveau de l'Ecran. Les valeurs possibles pour chaque attribut sont les mêmes, quel que soit le type de zone :
  • Valeur par défaut,
  • N: Normal,
  • B: Clignotant,
  • R: Inversion,
  • U: Souligné.
Libellé
Sélectionnez ici l'attribut de présentation des zones de type 'libellés'.
Affichage
Sélectionnez ici l'attribut de présentation des zones d'affichage de l'Ecran.
Saisie
Sélectionnez ici l'attribut de présentation des zones de saisie de l'Ecran.
Libellés d'erreur
Sélectionnez ici l'attribut de présentation des libellés d'erreur de l'Ecran.
Champs en erreur
Sélectionnez ici l'attribut de présentation des champs en erreur de l'Ecran.

Attributs de couleur

Vous sélectionnez ici les attributs de couleur pour cinq types de zones : les libellés, les zones d'affichage, les zones de saisie, les libellés d'erreur, les champs en erreur.

Ces attributs peuvent être indiqués au niveau du Dialogue et pris par défaut ou écrasés au niveau de l'Ecran. Les valeurs possibles pour chaque attribut sont les mêmes, quel que soit le type de zone :
  • W: Normal
  • B: Bleu
  • R: Rouge
  • P: Rose
  • Y: Jaune
  • G: Vert
  • T: Turquoise
Libellé
Sélectionnez ici l'attribut de couleur des zones de type 'libellés'.
Affichage
Sélectionnez ici l'attribut de couleur des zones d'affichage de l'Ecran.
Saisie
Sélectionnez ici l'attribut de couleur des zones de saisie de l'Ecran.
Libellés d'erreur
Sélectionnez ici l'attribut de couleur des libellés d'erreur de l'Ecran.
Champs en erreur
Sélectionnez ici l'attribut de couleur des champs en erreur de l'Ecran.