Bull DPS 7000 Guide de l'utilisateur

Interfaces de programmation Bull DPS 7000 Guide de l'utilisateur Configuration et utilisation de /HOST7 GCOS 7 Logiciel Sujet : Ce manuel explique comment configurer et utiliser le produit /HOST7. Il s'agit d'un logiciel Bull permettant à une application TUXEDO sous UNIX d'utiliser les transactions et les données d'une application TDS sous GCOS 7. Observations : Version du logiciel : GCOS 7 AP/HPS à partir de la version V6 (à partir de TS6152) Date : Novembre 1995 Bull S.A. Bull HN Information Systems Inc. CEDOC Publication Order Entry Atelier de reproduction MA30/843 331, Avenue Patton BP 428 300 Concord Road 49005 ANGERS Cedex Billerica, MA 01821 FRANCE U.S.A. 47 F2 30UT Rev01

Copyright Bull S.A., 1995 Toutes les marques citées sont la propriété de leurs titulaires respectifs. Vos suggestions sur la forme et le fond de ce manuel seront les bienvenues. Une feuille destinée à recevoir vos remarques se trouve à la fin du présent manuel. La loi du 11 mars 1957, complétée par la loi du 3 juillet 1985, interdit les copies ou reproductions destinées à une utilisation collective. Toute représentation ou reproduction intégrale ou partielle faite par quelque procédé que ce soit, sans consentement de l'auteur ou de ses ayants cause, est illicite et constitue une contrefaçon sanctionnée par les articles 425 et suivants du code pénal. Ce document est fourni à titre d'information seulement. Il n'engage pas la responsabilité de Bull S.A. en cas de dommages résultant de son application. Des corrections ou modifications au contenu de ce document peuvent intervenir sans préavis ; des mises à jour ultérieures les signaleront éventuellement aux destinataires.

Préface OBJET DU MANUEL Ce manuel explique comment configurer et utiliser les composants GCOS 7 de /HOST7. Sa lecture doit être associée à celle du manuel TUXEDO /Host Guide, qui décrit les composants UNIX de /HOST7. Remarque : Du point de vue de TUXEDO, /HOST7 est "l'instanciation" GCOS7/TDS du produit /Host. Dans la documentation TUXEDO, il est appelé "Extension de /Host". UTILISATEURS CONCERNES Administrateur TDS et administrateurs de réseau responsables de la configuration des composants GCOS 7 de /HOST7. La connaissance de TDS, XCP2 et NETGEN est un prérequis. Les programmeurs d'applications TDS responsables de la programmation de transactions TDS pour le compte de clients TUXEDO. La connaissance du COBOL ou du langage C sous GCOS 7 est un prérequis. 47 F2 30UT Rev01 iii

Configuration et utilisation de /HOST7 BIBLIOGRAPHIE GCOS 7 Cette bibliographie est fournie à titre indicatif. Pour plus de précisions (disponibilité du manuel en français, numéro de révision, indice de mise à jour), veuillez vous adresser à CEDOC. TDS : TDS - Guide de l'administrateur (V6)...47 F2 20UT TDS Administrator's Guide (V6)...47 A2 20UT TDS - Guide du programmeur (V6)...47 F2 21UT TDS Cobol Programmer's Manual (V6)...47 A2 21UT TDS - Guide de l'administrateur (V7)...47 F2 32UT TDS Administrator's Guide (V7)...47 A2 32UT TDS - Manuel du programmeur (V7)...47 F2 33UT TDS Programmer's Manual (V7)...47 A2 33UT TDS/C - Guide du programmeur...47 F2 07UT TDS C Language Programmer's Manual...47 A2 07UT Haute disponibilité (HA) - Guide de l'administrateur...47 F2 23UT High Availability Administrator's guide...47 A2 23UT Communications : CPI-C/XCP2 - Guide de l'utilisateur...47 F2 14UT CPI-C/XCP2 User's Guide...47 A2 14UT Réseaux - Concepts et génération...47 F2 71UC Networks: Overview and Generation... 47 A2 71UC Réseaux ISO - Concepts et génération...47 F2 91UC ISO Networks: Overview and Generation... 47 A2 91UC Réseaux - Concepts...47 F2 92UC Networks Overview... 47 A2 92UC Génération de réseaux...47 F2 93UC Network Generation... 47 A2 93UC iv 47 F2 30UT Rev01

