Rational Programming Patterns

Lignes -CS - Appel de Serveur

Vous pouvez appeler un Serveur à partir d'un Client TUI pour un service de contrôle et de sélection par exemple. Les caractéristiques de l'appel de Serveur doivent être renseignées dans la section Appel de Serveur dans la fenêtre de l'onglet Lignes -CS.

Segment

Segment
Sélectionnez un code pour le Segment appelé en cliquant sur Modifier. C'est le code du Segment choisi pour le client TUI. Le code choisi peut être identique au code du Segment dans la Base. La valeur LE00 est réservée pour appeler le fichier des libellés d'erreur. Ce Segment est appelé par le Dialogue des clients TUI.
Remarque : Vous pouvez choisir d'appeler ce fichier dans un serveur de libellés d'erreur. Dans ce cas, vous devrez au préalable définir et décrire le Segment correspondant à ce fichier.
Le code Vue Logique servant à l'appel d'un Composant Applicatif (Organisation X) doit être identique à celui utilisé dans le Composant Applicatif associé. Cliquez sur le code du Segment pour ouvrir l'éditeur de Segment.

Serveur

Sélectionnez le code du Serveur en cliquant sur Modifier. Pour enlever ce code de la zone, cliquez sur Supprimer. Cliquez sur le code du Serveur pour ouvrir l'éditeur dans lequel a été défini le Serveur.

identifiant

Catégorie
Vous indiquez ici à quelle catégorie de traitement le Segment appartient. Les catégories, et donc les Segments correspondants, sont traitées dans l'ordre suivant :
  • Catégorie en-tête,

    Segment appartenant à l'en-tête

  • R : catégorie répétitive

    Segment appartenant à la partie répétitive

  • Z : Catégorie bas de l'Ecran/Dialogue

    Segment appartenant au bas d'écran

Code Segment
C'est le code du Segment choisi pour le programme généré associé à l'Ecran. Le code choisi peut être identique au code du Segment dans la base.
Numéro de ligne
Cette zone doit contenir une valeur numérique. Pour un Segment donné, une seule ligne 00 est acceptée (par défaut). Cette ligne zéro est obligatoire pour renseigner les caractéristiques physiques du Segment (nom externe, organisation), le code de la clé d'accès au Segment, le code du Segment dans la base.

Remplissage de la clé d'accès

Code Segment précédent
Il est possible, dans chacune des catégories de traitement, d'accéder à plusieurs Segments. On peut donc être amené à préciser la hiérarchie des accès aux Segments d'une catégorie. Cette zone contient le code du Segment précédent dans la hiérarchie des accès. Ce Segment doit appartenir à la même catégorie. Si plusieurs Segments ont un même Segment précédent, ils sont traités dans l'ordre alphabétique de leur code.
Réception
Dans cette zone, vous devez préciser de quelle façon le Segment est utilisé dans les traitements de contrôle et mise à jour en choisissant une des valeurs proposées dans la liste déroulante.
Tableau 1. Valeurs de l'utilisation d'un Segment dans les traitements de contrôle et mise à jour
Options Description
Aucune valeur ou N Pour une organisation différente du type X, aucun ordre d'accès n'est généré pour le Segment dans les traitements de contrôle et mise à jour.

Pour une organisation de type X : aucun appel de serveur n'est généré.

L Lu. Un ordre de lecture simple est généré pour le Segment pour une organisation différente de X.

Ou appel d'un serveur pour sélection pour une organisation de type X.

E Pour une organisation différente du type X : contrôle d'existence à effectuer ou ordre de lecture avec positionnement d'un code erreur est généré (s’il n’est pas trouvé).

Pour une organisation de type X : appel d'un serveur pour contrôle.

M Pour une organisation différente du type X : Segment mis à jour (modification uniquement).

Pour une organisation de type X : appel d'un serveur pour contrôle et mise à jour.

X Pour une organisation différente du type X : Segment mis à jour (création et modification uniquement).

Pour une organisation de type X : appel d'un Composant Applicatif pour contrôle et sélection.

S Pour une organisation différente du type X seulement : Segment mis à jour (annulation uniquement).
C Pour une organisation différente du type X seulement : Segment mis à jour (création uniquement).
T Pour une organisation différente du type X : Segment mis à jour (création, modification et annulation). Dans ces trois cas, le contrôle d'existence et les ordres de mise à jour correspondant aux options choisies sont générés. Si le Segment est chaîné à un Segment précédent, quel que soit le code utilisation, seuls sont générés les ordres de mise à jour de modification et création.

Pour une organisation de type X : appel d'un serveur pour contrôle, mise à jour et sélection. Si la Vue Logique est appelée dans la catégorie répétitive, il n'est pas possible d'afficher la suite de l'Ecran. Il est donc impossible d'utiliser de manière automatique le code opérateur S.

U Pour une organisation de type X seulement : Appel d'un service utilisateur.
Affichage
Pour l'utilisation en affichage, une des valeurs proposées dans la liste doit être sélectionnée.
Tableau 2. Valeurs de l'utilisation d'un Segment en affichage
Options Description
Aucune valeur ou N Pour une organisation différente de X : aucun ordre d'accès n'est généré pour ce Segment dans les traitements d'affichage (option par défaut).

