Bull DPS Télécommunications. TDS-TCP/IP Guide de l'utilisateur. Sujet : Observations :

Transcription

1 Télécommunications Bull DPS 7000 TDS-TCP/IP Guide de l'utilisateur Sujet : Ce guide décrit les fonctions de TDS-TCP/IP et détaille les configurations et commandes nécessaires pour l administration de TDS et le développement d applications client. Observations : Version du logiciel : GCOS 7-V7 (HPS/EXMS) sur TS 7560 GCOS 7-V8 (EXMS) sur TS 8560 GCOS 7-V9 (TA) sur TS Logiciel/Matériel requis : Date : Décembre 1999 Bull S.A. CEDOC Atelier de reprographie 34, rue du Nid de Pie BP ANGERS Cedex 01 FRANCE Bull HN Information Systems Inc. Publication Order Entry FAX: (978) MA30/865A Technology Park Billerica, MA U.S.A. 47 F2 37UT Rev02

2 Copyright Bull S.A., 1998, 1999 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. 47 F2 37UT Rev02

3 Préface TDS-TCP/IP permet à une application installée sur un PC de dialoguer avec une transaction TDS s'exécutant sous GCOS 7 en mode Client/Serveur, via une liaison TCP/IP. L'application installée sur le PC (ou sur un système UNIX) est appelée application client et la transaction s'exécutant sous GCOS 7 application serveur. Objet du manuel Ce document présente les commandes de configuration, les différences par rapport aux commandes maîtresses standard de TDS ainsi qu'un sous-ensemble de fonctions XATMI en langage C destinées au développement d'applications client. Partout où cela est utile, il est fait référence aux informations pertinentes figurant dans le TDS Guide de l'administrateur et autres documents associés. La liste des documents associés avec leurs références figure ci-dessous. Utilisateurs concernés Ce guide est destiné : aux administrateurs et opérateurs concernés par la génération et la supervision de TDS, aux programmeurs chargés de développer des applications client/serveur s'exécutant sur un PC et dialoguant avec une transaction TDS via un réseau TCP/IP. 47 F2 37UT Rev02 iii

4 TDS-TCP/IP Guide de l'utilisateur Structure du manuel Après une présentation générale de TDS-TCP/IP, le présent manuel décrit les commandes nécessaires à son installation et à son utilisation, ainsi que l'api permettant le développement d'applications client. Le contenu du guide se résume ainsi : Chapitre 1 Récapitulation des fonctions de TDS-TCP/IP et des conditions nécessaires. Chapitre 2 Description des nouvelles fonctionnalités du GCOS 7 TS Chapitre 3 Chapitre 4 Chapitre 5 Chapitre 6 Chapitre 7 Description des commandes relatives à l'administration de TDS. Description de l'api à utiliser pour le développement des applications client. Description du traitement des erreurs. Description des transactions TCP/IP utilisant le mode FORMS. Description du protocole utilisé entre SA7 et l application client. Bibliographie Ce guide appartient à la collection de manuels TDS : Concepts TDS...47 F2 26UT TDS Guide de l'administrateur TDS...47 F2 32UT TDS COBOL Guide du Programmeur...47 F2 33UT TDS Langage C Guide du Programmeur...47 F2 07UT TDS Quick Reference Handbook...47 A2 04UT Les publications suivantes contiennent des informations sur des sujets liés à l'exécution d'une application TDS : Pour configurer TDS-TCP/IP : XTI GCOS 7 Name Services User's Guide A2 69UC OPEN 7 Administrator's Reference Manual Vol A2 82UC OPEN 7 Administrator's Reference Manual Vol A2 83UC OPEN 7 Administrator's Reference Manual Vol A2 84UC Normes Distributed Transaction Processing: The XATMI Specification X/Open CAE Specification (November 1995) ISBN: , Document number C506 iv 47 F2 37UT Rev02

5 Préface Pour générer le réseau DPS 7000 : Réseaux - Concepts GCOS F2 92UC Génération de Réseaux F2 93UC Commandes opérateur de la console principale : Réseaux - Guide de l'utilisateur F2 94UC GCOS 7 Manuel d'exploitation...47 F2 53US Valeurs d'état et codes retour : Messages et Codes retour F2 10UJ Conventions d écriture Conventions d écriture pour TP7GEN MAJUSCULES MAJUSCULES item [item] {item item item} indique que l'élément souligné est un mot clé réservé qui doit nécessairement être mentionné si la clause à laquelle il appartient est obligatoire. indique un mot clé réservé devant être écrit comme indiqué. Il peut être omis. un élément en italique désigne un terme pour lequel l'utilisateur fournit une valeur. entrée facultative. une liste d'éléments entre accolades indique qu un seul d entre eux sera sélectionné si le paramètre introduisant la liste est indiqué. Le premier élément de la liste, figurant en gras, indique la valeur par défaut qui sera prise en compte si le paramètre d introduction est omis. Cette liste de paramètres peut également être verticale : {item} {item} {item} item... trois points derrière un élément indiquent que plusieurs éléments de la même forme peuvent apparaître. Clause. trois points verticaux indiquent qu une partie de la. clause a été omise volontairement.. A B C Des clauses encadrées de doubles barres verticales indiquent que chaque clause n apparaît qu une fois. 47 F2 37UT Rev02 v

6 TDS-TCP/IP Guide de l'utilisateur Conventions d'écriture pour les commandes maîtresses Vous pouvez utiliser la syntaxe suivante : si vous être connecté à une boîte aux lettres maîtresse ou si la commande : est stockée dans un sous-fichier pour être exécutée par la commande M EXEC_TDS doit être exécutée via l'interface de traitement par lots doit être exécutée via la technique de génération dynamique. Les noms de commande et les paramètres suivent les mêmes conventions d'écriture. Séparez : le nom de la commande et le premier paramètre par au moins un espace les paramètres entre eux par des espaces ou des virgules. Chaque commande maîtresse est suivie de différents paramètres positionnels et de mots clés. Un paramètre peut être indiqué comme : un mot clé introduisant un argument un paramètre positionnel. Les mots clés peuvent figurer dans un ordre quelconque. Il est possible de mélanger des mots clés et des paramètres positionnels ; dans ce cas, ces derniers sont interprétés comme étant les valeurs des paramètres dont le rang est déterminé par l éventuel mot clé précédent. Les paramètres doivent être des constantes. Utilisez les types de données suivants : caractère décimal booléen nom profil de nom sous convention astérisque fichier. EXEMPLE : M CLOSE_TDS_FILE IFN=T1, DEASSIGN=1 Toutes les fonctions GCL n'étant pas disponibles : n'utilisez pas de variables intégrées ou de variables GCL ne mélangez pas les chaînes de caractères interprétées et non interprétées n'utilisez pas de parenthèses imbriquées. vi 47 F2 37UT Rev02