Préface BIBLIOGRAPHIE UNIX TUXEDO : TUXEDO /Host Guide...86 A2 58AT TUXEDO System /Host for GCOS Guide... 86 A2 56CD TUXEDO SRB...86 A2 58WF TUXEDO EXTENSION SRB... CD-ROM (DPX/20) TUXEDO Product Overview...86 A2 49AT TUXEDO Reference Manual...86 A2 61AT TUXEDO Administrator's Guide...86 A2 50AT TUXEDO Programmer's Guide...86 A2 52AT TUXEDO Cobol Guide...86 A2 60AT TUXEDO FML Guide...86 A2 54AT TUXEDO Application Development Guide...86 A2 51AT Communications : CPI-C/OSI Administrator's Guide... 86A2 92QP CPI-C Programmer's Guide... 86A2 91QP Dans ce manuel, les références des manuels GCOS 7 sont citées sous forme abrégée (4 derniers caractères alphanumériques). 47 F2 30UT Rev01 v

Configuration et utilisation de /HOST7 STRUCTURE DU MANUEL Chapitre 1 GENERALITES SUR /HOST7... Fournit un aperçu des concepts et du fonctionnement de /HOST7. Chapitre 2 CONFIGURATION DES COMPOSANTS GCOS 7 DE /HOST7. Décrit les procédures de configuration d'une application TDS et des communications XCP2 nécessaires à /HOST7. Chapitre 3 PROGRAMMATION D'UNE TRANSACTION TDS POUR UN CLIENT TUXEDO Décrit les structures de données, les fonctions et les règles de programmation des transactions de service TDS. Chapitre 4 CONTROLE D'ACTIVITE DE LA PASSERELLE TDS Explique comment obtenir des historiques en traitement par lots et l'affichage en ligne des informations concernant l'utilisation de la passerelle TDS. Annexe A FORMAT D'ARTICLE DU FICHIER HOST Présente la description d'article du fichier HOST. Annexe B MESSAGES D'ERREUR ET REPONSES /HOST7 Fournit la liste des messages de la passerelle TDS et des commandes maîtresses TDS, des messages d'erreur du compte rendu d'exécution HOST7 et des codes d'erreur envoyés à TUXEDO. Annexe C EXEMPLE COBOL D'UNE TRANSACTION DE SERVICE TDS Fournit un exemple de transaction TDS programmée en COBOL comme service pour TUXEDO. vi 47 F2 30UT Rev01

Préface LISTE DE CONVENTIONS D'ECRITURE GCL/JCL Les conventions d'écriture utilisées dans ce manuel pour la syntaxe des commandes maîtresses TDS, des commandes GCL et des ordres JCL sont les suivantes : ELEMENT élément Les majuscules indiquent une valeur littérale à introduire telle quelle. A noter que, dans la pratique, cette convention peut être abandonnée au profit des minuscules. Les minuscules indiquent une valeur non littérale. Il s'agit d'une valeur à fournir par l'utilisateur. En général, le type et la longueur maximale de la valeur sont spécifiés : déc2 nom8 nombre entier de 2 chiffres maximum nom de 8 caractères maximum Dans certains cas, le format de la valeur est précisé : jjmmaa date Dans d'autres cas, il s'agit d'une description de la valeur : classe-appareils volume ELEMENT Un élément souligné représente la valeur implicite. { } Les accolades indiquent que l'utilisateur doit choisir une valeur parmi celles présentées. [ ] Les crochets indiquent un élément facultatif. Un élément ne figurant pas entre crochets est obligatoire. = * # Caractères spéciaux à introduire tels quels. Exemple 1 : [ TDS = { nom4 #WTDS } ] Ce paramètre est facultatif. Vous pouvez spécifier : TDS=TD08 (par exemple) aucune valeur (la valeur implicite TDS=#WTDS est prise en compte) TDS=#WTDS (identique à la valeur implicite) Exemple 2 : REPORT = { D S } Ce paramètre est obligatoire. Vous devez spécifier REPORT=D ou REPORT=S. 47 F2 30UT Rev01 vii

Configuration et utilisation de /HOST7 viii 47 F2 30UT Rev01

Table des matières 1. Généralités sur /HOST7... 1-1 1.1 MODÈLE CLIENT/SERVEUR... 1-2 1.2 LOGICIELS NÉCESSAIRES... 1-4 1.3 CONCEPTS FONDAMENTAUX ET COMPOSANTS... 1-5 1.3.1 Passerelles TDS... 1-5 1.3.2 Fichier HOST... 1-7 1.3.3 Passerelles natives... 1-7 1.3.4 Types de tampon STRING, CARRAY et VIEW... 1-7 1.3.5 Communications entre passerelles... 1-8 1.4 RÉCAPITULATION DES FONCTIONS UTILISATEUR DE /HOST7... 1-9 2. Configuration des composants GCOS 7 de /HOST7... 2-1 2.1 ALLOCATION DU FICHIER HOST... 2-2 2.2 GÉNÉRATION DE TDS... 2-3 2.2.1 Clause HOST GATEWAY... 2-3 2.2.2 Clause MESSAGE-LENGTH... 2-4 2.2.3 Clause MAXIMUM XCP2-WAITTIME... 2-4 2.2.4 Passerelles TDS en environnement HA... 2-4 2.3 ASSIGNATION DU FICHIER HOST... 2-5 2.4 CONFIGURATION DE XCP2... 2-6 47 F2 30UT Rev01 ix

