Lignes -GO de Serveur ou Dialogue Serveur

Ces lignes vous permettent d'indiquer des options de génération sur un Serveur ou un Dialogue Serveur.

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.
Vous pouvez créer, réordonner ou supprimer des lignes avec les boutons (dont la position est paramétrable avec les préférences des éditeurs de design) associés au tableau ou avec le menu contextuel ouvert par clic droit. Le menu contextuel contient en outre les choix classiques Copier, Coller mais aussi Copier spécial et Coller spécial. Ces deux derniers choix sont disponibles depuis les Lignes -D des Rubriques, les Lignes -L des Etats et les Lignes -G de toutes les entités.
  • Si vous sélectionnez Copier spécial, une boîte de dialogue s'ouvre. Vous devez alors sélectionner les colonnes à copier et indiquer si vous voulez copier leur contenu vers un éditeur externe ou le même onglet d'une autre instance de la même entité. Le contenu copié est alors placé dans le presse-papiers.
  • Vous pouvez sélectionner Coller spécial pour coller un contenu copié depuis un éditeur externe. Dans ce cas, vous devez sélectionner la colonne dans laquelle le contenu doit être collé. Vous pouvez aussi sélectionner Coller spécial pour coller un contenu copié depuis une autre instance avec le choix Copier spécial.

La première colonne du tableau vous permet de sélectionner facilement plusieurs lignes contiguës ou non. Pour sélectionner des lignes contiguës, cliquez dans cette colonne sur la première ligne à sélectionner, puis appuyez sur la touche majuscule de votre clavier. Sélectionnez ensuite les autres lignes en cliquant sur la dernière ligne à sélectionner ou en utilisant les flèches vers le haut ou le bas de votre clavier. Pour sélectionner des lignes non-contiguës, cliquez sur une ligne, puis sélectionnez les autres lignes en cliquant dans cette colonne et en appuyant sur la touche ctrl de votre clavier.

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 une option. La saisie des options n'est pas contrôlée.

    Après avoir indiqué les options nécessaires, vous devez déclarer des options supplémentaires si vous ne spécifiez pas de Dossier pour votre application. Référez-vous alors aux explications du Tableau 2 pour le développement mono-vue.

    Référez-vous aux explications du Tableau 3 pour la liste des options sur un Composant Applicatif d'Initialisation et de Terminaison.

    Pour faciliter la saisie des options dans les Lignes -GO, vous pouvez ouvrir un assistant de contenu en cliquant simultanément sur Ctrl et la barre d'espace. Cet assistant affiche la liste des options possibles en fonction du type d'entité et de la variante de génération. Vous pouvez aussi saisir directement les options en saisissant le nom de l'option, le signe = et la valeur de l'option. Pour activer une option, indiquez OPTION=YES (OPTION étant le nom de l'option).

  • Si vous avez inséré une ligne de type *, vous devez saisir un 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 sur un Serveur ou un Dialogue Serveur

Le Tableau 1 indique les options générales sur un Serveur ou un Dialogue Serveur. Le Tableau 2 est spécifique du développement mono-vue. Le Tableau 3 présente les options sur un Composant Applicatif d'Initialisation et de Terminaison ou son Dialogue.

Tableau 1. Options sur un Serveur ou un Dialogue Serveur.

Ce tableau présente les valeurs des options sur un Serveur ou un Dialogue Serveur, avec leur signification. Si les options sont indiquées au niveau du Dialogue, elles deviennent alors les options par défaut des Serveurs de ce Dialogue. Cependant, quelques options doivent être indiquées au niveau des Serveurs. De plus, certaines options ne sont disponibles que dans certains types de Serveur.

Valeurs Signification
ACCESERR Nombre maximum d'erreurs d'accès Segment pouvant être retournées au client. Indiquez une valeur sur 3 caractères, la valeur par défaut étant 001.
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.

Dans les Lignes -GO, vous pouvez 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 appelés dans les Lignes -CD et dans les zones de travail (directement dans le code COBOL).
  • Les Dialogues et Ecrans pour les Rubriques élémentaires des Segments appelés dans le Complément au Dialogue, dans les Lignes -CS et dans les zones de travail (directement dans le code COBOL).
  • Les Rubriques appelées dans les zones de travail.

    Si vous activez l'option BREAKDATE, 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 Lignes -GO 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.

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 mais vous pouvez aussi indiquer la valeur LINK.

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. La valeur de cette option change en fonction de la variante de langage.

Pour CICS, les valeurs sont LINK et CALL.

Pour GCOS8, les valeurs sont NTPR, LINK et CALL.

Pour GCOS7, les valeurs sont NTPR, LINK et CALL.

Pour IMS, les valeurs sont CALL et CHNG.

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. La valeur par défaut est 32000.

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.
PACTABLE Nom du programme d'accès Pactables vers le serveur CICS.

Valeur par défaut : PACTABLE

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 2. Options supplémentaires pour le développement mono-vue.

Ce tableau présente les options supplémentaires pour un développement mono-vue, c'est à dire quand 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 3. Options sur un Composant Applicatif d'Initialisation et de Terminaison ou son Dialogue.

Ce tableau présente les valeurs des options sur un Serveur de type Composant Applicatif d'Initialisation et de Terminaison ou son Dialogue, 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. Indiquez une valeur sur 3 caractères, la valeur par défaut étant 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. La valeur de cette option change en fonction de la variante de langage.

Pour CICS, les valeurs sont LINK et CALL.

Pour GCOS8, les valeurs sont NTPR, LINK et CALL.

Pour GCOS7, les valeurs sont NTPR, LINK et CALL.

Pour IMS, les valeurs sont CALL et CHNG.

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 Spécifique à la variante TANDEM PATHWAY.

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