7 Table des matières 1. Présentation générale 1.1 Caractéristiques de TDS-TCP/IP Caractéristiques générales Définitions et terminologie Transactions TDS existantes API client TDS-TCP/IP Utilisateurs Conditions préalables Matériel Logiciel Facturation produit Configuration Génération de TDS Sockets SOCKG PC Client Sécurité Programmation des API Restrictions Fonctions de programmation des TPR Procédures de gestion de session Règles s'appliquant à la configuration Fonctionnalités ajoutées à GCOS 7 TS Génération dynamique sur un correspondant TCP/IP Correspondant TCP/IP actif Correspondant TCP/IP passif Appel SET-ACTIVE/SET-PASSIVE F2 37UT Rev02 vii

8 TDS-TCP/IP Guide de l'utilisateur 2.3 Temps maximal d inactivité Temps d attente TERMINAL_ID Déconnexions demandées par TDS SECUR'ACCESS Fonctionnalité PASSTHRU Administration du serveur 3.1 Génération de TDS Clause TCP-IP PROTOCOL Clause ATTACH SHARABLE MODULE Erreurs et réponses Configuration de l'environnement GCOS Description Déclarations pour OPEN Déclarations pour GXTI Commandes maîtresses Gestion des correspondants ALLOW_NEW_TDS_COR CANCEL_TDS_COR DISPLAY_TDS LIST_TDS_COR PREVENT_NEW_TDS_COR Gestion des sockets CLOSE_TDS_SOCKET DISPLAY_TDS_SOCKET OPEN_TDS_SOCKET Développement d'applications client 4.1 Configuration de l'environnement PC Description Déclarations de configuration API Client de TDS-TCP/IP Composition de l'api Compilation du programme client Fonctions XATMI en langage C tpalloc tpconnect tpdiscon viii 47 F2 37UT Rev02

9 4.3.4 tpfree tprecv tpsend tperrno tperrdtl Etats client Exemples de programmes client Programme principal de l'application Interface API de TDS Traitement des erreurs 5.1 Intégrité des séquences Cas anormaux de fermeture de socket Restauration non actualisée sur l'unité de consolidation Réinitialisation de TDS Défaillance de TDS Basculement TDS-HA Redémarrage à chaud de GCOS 7 après un crash Programmation des transactions Messages d'erreur client MESSAGES D'ERREUR TDS Trace client Activation de la trace Format de la trace Transactions TCP/IP utilisant FORMS 6.1 Généralités Particularités des verbes SDPI Activation des grilles (CDGET) Envoi de grilles (CDSEND) Réception de grilles (CDRECV) Libération des grilles (CDRELS) Suppression des données d'entrée des grilles (CDPURGE) Sélection des attributs de grille ou de liste (CDATTR ou CDATTL) Identification des grilles (CDFIDI) Fonction de mécanisme des grilles (CDMECH) F2 37UT Rev02 ix

10 TDS-TCP/IP Guide de l'utilisateur 6.3 Restrictions Exemple de flux de données Protocole entre SA7 et l application client Glossaire Index x 47 F2 37UT Rev02

11 Table des illustrations Figures 1-1. Composants de TDS-TCP/IP Dialogue client PC-TDS F2 37UT Rev02 xi

12 TDS-TCP/IP Guide de l'utilisateur xii 47 F2 37UT Rev02

13 1. Présentation générale 1.1 Caractéristiques de TDS-TCP/IP Caractéristiques générales TDS-TCP/IP permet à une application installée sur un PC de dialoguer avec une transaction TDS s'exécutant sous GCOS 7, suivant un modèle Client/Serveur. L'application installée sur le PC est appelée application client et la transaction s'exécutant sous GCOS 7 application serveur. Ce dialogue est constitué de messages échangés via le réseau ; il s'appuie sur un réseau de communication standard TCP/IP, utilisé dans l environnement GCOS 7 TDS. L'accès au réseau TCP/IP s'effectue par l'intermédiaire d'une couche de services réseau appelée interface socket (souvent désignée sous l'abréviation socket). La mise en place de cette couche dans GCOS 7 est assurée par un composant appelé SOCKG 7 (SOCKET pour GCOS 7) alors que, sur le PC, cette interface est incluse dans le système d'exploitation sous le nom de WINSOCKET (WINDOWS socket). Au niveau des applications (client et serveur), le dialogue conversationnel doit respecter les règles Client/Serveur définies par un sous-ensemble du protocole XATMI (X/Open Application to Transaction Manager Interface). 47 F2 37UT Rev02 1-1

14 TDS-TCP/IP Guide de l'utilisateur Sur GCOS 7 (serveur) Une application client peut utiliser des transactions TDS existantes ; ces dernières peuvent être en mode ligne ou en mode grille (c'est-à-dire utilisant le logiciel FORMS). Au niveau de la transaction TDS, l utilisation du protocole XATMI est transparent ; celui-ci est effectué à un niveau inférieur par un nouveau composant GCOS 7 : SOCKG 7 qui convertit les verbes spécifiques TDS (SEND, RECEIVE, etc.) en fonctions correspondantes de l'interface socket. SOCKG 7 accède aux couches de communication inférieures (sockets) via les services OPEN 7 ou GXTI. La génération et l'administration de la liaison TDS-TCP/IP se font par l'intermédiaire de TP7GEN et de commandes maîtresses. Sur le PC (client) L'application client dialogue avec les transactions TDS via une interface API spécifique fournie par Bull et installée sur le PC sous forme d une bibliothèque DLL (Dynamic Link Library) standard. Cette interface API est constituée d'un jeu de primitives en langage C conformes aux normes XATMI ; il est par conséquent possible de développer les applications client avec tout outil RAD (Rapid Application Development) capable de faire appel aux fonctions fournies par l'interface (comme WINDEV, VB5, etc.) Définitions et terminologie Les nouvelles fonctions offertes par TDS-TCP/IP introduisent le concept d'un autre type de transactions, répertoriées sous le terme de transactions TCP/IP pour les distinguer des autres transactions s'exécutant pour des correspondants OSI/DSA (comme TM, XCP1, XCP2, etc.). Une transaction TCP/IP est une transaction TDS présente sur un système DPS 7000 et lancée par un programme client installé sur un PC, lequel dialogue avec la transaction via l'interface socket, comme décrit précédemment. Une transaction TCP/IP est exécutée par un correspondant TCP/IP, sur une session de correspondant TCP/IP. Une transaction TCP/IP dialogue avec une application client située sur un PC via une liaison TCP/IP. D'autres termes et abréviations sont définis dans le glossaire F2 37UT Rev02