Configuration et utilisation de /HOST7 2.4.1 Fichier PPCLOG... 2-6 2.4.2 Exemple de génération de réseau... 2-6 2.5 LANCEMENT DE /HOST7... 2-8 3. Programmation d'une transaction TDS pour un client TUXEDO... 3-1 3.1 CORRESPONDANCE ENTRE TYPES DE DONNÉES TUXEDO ET TDS... 3-2 3.1.1 Types de tampon... 3-2 3.1.2 Conversion des tampons... 3-2 3.1.3 Données décimales condensées (dec_t)... 3-4 3.2 ECHANGE DE DONNÉES... 3-5 3.2.1 Verbe RECEIVE (COBOL)... 3-5 3.2.2 Verbe SEND (COBOL)... 3-7 3.2.3 Macro Receive (langage C)... 3-9 3.2.4 Macro Send (langage C)... 3-10 3.3 RÈGLES DE PROGRAMMATION... 3-11 3.4 ACCÈS PROGRAMME AUX INFORMATIONS SUR LA PASSERELLE TDS... 3-13 3.4.1 Procédure DISPLAY-GATEWAY (COBOL)... 3-13 3.4.2 Macro h_dgwt_status (langage C)... 3-15 3.5 CONSÉQUENCES DES DÉFAILLANCES ET RELANCES A CHAUD... 3-16 3.6 SÉCURITÉ ET CODES D'AUTORISATION D'ACCÈS... 3-17 4. Contrôle d'activité de la passerelle TDS... 4-1 4.1 HISTORIQUE DE L'ACTIVITÉ DE LA PASSERELLE TDS... 4-1 4.2 ACTIVITÉ COURANTE DE LA PASSERELLE TDS... 4-4 x 47 F2 30UT Rev01

Table des matières Annexes A. Format d'article du fichier HOST... A-1 A.1 FORMAT EN COBOL... A-1 A.2 FORMAT EN LANGAGE C... A-2 B. Messages d'erreur et réponses /HOST7... B-1 B.1 MESSAGES DE LA PASSERELLE TDS... B-1 B.2 MESSAGES DES COMMANDES MAÎTRESSES ("MASTER") TDS... B-3 B.3 MESSAGES D'ERREUR GENERÉS PAR PRINT_HOST_FILE... B-4 B.4 CODES D'ERREUR ENVOYES PAR LA PASSERELLE TDS A TUXEDO... B-6 C. Exemple COBOL de transaction de service TDS... C-1 Glossaire... g-1 Index... i-1 47 F2 30UT Rev01 xi

Configuration et utilisation de /HOST7 Illustrations Figures 1-1 Modèle client/serveur de /HOST7... 1-2 1-2 Exemple de configuration /HOST7... 1-3 1-3 Fonctionnement d'une passerelle TDS... 1-5 1-4 Communications entre passerelles... 1-8 2-1 Procédure de lancement de /HOST7... 2-8 3-1 Exemple de structures VIEW et COBOL correspondantes... 3-4 4-1 Exemple d'historique généré par la commande PRINT_HOST_FILE... 4-2 4-2 Exemple d'écran affiché par la commande DISPLAY_TDS_GATEWAY... 4-5 Tableaux 1-1 Primitives ATMI... 1-10 3-1 Types de données : correspondance entre langage C TUXEDO et langages COBOL et C sous GCOS 7... 3-3 3-2 Types de données : correspondance entre COBOL TUXEDO et langages COBOL et C sous GCOS 7... 3-3 xii 47 F2 30UT Rev01

1. Généralités sur /HOST7 /HOST7 permet à une application TUXEDO sous UNIX d'utiliser les transactions et les données d'une application TDS sous GCOS 7. TUXEDO est disponible sur les systèmes DPX/20 et ESCALA ; TDS (Transaction Driven Subsystem) est le sous-système transactionnel disponible sur les systèmes DPS 7000. Avec /HOST7, vous pouvez : étendre votre application TUXEDO afin de tirer parti de la puissance de GCOS 7 ; intégrer vos opérations TDS existantes à l'environnement UNIX-TUXEDO. Un exemple type d'utilisation de /HOST7 est une application bancaire TUXEDO demandant la mise à jour d'un compte, géré dans l'environnement GCOS 7, sur lequel s'effectue des prélèvements à l'aide d'une carte de crédit. S'il existe déjà des transactions TDS pour effectuer ces mises à jour, il est aisé de les modifier pour coopérer avec TUXEDO. 47 F2 30UT Rev01 1-1

