Onglet Complément du Dialogue
Cet onglet vous permet de compléter le Dialogue par des informations communes à tous ses Ecrans et par des informations concernant l'environnement physique de la transaction.
- Les caractéristiques de la zone commune de conversation qui véhiculera les informations nécessaires entre les différents Ecrans du Dialogue
- Le code du premier Ecran, c'est-à-dire, l'Ecran qui sera affiché au moment du lancement de la transaction
- Les caractéristiques du fichier des libellés d'erreur du Dialogue
Les autres options sont utilisées en fonction du matériel et du moniteur TP.
Plusieurs valeurs peuvent être saisies dans la zone Options, séparées par un espace. Lors de la génération de l'Ecran, un message de type warning signale les paramètres erronés.Zone commune de conversation
La zone commune de conversation constitue la zone d'échange entre les différents Ecrans du Dialogue.
- SD pour Zone commune de conversation
- Par défaut, aucune zone de conversation n'est indiquée et
la zone s'intitule Zone commune de conversation non
définie.
Pour indiquer une zone de conversation, cliquez sur le bouton Modifier et sélectionnez une Structure de Données.
Lorsque plusieurs Segments sont décrits pour cette Structure de Données, ils sont redéfinis dans la description générée dans les transactions.
- Complément longueur de conversation
- Vous devez indiquer un nombre dans cette zone si la longueur de
la zone commune de conversation dépasse 100 caractères.
La longueur totale de la zone de conversation (5-xxnn-LENGTH dans le programme généré) est constituée par les longueurs combinées d'une zone de mémorisation du code Ecran (6 caractères), du fichier zone commune de conversation utilisateur, de la zone permettant de mémoriser les clés d'accès aux Segments en affichage et de renseignements technologiques (transparents pour l'utilisateur).
Dans le calcul de cette longueur, il faut prendre en compte les faits suivants :- La longueur correspondant aux clés d'accès de chaque Segment en affichage est calculée par
catégorie.Exemple : si un Segment est utilisé dans l'en-tête, dans la catégorie répétitive et dans la catégorie de fin, la longueur des clés mémorisées pour ce Segment est la suivante :
- 1 fois la longueur de la clé pour l'en-tête
- + 2 fois la longueur de la clé pour la répétitive (clé de début et clé de fin)
- + 1 fois la longueur de la clé pour la fin d'écran
- Avec une option de génération MDT-OFF (voir la zone Options) ou, pour BULL multi-écrans et UNISYS Série A, une option DYNPRT (protection automatique des champs variables), vous devez tenir compte, dans le calcul de cette longueur, de la longueur du plus long fichier Ecran du Dialogue considéré.
- La longueur correspondant aux clés d'accès de chaque Segment en affichage est calculée par
catégorie.
- PSB ou code sous-schéma
- Cette zone est réservée aux Segments de bases de données DL/1.
Le code du PCB du fichier libellés d'erreur doit appartenir au PSB du Dialogue.
Pour HP3000, vous devez indiquer le code Bloc de la base ALLBASE/SQL, pour générer le moniteur avec une connexion à la Base.
- Premier Ecran du Dialogue
- Cette zone permet d'indiquer le premier Ecran de la transaction.Selon la variante COBOL à générer, les spécifications de ce code sont différentes :
- Pour CICS, si aucun premier Ecran n'est indiqué, la COMMON-AREA de chaque
Ecran du Dialogue est générée en WORKING-STORAGE SECTION.
Si un Ecran est indiqué, la COMMON-AREA de chaque Ecran du Dialogue est générée en LINKAGE SECTION, sauf pour le premier Ecran indiqué pour lequel elle est générée en WORKING-STORAGE SECTION.
- Pour IMS, un moniteur d'enchaînement est généré. Ce moniteur enchaîne sur l'Ecran indiqué quand
on débute la conversation et renvoie cet Ecran à la fin de la conversation. Les noms externes du
premier Ecran affiché et du programme correspondant doivent avoir été indiqués dans l'onglet
Définition de l'Ecran concerné.
Le code est obligatoire même si l'option MONITOFF a été indiquée.
- Pour GCOS7 et GCOS8, cette zone est utilisée uniquement pour les transactions de type multi-écrans.
- Pour DEC/VAX, MICRO FOCUS et HP3000, un moniteur d'enchaînement est généré. Ce moniteur enchaîne sur l'Ecran indiqué au début de la conversation.
- Pour UNISYS-A, cette zone est utilisée uniquement pour les transactions de type multi-écrans.
- Pour UNISYS-2200, cette zone n'est pas utilisée.
- Pour CICS, si aucun premier Ecran n'est indiqué, la COMMON-AREA de chaque
Ecran du Dialogue est générée en WORKING-STORAGE SECTION.
- Options
- Dans cette zone, vous saisissez des options, séparées par un blanc.
Il est à noter que toutes ces options sont aussi saisissables dans
la section Lignes -GO de l'onglet Lignes
-G.Remarque : Un synonyme a été associé à certaines options pour permettre la saisie de toutes les options nécessaires.Le tableau 1 montre les options sur les Dialogues et Ecrans standard. Le tableau 2 montre les options sur les Dialogues et Ecrans Clients. Le tableau 3 montre les options sur les Composants Applicatifs. Le tableau 4 montre les options supplémentaires sur les Composants Applicatifs pour le développement mono-vue. Le tableau 5 montre les options sur les Moniteurs de Communications. Le tableau 6 montre les options sur les Dossiers. Le tableau 7 montre les options sur les Composants Applicatifs d'Initialisation et de Terminaison.
Tableau 1. Options sur les Dialogues et Ecrans standard. Ce tableau présente les valeurs des options que vous pouvez indiquer sur les Dialogues et Ecrans standard, avec leur signification. Les options peuvent être indiquées au niveau du Dialogue. Elles deviennent alors les options par défaut des Ecrans de ce Dialogue. Valeurs Signification ATTRE UNISYS 2200 : Définition des attributs par défaut au niveau de l'Ecran. ATTRIB UNISYS 2200 : L'affichage des attributs spécifiés dynamiquement (Clignotant et Inversion) est conservé. Cette option agit sur la fonction F7020. CICS : Prise en compte de la modification dynamique des attributs de présentation. Cette option agit sur la fonction .F7020.
BREAKDATE Décomposition des Rubriques avec un format date. Les Rubriques au format date seront décomposées en zones élémentaires à la génération.
Vous pouvez aussi demander l'inhibition de l'option en saisissant BREAKDATE=NO si cette option a été positionnée à YES au niveau Bibliothèque.
Cette décomposition sera prise en compte dans les entités suivantes :- Les Programmes, pour 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 (directement dans le code COBOL),
- Les Dialogues et Ecrans pour les Rubriques élémentaires des Segments présents dans le Complément au Dialogue (onglet Complément), dans l'Appel de Segments (onglet Lignes -CS) et dans les zones de travail (directement dans le code COBOL),
- Les Rubriques appelées dans les zones de travail.
Si vous indiquez l'option BREAKDATE=YES, 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).
Exemple : Date définie avec un format de type M (JJ/MM/SSAA) :
10 ffnn-date. 11 ffnn-date-JJX. 12 ffnn-date-JJ PICTURE 99. 11 ffnn-date-S1 PICTURE X. 11 ffnn-date-MMX. 12 ffnn-date-MM PICTURE 99. 11 ffnn-date-S2 PICTURE X. 11 ffnn-date-SSX. 12 ffnn-date-AA PICTURE 9(4).
Notes :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 par exemple) 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.
Les Rubriques appelées dans les Segments SQL ne peuvent pas être décomposées, sauf si les Segments sont des Segments DB2 et si l'option DESCR=ALL a été saisie dans les Options de Génération (section Lignes -GO de l'onglet Lignes -G) du Bloc DB2.
Les variables hôtes ne pouvant être des zones groupe, les zones élémentaires seront générées sous un niveau groupe en redéfinition de la façon suivante : ffnn-date-BRK REDEFINES ffnn-date.
CSSA Mémorisation de toutes les SSAs utilisées lors d'un accès généré aux bases de données. Cette option allonge la zone de communication et est valide pour tous les Ecrans du Dialogue. Il est donc nécessaire de recompiler tous les Ecrans du Dialogue si cette option est modifiée.
CVISION Pour GCOS6 : Transfert des contrôles standard (contrôle de numéricité, contrôle de présence et mise en forme du caractère d'initialisation) au niveau du gestionnaire d'écran CVISION. Cette option améliore les performances. DCPROC Pour les tables DB2, NONSTOP SQL et DATACOM : Génération des DECLARE CURSEUR en PROCEDURE DIVISION fonction FOC. Si vous ne sélectionnez pas cette option, les DECLARE CURSEUR seront générés en WORKING-STORAGE SECTION.
DFHAID Pour IBM® CICS : Initialisation de la table des touches fonction avec le contenu de DFHAID. DYNAM Appel des Tables Pactables en Call Dynamique. DYNPRT Prise en compte de la protection des champs variables dans la table EN-AT (poste 5) et traitement automatique de cette protection en F7020. Pour prendre en compte la protection, vous devez placer un F dans le poste 5 de la table EN-AT pour la Rubrique concernée. Attention, les Rubriques deviennent protégées et transmissibles.
Cette option n'est pas opérationnelle pour les variantes IBM 36 et UNISYS série A format SDF
F10 Traitement de chaque catégorie (en-tête, répétitive, bas de page), à condition qu'elle contienne au moins une zone variable ou un accès à un Segment. FOR Formatage du COBOL généré. La DATA DIVISION sera générée avec justification à gauche, tandis que la PROCEDURE DIVISION sera générée sans justification et à raison d'un ordre COBOL par ligne. Cette option peut être déclarée dans l'onglet Définition de la Bibliothèque. Dans ce cas, le Dialogue est généré avec formatage du COBOL, même si l'option FOR n'est pas indiquée ici.
Avec cette option, jusqu'à 150 lignes sont possibles dans un paragraphe COBOL (entre deux points).Attention : Cette option existe toujours mais n'est plus maintenue.HEXVAL UNISYS A : Génération des zones à value HEXADECIMAL en PIC XX. HLPI Génération de l'accès aux fichiers à l'aide de l'interface HLPI. HLPVAL Envoi dans le fichier libellés d'erreur des valeurs à contrôler indiquées dans les Lignes -D d'une Rubrique, même si ce contrôle a été supprimé au niveau de l'Ecran dans lequel est appelée cette Rubrique. HPRT Appel de la documentation associée aux champs protégés (nature P et F). Elle comprend la documentation associée à la Rubrique ainsi que les Textes ou commentaires associés. dans les lignes de commentaires de l'Ecran. Dans le programme souffleur, l'enchaînement des écrans de documentation se fera d'abord sur les Rubriques variables, puis sur les Rubriques protégées dans l'ordre de l'onglet Lignes -CE.
IMSME Génération de la variante multi-écrans pour IMS. INDEXS DL/1 : Génération automatique des accès aux Segments par index secondaires. Cette option est incompatible avec l'option NOPSB si le code Segment cible est différent du code Segment source et si ce dernier n'est pas généré dans la zone PSB.
LOGMES Variantes CICS multi-écrans et MICRO FOCUS : génération d'un message logique qui gère l'affichage d'écran et l'envoi de message vers le moniteur de communication sélectionné par l'option MONIT (si elle n'est pas définie par défaut dans la variante). AS400 et IMS : Cette option est utilisée uniquement pour le Web.
LPAGE or LPA Gestion du LOGICAL PAGING selon les 2 modes possibles : implicite (utilisation de la touche PA1) et explicite (utilisation d'un opérateur de pagination dans les lignes -CE de l'Ecran). Cette option est disponible avec l'utilisation d'un moniteur, d'un sous-moniteur ou avec MONITOFF.
Avec MONITOFF, la pagination ne peut se faire que sur le même Ecran.
Dans le cas d'utilisation d'un moniteur ou d'un sous-moniteur, la pagination peut se faire sur le même Ecran ou sur des Ecrans différents. Si elle se fait sur des Ecrans différents, il faut indiquer quels sont les Ecrans qui participent à la pagination, au niveau des zones de travail du Dialogue.Remarque : Avec les sous-moniteurs, tous les Ecrans qui composent un groupe de pagination doivent être dans le même sous-moniteur.Les options LPAGE et SWAP sont incompatibles. Si elles sont indiquées toutes les deux, l'option SWAP est ignorée.
MONIT IBM CICS and UNISYS A Series : Génération avec moniteur. MONITOFF or MOFF IMS : Obtention d'un code transaction par Ecran du Dialogue et pas de génération de moniteur. Les options MONITOFF et NOTRAC sont incompatibles. Si les deux sont renseignées, seule l'option MONITOFF est traitée.
NOATTR IMS : Génération des champs protégés dans le MOD sans leurs attributs (ATTR=YES). Cette option est valide pour tous les Ecrans d'un même Dialogue. NOLOCK AS400 : Lecture des Segments sans mise à jour avec ajout de la clause WITH NO LOCK dans la fonction de lecture lorsque le fichier est ouvert en OPEN I-O. Cette option est inopérante si on accède à plusieurs Segments du même fichier en réception, seuls certains d'entre eux étant mis à jour, car le READ WITH NO LOCK enlève le verrou précédent.
NOOCF A la première entrée dans le programme, OCF ne sera pas positionnée à 1 (suppression de la fonction F0160). NOOPEN MICRO FOCUS et DEC : Optimisation des ouvertures des fichiers HE (sauvegarde du HELP) et LE, OU, EM (libellés d'erreur) ainsi que le CONNECT à ORACLE. NOOPENB HP3000, TURBOIMAGE : Interruption de l'ouverture de la base TURBOIMAGE, pas de génération de OPEN dans le programme. NOPSB Limitation de la génération des Segments. Dans chaque Ecran, seuls les Segments utilisés et leurs parents hiérarchiques sont générés. Dans le moniteur et les sous-moniteurs, la zone PSB n'est plus générée ni transmise aux Ecrans.
NORPT Pas de traitement automatique des Rubriques répétées (contrôle, transfert et positionnement des attributs). NOSAV Avec DEC/VAX, GCOS7, MICRO FOCUS, ICL, IBM 36, IBM 38, et BOS/TP : Evite la génération de la description et l'accès physique au fichier HE (HELP). NOSDERR UNISYS 2200 : Reconnaissance de la Rubrique LIERR dans le message qui n'est donc pas envoyé par la clause SEND ERROR. NOTRAC IMS : Pas de génération du code transaction dans le MID du premier Ecran de Dialogue. OCF Positionnement à 1 de OCF dès la première entrée dans le programme. OFF Les programmes et les mappes du Dialogue seront générés avec l'option MDT-OFF (valeur par défaut pour GCOS7 FORMS). ON Les programmes et les mappes du Dialogue seront générés avec l'option MDT-ON (valeur par défaut, sauf pour GCOS7 FORMS). PACSQL Prise en compte des données saisies dans les Lignes -GG du Segment pour les ordres SQL. PSBINIT Ecran CICS-DL/1 avec option moniteur : Cette option permet d'effectuer la connexion au PSB et sa fermeture (SCHEDULE PSB et TERMINATE) au niveau du sous-moniteur et non plus au niveau de chaque Ecran. REFER ou REF Génération de la liste de toutes les Rubriques référencées dans le programme Dialogue. Cette liste apparaît en WORKING-STORAGE SECTION en commentaire. Elle comporte les Rubriques suivantes : - Rubriques des Segments appelés dans l'Ecran ou le Dialogue sur des lignes -CS,
- Rubriques des Segments appelés dans des zones de travail de type F,
- Rubriques appelées directement sur des zones de travail de type I, E ou S,
- Rubriques appelées dans l'Ecran ou le Dialogue, sur des lignes -CE.
REPET ou RPT Contrôle, transfert et positionnement des attributs des zones variables répétées horizontalement et/ou verticalement. Si une zone répétée est utilisée pour l'accès à un Segment, il faut indiquer le nombre de répétitions au niveau de l'appel des Segments dans l'Ecran considéré.
SQLALL ou SQA SQL : Enumération de toutes les colonnes de la table dans les ordres d'accès aux Segments : (SELECT ALL COLCORUBn, ... INTO :FFNN-CORUBn)
SQLCA ou SQC SQL : Génération de l'ordre INCLUDE SQLCA en WORKING-STORAGE SECTION s'il y a au moins un Segment DB2 ou NonStop SQL appelé dans l'Ecran (Onglet Lignes -CS, Organisation = S, Q ou N). SQLIND ou SQI Génération d'indicateurs de présence de la Rubrique avant sa mise à jour ou son affichage. SQLREF ou SQR Génération des indicateurs de la nouvelle structure V-FFnn-CORUB, permettant la gestion automatique de références croisées. SSMON Indique, pour chaque Ecran, qu'on prend le PSB du sous-moniteur auquel il appartient. Permet de générer un PSB par sous-moniteur et non un PSB général pour tout le Dialogue (voir aussi la section Lignes -GG de l'onglet Lignes -G). SWAP Avec l'utilisation d'un moniteur ou d'un sous-moniteur permet d'indiquer, dans la mappe MFS, le code Ecran de débranchement à partir d'une touche fonction. Dans les mappes, la zone FUNC est générée sur 10 caractères. Cette zone comporte la valeur de la touche fonction et le nom externe du prochain Ecran à appeler. En cas de fin de conversation, le nom externe est à blanc.
En cas de débranchement différé ou de traitement de la touche fonction comme alimentation du code opération, le nom externe est celui qui correspond à la mappe générée. Le traitement de cette zone est effectué dans le moniteur ou le sous-moniteur.
Cette option améliore les performances, car il n'est nécessaire de rappeler le programme pour effectuer le débranchement.
TMF TANDEM : Prise en compte du mode transactionnel par génération des ordres BEGIN-TRANSACTION et END-TRANSACTION dans les requesters et des ordres BEGIN-WORK et COMMIT-WORK dans le moniteur transactionnel PacWeb. TS CICS : Gestion de la zone de communication en dehors de la LINKAGE SECTION. Cette zone est décrite en WORKING-STORAGE SECTION et sauvegardée par défaut en TEMPORARY STORAGE. En cas de MDTOFF et d'appel de la fonction souffleur, l'écran est sauvegardé dans une seule zone. TZVAR BULL multi-écrans : alimentation des zones de réception et d'affichage en cas d'erreur. ZNUM GCOS7 (sauf GCOS7 FORMS) et GCOS8 : Alimentation des zones numériques dans le message (F8145) effectuée uniquement si aucune erreur n'a été détectée (GR-EG=0). Tableau 2. Options sur les Dialogues et Ecrans Clients. Ce tableau présente les valeurs des options que vous pouvez indiquer sur les Dialogues et Ecrans Clients, avec leur signification. Les options peuvent être indiquées au niveau du Dialogue. Elles deviennent alors les options par défaut des Ecrans de ce Dialogue. Valeurs Signification CALLSPG Option possible sur un Moniteur Client ou un Moniteur Serveur. Type d'appel utilisé par les Moniteurs Client ou Serveur pour l'appel des Clients ou Serveurs qui leur sont rattachés. La valeur par défaut est CALL.
Dans le cas où il n'y a pas de Moniteur Client, c'est le type d'appel du Serveur par le Client.
CALLTYPE Option possible sur un Moniteur Client, un Moniteur Serveur, un Moniteur de Communication, un Composant Applicatif ou un Dossier. Type d'appel du Serveur par le Client.
Pour CICS, cette option a 2 valeurs possibles : CALL et LINK.
FORMAT Format des Rubriques de la Vue Logique. Avec la valeur INTERNAL, les Rubriques de la Vue Logique sont générées à partir du format interne et prennent en compte l'usage de cette Rubrique.
Avec la valeur EXTENDED, le format des Rubriques est recalculé de la manière suivante : l'usage indiqué est ignoré et remplacé par l'usage DISPLAY, et si la Rubrique est une Rubrique numérique signée, l'usage SIGN IS LEADING.
INICHECK Gestion de la présence des Rubriques. Option réservée à un Dialogue Client TUI.
Un buffer de présence des données est généré et initialisé à P (champ absent). Lors des transferts en vue d'une mise à jour (fonction F30), le poste de chaque champ effectivement transféré sera positionné à N. Les transferts en affichage seront aussi conditionnés par la présence du champ.
INITSERV Appel d'un Composant Applicatif d'Initialisation et de Terminaison (type IT). Un chaînage libre est établi dès que vous indiquez un Composant Applicatif d'Initialisation et de Terminaison.
La saisie dans cette zone est facilitée par un assistant de saisie, signalé par le symbole
devant la zone. Pour activer l'assistant de contenu, cliquez simultanément sur Ctrl et la barre d'espace. Un lien de sous-référence est créé automatiquement, même si l'instance cible n'existe pas. Depuis l'instance cible affichée dans les sous-références, vous pouvez lancer une recherche de super-références.
LGCOMZS Option possible sur un Moniteur Client ou un Moniteur Serveur. Zone de communication entre les Moniteurs Client et Serveur.
La valeur saisie doit être de 5 caractères.
LTHENATT Longueur de la zone de sauvegarde de la table EN-ATT (défaut : 2000). LTHREPET Longueur de la zone de sauvegarde de la répétitive (défaut : 1000). LTHSCREEN Longueur de la zone de sauvegarde du message écran (défaut : 6000). NOMAP Génération ou non-génération de la mappe, suivant la valeur de l'option dans le Dialogue et l'Ecran. La génération de la mappe dépend aussi de la case à cocher Génération avec mappe dans la Définition de l'Ecran.
La valeur NOMAP est équivalente à NOMAP=YES. Elle inhibe la génération de la mappe.
La valeur NOMAP=NO permet de générer la mappe.
La valeur de l'option dans le Dialogue est automatiquement prise en compte dans l'Ecran. Si vous souhaitez conserver cette valeur dans tous les Ecrans du Dialogue, il est donc inutile d'indiquer cette option sur tous ces Ecrans.
En revanche, si vous souhaitez modifier la valeur de l'option indiquée dans le Dialogue sur certains Ecrans, vous devez l'indiquer. Les deux cas suivants sont possibles :- Si le Dialogue contient la valeur NOMAP ou NOMAP=YES et si l'Ecran contient la valeur NOMAP=NO, la mappe de l'Ecran est générée.
- Si le Dialogue contient la valeur NOMAP=NO et si l'Ecran contient la valeur NOMAP ou NOMAP=YES, la mappe de l'Ecran n'est pas générée.
NUVERS Gestion des versions du Composant Applicatif, de la proxy Dossier ou Vue de Dossier et du Client TUI. Cette option n'est pas utilisée dans Rational Programming Patterns.
TERMSERV Appel d'un Composant Applicatif de Terminaison. Tableau 3. Options sur les Composants Applicatifs. Ce tableau présente les valeurs des options sur les Composants Applicatifs, avec leur signification. Les options peuvent être indiquées au niveau du Dialogue Composant Applicatif. Elles deviennent alors les options par défaut des Composants Applicatifs de ce Dialogue. Cependant, quelques options doivent être indiquées au niveau des Composants Applicatifs. Ces cas sont mentionnés dans le tableau. Valeurs Signification ACCESERR Nombre maximum d'erreurs d'accès Segment pouvant être retournées au client. Valeur sur 3 caractères (défaut = 001)
CALLSPG Option possible sur un Moniteur Client ou un Moniteur Serveur. Type d'appel utilisé par les Moniteurs Client ou Serveur pour l'appel des Clients ou Serveurs qui leur sont rattachés. La valeur par défaut est CALL.
Dans le cas où il n'y a pas de Moniteur Client, c'est le type d'appel du Serveur par le Client.
CALLTYPE Option possible sur un Moniteur Client, un Moniteur Serveur, un Moniteur de Communication, un Composant Applicatif ou un Dossier. Type d'appel du Serveur par le Client.
Pour CICS, cette option a 2 valeurs possibles : CALL et LINK.
CHANGE Option spécifique à TUXEDO. CHANGE=NO (valeur par défaut) : Appel du Composant Applicatif avec le paramètre TPNOCHANGE
CHANGE=YES : appel du Composant Applicatif avec le paramètre TPCHANGE
Il est conseillé de positionner la même option dans le Dialogue Composant Applicatif et le Dialogue Dossier.
CHECKSER Cette option permet de générer ou non le contrôle des données de la Vue Logique par le Composant Applicatif. CHECKSER=NO (défaut) : Pas de contrôle des données de la Vue Logique par le Composant Applicatif.
CHECKSER=YES : Contrôle des données de la Vue Logique par le Composant Applicatif.
Pour les applications graphiques, les options VECTPRES et CHECKSER dans des Composants Applicatifs appelant la même Vue Logique doivent être identiques.
CONNECT Gestion des connexions et déconnexions aux bases de données relationnelles. CONNECT=YES (défaut) : Connexions et déconnexions générées dans le Moniteur de Communication
Pour TUXEDO, ces connexions et déconnexions sont générées dans les Composants Applicatifs d'Initialisation et Terminaison (type SI ou ST type). Dans ce cas, vous appelez également un des Segments Tables de la base à laquelle vous voulez vous (dé)connecter.
CONNECT=NO (valeur réservée aux applications TUI) : Connexions et déconnexions générées automatiquement dans le Composant Applicatif.
CURSUFF Suffixage des noms de curseurs. CURSUFF=NO (défaut) : Pas de suffixage des noms de curseurs.
CURSUFF=YES : Nom des curseurs SQL suffixé par le nom de l'Ecran correspondant.
DATAERR Nombre d'erreurs sur les données de la Vue Logique pouvant être retournées au Client. Le nombre est saisi sur 2 caractères. La valeur par défaut est 01.
Remarque : La valeur de cette option indiquée dans le Composant Applicatif d'Initialisation et de Terminaison doit être identique à la valeur de l'option dans tous les Composants Applicatifs rattachés au Dossier.FORMAT Pour une application graphique, indiquez obligatoirement FORMAT=EXTENDED. INITSERV Appel d'un Composant Applicatif d'Initialisation et de Terminaison (type IT). Un chaînage libre est établi dès que vous indiquez un Composant Applicatif d'Initialisation et de Terminaison.
La saisie dans cette zone est facilitée par un assistant de saisie, signalé par le symbole
devant la zone. Pour activer l'assistant de contenu, cliquez simultanément sur Ctrl et la barre d'espace. Un lien de sous-référence est créé automatiquement, même si l'instance cible n'existe pas. Depuis l'instance cible affichée dans les sous-références, vous pouvez lancer une recherche de super-références.
LGCOMM Longueur de la zone de communication entre les composants suivants : - Moniteur de Communication (application graphique) et Composant Applicatif,
- Dossier et Composant Applicatif,
- Client TUI ou Moniteur Client et Composant Applicatif.
La valeur de cette option est numérique sur 5 caractères. Elle est obligatoire si plusieurs Composants Applicatifs sont rattachés au Dialogue.
LGCOMZS Option possible sur un Moniteur Client ou un Moniteur Serveur. Zone de communication entre les Moniteurs Client et Serveur.
La valeur saisie doit être de 5 caractères.
LOCATION Option à indiquer pour la prise en compte d'un Moniteur de Communication. Elle doit être indiquée dans le Dialogue Dossier, ou le Dialogue Composant Applicatif si aucun Dossier n'est spécifié. Vous devez indiquer le nom du Moniteur de Communication (sur 6 caractères), un tiret et le nom de l'environnement (sur 20 caractères maximum) : LOCATION=FMCODE-ENVIRNAME.
Un chaînage libre est établi dès que vous indiquez un Moniteur de Communication.
La saisie dans cette zone est facilitée par un assistant de saisie, signalé par le symbole
devant la zone. Pour activer l'assistant de contenu, cliquez simultanément sur Ctrl et la barre d'espace. Un lien de sous-référence est créé automatiquement, même si l'instance cible n'existe pas. Depuis l'instance cible affichée dans les sous-références, vous pouvez lancer une recherche de super-références.
MONSER Nom du Moniteur Serveur pour le mode TUI. Par défaut, il n'y a pas de Moniteur Serveur. NULLMNGT Gestion de la présence des Rubriques des Vues Logiques. NULLMNGT=NO (valeur par défaut) : Pas de gestion de présence des Rubriques des Vues Logiques au niveau de la proxy.
NULLMNGT=YES : Gestion de présence des Rubriques des Vues Logiques au niveau de la proxy.Remarque : Si NULLMNGT=YES, l'option VECTPRES=YES est systématiquement prise en compte.NUVERS Gestion des versions du Composant Applicatif, de la proxy Dossier ou Vue de Dossier et du Client TUI. Cette option n'est pas utilisée dans Rational Programming Patterns.
PACTABLE Nom du programme d'accès Pactables vers le serveur CICS. Valeur par défaut : PACTABLE
PROCESS Option spécifique à TANDEM PATHWAY. Cette option ne peut être indiquée qu'au niveau d'un Composant Applicatif. Nom du process dans l'appel du Composant Applicatif.
Ce nom doit comporter 15 caractères maximum sans caractère blanc. Les minuscules ne sont pas converties en majuscules.
SEGMBUFF Cette option ne peut être indiquée qu'au niveau d'un Composant Applicatif. Cette option est utilisée pour le buffer serveur. Elle permet de sélectionner des Segments de la Structure de Données qui définit le buffer serveur.
Par exemple, si vous indiquez SEGMBUFF=s1s2s3, alors s1, s2 et s3 représentent les deux derniers caractères des codes Segments.
Vous pouvez positionner 10 Segments par option SEGMBUFF.
10 options SEGMBUFF maximum peuvent être appelées au niveau de chaque Composant Applicatif.
Le Segment 00 n'a pas besoin d'être sélectionné. Il est systématiquement généré s'il est présent dans la Structure de Données.
Par défaut, tous les Segments de la Structure de Données sont sélectionnés.
SERVBUFF Disponible uniquement si un Dossier est utilisé. Cette option identifie la Structure de Données qui définit le buffer serveur.
Vous indiquez SERVBUFF=xx, où xx identifie la Structure de Données qui représente le buffer serveur (2 caractères).
Au niveau de chaque Composant Applicatif, vous pouvez sélectionner certains Segments de cette Structure de Données par l'option SEGMBUFF (SEGMBUFF=s1s2s3 par exemple).
TRAN Spécifique à TUXEDO. TRAN=YES (valeur par défaut) : Utilisation du mode transactionnel pour la variante TUXEDO.
TRAN=NO : Pas d'utilisation du mode transactionnel.
VECTPRES Gestion de présence des Rubriques des Vues Logiques. VECTPRES=NO (valeur par défaut) : Pas de gestion de présence des Rubriques des Vues Logiques.
VECTPRES=YES : Gestion de présence des Rubriques des Vues Logiques.Remarque : Si CHECKSER=YES, alors l'option VECTPRES=YES est systématiquement prise en compte.Contrairement à l'option NULLMNGT, cette option ne permet pas de gérer la présence des Rubriques dans la proxy.
Pour les applications graphiques, les options VECTPRES et CHECKSER dans des Composants Applicatifs appelant la même Vue Logique doivent être identiques.
Tableau 4. Options supplémentaires sur les Composants Applicatifs pour le développement mono-vue. Ce tableau présente les options supplémentaires lorsqu'une application ne manipule qu'une Vue Logique et n'inclut donc pas la spécification d'un Dossier. Un gestionnaire de service doit être généré (à partir de la version 9.6) pour chaque Composant Applicatif non intégré à un Dossier. Ce composant purement technique gère toutes les fonctions qui sont gérées par le Dossier quand un Dossier est spécifié. Pour le générer, l'option LOCATION=FMCODE-ENVIRNAME doit être indiquée dans le Composant Applicatif ou son Dialogue. La présence de cette option entraîne par défaut la prise en compte de l'option implicite SRVMGR=YES. Le gestionnaire de service est donc généré par défaut. Les options indiquées au niveau du Dialogue Composant Applicatif deviennent les options par défaut des Composants Applicatifs de ce Dialogue.
Valeurs Signification ERRLAB Format des erreurs qui doivent être retournées. ERRLAB=YES (défaut) : Le Moniteur de Communication récupère la clé, la gravité et les libellés d'erreur retournés par un Composant Applicatif avant d'envoyer la réponse au Client.
ERRLAB=NO : Seule la clé des erreurs est retournée. Dans ce cas, l'application cliente est chargée de lire le libellé d'erreur en local.
ERRSERV Nom du Serveur de Libellés d'erreurs. Cette option est obligatoire. LOCATION Option à indiquer pour la prise en compte d'un Moniteur de Communication. Elle doit être indiquée dans le Dialogue Dossier, ou le Dialogue Composant Applicatif si aucun Dossier n'est spécifié. Vous devez indiquer le nom du Moniteur de Communication (sur 6 caractères), un tiret et le nom de l'environnement (sur 20 caractères maximum) : LOCATION=FMCODE-ENVIRNAME.
Un chaînage libre est établi dès que vous indiquez un Moniteur de Communication.
La saisie dans cette zone est facilitée par un assistant de saisie, signalé par le symbole
devant la zone. Pour activer l'assistant de contenu, cliquez simultanément sur Ctrl et la barre d'espace. Un lien de sous-référence est créé automatiquement, même si l'instance cible n'existe pas. Depuis l'instance cible affichée dans les sous-références, vous pouvez lancer une recherche de super-références.
LOCKMODE Option permettant de préciser le type de verrouillage. Le verrouillage permet de bloquer la mise à jour d'un ensemble de données afin d'éviter toute incohérence.
La valeur NO (par défaut) n'implémente aucun verrouillage.La valeur PESSIMIST créé une appropriation exclusive de l'instance verrouillée pour tout autre utilisateur pendant le temps de sa mise à jour.
La valeur OPTIMIST n'opère qu'au moment de la demande de mise à jour en comparant l'image initialement chargée de l'instance avec son image courante sur la base. Si elles sont identiques, la mise à jour est acceptée.
PAGEMODE Option permettant de préciser le type de pagination. La valeur NOEXTEND (par défaut) permet de paginer en avant et en arrière sur une population prédéfinie. Chaque pagination demandée par le composant Client exécute une demande de lecture et son résultat écrase celui de la lecture précédente.
La valeur EXTEND permet de paginer en avant sur une population prédéfinie, sachant que le résultat de chaque pagination vient s'additionner à celui de la lecture précédente. La lecture des pages précédentes est donc prise en charge par le client graphique.
SRVMGR Option permettant de préciser la génération d'un deuxième source COBOL correspondant au source du gestionnaire de services. Ce composant purement technique génère toutes les fonctions qui sont générées par le Dossier quand un Dossier est spécifié. Par défaut, l'option SRVMGR=YES est implicite dans les Composants Applicatifs et leur Dialogue si l'option LOCATION est présente. Le gestionnaire de service est donc généré par défaut. Le nom du fichier du gestionnaire de service provient de la zone Nom externe du service de la Définition du Composant Applicatif ou, à défaut, du nom du Composant Applicatif.
Vous indiquez l'option SRVMGR=NO dans tout Composant Applicatif qui ne nécessite la génération d'un gestionnaire de service.
Tableau 5. Options sur les Moniteurs de Communication. Ce tableau présente les valeurs des options sur les Moniteurs de Communication, avec leur signification. Les options peuvent être indiquées au niveau du Dialogue Moniteur de Communication. Elles deviennent alors les options par défaut des Moniteurs de Communication de ce Dialogue. Valeurs Signification BASE Code de la base de données relationnelle. Cette option est obligatoire dès lors qu'une table relationnelle est un composant du Dossier, même s'il ne s'agit que du fichier de travail.
La valeur BASE=THREAD est réservée à UNISYS 2200 pour indiquer une organisation SFS.
BASELOC Localisation de la base de données relationnelle. Cette option est obligatoire si le code de la base est renseigné.
Les valeurs possibles sont LOCAL (défaut) et REMOTE.
CALLTYPE Option possible sur un Moniteur Client, un Moniteur Serveur, un Moniteur de Communication, un Composant Applicatif ou un Dossier. Type d'appel du Serveur par le Client.
Pour CICS, cette option a 2 valeurs possibles : CALL et LINK.
SERVBUFF Saisie de la Structure de Données définissant le buffer serveur. Vous indiquez SERVBUFF=xx, où xx identifie la Structure de Données qui représente le buffer serveur (2 caractères).
Remarque : La même option doit être positionnée au niveau du Dialogue des Composants Applicatifs du Dossier.WAITINT Option spécifique à MQ Series et à TCP/IP Socket sous MVS/CICS Délai d'attente, en secondes, entre le lancement de deux requêtes.
La valeur par défaut pour MQ Series est 0001.
La valeur par défaut pour TCP/IP Socket sous MVS/CICS est 1800.
WAITINT1 Option spécifique à MQ Series. Délai d'attente, en secondes, avant le lancement de la première requête (valeur par défaut = illimitée).
Vous pouvez modifier la valeur par défaut en saisissant un nombre sur quatre caractères.
WORKFILB Option obligatoire. Nom du Bloc Base de Données pour un fichier de travail en organisation H ou nom externe du fichier pour une organisation V.
Pour IBM CICS - VSAM, vous indiquez le DDNAME sur 1 à 8 positions.
Pour GCOS8, la valeur dépend du type de blocage :- Avec un blocage par caractères, vous indiquez le nom externe sur 4 caractères (généré dans la clause SELECT) et le blocage sur les 4 derniers caractères (généré dans la clause FD).
- Avec un blocage par record, vous indiquez le nom externe sur 5 caractères et le blocage sur les 3 derniers caractères.
Pour les autres variantes, vous indiquez le nom logique, généré dans la clause SELECT.
WORKFILS Option obligatoire. Segment associé au fichier de travail.
WORKFILO Option obligatoire. Organisation du fichier de travail utilisé par le Moniteur de Communication :- V : Séquentielle indexée
- H : Relationnelle
- W : Working
Tableau 6. Options sur les Dossiers. Ce tableau présente les valeurs des options sur les Dossiers, avec leur signification. Les options peuvent être indiquées au niveau du Dialogue Dossier. Elles deviennent alors les options par défaut des Dossiers de ce Dialogue. Valeurs Signification CALLTYPE Option possible sur un Moniteur Client, un Moniteur Serveur, un Moniteur de Communication, un Composant Applicatif ou un Dossier. Type d'appel du Serveur par le Client.
Pour CICS, cette option a 2 valeurs possibles : CALL et LINK.
CHANGE Option spécifique à TUXEDO. CHANGE=NO (valeur par défaut) : Appel du Composant Applicatif avec le paramètre TPNOCHANGE
CHANGE=YES : appel du Composant Applicatif avec le paramètre TPCHANGE
Il est conseillé de positionner la même option dans le Dialogue Composant Applicatif et le Dialogue Dossier.
ERRLAB Format des erreurs qui doivent être retournées. ERRLAB=YES (défaut) : Le Moniteur de Communication récupère la clé, la gravité et les libellés d'erreur retournés par un Composant Applicatif avant d'envoyer la réponse au Client.
ERRLAB=NO : Seule la clé des erreurs est retournée. Dans ce cas, l'application cliente est chargée de lire le libellé d'erreur en local.
INITSERV Appel d'un Composant Applicatif d'Initialisation et de Terminaison (type IT). Un chaînage libre est établi dès que vous indiquez un Composant Applicatif d'Initialisation et de Terminaison.
La saisie dans cette zone est facilitée par un assistant de saisie, signalé par le symbole
devant la zone. Pour activer l'assistant de contenu, cliquez simultanément sur Ctrl et la barre d'espace. Un lien de sous-référence est créé automatiquement, même si l'instance cible n'existe pas. Depuis l'instance cible affichée dans les sous-références, vous pouvez lancer une recherche de super-références.
LOCATION Option à indiquer pour la prise en compte d'un Moniteur de Communication. Elle doit être indiquée dans le Dialogue Dossier, ou le Dialogue Composant Applicatif si aucun Dossier n'est spécifié. Vous devez indiquer le nom du Moniteur de Communication (sur 6 caractères), un tiret et le nom de l'environnement (sur 20 caractères maximum) : LOCATION=FMCODE-ENVIRNAME.
Un chaînage libre est établi dès que vous indiquez un Moniteur de Communication.
La saisie dans cette zone est facilitée par un assistant de saisie, signalé par le symbole
devant la zone. Pour activer l'assistant de contenu, cliquez simultanément sur Ctrl et la barre d'espace. Un lien de sous-référence est créé automatiquement, même si l'instance cible n'existe pas. Depuis l'instance cible affichée dans les sous-références, vous pouvez lancer une recherche de super-références.
NULLMNGT Gestion de la présence des Rubriques des Vues Logiques. NULLMNGT=NO (valeur par défaut) : Pas de gestion de présence des Rubriques des Vues Logiques au niveau de la proxy.
NULLMNGT=YES : Gestion de présence des Rubriques des Vues Logiques au niveau de la proxy.Remarque : Si NULLMNGT=YES, l'option VECTPRES=YES est systématiquement prise en compte.PROCESS Option spécifique à TANDEM PATHWAY. Cette option ne peut être indiquée qu'au niveau d'un Composant Applicatif. Nom du process dans l'appel du Composant Applicatif.
Ce nom doit comporter 15 caractères maximum sans caractère blanc. Les minuscules ne sont pas converties en majuscules.
TRAN Spécifique à TUXEDO. TRAN=YES (valeur par défaut) : Utilisation du mode transactionnel pour la variante TUXEDO.
TRAN=NO : Pas d'utilisation du mode transactionnel.
Tableau 7. Options sur les Composants Applicatifs d'Initialisation et de Terminaison. Ce tableau présente les valeurs des options sur les Serveurs de type Composants Applicatifs d'Initialisation et de Terminaison, avec leur signification. Les options peuvent être indiquées au niveau du Dialogue Composant Applicatif d'Initialisation et de Terminaison. Elles deviennent alors les options par défaut des Composants Applicatifs d'Initialisation et de Terminaison de ce Dialogue. Valeurs Signification ACCESERR Nombre maximum d'erreurs d'accès Segment pouvant être retournées au client. Valeur sur 3 caractères (défaut = 001)
CALLTYPE Option possible sur un Moniteur Client, un Moniteur Serveur, un Moniteur de Communication, un Composant Applicatif ou un Dossier. Type d'appel du Serveur par le Client.
Pour CICS, cette option a 2 valeurs possibles : CALL et LINK.
CHANGE Option spécifique à TUXEDO. CHANGE=NO (valeur par défaut) : Appel du Composant Applicatif avec le paramètre TPNOCHANGE
CHANGE=YES : appel du Composant Applicatif avec le paramètre TPCHANGE
Il est conseillé de positionner la même option dans le Dialogue Composant Applicatif et le Dialogue Dossier.
DATAERR Nombre d'erreurs sur les données de la Vue Logique pouvant être retournées au Client. Le nombre est saisi sur 2 caractères. La valeur par défaut est 01.
Remarque : La valeur de cette option indiquée dans le Composant Applicatif d'Initialisation et de Terminaison doit être identique à la valeur de l'option dans tous les Composants Applicatifs rattachés au Dossier.PROCESS Option spécifique à TANDEM PATHWAY. Cette option ne peut être indiquée qu'au niveau d'un Composant Applicatif. Nom du process dans l'appel du Composant Applicatif.
Ce nom doit comporter 15 caractères maximum sans caractère blanc. Les minuscules ne sont pas converties en majuscules.
TRAN Spécifique à TUXEDO. TRAN=YES (valeur par défaut) : Utilisation du mode transactionnel pour la variante TUXEDO.
TRAN=NO : Pas d'utilisation du mode transactionnel.
Fichier d'erreur
Précisez les caractéristiques physiques du fichier des libellés d'erreur afin que la description de ce fichier et ses accès puissent être générés.
Les accès physiques sont générés en fonction F8098. Si vous désirez les ré-écrire, vous devez écraser cette sous-fonction.
- Organisation
- Cette zone permet d'indiquer le type d'organisation du fichier
des libellés d'erreur :
- Aucune
- D: Segment de base DL/1
La description du fichier des libellés d'erreur et les ordres d'accès à ce fichier sont générés automatiquement. En IMS, la description du fichier libellés d'erreur n'est pas générée automatiquement. Vous devez la décrire dans un Segment appelé par un Bloc hiérarchique.
- S: Base DB2
- U: Accès par code spécifique
- V: Organisation indexée
- Y : UNYSIS 2200 SFS organisation indexée
Les Segments sont déclarés en FD et les accès sont générés en fonction F80.
- Nom externe
- Indiquez le nom externe du fichier des libellés d'erreur. Sa valeur varie selon la variante
COBOL à générer :
- Pour IBM CICS - VSAM, indiquez un DDNAME sur 8 positions.
- Pour GCOS7 - UFAS, indiquez un code fichier sur 2 caractères.
- Pour GCOS8 - TP8, indiquez un nom externe sur 4 caractères (généré dans la clause SELECT) et un blocage sur les 4 derniers caractères (généré dans la clause FD).
- Pour toute autre variante, indiquez un nom logique, généré dans la clause SELECT.