15 Présentation générale La figure suivante montre les composants qui interagissent via TDS-TCP/IP : Bull DPS7000 Serveur d Application TPRs TDS Sockg7 GXTI OPEN7 FCP7 Contrôleur ISL RESEAU TCP/IP via FDDI ou ethernet Pile TCP/IP Sockets DLL sur MS-WINDOWS Application client PC Figure 1-1. Composants de TDS-TCP/IP 47 F2 37UT Rev02 1-3

16 TDS-TCP/IP Guide de l'utilisateur Transactions TDS existantes TDS-TCP/IP a un impact sur TDS au niveau de la génération et de l'administration, mais n'affecte pas les routines TPR déjà écrites. Ces dernières peuvent être exécutées par un correspondant TCP/IP en l'état (sans aucune modification) et quel que soit leur mode de présentation (Ligne ou Grille). A l'intérieur du même TDS, il est possible d'exécuter simultanément des transactions OSI/DSA et des transactions TCP/IP. Dans un TDS donné, il est possible d'exécuter simultanément des transactions pour des correspondants TCP/IP et pour des correspondants OSI/DSA. De plus, une même transaction peut être exécutée simultanément pour un correspondant de type terminal et pour un correspondant de type TDS-TCP/IP API client TDS-TCP/IP Bull fournit une API client TDS-TCP/IP permettant de développer des applications client communiquant avec TDS via une liaison TCP/IP. Cette API, construite à partir de l'interface standard XATMI de X/Open, accède aux fonctions PC via la DLL écrite en langage C. Il est de la responsabilité de l utilisateur de s assurer que l'outil qu'il souhaite utiliser pour développer ses applications client (compilateur C et/ou outils RAD) est capable d'utiliser correctement l'api client TDS-TCP/IP fournie par Bull. L'API est constituée du sous-ensemble suivant de fonctions XATMI écrites en langage C : fonctions concernant les services conversationnels : tpconnect, tpdiscon, tprecv et tpsend, fonctions pour la gestion des tampons typés : tpalloc et tpfree. Certaines fonctions complémentaires de gestion des erreurs ont été ajoutées aux fonctions XATMI standard : tperrno et tperrdtl. Les fonctions fournies par cette API sont disponibles dans la bibliothèque DLL du PC. Elles font l'objet d'une description complète dans le chapitre Développement d'applications client F2 37UT Rev02

17 Présentation générale 1.2 Utilisateurs Deux types d'utilisateurs sont directement concernés par les fonctions TDS-TCP/IP : les personnes chargées de la génération de TDS, ainsi que de la configuration et de la supervision du GCOS 7 associé, les développeurs d'applications client s'exécutant sur un PC et utilisant des services TDS. En outre, d'autres types d'utilisateurs interagissent pour permettre le fonctionnement de TDS-TCP/IP : l'administrateur de TDS, responsable de la génération de TDS et du contrôle des applications TDS, l'administrateur GCOS 7, responsable de la génération du réseau, l'administrateur OPEN 7, responsable de l'installation et de la configuration d'open 7 et de SOCKG 7, l'administrateur PC, en charge de l'installation des produits et de la configuration du système, l'administrateur des réseaux et télécommunications, responsable des déclarations d'adresses et de la coordination pour tous les types de machines, dans la mesure où TDS-TCP/IP utilise des matériels hétérogènes. 47 F2 37UT Rev02 1-5

18 TDS-TCP/IP Guide de l'utilisateur 1.3 Conditions préalables Matériel Serveur DPS 7000 Tout système DPS 7000 prenant en charge : Les versions GCOS 7 V7 (HPS/EXMS), Les versions GCOS 7 V8 (EXMS), et doté d'un contrôleur FCP7 ou ISL permettant la connexion à un réseau TCP/IP via les technologies FDDI ou Ethernet. PC Client Tout PC doté d une carte de communication permettant la connexion à un réseau TCP/IP et capable d'exécuter les logiciels énumérés ci-après Logiciel GCOS 7 Le composant GCOS 7 de TDS-TCP/IP est intégré dans TDS et disponible avec : Les versions GCOS 7-V7 (HPS/EXMS) à partir de TS 7560, ou Les versions GCOS 7-V8 (EXMS) à partir de TS SOCKG 7 TDS-TCP/IP utilise les sockets SOCKG 7 de GCOS 7. SOCKG 7 offre une interface socket standard acceptant deux méthodes de communication : la première est fournie par les services OPEN 7 disponibles à partir de OPEN 7 V4, la seconde est fournie par les services GXTI, disponibles avec les versions de GCOS 7 indiquées ci-dessus. SOCKG 7 et OPEN 7 V4 peuvent être installés avec la fonction INTEROP 7 version minimum de bande ISI 7 = I423C F2 37UT Rev02

19 Présentation générale Logiciel PC Les systèmes d'exploitation PC autorisant le développement et l'exécution d'applications client sont Windows 95 et Windows NT. La bibliothèque DLL requise par l'api client TDS-TCP/IP est livrée séparément sur un support spécifique (disquettes 3,5 pouces). La DLL existe en version 32 bits pour Windows 95 ou Windows NT. Trois fichiers sont fournis : atmi.ini : contient les options de la DLL pour les fonctions de trace et de délai d'exploitation. atmi.lib : contient les définitions XATMI standard (ce fichier est obligatoire pour le développement de l'application client, mais pas pour son exécution). atmi.dll : contient la bibliothèque DLL proprement dite. Ces trois fichiers doivent être placés dans le répertoire système de Windows (habituellement C:\WINDOWS) Facturation produit Les produits/fonctions suivants sont payants et sont protégés par des codes marketing (MI) spécifiques : Fonctions GCOS 7 HPS GCOS 7 EXMS Fonctions TDS TCP/IP TPDDnnn-y00 TPDDnnn-y00 OPEN 7 SCC3636-T00 TCP/IP 7 SCC3637-Tx0 CNSD024-y00 GCOS 7 XTI SCC3649-Tx0 CNHD014-y00 47 F2 37UT Rev02 1-7

20 TDS-TCP/IP Guide de l'utilisateur 1.4 Configuration Génération de TDS Pour permettre au TDS de communiquer via TCP/IP, la TDS SECTION du fichier STDS doit être adaptée lors de la génération de TDS. STDS constitue le fichier d'entrée du processus de génération ; il décrit les caractéristiques du TDS-TCP/IP résultant, qui est une application transactionnelle. La génération de TDS comprend deux points importants : La déclaration du protocole TCP/IP, La sélection de la liaison SOCKG 7 (OPEN 7 ou GXTI) Sockets SOCKG 7 Le choix du socket est déterminant car, suivant la liaison SOCKG 7 à établir, deux ensembles différents de fichiers peuvent être utilisés pour la configuration. La configuration de SOCKG 7 comporte deux points importants : la déclaration du service TCP/IP, la fourniture d'informations détaillées sur l'hôte et le client. Le chapitre Administration du serveur décrit la génération de TDS et la configuration de SOCKG PC Client La configuration des PC comporte deux points importants : la déclaration du service TCP/IP, la fourniture d'informations détaillées sur l'hôte et le client F2 37UT Rev02