Configuration et utilisation de /HOST7 1.1 MODELE CLIENT/SERVEUR /HOST7 permet d'étendre le modèle client/serveur de TUXEDO à l'environnement GCOS 7. Application TUXEDO Application TDS client Passerelle native Passerelle TDS Transaction de service UNIX GCOS 7 Figure 1-1. Modèle client/serveur de /HOST7 Dans le modèle client/serveur de /HOST7 : L'application TUXEDO est le "client" et l'application TDS le "serveur". Le programmeur TUXEDO écrit un client qui demande un "service", tandis que le programmeur TDS écrit une transaction qui le fournit (transaction de service). Leurs programmes échangent des données dans des formats compatibles, mais, par ailleurs, ils sont parfaitement indépendants l'un vis à vis de l'autre. Les communications de données sont prises en charge par des "serveurs passerelles" et sont complètement transparentes pour le client TUXEDO et la transaction de service TDS. Les communications entre un client TUXEDO et une transaction TDS s'effectuent via deux serveurs passerelles situés aux deux extrémités du lien de communications. Côté UNIX, la passerelle est appelée "passerelle native" ("native gateway") et côté GCOS 7 "passerelle TDS" ("TDS gateway"). Du point de vue d'unix, la passerelle TDS est également considérée comme une passerelle étrangère, distante ou hôte. A condition d'avoir une passerelle native et une passerelle TDS par lien de communications : une application TUXEDO peut communiquer avec diverses applications TDS ; plusieurs applications TUXEDO peuvent communiquer avec la même application TDS. 1-2 47 F2 30UT Rev01

Généralités sur /HOST7 La figure 1-2 présente un exemple de configuration réunissant deux applications TUXEDO (APP1 et APP2) et trois applications TDS (TDS1, TDS2 et TDS3). Application UNIX - TUXEDO : APP2 Application UNIX -TUXEDO : APP1 client client client NGW1 NGW3 NGW1 NGW2 TGW1 TGW3 TGW1 TGW2 TDS2 TDS3 TDS1 GCOS 7 GCOS 7 Figure 1-2. Exemple de configuration /HOST7 47 F2 30UT Rev01 1-3

Configuration et utilisation de /HOST7 1.2 LOGICIELS NECESSAIRES DPS 7000 : GCOS 7 - V6 (à partir de TS6152) CPI-C/XCP2 option accès ISO/DSA sur CNS7 ou DNS ou MAINWAY ESCALA : AIX 4.1 CPI-C/OSI Pour en savoir plus, voir le document TUXEDO EXTENSIONS Software Release Bulletin. 1-4 47 F2 30UT Rev01

Généralités sur /HOST7 1.3 CONCEPTS FONDAMENTAUX ET COMPOSANTS 1.3.1 Passerelles TDS Une passerelle TDS ("TDS gateway") est une transaction système capable de : lancer les transactions utilisateur TDS pour le compte de TUXEDO ; envoyer les données structurées générées par la transaction à TUXEDO ; fournir des informations en ligne concernant la configuration et l'utilisation de /HOST7 ; consigner, dans le fichier HOST, des informations concernant chaque demande de service TUXEDO. GCOS 7 TDS UNIX TUXEDO C P I _ C Gestion des services TRANSACTION Gestion des services ADMINISTRATION Transaction utilisateur PASSERELLE TDS Fichier HOST Figure 1-3. Fonctionnement d'une passerelle TDS Comme tous les serveurs, une passerelle TDS doit être lancée pour pouvoir traiter les demandes de service et arrêtée après la dernière demande. Ces deux opérations sont effectuées, à la demande de l'administrateur TUXEDO, par la passerelle native ("native gateway"). 47 F2 30UT Rev01 1-5