Pour une organisation X : aucun appel de serveur n'est généré.

A Pour une organisation différente de X : les ordres d'accès sont générés pour l' affichage en fonction du type de traitement d'accès logique. Si le code Segment précédent est à blanc et si le Segment est utilisé, la clé est sauvegardée en zone de conversation.

Pour une organisation X : appel d'un serveur pour sélection (incompatible avec la valeur L en réception).

U Pour une organisation de type X seulement : appel d'un service utilisateur.
Alimentation de la clé
Cette zone peut être une zone de travail, un littéral ou une zone de l'Ecran. Dans ce dernier cas, les 4 premiers caractères de la zone doivent correspondre au code de l'Ecran dans le Dialogue.
Exemple :
  • 0001-corub pour une zone de l'Ecran
  • 02 pour un littéral
  • ww10-corub pour une zone de travail

Clé primaire

Dans cette section, vous devez sélectionner une Rubrique ou saisir le nom d'une nouvelle Rubrique (non définie) qui servira de clé d'accès au Segment. Elle est utilisée pour générer la clause RECORD KEY. La Rubrique indiquée ici est considérée comme une Rubrique groupe, sauf dans les organisations SQL où elle est considérée comme Rubrique élémentaire.

Rubrique
Cette zone contient le code de la Rubrique utilisée comme clé d'accès au Segment. Vous pouvez changer le choix du code avec le bouton Modifier.
Rubrique non définie
Si la clé d'accès primaire est une Rubrique groupe, vous pouvez saisir dans la zone Rubrique non définie le code des Rubriques élémentaires composant le groupe.

S'il s'agit d'un groupe et que les différentes sous-Rubriques sont alimentées séparément, des lignes suites contiennent alors le code des sous-Rubriques alimentées.

Pour une Table (organisation G), la sélection d'un sous-système s'effectue en indiquant dans cette zone la valeur NUSSY. L'alimentation de la clé associée (G-ddss-NUSSY) est automatiquement générée.

En DL/1, la Rubrique peut appartenir à toutes les SSA qui permettent d'accéder au Segment dans le PCB indiqué dans le nom externe.

Pour les bases de données SQL, une Rubrique clé doit être indiquée pour chaque ligne où un Affichage autre que N est déclaré.

Dans les accès générés, la sélection se fait sur l'égalité en mise à jour ou lecture directe. Pour la lecture séquentielle en catégorie répétitive, la sélection se fait sur les valeurs supérieures ou égales.

Le nombre de Rubriques clés pour un même Segment est limité à 10

Les Rubriques clés ne sont pas mises à jour dans un ordre SQL UPDATE.

Logical characteristics