21 Présentation générale 1.5 Sécurité Pour chaque connexion TDS-TCP/IP, l'application client doit fournir : un identificateur utilisateur, un mot de passe, un projet, un compte. Ces données sont ensuite vérifiées par rapport aux informations contenues dans le catalogue GCOS 7. Avant GCOS 7 TS 9764, un TDS exécutant des transactions TCP/IP ne peut pas être contrôlé par SA 7 (Secur Access). GCOS 7 TS 9764 permet le contrôle par Secur'Access. La fonction Access Master n est pas supportée. 1.6 Programmation des API L'API client permet à l'application client de dialoguer avec les transactions TDS. La gestion des tampons est assurée par deux fonctions locales aux applications client : tpalloc : alloue les tampons typés, tpfree : libère les tampons typés. L'interface entre l'application client et TDS inclut six fonctions appelées par le client : tpconnect : connecte le client TCP/IP à TDS, tprecv : reçoit les messages de TDS, tpsend : envoie des messages à TDS, tpdiscon : déconnecte le client de TDS en mode forcé, tperrno et tperrdtl pour la gestion des erreurs (extension du protocole XATMI). La programmation des API est expliquée en détail dans le chapitre Développement d'applications client. 47 F2 37UT Rev02 1-9

22 TDS-TCP/IP Guide de l'utilisateur 1.7 Restrictions Bien que la plupart des services TDS puissent être utilisés par les transactions TDS-TCP/IP, des restrictions s'appliquent à : certaines fonctions de programmation des TPR, certaines procédures de gestion de session, la fonction de terminal BREAK n'est pas supportée, les messages de service, les verbes SEND comportant des adresses de routage et les commandes M SNDTU ; aucun de ces messages n'est envoyé à des correspondants TCP/IP. Il n y a pas d en-tête ni de fin dans la présentation d un message. La fonction pass-thru ne peut pas être utilisée. A partir de GCOS 7 TS 9764, la fonction passthru est autorisée. Pour plus de détails, consultez la section de ce document relative aux Fonctionnalités ajoutées à GCOS 7 TS Fonctions de programmation des TPR Les TPR existantes peuvent être exécutées en l'état, sans aucune modification. Pour développer de nouvelles TPR, il est possible d'utiliser la même méthode que précédemment (avant l'arrivée de l'interface TDS-TCP/IP), mais en tenant compte des restrictions suivantes : La génération dynamique vers un correspondant TCP est interdite. Un code d'erreur - type de correspondant erroné - est retourné si un CALL DSPAWN/SPAWN/SPAWNTX/TSPAWN est tenté sur un correspondant TCP/IP. A partir de GCOS 7 TS 9764, la génération dynamique (SPAWNING) sur un correspondant TCP/IP est autorisée à l aide d un CALL DSPAWN/SPAWN/SPAWNTX/TSPAWN. Le comportement de cette génération, en fonction du type de correspondant, est décrit dans la section de ce document relative aux Fonctionnalités ajoutées à GCOS 7 TS F2 37UT Rev02

23 Présentation générale Procédures de gestion de session Les procédures de gestion de session suivantes ne peuvent pas être utilisées : RECONNECT-OPTION. Un code d'erreur - type de session erroné - est retourné pour un correspondant TCP/IP. SET-ACTIVE. La fonction est ignorée pour un correspondant TCP/IP. SET-PASSIVE. La fonction est ignorée pour un correspondant TCP/IP. A partir de GCOS 7 TS 9764, les fonctions CALL SET-ACTIVE/SET-PASSIVE associées à un correspondant TCP/IP sont autorisées. Pour plus de détails, consultez la section de ce document relative aux Fonctionnalités ajoutées à GCOS 7 TS Règles s'appliquant à la configuration TDS supporte 4000 sessions au maximum (OSI/DSA et TCP/IP). Le nombre maximum de clients TCP/IP pouvant être connectés à un système GCOS 7 est de : 1500 avec OPEN 7, 4000 avec GXTI. 47 F2 37UT Rev

24 TDS-TCP/IP Guide de l'utilisateur F2 37UT Rev02

25 2. Fonctionnalités ajoutées à GCOS 7 TS Génération dynamique sur un correspondant TCP/IP L appel SPAWN/DSPAWN/TSPAWN/SPAWNTX vers un correspondant TCP/IP est autorisé. Si le correspondant est dans l état gelé, un état 3 (ou un type incorrect 17 sur SPAWNTX) est renvoyé. La reconnexion d un correspondant TCP/IP dans l état gelé à l aide de la commande maîtresse TDS, ALNTC, est sans effet ; le correspondant doit être reconnecté pour pouvoir accepter une nouvelle génération dynamique Correspondant TCP/IP actif Une transaction générée de façon dynamique ne peut être lancée sur ce type de correspondant qu après la fin d une transaction en cours d exécution. Si une transaction en cours d exécution, associée à un correspondant actif, effectue un appel SPAWN sur elle-même, la génération dynamique sera automatiquement démarrée à la fin de l exécution de la transaction. Une transaction générée dynamiquement à partir d un autre correspondant (TCP/IP ou un autre type) peut être démarrée sur le correspondant TCP/IP actif à la fin d une transaction en cours d exécution. Si aucune transaction n est en cours d exécution, la prochaine transaction démarrée par tpsend () sera exécutée, après quoi la transaction générée dynamiquement sera lancée. 47 F2 37UT Rev02 2-1

26 TDS-TCP/IP Guide de l'utilisateur Correspondant TCP/IP passif Lorsqu une transaction générée dynamiquement est lancée par TDS pour ce type de correspondant, le client reçoit le message envoyé par cette dernière via la fonction tprecv (). Le client n est pas autorisé à démarrer une transaction à l aide de tpsend () car le correspondant est de type passif. Le client utilisant la fonction tprecv () peut toutefois recevoir un message envoyé par une transaction générée dynamiquement. La fonction tprecv est synchrone : le traitement d exécution de la fonction est donc bloqué jusqu à la réception des données provenant du serveur ou l expiration du délai indiqué dans le fichier Atmi.ini. Pendant ce laps de temps, l exécution du programme est arrêtée et les actions ultérieures générées dans le programme sont différées. 2.2 Appel SET-ACTIVE/SET-PASSIVE Ces fonctions TDS sont autorisées. Notez que le comportement de génération dynamique est différent selon qu il s agit d un correspondant TCP/IP actif ou passif (cf. ci-dessus la section relative à la génération dynamique sur un corespondant TCP/IP). Un correspondant TCP/IP est toujours connecté ou reconnecté en mode ACTIF. 2.3 Temps maximal d inactivité A partir de GCOS 7 TS 9764, le dépassement du temps maximal d inactivité appliqué à un correspondant TCP/IP provoque une déconnexion anormale (si elle existe, la transaction de déconnexion est lancée). 2.4 Temps d attente Le temps d attente (WAIT-TIME) pour un correspondant TCP/IP ne permet pas l exécution automatique de la TPR suivante lorsque la TPR en cours se termine par SEND EGI. Dans ce cas, l exécution de la TPR suivante est lancée par le message de réponse du client au signal SEND EGI (tpsend ()). Si la TPR ne se termine pas par SEND ou se termine par SEND EMI, le temps indiqué dans WAIT-TIME est normalement pris en compte F2 37UT Rev02