Configuration et utilisation de /HOST7 Après lancement, une passerelle TDS peut gérer les services "transaction" pour le client TUXEDO et les services "administration" pour l'administrateur TUXEDO. De même, elle peut consigner des informations concernant ces demandes dans le fichier HOST, pour que l'administrateur TDS puisse en disposer (voir ci-dessous). Gestion des services "transaction" Ces services sont demandés par le client TUXEDO. La demande indique un nom de service et est généralement accompagnée de données utilisateur TUXEDO. La passerelle native ("native gateway") met en correspondance le nom de service avec le nom d'une transaction utilisateur TDS. Cette information est ensuite transmise à la passerelle TDS ("TDS gateway"). Cette dernière lance la transaction utilisateur TDS demandée, puis lui transmet les données TUXEDO. A la fin de la transaction utilisateur TDS, la passerelle TDS envoie à TUXEDO les données générées par cette transaction. Gestion des services "administration" Ces services sont demandés par l'administrateur TUXEDO responsable du lancement et de la surveillance des passerelles native et TDS. Les demandes sont traitées par la passerelle native et consignées par la passerelle TDS comme demandes de service dans le fichier HOST. Les noms de services d'administration consignés par la passerelle TDS sont de type : BOOT SHUTDOWN PRINTHOST STATS RECONNECT Demande de connexion de la passerelle native à la passerelle TDS (commande tmboot). Demande de déconnexion de la passerelle native de la passerelle TDS (commande tmshutdown). Demande d'informations de disponibilité de la passerelle TDS (commande printdomain). Demande d'informations statistiques concernant l'utilisation de la passerelle TDS (commande stats). Demande de reconnexion de la passerelle native à la passerelle TDS (commande reconnectdomain). Cette demande peut survenir après une défaillance de TDS ou une rupture des communications entre les deux passerelles (native et TDS). Par exemple, dans le cas d'une défaillance de TDS, l'administrateur TUXEDO peut reconnecter la passerelle native à la passerelle TDS, une fois cette dernière relancée. 1-6 47 F2 30UT Rev01