Limitation de génération
Sélectionnez dans la liste, la limitation de génération des accès logiques aux Segments :
  • Automatique :

    Accès logiques générés automatiquement (en fonction de l'utilisation du Segment)

  • U : Accès laissés à la charge de l'utilisateur

    Accès logiques au Segment laissés à la charge de l'utilisateur, en langage structuré (organisations différentes de X )

  • P : Pas de description du Segment (organisations différentes de X )
Rupture d'affichage
Cette zone indique qu'une Rubrique, appartenant à une clé dans la partie répétitive de l'Ecran, doit rester constante au cours de l'affichage. Sélectionnez dans la liste la rupture d'affichage. Dans le cas d'un Segment utilisé en mise à jour, cette zone doit être positionnée à la valeur Pas de Rupture d'affichage.
Tableau 3. Valeurs possibles pour la rupture d'affichage
Option Description
Pas de rupture d'affichage. Pour les organisations différentes de X, indique qu'une Rubrique, appartenant à une clé dans la partie répétitive d'un Ecran, doit rester constante au cours de l'affichage.
C : Rupture d'affichage. Pour les organisations différentes de X, indique qu'une Rubrique, appartenant à une clé dans la partie répétitive d'un Ecran, doit rester constante au cours de l'affichage.
E : Rupture d'affichage. (SQL) Pour les organisations SQL, provoque la génération dans la clause WHERE de l'ordre SQL DECLARE CURSOR d'une condition d'égalité (et non >= qui est généré sinon). Permet d'optimiser l'emploi des curseurs en catégorie répétitive.
R Pour les organisations SQL, lecture massive à partir de la racine (application graphique en mode dossier uniquement).
Sous-schéma
Cette zone permet d'indiquer quel sous-schéma doit être décrit. Vous devez sélectionner une valeur dans la liste déroulante parmi Toutes les Rubriques et une sous-description de 0 à 9 (0 correspond à un sous-schéma 10). Un sous-schéma est un groupe de Rubriques présentes dans la composition du Segment.
  • Pour les organisations G ou H, cette zone précise le numéro de la sous-description de la table à laquelle correspond la description de la zone entrée-sortie. Si le Segment appelé correspond à une vue et qu'il n'y a pas de sous-schéma indiqué, on prendra ce qui est indiqué au niveau du -DR du Bloc :
    • Toutes les Rubriques du Segment
    • Sous-description ou sous-schéma numéro 0 à 9
  • Pour les organisations V, elle indique les clés secondaires d'accès aux fichiers indexés :
    • La valeur 2 indique que la clé secondaire est référencée en codant 2 dans le numéro de sous-schéma. La clé primaire doit être indiquée sur la ligne 00 du Segment sans utilisation en affichage ni réception, même si elle n'est pas utilisée, afin de générer la clause RECORD KEY. Si la clé secondaire est une zone groupe, le numéro du sous-schéma doit être indiqué uniquement pour cette zone groupe.
    • La valeur 3 indique que la clé secondaire est DUPLICATE.
      Remarque : Cette spécification n'est pas implémentée dans la variante CICS puisque la déclaration des clés secondaires est effectuée lors de la définition VSAM.
Niveau des traitements générés
Pacbench C/S génère automatiquement dans le Composant Applicatif associé au client les traitements dépendant de l'utilisation en réception et en affichage des Segments utilisés dans cet Ecran. Les valeurs autorisées sont celles comprises entre 06 et 98. Ce niveau hiérarchique est à 10 par défaut. Il peut être modifié pour une Rubrique ou pour un Segment.

Caractéristiques physiques

Organisation
La valeur que vous sélectionnez dans cette zone correspond à l'organisation du Segment, elle est obligatoire pour la ligne 00. Sélectionnez un type d'organisation dans la liste. Les options sont présentées dans Tableau 4.
Tableau 4. Organisations disponibles pour un Segment
Options Description
Aucun Aucune
V : Indexée Segment d'organisation indexée.
G : typeTable Segment de type Pactables : l'accès généré correspond à l'appel du module d'accès standard à Pactables.
H : Base de Données relationnelle (accès SQL) Segments de base de données relationnelle à laquelle on accède par SQL :

La description du Segment et les accès physiques sont générés; la déclarative du curseur est générée pour les Segments de la catégorie répétitive.

Le type du Bloc Base de Données relationnel est requis sur la Définition du Bloc dont le code est à saisir dans la zoneNom externe.

W : Traitements spécifiques et alimentation clés d'affichage Accès au Segment gérés par traitements spécifiques. Seule une description en WORKING-STORAGE SECTIION est générée.
X : Appel d'un serveur pour contrôle et sélection Appel d'un serveur pour contrôle et sélection.
Remarque : Pour le Fichier des libellés d'erreur :
  • Organisation V: Indiquez le nom externe du fichier, le code Pacbase n'est pas contrôlé.
  • Organisation W : Working; pas d'accès généré.
  • Organisation H : Indiquez le nom externe du fichier. Le nom externe correspond au code du Bloc contenant la table relationnelle indiquée dans la zone Bloc Base de Données.
  • Organisation X : Appel du Serveur accédant au fichier de libellés d'erreur. Le code Serveur est indiqué dans le nom externe. .
Type de description
La valeur sélectionnée dans cette zone permet d'obtenir à partir de la description du Segment dans la base, différentes descriptions dans le Programme généré. Sélectionnez une des options suivantes :
Tableau 5. Types de description
Option Description
Complet Segment complet (partie commune et partie spécifique).
1 :Partie spécifique uniquement Partie spécifique uniquement. (Valeur par défaut pour une table G).
E : Type TABLE Pour l'organisation table, prise en compte du format d'entrée des Rubriques du Segment table.
2 : Complet (longueur variable) Segment complet en longueur variable pour l'organisation indexée (V).

La description générée peut varier en fonction de la variante de langage sélectionnée.

Nom externe
Cette valeur par défaut correspond aux deux premiers caractères du code du Segment dans l'Ecran.
  • Pour une organisation V (indexée) :
    • IBM CICS-VSAM : DDNAME DDNAME sur 1 à 8 positions.
    • DPS8-TP8 : Nom externe sur 4 caractères (généré dans la clause SELECT).
    • Blocage sur les 4 derniers caractères (généré dans la clause FD).
    • Autre variante : Nom logique, généré dans la clause SELECT.
  • Pour une organisation H (SQL) :
    • Code du Bloc SQL, dans lequel est appelée la table ou la vue. Il est possible de sélectionner une table ou une vue en indiquant T ou V après le code du Bloc choisi. Attention : le code du Bloc et le type d'objet doivent être séparé par un blanc.

      Au moment de la génération, le nom externe de la table ou vue est recherché dans la description du Bloc. S'il n'est pas indiqué, le nom externe est pris sur la définition du Segment.

    • Pour un Fichier des libellés d'erreurs :

      Le nom externe à renseigner est le code du Bloc contenant la table relationnelle indiquée dans la zone Base.

      La description et les accès sont générés sous le code de la table relationnelle saisi dans cette zone.

  • Pour une organisation G :

    CICS : 4 caractères à partir desquels sont établis les DDNAMEs des fichiers gérés par Pactables, c'est à dire le code transaction permettant l'accès au fichier Pactables.

  • Pour une organisation X (Appel de serveur) : code du Composant Applicatif

Conditions d'utilisation | Commentaires en retour

Ce centre de documentation utilise la technologie Eclipse. (http://www.eclipse.org)