Lignes -GO

Ces lignes vous permettent d'indiquer des options de génération.

Pour ajouter une ligne, vous avez deux possibilités :
  • Cliquez sur Ajouter ou sélectionnez cette action dans le menu contextuel. Par défaut, le type d'une nouvelle ligne est initialisé à * (commentaire). Pour indiquer une option de génération, cliquez dans la zone Type et sélectionnez le type de ligne O. Indiquez l’option dans la zone Description.
  • Cliquez sur Ajouter un appel de Format Guide ou sélectionnez cette action dans le menu contextuel pour insérer l’appel d’un Format Guide. Une boîte de sélection s’ouvre. Elle affiche les Formats Guides disponibles de type O : Options de génération. Sélectionnez l’un d’eux et cliquez sur OK.

    Les libellés variables et les valeurs symboliques indiqués dans l’onglet Lignes -D du Format Guide sélectionné s’affichent alors dans la colonne Description, en consultation. Le nom du Format Guide s’affiche dans la colonne Format Guide.

    Si vous cliquez sur le nom du Format Guide dans la colonne Format Guide, un bouton s’affiche. Cliquez dessus pour faire apparaître toutes les lignes de description du Format Guide dans une fenêtre de détail. Dans cette fenêtre, vous pouvez modifier les libellés variables et les valeurs symboliques.
    Remarque : La longueur d’un libellé variable ne doit pas excéder la longueur définie dans l’onglet Lignes -D du Format Guide.
Erreur
Cette colonne affiche un point pour toute ligne de description existante non vide.

De plus, si la ligne n'est pas correcte, cette colonne affiche aussi le symbole d'une erreur ou d'un avertissement, selon la gravité de l'erreur. Une infobulle vous informe de l'origine de l'erreur.

Type
Les types de ligne suivants sont possibles :
  • O pour une ligne d’option de génération.
  • * pour une ligne non générée et utilisée pour l'insertion d'un commentaire ou écrasement. Par défaut, lorsqu'une ligne est créée, son type est initialisé à cette valeur.

Cette colonne affiche la valeur I sur toutes les insertions de Format Guide. Cette valeur ne peut pas être sélectionnée directement.

Description
Cette zone doit contenir les informations suivantes :
  • Si vous avez inséré une ligne de type O, vous devez indiquer le nom de l'option, le signe =, puis la valeur de l'option. Pour activer une option, indiquez OPTION=YES (OPTION étant le nom de l'option). Ces options peuvent être saisies indifféremment dans les Lignes -GO la zone Options de l'onglet Complément du Dialogue ou Dialogue Serveur.
  • Si vous avez inséré une ligne de type *, vous devez saisir le commentaire.
  • Si vous avez inséré une ligne d’appel de Format Guide, les libellés variables et les valeurs symboliques indiqués dans les Lignes -D du Format Guide sélectionné s’affichent.
    Remarque : La largeur de la colonne Description est limitée à 60 caractères. Pour voir l'intégralité d'un appel de Format Guide dépassant 60 caractères, survolez le contenu de la colonne. L'intégralité de l'appel s'affiche alors dans une infobulle.
Format Guide
Cette colonne contient le nom d’un Format Guide appelé. Le bouton qui s’affiche quand vous cliquez dans cette colonne vous permet de voir la description du Format Guide dans une fenêtre de détail. Dans cette fenêtre, vous pouvez modifier les libellés variables et les valeurs symboliques.

Liste des options de génération disponibles

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 assistant de saisie 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 assistant de saisie 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 assistant de saisie 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 assistant de saisie 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.
Les deux parties du nom externe, chacune sur 2 caractères, sont séparées par un tiret.

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 assistant de saisie 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 assistant de saisie 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.


Vos commentaires