Généralités sur /HOST7 1.3.2 Fichier HOST Le fichier HOST sert à enregistrer l'activité de la passerelle TDS. Les informations concernant chaque demande de service émise par TUXEDO y sont consignées (date, heure, état service effectué ou non, noms de service, longueur de tampon, type de tampon...). Le fichier HOST est facultatif. S'il n'est ni alloué ni assigné, l'administrateur ne peut tout simplement pas obtenir d'historique en traitement par lots ("batch") concernant l'activité de la passerelle TDS. 1.3.3 Passerelles natives Les passerelles natives ("native gateway") sont les composants UNIX de /HOST7. Elles fournissent les noms des services (transactions TDS) disponibles dans l'environnement GCOS 7. Les noms de services sont consignés par l'administrateur TUXEDO dans le fichier UBBCONFIG et associés aux noms de transactions TDS dans le fichier INITFILE (voir TUXEDO Administrator's Guide). Lorsqu'un client TUXEDO demande un service, la passerelle native adresse cette demande et les données associées à la passerelle TDS. Elle assure la conversion des données TUXEDO au format EBCDIC requis par TDS, ainsi que celle des données émises par TDS au format ASCII requis par TUXEDO. Les passerelles natives sont créées au moyen de la commande buildgateway. Leur configuration s'effectue comme celle de tout autre serveur TUXEDO. 1.3.4 Types de tampon STRING, CARRAY et VIEW Les applications TUXEDO échangent des données via des tampons ("buffer") de quatre types différents : STRING, CARRAY, VIEW et FML. Toutefois, lors de ses échanges avec la passerelle TDS, la passerelle native n'utilise que les trois suivants : STRING CARRAY VIEW Tableau de caractères non-nuls terminés par le caractère Nul. Il s'agit d'un tampon autodéfini. Tableau d'octets non interprétés, éventuellement Nuls. Il s'agit d'un tampon autodéfini. Structure de données similaire à une structure C ou à une donnée groupe COBOL. Il s'agit d'un tampon nécessitant un fichier de description. Le tampon de type FML est converti en structure VIEW par la passerelle native. 47 F2 30UT Rev01 1-7

Configuration et utilisation de /HOST7 1.3.5 Communications entre passerelles Les communications entre la passerelle native et la passerelle TDS sont gérées par CPI- C/OSI du côté UNIX et par CPI-C/XCP2 côté GCOS 7. CPI-C est l'interface de programmation commune pour les communications définie par X/OPEN. CPI-C/OSI côté UNIX et CPI-C/XCP2 côté GCOS 7 sont des produits distincts. /HOST7 ne peut être utilisé que s'ils sont installés et configurés. Les demandes de service s'effectue au moyen des verbes TUXEDO standard tpcall, tpacall et tpforward. Elles sont ensuite : interprétées comme verbes CPI-C par la passerelle native ; transmises au réseau par le serveur OSI-XCP2 ; transmises à la passerelle TDS via l'interface CPI-C/XCP2 ; et enfin, transmises pour traitement à la transaction utilisateur TDS. UNIX GCOS 7 TUXEDO TDS Client TUXEDO Transaction utilisateur tpcall RECEIVE SEND EGI PASSERELLE NATIVE CPI-C PASSERELLE TDS CPI-C CPI-C/OSI ISO (PID) DSA CPI-C/XCP2 Figure 1-4. Communications entre passerelles Les termes CPI-C, XCP2, PID... sont définis dans le glossaire. 1-8 47 F2 30UT Rev01

Généralités sur /HOST7 1.4 RECAPITULATION DES FONCTIONS UTILISATEUR DE /HOST7 Administrateur TDS : Paramètres TP7PREP permettant l'allocation du fichier HOST (voir le chapitre 2). Clause HOST GATEWAY de TDS permettant la déclaration des passerelles TDS lors de la génération de TDS (voir le chapitre 2). Commande GCL PRINT_HOST_FILE permettant d'obtenir un rapport en traitement par lots ("batch") de l'historique des demandes de service (voir le chapitre 4). Commande maîtresse ("MASTER") TDS DISPLAY_GATEWAY_STATUS permettant la visualisation rapide de l'état courant de la passerelle TDS, du nom de ses correspondants, ainsi que d'un court résumé du traitement des demandes de service (voir le chapitre 4) Programmeur d'applications TDS : Structures de données en langage C et COBOL permettant l'échange de données avec TUXEDO (voir le chapitre 3). Procédure COBOL "DISPLAY-GATEWAY" et macro h_dgwt_status en langage C permettant l'accès aux informations relatives à la passerelle TDS (voir le chapitre 3). Administrateur TUXEDO : Commande buildgateway permettant de créer des passerelles natives. Commande printservice de tmadmin permettant d'obtenir le nom d'un service tel qu'il est connu par le TDS distant. Commandes printdomain et stats de tmadmin permettant d'obtenir l'état de la passerelle TDS et des informations relatives à son activité. Commande reconnectdomain de tmadmin permettant de reconnecter la passerelle native à la passerelle TDS après défaillance de TDS ou une rupture de communications entre passerelles. Pour plus de détails, voir les manuels TUXEDO /Host Guide et TUXEDO Reference Manual. 47 F2 30UT Rev01 1-9

Configuration et utilisation de /HOST7 Programmeur d'applications TUXEDO : La programmation de clients et de serveurs en environnement /HOST7 est très proche de celle des autres clients et serveurs TUXEDO. Il existe trois contraintes à respecter : Les données transmises par le client TUXEDO doivent être convertibles par la passerelle native au format compatible avec TDS. Les programmeur TUXEDO et TDS doivent s'entendre au préalable sur les types de données à utiliser. Lorsque le verbe tpbegin est émis, les verbes tpcall et tpacall doivent être utilisés avec l'indicateur TPNOTRAN. Seules peuvent être employées les primitives standard ATMI (Application Transaction Management Interface) suivantes : Tableau 1-1. Primitives ATMI Interface application Interface gestion des tampons Communications RPC Routines de service tpinit tpterm tpalloc tprealloc tpfree tptypes tpcall tpacall tpgetreply tpgetprio tpsetprio tpreturn tpforward Pour plus de détails, voir les manuels TUXEDO /Host Guide et TUXEDO Reference Manual. 1-10 47 F2 30UT Rev01

2. Configuration des composants GCOS 7 de /HOST7 Côté GCOS 7 : Les principales opérations à effectuer sont les suivantes : allocation du fichier HOST (facultatif), génération de TDS, assignation du fichier HOST (s'il a été alloué), configuration de XCP2. Les modifications de TDS et les opérations concernant le fichier HOST incombent à l'administrateur TDS. La configuration de XCP2 incombe conjointement aux administrateurs de réseaux UNIX et GCOS 7. Côté UNIX : Les principales opérations à effectuer sont les suivantes : création des passerelles natives (commande buildgateway), déclaration des serveurs passerelles natives ("native gateway") et des services TDS (fichier UBBCONFIG), définition des variables d'environnement des passerelles natives (fichiers ENVFILE), configuration des communications CPI-C/OSI. Pour plus de détails, voir les manuels TUXEDO /HOST Guide et CPI-C/OSI Administrator's Guide. 47 F2 30UT Rev01 2-1

Configuration et utilisation de /HOST7 2.1 ALLOCATION DU FICHIER HOST Pour une réservation automatique, vous pouvez utiliser l'ordre JCL TP7PREP en spécifiant les paramètres suivants : HOST = Y [ HOSTSZ = { déc2 1 } ] [ HOSTMD = { vol ONMD } ] [ HOSTDVC = { app ONDVC } ] HOST HOSTSZ HOSTMD HOSTDVC HOST=Y alloue le fichier HOST sous le nom nom-tds.host. Si le fichier est catalogué, l'attribut SHARE prend automatiquement la valeur SHARE=NORMAL. Taille du fichier en cylindres (valeur par défaut = 1 cylindre). Nom du volume disque. Classe d'appareil. Vous pouvez aussi employer un utilitaire de gestion de fichiers JCL ou GCL (par exemple, la commande GCL BUILD_FILE) pour spécifier les caractéristiques suivantes : Organisation UFAS séquentiel indexé CISIZE 4096 RECSIZE 200 RECFORM Variable (V) Clé primaire (1,8) Taille du fichier HOST L'espace requis par le fichier HOST est proportionnel au nombre total de demandes de services "transaction" et de services "administration" reçu par l'ensemble des passerelles de l'application TDS. taille en octets = 200 * (demandes de services "transaction" + demandes de services "administration") Taille d'incrément du fichier HOST Lorsque le fichier HOST est alloué au moyen de TP7PREP, sa taille d'incrément est de 1 cylindre. Le nombre maximal d'extensions dynamiques est de 15. Lorsque le fichier HOST est saturé le code d'erreur 30024 est enregistré dans le fichier TUXEDO ULOG ; aucune autre information n'est consignée dans le fichier HOST tant qu'il n'a pas été nettoyé par l'administrateur TDS. 2-2 47 F2 30UT Rev01

Configuration des composants GCOS 7 de /HOST7 2.2 GENERATION DE TDS Modifier le fichier source STDS au moyen des éditeurs GCOS 7 (TEXT EDIT ou FSE). Le fichier STDS doit comporter une clause HOST GATEWAY par passerelle TDS à déclarer (voir ci-dessous). Vérifier la valeur de MESSAGE-LENGTH et de MAXIMUM XCP2-WAITTIME (voir cidessous). Générer TDS au moyen de TP7GEN. Pour plus de détails, voir le Guide de l'administrateur TDS. 2.2.1 Clause HOST GATEWAY La syntaxe est la suivante : HOST GATEWAY IS {nom8}. La ou les clauses HOST GATEWAY doivent figurer juste avant la première clause USE (si elle est spécifiée), après la clause MAXIMUM XCP2 WAIT-TIME. Le nom spécifié dans la clause HOST GATEWAY doit correspondre à celui déclaré par le paramètre TDSGATEWAY du fichier ENVFILE correspondant (voir TUXEDO /HOST Guide.) Le nombre maximal de passerelles TDS pouvant être déclarées par application TDS est de 100. Exemple : TDS SECTION. PROGRAM-ID TX03. SIMULTANEITY IS 3. HOST GATEWAY IS TX03-GW. TRANSACTION SECTION. MESSAGE "HSTOPENC" ASSIGN TO... MESSAGE "HSTBALAC" ASSIGN TO... MESSAGE "CRDTC" ASSIGN TO... 47 F2 30UT Rev01 2-3

Configuration et utilisation de /HOST7 2.2.2 Clause MESSAGE-LENGTH Si les données TUXEDO sont trop longues pour la passerelle TDS, la demande échoue. Pour éviter ce problème, spécifier : MESSAGE-LENGTH >= MAXDATALEN + 200 MAXDATALEN est la longueur de données maximale définie côté TUXEDO dans le fichier ENVFILE correspondant (voir TUXEDO /HOST Guide). 2.2.3 Clause MAXIMUM XCP2-WAITTIME Cette clause spécifie la temporisation des verbes CPI-C émis par les passerelles TDS. La valeur par défaut convient généralement ; dans le cas contraire, voir le Guide de l'administrateur TDS. 2.2.4 Passerelles TDS en environnement HA Les passerelles TDS peuvent être générées dans une application TDS s'exécutant dans un environnement HA (c'est-à-dire surveillée par CMSC). Dans le cas d'un basculement (TAKEOVER), lorsque l'application TDS est relancée automatiquement sur un système de secours (BACKUP), les pools de sessions XCP2 sont réouverts automatiquement. Pour plus de détails, voir le Guide de l'administrateur Haute disponibilité. 2-4 47 F2 30UT Rev01

Configuration des composants GCOS 7 de /HOST7 2.3 ASSIGNATION DU FICHIER HOST Pour une assignation statique, ajouter l'ordre ASSIGN au JCL d'exécution TDS de l'utilisateur : ASSIGN H_HOST, nom-tds.host, ACCESS=WRITE; Pour une assignation dynamique, employer la commande maîtresse ("MASTER") TDS OPEN_TDS_FILE : OTF IFN=H_HOST EFN=nom-tds.HOST; Dans les deux cas, s'il s'agit d'un fichier non catalogué, vous devez spécifier le volume et la classe d'appareil associés. Remarque : Si la valeur de l'attribut SHARE du fichier HOST est NORMAL, vous devez désassigner le fichier pour pouvoir lancer en traitement par lots PRINT_HOST_FILE (voir le chapitre 4). Ne pas oublier que SHARE=NORMAL si l'allocation du fichier et son catalogage ont été effectués au moyen de TP7PREP. Afin d'éviter de désassigner le fichier HOST, dans le cas où une lecture "sale" (non consolidée) est admissible, vous pouvez spécifier SHARE=ONEWRITE en procédant comme suit : Pour un fichier HOST catalogué, employer la commande MODIFY_FILE avant de lancer TDS. Pour un fichier HOST non catalogué : - en cas d'assignation statique, modifier l'ordre ASSIGN dans le JCL d'exécution ; - en cas d'assignation dynamique, utiliser la commande maîtresse ("MASTER") TDS OPEN_TDS_FILE ; - modifier l'ordre ASSIGN du JCL TP7HOST dans SYS.HSLLIB avant d'émettre la commande PRINT_HOST_FILE (il s'agit d'une contrainte temporaire). 47 F2 30UT Rev01 2-5

Configuration et utilisation de /HOST7 2.4 CONFIGURATION DE XCP2 1. Allocation du fichier PPCLOG au moyen de TP7PREP. 2. Déclaration des noms d'objets XCP2 au moyen des directives NETGEN. Pour plus de détails, voir le Guide de l'utilisateur CPI-C/XCP2. A NOTER Les administrateurs de réseaux UNIX et GCOS 7 doivent se concerter pour choisir des noms d'objets XCP2 qui correspondent. 3. Configuration de la passerelle ISO/DSA (PID). Voir les manuels Concepts et génération de réseaux et Concepts et génération de réseaux ISO. 2.4.1 Fichier PPCLOG Ce fichier système est obligatoire lorsque TDS utilise XCP2. Pour obtenir des informations concernant son allocation, voir le Guide de l'administrateur TDS. 2.4.2 Exemple de génération de réseau L'exemple suivant présente les directives NETGEN nécessaires à la configuration des communications de TDS (TD08) et XCP2. TDSWKS NAME=TD08 TMSESS=5 XCP2WKS=TDS8; COMM '*********************************************************'; COMM '** X2TDS8: REMOTE LU NAME under UNIX **'; COMM '*********************************************************'; XCP2WKS NAME=TDS8, MAILBOX=X2TDS8, SERVER=1, SESS_CHECK=1, SESS_VERIFIED_ACCEPTED=1, SESS_USERID=MANDATORY, CONV_CHECK=1, CONV_VERIFIED_ACCEPTED=1, CONV_USERID=OPTIONAL, MAXTX=10; 2-6 47 F2 30UT Rev01

Configuration des composants GCOS 7 de /HOST7 XCP2COR NAME=LOCTDS8, SESS=BPCC, MAILBOX=X2TDS8, PARALLEL=1, SYNC_LEVEL=CONFIRM; COMM '*********************************************************'; COMM '** DPX2TDS8: LOCAL LU NAME under UNIX **'; COMM '*********************************************************'; XCP2COR NAME=DPX2TDS8, SESS=BK23, MAILBOX=DPX2TDS8, PARALLEL=1, SYNC_LEVEL=CONFIRM; COMM '*********************************************************'; COMM '** DPXA00L3: MODE NAME under UNIX **' COMM '*********************************************************'; POOL NAME=DPXAOOL3, XCP2COR=DPX2TDS8, XCP2WKS=TDS8, MAXSESS=10, MIN_WINNER_SOURCE=6, MIN_WINNER_TARGET=1 WINNER_AUTO=6, DRAIN_SOURCE=0 DRAIN_TARGET=0, SESS_XCP2WKS_SECURITY=1, SESS_VERIFIED_ACCEPTED=1, SESS_USERID=OPTIONAL, CONV_XCP2WKS_SECURITY=1, CONV_CHECK=0, CONV_VERIFIED_ACCEPTED=1, CONV_USERID=NONE, SYNC_LEVEL=CONFIRM; Remarque : La sécurité au niveau session est définie pour le pool XCP2 DPXAOOL3. En effet, le nom de XCP2COR qui correspond à celui de la LU locale sous UNIX doit être enregistré dans le catalogue de site GCOS 7. L'administrateur du système GCOS 7 doit faire figurer les informations suivantes dans le catalogue de site : - l'application TDS (MODIFY_PROJECT NAME=projet ADDAPPL=TD08/codes d'autorisation) - la boîte à lettres XCP2 (MODIFY_PROJECT NAME=projet ADDAPPL=X2TDS8/codes d'autorisation) - l'utilisateur DPX2TDS8 (CREATE_USER NAME=projet.DPX2TDS8) Le paramètre MAXTX de la directive XCP2WKS limite le nombre de transactions admises par TDS. Pour spécifier ce paramètre, vous devez tenir compte du nombre de demandes qui peuvent être reçues simultanément de TUXEDO. 47 F2 30UT Rev01 2-7