27 Fonctionnalités ajoutées à GCOS 7 TS TERMINAL_ID A partir de GCOS 7 TS 9764, et de la version de la DLL, une identification de terminal peut être indiquée sur la fonction tpconnect, dans la zone termid, du paramètre de données. Si cette zone est renseignée par une valeur non constituée d espaces, elle est placée dans la zone TERMINAL_ID de la TRANSACTION- STORAGE de la transaction LOGON. Si la zone d identification de terminal est nulle ou non spécifiée, ou si la version de la DLL est 3.0.5, la zone TERMINAL_ID de TRANSACTION-STORAGE de la transaction LOGON est initialisée par TDS avec la valeur spécifique H-TCPIP-CLI. 2.6 Déconnexions demandées par TDS Depuis GCOS 7 TS 9764, le dépassement du temps maximal d inactivité de la génération TDS appliquée à un correspondant TCP/IP entraîne une déconnexion anormale à l'initiative de TDS. TDS effectue une déconnexion anormale du correspondant si aucun message n est reçu du client pendant un laps de temps de 2 minutes après que TDS a demandé le droit d émission (l action ayant besoin d un droit d émission pour être lancée). 2.7 SECUR'ACCESS Une application TDS TCP/IP peut être protégée par Secur'Access. Un correspondant TCP/IP connecté à un TDS, contrôlé par Secur'Access, exécute les transactions Secur'Access et les dialogues doivent être effectués en fonction du format de leurs messages. Pour plus de détails, consultez la section Protocole entre SA7 et l application client de ce document. La fonctionnalité Access Master n est pas supportée. 47 F2 37UT Rev02 2-3

28 TDS-TCP/IP Guide de l'utilisateur 2.8 Fonctionnalité PASSTHRU Depuis GCOS 7 TS 9764, la fonctionnalité Passthru peut être activée à partir d un correspondant TCP/IP. La connexion demandée à une application TDS ou IOF est effectuée en mode DSA, en utilisant un terminal DKU7105 (et un type correspondant TM pour l application TDS cible). Si l application cible est TDS, les messages sont reçus sans en-tête ni fin de message, en mode ligne. Lorsque le mode grille (FORMS) est activé dans une transaction, les messages sont reçus au format FORMS TDS-TCP/IP. Si l application cible est IOF, seul le mode ligne peut être utilisé car le format FORMS TDS-TCP/IP FORMS est uniquement utilisé pour TDS. Les messages envoyés par IOF en mode ligne contiennent des caractères de présentation corrrespondant au modèle DKU7105, comme l identification de terminal et la position du curseur F2 37UT Rev02

29 3. Administration du serveur L'administration du serveur TDS-TCP/IP comporte les tâches suivantes : Administration de TDS en ce qui concerne la génération de TDS et le contrôle de la session TDS via les commandes maîtresses (TDS-TCP/IP n'a pas d'impact sur la préparation de TDS). Administration de GCOS 7 pour la configuration des services TDS-TCP/IP. 3.1 Génération de TDS L'utilisation de la liaison TCP/IP doit être déclarée lors de la génération de TDS. Pour générer TDS : Modifier le membre STDS de façon à inclure : la clause TCP-IP PROTOCOL (voir ci-dessous), la clause ATTACH SHARABLE MODULE (voir ci-dessous). Générer TDS en utilisant TP7GEN (consulter le TDS Guide de l'administrateur pour plus de détails) Clause TCP-IP PROTOCOL Syntaxe [TCP-IP PROTOCOL [USED] [WITH {OPEN7 GXTI }].] Cette clause définit l'utilisation du protocole TCP/IP et permet de choisir la liaison à utiliser : OPEN 7 ou GXTI. OPEN7 est la valeur par défaut. La clause TCP-IP PROTOCOL se trouve juste avant la première clause USE (éventuelle) et après la clause XA-RESYNC-DELAY, dans la TDS SECTION du STDS. 47 F2 37UT Rev02 3-1

30 TDS-TCP/IP Guide de l'utilisateur Clause ATTACH SHARABLE MODULE Syntaxe [ATTACH SHARABLE MODULE H_SM_DCM.] Cette clause (déjà existante) doit également être déclarée pour associer SOCKG 7. La clause ATTACH SHARABLE MODULE se trouve juste après la clause RESERVE AREAS de la TDS SECTION du membre STDS. Consulter le Guide de l'administrateur TDS pour plus de détails Erreurs et réponses Le message d'erreur suivant de TP7GEN peut s'afficher : TG28 sev WRONG SYNTAX IN CLAUSE OR STATEMENT: clause. où clause représente : TCP-IP PROTOCOL Type : Signification : Action : Information : sev=2 Indique la clause ou l'instruction dans laquelle une erreur de syntaxe a été détectée. Corrigez la syntaxe de la clause ou de l'instruction et relancez TP7GEN F2 37UT Rev02

31 Administration du serveur 3.2 Configuration de l'environnement GCOS 7 TDS-TCP/IP, comme les autres services Internet, doit être déclaré au niveau de GCOS 7. Il existe deux possibilités de configuration, OPEN 7 ou GTXI, suivant la liaison utilisée par le socket Description Deux types d'informations doivent être déclarés dans les fichiers de configuration, /etc/hosts (pour OPEN 7) ou ETC_HOSTS (pour GXTI) : les adresses IP des hôtes client, les noms des services Déclarations pour OPEN 7 Mettre à jour le fichier /etc/hosts en indiquant l'adresse IP du nom de l'hôte, qui est le nom symbolique utilisé pour accéder au système DPS Consulter l OPEN 7 Administrator's Reference Manual. Mettre à jour le fichier /etc/services du sous-système OPEN 7 en indiquant le nom des services, leur numéro de port associé et le protocole utilisé (c'est-à-dire TCP). Consulter l OPEN 7 Administrator's Reference Manual. Le nom du service TDS-TCP/IP est la concaténation du nom d'hôte et du nom du TDS. Un numéro de port est associé à chaque service. Il doit être identique à celui déclaré sur le PC pour le même service et ne doit pas être en conflit avec les numéros de port d'autres services. Le numéro de port doit avoir une valeur supérieure à EXEMPLE: Si une application client veut se connecter au TDS TDS1 du système DPS 7000 désigné par le nom d'hôte BC0F, la ligne suivante devra apparaître dans /etc/services: bc0ftds /tcp 47 F2 37UT Rev02 3-3

