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.
- 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.
- 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.
Référez-vous aux explications du Tableau 1 pour la liste des options disponibles sur un Serveur ou un Dialogue Serveur.
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.
- 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.
- 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.
| 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 :
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 |
| LGCOMM | Longueur de la zone de communication entre les composants suivants :
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 |
| 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. |
| 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 |
| 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. |
| 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. |