Appel de Serveurs dans un Composant Applicatif

Dans l'onglet Lignes -CS d'un éditeur de Serveur ou Dialogue Serveur de type Composant Applicatif, vous pouvez appeler un autre Composant Applicatif pour exécuter un service. Le code de la première Vue Logique qui transmet la demande de service au Composant Applicatif de premier niveau, l'appel de la Vue Logique de niveau 2 (dans l'arborescence correspondante) par son code dans le Composant Applicatif de niveau 1, l'appel de service auprès du Composant Applicatif de second niveau doivent être indiqués dans la section Appel d'un Serveur.

Remarque : Pour mettre en place cet appel de service, vous devez déclarer la Vue Logique 2 qui véhicule les informations entre les deux Composants Applicatifs et préciser le type de service à exécuter sur la Vue Logique 2.

Serveur

Dans cette zone, vous devez sélectionner un code pour le Serveur appelé dans le Composant Applicatif en cliquant sur Modifier. Pour supprimer l'appel de ce code dans la zone, cliquez sur Supprimer. Un clic sur le code Serveur ouvre l'éditeur du 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 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.
Chaque Segment doit être chaîné directement ou indirectement à la Vue Logique dont il dépend. Il doit donc comporter le code d'un Segment précédent, ou de sa Vue Logique (organisation S).
Exception : Le Segment dédié au fichier des libellés d'erreur ne doit pas comporter de Segment précédent. De même, une Vue Logique ne peut avoir de Segment précédent.
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 pour une organisation de type X : Appel global d'un Composant Applicatif ou 2 : Appel d'un Composant Applicatif instance par instance.
Tableau 1. Spécification de l'utilisation d'un Segment dans un traitement en réception
Options Description
Aucune valeur ou N Aucun appel de Serveur n'est généré.
L Appel d'un Serveur pour sélection.
E Appel d'un Serveur pour contrôle.
M Appel d'un Serveur pour contrôle et mise à jour.
X Appel d'un Composant Applicatif pour contrôle et sélection.
T Appel d'un Serveur pour contrôle, mise à jour et sélection. Dans le cas où la Vue Logique est appelée dans la catégorie répétitive, il n'est pas possible d'afficher la suite de l'écran. Il n’est donc pas possible d'utiliser de manière automatique le code opérateur S.
U Appel d'un service utilisateur.
Alimentation de la clé
Cette zone peut être une zone de travail, un littéral
Exemple :
  • 02 pour un littéral
  • ww10-corub pour une zone de travail
Remarque : L'alimentation des clés pour les listes doit toujours se faire à partir de la zone 1- dans les serveurs dès lors que la clé se trouve dans la répétitive de la Vue Logique.

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.

Caractéristiques logiques

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

    Pas de génération des traitements logiques d'accès (organisations différentes de S)

  • P : Pas de description du Segment (organisations différentes de S)
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 2. Valeurs possibles pour la rupture d'affichage
Option Description
Pas de rupture de sélection Pour les organisations différentes de S, indique qu'une Rubrique, appartenant à une clé dans la partie répétitive, doit rester constante au cours de la sélection.
C : Rupture de sélection Pour les organisations différentes de S, indique qu'une Rubrique, appartenant à une clé dans la partie répétitive, doit rester constante au cours de la sélection.
E : Rupture de sélection (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é.
R Organisations H, D ou V : Lecture massive du Dossier. Zone à renseigner pour chaque Segment rattaché à la Vue Logique, cette Vue devant appartenir à un noeud dépendant du Dossier. Valeur à positionner sur chaque Rubrique clé qui correspond à une Rubrique clé de la Vue Logique appartenant au noeud racine du Dossier.
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
Non utilisé pour un Composant Applicatif.

Caractéristiques physiques

Organisation
  • X: Appel global de Composant Applicatif :

    Le Composant Applicatif de premier niveau effectue ainsi des appels de service et se comporte comme un Client. Sa fonctionnalité doit être envisagée comme un aiguillage vers des Composants Applicatifs de second niveau qui exécutent la totalité du service demandé ; l'appel du Composant Applicatif de second niveau ne s'effectue qu'une seule fois pour toutes les instances.

  • Appel de Composant Applicatif (instance par instance) :

    L'appel du Composant Applicatif de second niveau s'effectue à chaque instance. Ceci permet l'appel de Composants Applicatifs en tant que serveurs complémentaires par rapport au Composant Applicatif de premier niveau. De la sorte, une demande de service peut appeler des Composants Applicatifs et des Segments d'accès aux données.

    Remarque : Ce type d'appel permet notamment à une application TUI de travailler en mode pseudo Dossier : Le client passif demande un service sur une Vue Logique agrégée contenant plusieurs Vues Logiques. Ce service est implémenté par un Composant Applicatif de premier niveau qui a charge d'appeler – pour chaque instance de la Vue Logique agrégée – les différents Composants Applicatifs associés aux autres Vues Logiques concernées.
Type de description
Le type de description est positionné à 1 automatiquement.
Nom externe
Saisissez le code du Composant Applicatif.

Vos commentaires