32 TDS-TCP/IP Guide de l'utilisateur Déclarations pour GXTI Le sous-fichier ETC_HOSTS de la bibliothèque GCOS 7 SYS.DSACONF doit contenir les mêmes informations que le fichier /etc/hosts présent dans le sous-système OPEN 7. Consulter le XTI GCOS 7 Name Services User's Guide. Pour être conforme aux conventions d'écriture de GXTI, le nom de l'hôte est DPS7000_nom-xti en minuscules. EXEMPLE : bc0f-xti Le sous-fichier ETC_SERVICES de la bibliothèque GCOS 7 SYS.DSACONF doit contenir les mêmes informations que le fichier /etc/services du sous-système OPEN 7. Consulter le XTI GCOS 7 Name Services User's Guide. Vérifier que le service standard : echo est également déclaré dans ETC_SERVICES. EXEMPLE : Si une application client veut se connecter au TDS TDS1 du système DPS 7000 désigné par le nom d'hôte bc0f-xti, les lignes suivantes doivent apparaître dans ETC_SERVICES: echo 7/tcp bc0f-xtitds /tcp F2 37UT Rev02

33 Administration du serveur 3.3 Commandes maîtresses Gestion des correspondants Les applications client exécutant des transactions TDS via TCP/IP sont des correspondants TCP/IP. Les commandes maîtresses suivantes s'appliquent à ce type de correspondants : ALLOW_NEW_TDS_COR (permet la connexion de nouveaux correspondants TCP/IP). CANCEL_TDS_COR (annule un correspondant ou tous les correspondants TCP/IP). DISPLAY_TDS (affiche des informations sur le nombre courant de sessions TCP/IP actives). LIST_TDS_COR (fournit une liste d'informations sur l'état des correspondants ainsi que le nombre de transactions et de TPR en cours d'exécution). PREVENT_NEW_TDS_COR (empêche la connexion de nouveaux correspondants TCP/IP). REMARQUE : Un correspondant TCP/IP ne peut pas être un opérateur maître. 47 F2 37UT Rev02 3-5

34 TDS-TCP/IP Guide de l'utilisateur ALLOW_NEW_TDS_COR Signification Annule une commande [M] PREVENT_NEW_TDS_COR précédente et reconnecte tous les correspondants TM, XCP1, XCP2 et TCP/IP passifs. Selon les paramètres indiqués, cette commande : autorise la connexion de nouveaux correspondants TM ou TCP/IP à une application TDS, établit de nouveaux pools de sessions XCP1 et XCP2, augmente le nombre de sessions allouées pour les pools déjà ouverts. Syntaxe [ M ] { ALLOW_NEW_TDS_COR ALNTC } [ { TMC TM_COR } = bool } ] [ { X1C XCP1_COR } = bool } ] [ { X2C XCP2_COR } = bool } ] [ TDS = { nom4 #WTDS } ] [ { TCPIPC TCPIP_COR } = bool } ] Paramètres TCPIP_COR Correspondants TCP/IP. Consulter le TDS Guide de l'administrateur pour les autres paramètres. Contraintes Ne spécifier aucun paramètre _COR revient à indiquer tous les correspondants, quel que soit leur type. Sortie Consulter le TDS Guide de l'administrateur. Exemple [M] ALNTC TCPIPC; Autorise tous les correspondants TCP/IP à se connecter au TDS F2 37UT Rev02

35 Administration du serveur CANCEL_TDS_COR Signification Force la déconnexion des correspondants indiqués même si l'utilisateur est "gelé". Syntaxe [ M ] { CANCEL_TDS_COR CTC } { COR USER } = star12 [ STRONG = { 0 bool } ] [ FROZEN = { 0 bool } ] [ TDS = { nom4 #WTDS } ] Paramètres STRONG Oblige le correspondant à se déconnecter immédiatement ou autorise les transactions actives à se terminer. L'impact de STRONG=1 dépend du type de correspondant : Pour les correspondants TCP/IP, si une transaction est en cours, la TPR en cours d'exécution est abandonnée, la routine ON-ABORT-TPR est exécutée, et la transaction se termine. L'application client distante est avertie de la déconnexion par l'état indiqué dans le verbe API suivant. Consulter le TDS Guide de l'administrateur pour les autres paramètres. Contraintes Aucune. Sortie Consulter le TDS Guide de l'administrateur. Exemple [M] CTC COR=LAUTIER TDS=PL ; 47 F2 37UT Rev02 3-7

36 TDS-TCP/IP Guide de l'utilisateur DISPLAY_TDS Signification Affiche des informations sur la session TDS en cours, suivant les paramètres indiqués. D'autres informations sont affichées lorsque les paramètres SIMUL et/ou STATUS sont indiqués. Syntaxe [ M ] { DISPLAY_TDS DTDS } [ { STATUS STAT } = bool ] [ SIMUL = { 0 bool } ] [ SMLIB = { 0 bool } ] [ SWAP = { 0 bool } ] [ TDS = { nom4 #WTDS } ] [ { RPC_STAT RPC_STATUS } = bool ] Paramètres Consulter le TDS Guide de l'administrateur. Contraintes Consulter le TDS Guide de l'administrateur. Sortie Le nombre actuel de sessions TCP/IP s'affiche dans les statistiques générales si le TDS est TCP/IP. Consulter le TDS Guide de l'administrateur pour une description complète F2 37UT Rev02

37 Administration du serveur Exemple Afficher les statistiques générales d'une application nommée PL : S: DTDS STATUS TDS = PL 11:45:51 NOV 14, GENERAL TDS STATISTICS INIT.SIMU.COUNT = 5 CUR.SIMU.COUNT = 4 ACC.SESS.ALLOC = 0 ACC.SESS.REJEC = 0 USED TX COUNT = 16 TX ABORT. COUNT = 0 USED TPR COUNT = 27 TPR ABORT COUNT = 0 COMMIT COUNT = 16 DIALOG COUNT = 10 TPR ELAPSED TIME = 3 TPR CPU TIME = 0 DEADLOCK COUNT = 0 NON CONCUR WAIT = 0 TABOV ABT COUNT = 0 WDNAV ABT COUNT = 0 LGWAITABT COUNT = 0 DIRTY READ ABORT = 0 BUFOVABT COUNT = 0 SERIALIZATION = 0 MAX TM SES = 10 CUR TM SES = 0 MAX XCP1 SES = 5 CUR XCP1 SES = 0 MAX XCP2 SES = 50 CUR XCP2 SES = 0 MAX VIRT SES = 3 CUR VIRT SES = 1 PMOS COR COUNT = 1 MAX IDLE TIME = 2000 POOL USED (KB) = 160 POOL SIZE (KB) = 500 PSEUDO BUFFERS = 0 WAITING TPR MEAN = 0 MAX CPU TIME = 9000 CUR TCP SES = 2 TDS: PL, DTDS COMMAND COMPLETED 47 F2 37UT Rev02 3-9

38 TDS-TCP/IP Guide de l'utilisateur LIST_TDS_COR Signification Affiche des informations sur tous les correspondants ou sur des correspondants spécifiés. Syntaxe [ M ] { LIST_TDS_COR LSTC } { COR USER } = star12 [ TYPE = { * TM XCP1 XCP2 DUMMY TCPIP } ] [ { NG NETGEN } = { 0 bool } ] [ { LOG LOGGED } = bool ] [ { DTLD DETAILED } = { 0 bool } ] [ SORT = { 0 bool } ] [ { PRTMB PRINT_MEMBER } = nom31 ] [ TDS = { nom4 #WTDS } ] Paramètres Consulter le TDS Guide de l'administrateur. Contraintes NETGEN=1 et LOGGED s'excluent mutuellement. Sortie La commande traite le nouveau cortype TCP/IP. Consulter le TDS Guide de l'administrateur pour une description complète F2 37UT Rev02

39 Administration du serveur Exemple Pour obtenir la liste de tous les correspondants connus de TDS, dans le cas d'un TDS TCP/IP : S: LSTC * * TDS = PL 10:38:40 NOV 14, LIST OF CORRESPONDENTS STATE: UNSPEC / TYPE: TM / LIST: SHORT / OPTION: DYNAMIC LEVENEZ-P H PMS STATE: UNSPEC / TYPE: DUMMY / LIST: SHORT / OPTION: DYNAMIC DUMMY STATE: LOGGED / TYPE: TCPIP / LIST: SHORT / OPTION: DYNAMIC LAUTIER TDS: PL, LSTC COMMAND COMPLETED Pour obtenir la liste détaillée de tous les correspondants TCP/IP : S: LSTC * TCPIP DTLD TDS = PL 10:49:12 NOV 14, LIST OF CORRESPONDENTS STATE: LOGGED /TYPE: TCPIP /LIST: DETAILED /OPTION: DYNAMIC CORRESPONDENT ADDRESS TX_COUNT TPR_COUNT STATUS TX_NM LAUTIER 3 8 P ESSAI TDS: PL, LSTC COMMAND COMPLETED 47 F2 37UT Rev

40 TDS-TCP/IP Guide de l'utilisateur PREVENT_NEW_TDS_COR Signification Empêche les nouveaux correspondants, y compris les correspondants TCP/IP, de se connecter à une application TDS. Empêche l'allocation de nouvelles sessions XCP1 et XCP2 par [M] MODIFY_COR_POOL, [M] OPEN_COR_POOL ou par des instructions CALL correspondantes décrites dans le document TDS COBOL Guide du Programmeur. Il est possible d allouer de nouvelles conversations aux correspondants XCP2 en utilisant les pools déjà ouverts. Lorsque tous les correspondants en cours se déconnectent normalement, TDS reste inactif jusqu'à émission d'une commande [M] ALLOW_NEW_TDS_COR ou [M] TERMINATE_TDS. Syntaxe [ M ] { PREVENT_NEW_TDS_COR PVNTC } [ { TMC TM_COR } = bool } ] [ { X1C XCP1_COR } = bool } ] [ { X2C XCP2_COR } = bool } ] [ TDS = { nom4 #WTDS } ] [ { TCPIPC TCPIP_COR } = bool } ] Paramètres TCPIP_COR Correspondants TCP/IP. Consulter le TDS Guide de l'administrateur pour les autres paramètres. Contraintes Aucune. Sortie Consulter le TDS Guide de l'administrateur. Exemple [M] PVNTC TCPIPC TDS=PL; Empêche les correspondants TCP/IP de se connecter à l'application TDS nommée PL F2 37UT Rev02

41 Administration du serveur Gestion des sockets Trois nouvelles commandes maîtresses permettent de gérer la fermeture, l'affichage et l'ouverture du socket TDS : CLOSE_TDS_SOCKET DISPLAY_TDS_SOCKET OPEN_TDS_SOCKET Au démarrage de TDS, la socket TDS est ouverte automatiquement. Les correspondants TCP/IP peuvent se connecter à l'application dès que le TDS est prêt. Les commandes CLOSE_TDS_SOCKET et OPEN_TDS_SOCKET permettent de réinitialiser dynamiquement la liaison sans arrêter l'application TDS. La commande OPEN_TDS_SOCKET est prévue pour être utilisée suite à un arrêt de SOCKG 7 ou un incident réseau. 47 F2 37UT Rev

42 TDS-TCP/IP Guide de l'utilisateur CLOSE_TDS_SOCKET Signification Ferme la socket TDS. Cette commande déconnecte tous les correspondants TCP/IP et ferme le socket. La commande CLOSE_TDS_SOCKET n'est pas rémanente en cas de redémarrage à chaud de TDS. Syntaxe [ M ] { CLOSE_TDS_SOCKET CLTS} [ STRONG = { bool 0 } ] [ TDS = { nom4 #WTDS } ] Paramètres STRONG Si STRONG = 1, les correspondants TCP/IP sont déconnectés même s'ils sont en train d'exécuter une transaction. Dans ce cas, la TPR en cours est abandonnée. Si STRONG = 0 (valeur par défaut), la fermeture du socket TDS interviendra lorsque le dernier correspondant TCP/IP aura terminé sa transaction en cours. Contraintes Aucune. Sortie Lorsque la commande a abouti, le message TX92 apparaît sur la console principale : TDS SOCKET CLOSED. Exemple S: CLTS STRONG=1 TDS=PL TX54 TDS: PL, CLTS COMMAND COMPLETED --> TX92 TDS SOCKET CLOSED Si la commande ne peut être exécutée, le message TX55 s'affiche : TX55 TDS: PL, CLTS COMMAND NOT PERFORMED rc F2 37UT Rev02

43 Administration du serveur DISPLAY_TDS_SOCKET Signification Affiche le paramètre TCP/IP d'une session TDS, c'est-à-dire la configuration du socket, OPEN7 ou GXTI. Syntaxe [ M ] { DISPLAY_TDS_SOCKET DTDSS } [ { STATUS STAT } = bool ] [ TDS = { nom4 #WTDS } ] Paramètres STATUS Affiche l'état de l'interface socket. Contraintes Aucune. Sortie La commande renvoie la valeur courante de l'interface socket configurée. Exemple S: DTDSS TDS=PL TDS = PL 17:17:52 AUG 08, CURRENT TCP/IP PARAMETERS SOCKET_INTERFACE IS: OPEN7 TDS: PL, DTDSS COMMAND COMPLETED Si la commande ne peut être exécutée, le message TX55 s'affiche : TX55 TDS: PL, DTDSS COMMAND NOT PERFORMED rc. 47 F2 37UT Rev

44 TDS-TCP/IP Guide de l'utilisateur OPEN_TDS_SOCKET Signification Ouvre la socket TDS. Cette commande procède à la réouverture de la socket TDS après émission d'une commande CLOSE_TDS_SOCKET. Syntaxe [ M ] { OPEN_TDS_SOCKET OTS } [ UPON = { OPEN7 GXTI } ] [ TDS = { nom4 #WTDS } ] Paramètres UPON Indique l'option choisie pour la liaison : OPEN7 ou GXTI. Cette option doit correspondre à celle définie dans la clause de génération TDS-TCP/IP PROTOCOL. La valeur par défaut est GXTI. Contraintes Aucune. Sortie Lorsque la commande a abouti, le message TX92 apparaît sur la console principale : TDS SOCKET OPENED. Exemple S: OTS UPON=OPEN7 TDS=PL TX54 TDS: PL, OTS COMMAND COMPLETED --> TX92 TDS SOCKET OPENED Si la commande ne peut être exécutée, le message TX55 s'affiche : TX55 TDS: PL, OTS COMMAND NOT PERFORMED rc F2 37UT Rev02

45 4. Développement d'applications client Le développement d'applications client sur PC concerne : la configuration de la machine client, c'est-à-dire le PC, les appels aux fonctions XATMI en langage C effectués par l'api de TDS-TCP/IP pour accéder à une ou plusieurs applications TDS depuis une application PC. 4.1 Configuration de l'environnement PC Description Les PC client doivent être configurés pour chaque application TDS. Deux fichiers contiennent les informations concernées : Les adresses de mise en correspondance d hôtes distants sont contenues dans le fichier HOSTS qui se trouve dans le répertoire d'installation de Windows, la déclaration de services est contenue dans le fichier SERVICES qui se trouve dans le répertoire d'installation de Windows Déclarations de configuration Le fichier HOSTS doit être mis à jour en indiquant l'adresse IP des noms d'hôte exécutant les applications TDS ; le nom d'hôte est le nom symbolique utilisé dans l'application client pour accéder au système DPS 7000 (correspondant au paramètre hostid du verbe tpconnect). EXEMPLE : bc0f #nom d'hôte du DPS 7000 sur lequel s'exécute le TDS tds1 47 F2 37UT Rev02 4-1

46 TDS-TCP/IP Guide de l'utilisateur Le fichier SERVICES doit être mis à jour en indiquant le nom des services nécessaires, le numéro de port associé à chaque service et le protocole utilisé. Le nom du service est la concaténation du nom d'hôte et du nom TDS. Le numéro de port doit être identique à celui déclaré sur le serveur GCOS 7. EXEMPLE: Si une application client veut se connecter au TDS tds1 du système DPS 7000 désigné par le nom d'hôte bc0f, la ligne suivante devra apparaître dans le fichier SERVICES : bc0ftds /tcp REMARQUE : Le numéro de port doit avoir une valeur supérieure à F2 37UT Rev02

47 Développement d'applications client 4.2 API Client de TDS-TCP/IP Un utilisateur PC connecté à TDS via TCP/IP accède à une application TDS de la même manière qu'un utilisateur de terminal connecté via DSA. Notamment, la gestion du droit d émission est assurée. L'API client de TDS-TCP/IP fournie pour le développement d'applications client offre un service conversationnel. Elle utilise des fonctions XATMI adaptées aux exigences de GCOS 7 en matière de connexion, de dialogue transactionnel avec droit d émission, d'évènements anormaux et de déconnexion. La transaction LOGON est activée à chaque fois qu'un client TCP/IP se connecte à TDS. Dans la zone TRANSACTION-STORAGE de la transaction LOGON, TDS initialise le champ TERMINAL-ID à la valeur spécifique H-TCPIP-CLI. A partir de GCOS 7 TS 9764 et de la DLL, version 3.0.6, la fonction tpconnect prend en charge une zone termid avec 13 caractères dans le paramètre data. Si une valeur non constituée d espaces est attribuée à cette zone, cette dernière est placée dans la zone TERMINAL-ID de la TRANSACTION-STORAGE pour la transaction LOGON. Si la valeur attribuée à termid comporte des espaces, est nulle ou inutilisée, ou si la version de la DLL est antérieure à 3.0.6, la zone TERMINAL-ID de la TRANSACTION-STORAGE pour la transaction LOGON est initialisée par TDS à la valeur spécifique H-TCPIP-CLI. Le lancement des transactions est assuré par la fonction tpsend. Les fonctions tpsend et tprecv de l'application client correspondent aux verbes RECEIVE et SEND des TPR et aux messages envoyés et reçus par le moniteur TDS. Avant GCOS 7 TS 9764 et en l'absence de verbe SEND à la fin d'une transaction, une fonction finale tprecv est émise pour récupérer le droit d émission. Un message de longueur nulle est envoyé. Depuis la version GCOS 7 TS 9764, en l absence de verbe SEND à la fin d une transaction, une fonction finale tprecv reçoit le message READY de TDS (ou le message de service correspondant, défini lors de la génération TDS). Si une transaction se termine anormalement, le message envoyé par la routine ON-ABORT-TPR est récupéré par le verbe tprecv suivant. Si certains paramètres de tpsend sont incorrects du point de vue du dialogue TDS-TCP/IP, un code d'erreur est renvoyé sur le verbe tprecv suivant. 47 F2 37UT Rev02 4-3

48 TDS-TCP/IP Guide de l'utilisateur Composition de l'api L'API client de TDS-TCP/IP se compose d un sous-ensemble de fonctions XATMI en langage C : quatre fonctions pour les services conversationnels : tpconnect, tpdiscon, tprecv et tpsend deux fonctions pour la gestion des tampons typés : tpalloc et tpfree deux fonctions de gestion des erreurs : tperrno et tperrdtl ; ces fonctions constituent des extensions de XATMI. C'est toujours l'application client qui initie la connexion à TDS, mais la déconnexion peut être effectuée par le client (PC) ou par le serveur (DPS 7000) Compilation du programme client Pour un client écrit en langage C, un fichier atmi.h contenant la description des structures de connexion suivantes est fourni : service_id et sous-type, les prototypes de fonctions externes et les codes d erreur. Le fichier atmi.h doit être placé dans le répertoire de travail client. Dans le code source utilisant les fonctions API, l instruction suivante doit être indiquée : #include <atmi.h> F2 37UT Rev02