MQSeries. Clients GC

Transcription

1 MQSeries Clients GC

2

3 MQSeries Clients GC

4 Important Avant d utiliser le présent document et le produit associé, prenez connaissance des informations générales figurant à l «Annexe C. Remarques» à la page 175. Sixième édition - mars 2000 Réf. US : GC LE PRESENT DOCUMENT EST LIVRE EN L ETAT. IBM DECLINE TOUTE RESPONSABILITE, EXPRESSE OU IMPLICITE, RELATIVE AUX INFORMATIONS QUI Y SONT CONTENUES, Y COMPRIS EN CE QUI CONCERNE LES GARANTIES DE QUALITE MARCHANDE OU D ADAPTATION A VOS BESOINS. Certaines juridictions n autorisent pas l exclusion des garanties implicites, auquel cas l exclusion ci-dessus ne vous sera pas applicable. Ce document est mis à jour périodiquement. Chaque nouvelle édition inclut les mises à jour. Les informations qui y sont fournies sont susceptibles d être modifiées avant que les produits décrits ne deviennent eux-mêmes disponibles. En outre, il peut contenir des informations ou des références concernant certains produits, logiciels ou services non annoncés dans ce pays. Cela ne signifie cependant pas qu ils y seront annoncés. Pour plus de détails, pour toute demande d ordre technique, ou pour obtenir des exemplaires de documents IBM, référez-vous aux documents d annonce disponibles dans votre pays, ou adressez-vous à votre partenaire commercial. Vous pouvez également consulter les serveurs Internet suivants : v (serveur IBM en France) v (serveur IBM au Canada) v (serveur IBM aux Etats-Unis) Compagnie IBM France Direction Qualité Tour Descartes Paris-La Défense Cedex 50 Copyright IBM France Tous droits réservés. Copyright International Business Machines Corporation 1994, All rights reserved.

5 Table des matières Figures vii Tableaux ix Préface xi Connaissances préalables xi Utilisation du manuel xi Terminologie xi Résumé des modifications xiii Modifications apportées à la présente édition (GC ) xiii Modifications apportées à la cinquième édition.. xiii Modifications apportées à la quatrième édition.. xiii Partie 1. Introduction aux clients MQSeries Chapitre 1. Présentation des clients MQSeries Définition d un client MQSeries Connexion client-serveur Utilisation des clients MQSeries Applications fonctionnant sur un client MQSeries 5 Configuration d un client MQSeries Partie 2. Installation des clients MQSeries Chapitre 2. Préparation de l installation 11 Plateformes prises charge pour les clients MQSeries 11 Applications sur les clients en version Clients MQSeries sur d autres plateformes Communications Performances Compatibilité an Configurations matérielle et logicielle requises Client AIX : matériel et logiciels requis Client AT&T GIS UNIX (NCR UNIX) : matériel et logiciels requis Clients Digital OpenVMS : matériel et logiciels requis Client Digital UNIX : matériel et logiciels requis 17 Client DOS : matériel et logiciels requis Client HP-UX : matériel et logiciels requis Client OS/2 Warp : matériel et logiciels requis 21 Client SINIX et DC/OSx : matériel et logiciels pris en charge Client Sun Solaris : matériel et logiciels requis.. 23 Client VM/ESA : matériel et logiciels requis.. 24 Client Windows 3.1 : matériel et logiciels requis 25 Client Windows 95 et Windows 98 : matériel et logiciels requis Client Windows NT : matériel et logiciels requis 27 Chapitre 3. Installation des composants clients MQSeries à partir de produits en version Installation d un système client-serveur MQSeries 29 Installation de clients MQSeries sur le même poste serveur Retrait des clients MQSeries Installation sous AIX Composants pour AIX Avant l installation Installation simplifiée Installation personnalisée Migration à partir d une version antérieure de MQSeries pour AIX Modification de la langue nationale Messages traduits Retrait d un client MQSeries sous AIX Installation sous DOS Composants pour DOS À l aide de la commande setup Suppression d un client MQSeries sous DOS.. 38 Installation sous HP-UX Composants pour HP-UX Avant l installation Installation Configuration du noyau Messages traduits Retrait d un client MQSeries sous HP-UX Installation sous OS/2 Warp Composants pour OS/2 Warp Installation Installation automatique sous OS/2 Warp Paramètres d installation et de maintenance.. 46 Fichiers de réponses d installation Retrait d un client MQSeries sous OS/2 Warp.. 50 Installation sous Sun Solaris Composants pour Sun Solaris Avant l installation Installation Configuration du noyau Messages traduits Retrait d un client MQSeries sous Sun Solaris.. 53 Installation sous Windows Composants pour Windows Installation Retrait d un client MQSeries sous Windows Installation sous Windows 95 ou Windows Composants pour Windows 95 ou Installation Réexécution de Setup Copyright IBM Corp. 1994, 2000 iii

6 Installation automatique sous Windows 95 et Windows Retrait d un client MQSeries sous Windows 95 et Windows Installation sous Windows NT Composants pour Windows NT Installation Réexécution du programme d installation Installation à partir d un réseau local Utilisation de SMS avec MQSeries pour Windows NT Installation automatique sous Windows NT.. 64 Retrait d un client MQSeries sous Windows NT 66 Chapitre 4. Installation de clients MQSeries avec des produits autres que ceux en version Obtention de clients MQSeries à partir d autres produits MQSeries Client et serveur MQSeries sur la même plateforme Client et serveur MQSeries sur des plateformes différentes Obtention de clients MQSeries à partir de la bibliothèque IBM Transaction Processing SupportPac 68 Installation du serveur MQSeries Fichiers client MQSeries sur le serveur Installation de clients MQSeries à partir de MQSeries pour Digital OpenVMS Installation d un client MQSeries sous Digital OpenVMS à partir de Digital OpenVMS Installation d un client MQSeries sous OS/2 Warp à partir de Digital OpenVMS Installation d un client MQSeries sous DOS à partir de Digital OpenVMS Installation d un client MQSeries sous Windows 3.1 à partir de Digital OpenVMS Installation de clients MQSeries à partir de MQSeries pour systèmes UNIX Installation d un client MQSeries sous UNIX à partir d un système UNIX Installation d un client MQSeries sous OS/2 Warp à partir d un système UNIX Installation d un client MQSeries sous DOS à partir d un système UNIX Installation d un client MQSeries sous Windows 3.1 à partir d un système UNIX Client MQSeries pour VM/ESA Modification des fichiers config.sys et autoexec.bat 77 Modification du fichier config.sys de OS/2 Warp 77 Modification du fichier autoexec.bat sous DOS et Windows Chapitre 5. Configuration des liaisons 79 Choix du protocole de communication à utiliser.. 79 Définition d une connexion TCP/IP Nombre maximal de connexions TCP/IP TCP/IP sur un client MQSeries (tout type de plateforme) TCP/IP sur un serveur OS/2 Warp TCP/IP sur un serveur Windows NT TCP/IP sur un serveur UNIX TCP/IP sur un serveur AS/ TCP/IP sur un serveur OS/ TCP/IP sur un serveur Digital OpenVMS TCP/IP sur un serveur Tandem NSK TCP/IP sur un serveur VSE/ESA Définition d une connexion LU LU 6.2 sur un client MQSeries OS/2 Warp LU 6.2 sur un serveur OS/2 Warp LU 6.2 sur un client MQSeries Windows NT.. 90 LU 6.2 sur un serveur Windows NT LU 6.2 sur un client MQSeries UNIX LU 6.2 sur un serveur UNIX LU 6.2 sur un serveur AS/ LU 6.2 sur un serveur Tandem NSK LU 6.2 sur un serveur OS/ LU 6.2 sur un client Digital OpenVMS Définition d une connexion NetBIOS NetBIOS sur un client MQSeries (toute plateforme prise en charge) NetBIOS sur un serveur OS/2 Warp NetBIOS sur un serveur Windows NT Définition d une connexion SPX SPX sur un client MQSeries (toute plateforme prise en charge) SPX sur un serveur MQSeries (OS/2 Warp ou Windows NT) Paramètres SPX et IPX Définition d une connexion DECnet DECnet sur un client MQSeries DECnet sur un serveur MQSeries (Digital OpenVMS) Chapitre 6. Vérification de l installation Installation utilisée Exemple Configuration du serveur Configuration du serveur (AS/400) Configuration du serveur (OS/390) Configuration du serveur (VSE/ESA) Configuration du client MQSeries Définition d un canal de connexion client à l aide de MQSERVER Insertion d un message dans une file d attente Sur le poste client MQSeries (à l exception de VM/ESA et de Windows 3.1) Sur le poste client MQSeries (VM/ESA) Sur le poste client MQSeries (Windows 3.1) Extraction d un message de la file d attente Sur le poste client MQSeries (à l exception de VM/ESA et de Windows 3.1) Sur le poste client MQSeries (VM/ESA) Sur le poste client MQSeries (Windows 3.1) Fin de la vérification Partie 3. Administration du système iv MQSeries - Clients

7 Chapitre 7. Sécurité des clients MQSeries Authentification Variables d environnement ID utilisateur Contrôle des droits d accès Chapitre 8. Utilisation des canaux Qu est-ce qu un canal? Types de canaux MQI Connexion client-serveur MQSeries - Définitions de canaux Définition automatique des canaux par les serveurs Création d un gestionnaire de files d attente et lancement de MQSC sur le serveur (à l exception de l OS/390) Lancement de commandes MQSeries (MQSC) 120 Création d une définition sur le client MQSeries et de l autre définition sur le serveur Au niveau du serveur Au niveau du client MQSeries Création des deux définitions sur le serveur Au niveau du serveur Au niveau du client MQSeries Migration à partir des produits MQSeries en version 2 vers la version Chapitre 9. Utilisation des variables d environnement MQSeries MQCCSID MQCHLLIB MQCHLTAB MQDATA (DOS et Windows 3.1 uniquement) MQNAME MQ_PASSWORD (DOS, OS/2 Warp, Windows 3.1, Windows 95 et Windows 98 uniquement MQSERVER Port TCP/IP par défaut Prise SPX par défaut Exemples d utilisation de MQSERVER MQTRACE (DOS, Windows 3.1 et VM/ESA uniquement) MQ_USER_ID (DOS, OS/2 Warp, Windows 3.1, Windows 95 et Windows 98 uniquement) MQSWORKPATH (OS/2 Warp uniquement) Partie 4. Programmation d applications Chapitre 10. Utilisation de l interface MQI Limitation de la taille d un message Identificateur de jeu de caractères codés (CCSID) client ou serveur CCSID et zones de codage - commandes PUT multiples Contrôle de l application dans l environnement Windows Développement d applications Environnement Windows Utilisation de MQINQ Coordination des points de synchronisation Serveur MQSeries pour Tandem NonStop Kernel Utilisation de MQCONNX Chapitre 11. Création d applications pour les clients MQSeries Exécution d applications en environnement client MQSeries Déclenchement en environnement client Définition du processus Moniteur de déclenchement Applications CICS (à l exception de l OS/390) 144 Exits de canal Chemin d accès des exits Liaison d applications en C avec le code client MQSeries Utilisation de postes client Windows 16 et 32 bits Liaison d applications en C++ avec le code client MQSeries Liaison d applications en COBOL avec le code client MQSeries Liaison d applications en PL/I avec le code client MQSeries Liaison d applications en Visual Basic avec le code client MQSeries Chapitre 12. Exécution d applications sur les clients MQSeries Utilisation des variables d environnement Utilisation de MQSERVER Utilisation de MQCHLLIB et MQCHLTAB Utilisation de la structure MQCNO Utilisation de DEFINE CHANNEL Rôle de la table de définitions de canaux Gestionnaires de files d attente multiples Exemples d appels MQCONN Objet des exemples Exemple 1. Nom de gestionnaire de files d attente contenant un astérisque (*) Exemple 2. Nom de gestionnaire de files d attente précisé Exemple 3. Nom de gestionnaire de files d attente non précisé ou correspondant à un astérisque (*) Chapitre 13. Résolution des incidents 157 Echec de la connexion au niveau du client MQSeries Arrêt des clients MQSeries Messages d erreur relatifs aux clients MQSeries Systèmes Digital OpenVMS, OS/2 Warp, UNIX, Windows 95, Windows 98 et Windows NT Clients DOS et Windows Lecture des journaux d erreurs et des fichiers FFDC sous DOS et Windows Table des matières v

8 Variables d environnement MQSeries Utilisation de la trace sous DOS et Windows Exemple de données de trace DOS Utilisation de la trace sous OS/2 Warp, Windows NT, Windows 95 et Windows Noms des fichiers de trace Consultation des fichiers First Failure Support Technology (FFST) Utilisation de la trace sous AIX et AT&T GIS UNIX 161 Utilisation de la trace sous Digital OpenVMS, HP-UX, SINIX, DC/OSx et Sun Solaris Noms des fichiers de trace Lecture des fichiers FFST Utilisation de la trace sous VM/ESA Exemple de données de trace VM/ESA Partie 5. Annexes Annexe A. Format du fichier de réponses d installation pour Windows NT Fichier de réponses d installation type Strophe [MQSeries-0] Noms de composants utilisés dans les fichiers de réponses Annexe B. Désinstallation de MQSeries pour Windows NT Désinstallation manuelle Désinstallation automatique Format du fichier de réponses de désinstallation 172 La strophe MQSeries La strophe Components Annexe C. Remarques Marques Glossaire Bibliographie Publications MQSeries communes aux différentes plateformes Publications MQSeries propres aux plateformes 185 Documentation électronique Format BookManager Format HTML Format PDF (Portable Document Format) Format PostScript Format d aide Windows Informations relatives à MQSeries sur Internet Publications Index Envoi de vos remarques à IBM vi MQSeries - Clients

9 Figures 1. Lien entre un client et un serveur Serveur MQSeries connecté àdes clients sur différentes plateformes Ecran de configuration de communication LU extrémité démarrée Sécurité pour une connexion client-serveur Canaux de communication entre deux gestionnaires de files d attente Canal MQI reliant un client et un gestionnaire de files d attente Connexions client et serveur sur un canal MQI Définition de la connexion serveur d un canal MQI Définition de canal simple Définition du canal de connexion serveur Définition du canal de connexion client Exemple d appel MQCONN Extrait de fichier de trace pour un client DOS Extrait de fichier de trace pour client VM/ESA Exemple de fichier de réponses de désinstallation d un client Windows NT Copyright IBM Corp. 1994, 2000 vii

10 viii MQSeries - Clients

11 Tableaux 1. Protocoles de communication pour canaux MQI Protocoles de communication - combinaisons de plateformes client et serveur MQSeries Nombre maximal de demandes de connexion en attente mises en file d attente sur un port TCP/IP Paramètres du serveur sur le client MQSeries OS/2 Warp Paramètres du serveur sur le client MQSeries Windows NT Paramètres du serveur sur le client MQSeries UNIX Langages de programmation pris en charge dans les environnements client Copyright IBM Corp. 1994, 2000 ix

12 x MQSeries - Clients

13 Préface Connaissances préalables Utilisation du manuel Le présent manuel contient des informations sur l environnement client-serveur MQSeries. Il explique comment installer un client MQSeries et comment configurer les communications, ainsi que les canaux MQSeries, pour que les applications MQSeries puissent fonctionner sur le poste client. Les variables d environnement MQSeries, ainsi que la création et l exécution d applications sur un client MQSeries, sont également décrites. Vous trouverez dans ce manuel la plupart des informations dont vous avez besoin concernant les clients MQSeries. Certains des autres ouvrages de référence MQSeries contiennent également des informations relatives à ces clients. Ces informations ne sont pas reprises dans le présent manuel. Ce manuel est destiné aux administrateurs système, à toute personne chargée d installer et de configurer les produits MQSeries dans l environnement client-serveur, et aux programmeurs qui doivent rédiger des programmes faisant appel à l interface MQI. Vous devez maîtriser les concepts suivants : v Installation et configuration du système serveur : AS/400, Digital OpenVMS, OS/2 Warp, OS/390, Tandem NonStop Kernel (NSK), l un des systèmes UNIX répertoriés ci-après, VSE/ESA ou Windows NT. v Utilisation des plateformes client telles que DOS, Windows 3.1, Windows 95 et Windows 98. v Utilisation de l interface MQI. v Programmes et documentation MQSeries. Consultez le «Chapitre 1. Présentation des clients MQSeries» àla page 3, en guise d introduction. La section «Configuration d un client MQSeries» àla page 5, dresse la liste des tâches à accomplir et vous guide ainsi tout au long du manuel. Terminologie Dans ce manuel, l expression systèmes UNIX regroupe les produits suivants : v AIX v AT&T GIS UNIX (cette plateforme s appelle désormais NCR UNIX) v DIGITAL UNIX (Compaq Tru64 UNIX) v HP-UX v SINIX et DC/OSx v Sun Solaris Les produits MQSeries pour systèmes UNIX correspondants sont : v IBM MQSeries pour AIX version 5.1 v IBM MQSeries pour AT&T GIS UNIX version 2.2 v IBM MQSeries IBM pour DIGITAL UNIX (Compaq Tru64 UNIX) version 2 édition 2.1 Copyright IBM Corp. 1994, 2000 xi

14 Préface v IBM MQSeries pour HP-UX version 5.1 v IBM MQSeries pour SINIX et DC/OSx version 2.2 v IBM MQSeries pour Sun Solaris version 5.1 Dans le présent manuel, le terme mqmtop désigne le répertoire de base dans lequel MQSeries est installé sur des systèmes UNIX. v Pour AIX, le nom de ce répertoire est /usr/mqm v Pour les autres systèmes UNIX, le nom de ce répertoire est /opt/mqm xii MQSeries - Clients

15 Résumé des modifications Cette section identifie les modifications apportées dans la présente édition du manuel MQSeries - Clients. Modifications apportées à la présente édition (GC ) Inclusion des produits suivants : v MQSeries pour AS/400 V5.1 v MQSeries pour DIGITAL UNIX (Compaq Tru64 UNIX) V2.2.1 v MQSeries pour Tandem NonStop Kernel V Modifications apportées à la cinquième édition Inclusion des produits suivants : v MQSeries pour AIX version 5.1 v MQSeries pour AS/400 V4R2M1 v MQSeries pour HP-UX version 5.1 v MQSeries pour OS/2 Warp V5.1 v MQSeries pour OS/390 version 2.1 v MQSeries pour Sun Solaris version 5.1 v MQSeries pour VSE/ESA version 2.1 v MQSeries pour Windows NT version 5.1 Modifications apportées à la quatrième édition Inclusion des produits suivants : v MQSeries pour AS/400 version 4 édition 2 v MQSeries pour Tandem NonStop Kernel version 2.2 v MQSeries Client pour VM/ESA version 2 édition 3 Copyright IBM Corp. 1994, 2000 xiii

16 Modifications xiv MQSeries - Clients

17 Partie 1. Introduction aux clients MQSeries Chapitre 1. Présentation des clients MQSeries.. 3 Définition d un client MQSeries Connexion client-serveur Client et gestionnaire de files d attente sur la même machine Clients sur différentes plateformes Utilisation des clients MQSeries Applications fonctionnant sur un client MQSeries 5 Configuration d un client MQSeries Copyright IBM Corp. 1994,

18 Présentation 2 MQSeries - Clients

19 Chapitre 1. Présentation des clients MQSeries Le présent chapitre aborde les points suivants : v «Définition d un client MQSeries» v «Utilisation des clients MQSeries» àla page 5 v «Configuration d un client MQSeries» àla page 5 Définition d un client MQSeries Un client MQSeries est un composant MQSeries qui peut être installé seul, sur une machine distincte du produit de base et du logiciel serveur. Il permet d exécuter sur le poste client des applications MQSeries qu il relie à un ou plusieurs serveurs MQSeries et aux gestionnaires de files d attente correspondants, via un protocole de communication. Les serveurs auxquels le client se connecte peuvent appartenir ou non à un cluster. Figure 1. Lien entre un client et un serveur Les plateformes ci-après peuvent être utilisées. Les combinaisons possibles de clients et de serveurs dépendent du produit MQSeries utilisé et sont décrites à la section «Plateformes prises charge pour les clients MQSeries» àla page 11. D autres clients MQSeries sont également disponibles ; ils sont décrits à la section «Clients MQSeries sur d autres plateformes» àla page 12. Client MQSeries Digital OpenVMS Digital UNIX DOS OS/2 Warp Systèmes UNIX VM/ESA Windows NT Windows 3.1 Windows 95 Windows 98 Serveur MQSeries AS/400 Digital OpenVMS Digital UNIX MVS/ESA OS/2 Warp OS/390 Tandem NSK Systèmes UNIX VSE/ESA Windows NT L interface MQI est disponible pour les applications s exécutant sur la plateforme client. Les files d attente et autres objets MQSeries sont gérés par le gestionnaire installé sur le serveur. Copyright IBM Corp. 1994,

20 Présentation des clients MQSeries Pour qu une application puisse être utilisée dans l environnement client MQSeries, elle doit auparavant être connectée à la bibliothèque client correspondante. Lorsqu une application émet un appel MQI, le client MQSeries dirige la demande vers un gestionnaire de files d attente, qui la traite et renvoie une réponse au client MQSeries. La liaison entre l application et le client MQSeries est établie de façon dynamique au moment de l exécution (sauf sous DOS, en cas de liaison statique). Connexion client-serveur Une application s exécutant en environnement client MQSeries fonctionne en mode synchrone car il doit exister une connexion active entre le client et le serveur. La connexion est établie par une application émettant un appel MQCONN ou MQCONNX. Clients et serveurs communiquent via des canaux MQI. Lorsque l appel aboutit, le canal MQI reste connecté jusqu à ce que l application émette un appel MQDISC. Cette procédure est utilisée pour chaque gestionnaire de files d attente auquel une application doit se connecter. Client et gestionnaire de files d attente sur la même machine Vous pouvez également exécuter une application dans un environnement client MQSeries au niveau duquel un gestionnaire de files d attente a été installé pour votre machine. Dans ce cas, vous pouvez effectuer un lien avec les bibliothèques du gestionnaire ou les bibliothèques du client. Vous devez cependant vous souvenir que dans ce dernier cas, il est tout de même nécessaire de définir les connexions de canal. Cela peut être utile durant la phase de développement d une application. Vous pouvez alors tester votre programme sur votre propre machine, indépendamment des autres, et vous assurer que votre système fonctionnera même si vous passez en environnement MQSeries complet. Clients sur différentes plateformes Voici un autre exemple de modèle client-serveur MQSeries dans lequel le serveur communique avec trois clients MQSeries se trouvant sur des plateformes différentes. Figure 2. Serveur MQSeries connecté à des clients sur différentes plateformes 4 MQSeries - Clients

21 D autres environnements plus complexes sont disponibles ; un client MQSeries peut, par exemple, être relié àplusieurs gestionnaires de files d attente. Utilisation des clients MQSeries Les clients MQSeries constituent un moyen performant pour mettre en oeuvre les fonctions de messagerie et de mise en file d attente MQSeries. Une même application peut utiliser simultanément le client MQI présent sur une machine et le gestionnaire de files d attente opérant sur une autre machine, en mode physique ou virtuel. Les avantages de cette technique sont les suivants : v v v v v Il n est pas nécessaire d installer la totalité de MQSeries sur le poste client (plateforme DOS, Windows 3.1, Windows 95 ou Windows 98, par exemple). La configuration matérielle requise sur le poste client reste minimale. Les besoins en administration système sont réduits. Les applications MQSeries du client peuvent se connecter à plusieurs gestionnaires de files d attente sur différents systèmes. Il est possible d utiliser des canaux fonctionnant avec des protocoles de transmission différents. Applications fonctionnant sur un client MQSeries L environnement client prend en charge l intégralité de l interface MQI, permettant ainsi à toute application MQSeries d être redirigée vers un client MQSeries. Sur le client MQSeries, liez l application à la bibliothèque MQIC et non à la bibliothèque MQI. Les exceptions à cette règle sont : v une application nécessitant la coordination des points de synchronisation avec d autres gestionnaires de ressources ; v MQGET avec signal. Une application client MQSeries peut être reliée à plusieurs gestionnaires de files d attente en même temps ou utiliser un nom de gestionnaire de files comportant un astérisque (*) dans l appel MQCONN ou MQCONNX (voir les exemples dans le «Chapitre 12. Exécution d applications sur les clients MQSeries» àla page 149). L appel MQCONNEX n est pris en charge que par les bibliothèques client. Configuration d un client MQSeries Présentation des clients MQSeries Le présent manuel explique comment configurer et utiliser un client MQSeries. Vous devez disposer d un serveur MQSeries, installé et opérationnel sur un poste, auquel votre client pourra se connecter. Pour configurer un client, procédez comme suit : 1. Vérifiez que vous disposez d une plateforme pouvant servir de client MQSeries, offrant une configuration matérielle et logicielle appropriée. Pour plus de détails, reportez-vous au «Chapitre 2. Préparation de l installation» àla page Déterminez comment installer MQSeries sur le poste client, puis suivez les instructions relatives à votre combinaison de plateformes client-serveur. Pour cela, reportez-vous aux «Chapitre 3. Installation des composants clients MQSeries à partir de produits en version 5.1» àla page 29, et «Chapitre 4. Installation de clients MQSeries avec des produits autres que ceux en version 5»àla page Assurez-vous que les liens de communication sont configurés et connectés. Pour plus de détails, reportez-vous au «Chapitre 5. Configuration des liaisons» à la page 79. Chapitre 1. Présentation des clients MQSeries 5

22 Présentation des clients MQSeries 4. Vérifiez que votre installation fonctionne correctement. Pour plus de détails, reportez-vous au «Chapitre 6. Vérification de l installation» àla page Après avoir vérifié l installation du client MQSeries, il convient de déterminer les besoins en matière de sécurité. Pour plus de détails, reportez-vous au «Chapitre 7. Sécurité des clients MQSeries» àla page Configurez ensuite les canaux entre le client et le serveur MQSeries. Ces canaux seront utilisés par les applications MQSeries s exécutant sur le client. Pour plus de détails, reportez-vous au «Chapitre 8. Utilisation des canaux» àla page 117. Il peut être nécessaire de recourir aux variables d environnement MQSeries pour configurer les canaux. Pour plus de détails, reportez-vous au «Chapitre 9. Utilisation des variables d environnement MQSeries» àla page Vous trouverez une description complète des applications MQSeries dans le manuel MQSeries Application Programming Guide. 8. Il existe des différences dont il faut tenir compte lorsque vous concevez, créez et exécutez des applications dans un environnement client MQSeries. Pour plus de détails, consultez les chapitres ci-dessous : v «Chapitre 10. Utilisation de l interface MQI» àla page 137 v «Chapitre 11. Création d applications pour les clients MQSeries» àla page 141 v «Chapitre 12. Exécution d applications sur les clients MQSeries» àla page 149 v «Chapitre 13. Résolution des incidents» àla page MQSeries - Clients

23 Partie 2. Installation des clients MQSeries Chapitre 2. Préparation de l installation Plateformes prises charge pour les clients MQSeries 11 Applications sur les clients en version Clients MQSeries sur d autres plateformes Communications Performances Compatibilité an Configurations matérielle et logicielle requises Client AIX : matériel et logiciels requis Matériel Logiciels Compilateurs pour applications MQSeries sur clients AIX Client AT&T GIS UNIX (NCR UNIX) : matériel et logiciels requis Matériel Logiciels Compilateur pour applications MQSeries sur clients AT&T GIS UNIX Clients Digital OpenVMS : matériel et logiciels requis Matériel Logiciels Compilateurs pour applications MQSeries sur clients Digital OpenVMS Client Digital UNIX : matériel et logiciels requis 17 Matériel Logiciels Compilateurs pour applications MQSeries sur clients Digital UNIX Client DOS : matériel et logiciels requis Matériel Logiciels Compilateurs pour applications MQSeries sur clients DOS Client HP-UX : matériel et logiciels requis Matériel Logiciels Compilateurs pour applications MQSeries sur clients HP-UX Client OS/2 Warp : matériel et logiciels requis 21 Matériel Logiciels Compilateurs pour applications MQSeries sur clients OS/2 Warp Client SINIX et DC/OSx : matériel et logiciels pris en charge Matériel Logiciels Compilateurs pour applications MQSeries sur clients SINIX et DC/OSx Client Sun Solaris : matériel et logiciels requis.. 23 Matériel Logiciels Compilateurs pour applications MQSeries sur clients Sun Solaris Client VM/ESA : matériel et logiciels requis.. 24 Matériel Logiciels Compilateurs pour applications MQSeries sur clients VM/ESA Client Windows 3.1 : matériel et logiciels requis 25 Matériel Logiciels Compilateurs pour applications MQSeries sur clients Windows Client Windows 95 et Windows 98 : matériel et logiciels requis Matériel Logiciels Compilateurs pour applications MQSeries sur clients Windows 95 et Client Windows NT : matériel et logiciels requis 27 Matériel Logiciels Compilateurs pour applications MQSeries sur clients Windows NT Chapitre 3. Installation des composants clients MQSeries à partir de produits en version Installation d un système client-serveur MQSeries 29 Installation de clients MQSeries sur le même poste serveur Retrait des clients MQSeries Installation sous AIX Composants pour AIX Avant l installation Création d un autre système de fichiers pour le client Création de l ID utilisateur et de groupe mqm 33 Installation simplifiée Installation personnalisée Migration à partir d une version antérieure de MQSeries pour AIX Modifications apportées au chemin d installation Modification de la langue nationale Messages traduits Retrait d un client MQSeries sous AIX Installation sous DOS Composants pour DOS À l aide de la commande setup Suppression d un client MQSeries sous DOS.. 38 Installation sous HP-UX Composants pour HP-UX Avant l installation Installation Configuration du noyau Messages traduits Retrait d un client MQSeries sous HP-UX Installation sous OS/2 Warp Composants pour OS/2 Warp Copyright IBM Corp. 1994,

24 Installation des clients MQSeries Installation Installation automatique sous OS/2 Warp Démarrage de l installation automatique Paramètres d installation et de maintenance.. 46 Fichiers de réponses d installation Mots clés pour fichiers de réponses Structure des fichiers de réponses Retrait d un client MQSeries sous OS/2 Warp.. 50 Installation sous Sun Solaris Composants pour Sun Solaris Avant l installation Installation Configuration du noyau Messages traduits Retrait d un client MQSeries sous Sun Solaris.. 53 Installation sous Windows Composants pour Windows Installation Réexécution de Setup Retrait d un client MQSeries sous Windows Installation sous Windows 95 ou Windows Composants pour Windows 95 ou Installation Réexécution de Setup Installation automatique sous Windows 95 et Windows Configuration du serveur Installation sur le poste éloigné Retrait d un client MQSeries sous Windows 95 et Windows Installation sous Windows NT Composants pour Windows NT Installation Procédure d installation Réexécution du programme d installation Installation à partir d un réseau local Utilisation de SMS avec MQSeries pour Windows NT Création de progiciels et de travaux SMS pour MQSeries Création du progiciel SMS MQSeries Création du travail SMS MQSeries Installation automatique sous Windows NT.. 64 Installation sur le poste éloigné Retrait d un client MQSeries sous Windows NT 66 Chapitre 4. Installation de clients MQSeries avec des produits autres que ceux en version Obtention de clients MQSeries à partir d autres produits MQSeries Client et serveur MQSeries sur la même plateforme Client et serveur MQSeries sur des plateformes différentes Obtention de clients MQSeries à partir de la bibliothèque IBM Transaction Processing SupportPac 68 Installation du serveur MQSeries Fichiers client MQSeries sur le serveur Plateformes MQSeries pour Digital OpenVMS et UNIX MQSeries pour OS/390, Tandem NSK et VSE/ESA Installation de clients MQSeries à partir de MQSeries pour Digital OpenVMS Installation d un client MQSeries sous Digital OpenVMS à partir de Digital OpenVMS Installation d un client MQSeries sous OS/2 Warp à partir de Digital OpenVMS Installation d un client MQSeries sous DOS à partir de Digital OpenVMS Installation d un client MQSeries sous Windows 3.1 à partir de Digital OpenVMS Installation de clients MQSeries à partir de MQSeries pour systèmes UNIX Installation d un client MQSeries sous UNIX à partir d un système UNIX Installation d un client MQSeries sous OS/2 Warp à partir d un système UNIX Installation d un client MQSeries sous DOS à partir d un système UNIX Installation d un client MQSeries sous Windows 3.1 à partir d un système UNIX Client MQSeries pour VM/ESA Modification des fichiers config.sys et autoexec.bat 77 Modification du fichier config.sys de OS/2 Warp 77 Modification du fichier autoexec.bat sous DOS et Windows Chapitre 5. Configuration des liaisons Choix du protocole de communication à utiliser.. 79 Définition d une connexion TCP/IP Nombre maximal de connexions TCP/IP TCP/IP sur un client MQSeries (tout type de plateforme) TCP/IP sur un serveur OS/2 Warp Utilisation de inetd Utilisation de la commande d exécution de programme d écoute (RUNMQLSR) TCP/IP sur un serveur Windows NT Utilisation de la commande d exécution de programme d écoute (RUNMQLSR) TCP/IP sur un serveur UNIX Utilisation de la commande d exécution de programme d écoute (RUNMQLSR) TCP/IP sur un serveur AS/ TCP/IP sur un serveur OS/ TCP/IP sur un serveur Digital OpenVMS TCP/IP sur un serveur Tandem NSK TCP/IP sur un serveur VSE/ESA Définition d une connexion LU LU 6.2 sur un client MQSeries OS/2 Warp LU 6.2 sur un serveur OS/2 Warp Utilisation de la commande RUNMQLSR.. 89 Utilisation de Communications Manager/ LU 6.2 sur un client MQSeries Windows NT.. 90 LU 6.2 sur un serveur Windows NT Utilisation de la commande RUNMQLSR.. 91 Utilisation de SNA Server LU 6.2 sur un client MQSeries UNIX LU 6.2 sur un serveur UNIX LU 6.2 sur un serveur AS/ MQSeries - Clients

25 Installation des clients MQSeries LU 6.2 sur un serveur Tandem NSK LU 6.2 sur un serveur OS/ LU 6.2 sur un client Digital OpenVMS Définition d une connexion NetBIOS NetBIOS sur un client MQSeries (toute plateforme prise en charge) NetBIOS sur un serveur OS/2 Warp Lancement du programme d écoute NetBIOS sur un serveur Windows NT Lancement du programme d écoute Définition d une connexion SPX SPX sur un client MQSeries (toute plateforme prise en charge) SPX sur un serveur MQSeries (OS/2 Warp ou Windows NT) Utilisation de la commande d exécution de programme d écoute (RUNMQLSR) Paramètres SPX et IPX SPX sur un client OS/2 Warp SPX sur un client DOS ou Windows SPX sur un client Windows NT SPX sur un client MQSeries pour Windows 95 et Windows Définition d une connexion DECnet DECnet sur un client MQSeries DECnet sur un serveur MQSeries (Digital OpenVMS) Réception sous DECnet Phase IV Réception sous DECnet OSI Chapitre 6. Vérification de l installation Installation utilisée Exemple Sécurité Configuration du serveur Configuration du serveur (AS/400) Configuration du serveur (OS/390) Configuration du serveur (VSE/ESA) Configuration du client MQSeries Définition d un canal de connexion client à l aide de MQSERVER Insertion d un message dans une file d attente Sur le poste client MQSeries (à l exception de VM/ESA et de Windows 3.1) Sur le poste client MQSeries (VM/ESA) Sur le poste client MQSeries (Windows 3.1) Extraction d un message de la file d attente Sur le poste client MQSeries (à l exception de VM/ESA et de Windows 3.1) Sur le poste client MQSeries (VM/ESA) Sur le poste client MQSeries (Windows 3.1) Fin de la vérification Partie 2. Installation des clients MQSeries 9

26 Installation des clients MQSeries 10 MQSeries - Clients

27 Chapitre 2. Préparation de l installation Le présent chapitre aborde les points suivants : v «Plateformes prises charge pour les clients MQSeries» v «Communications» àla page 12 v «Compatibilité an 2000» àla page 14 v «Configurations matérielle et logicielle requises» àla page 14 Plateformes prises charge pour les clients MQSeries Les plateformes prises en charge pour les clients et les serveurs MQSeries sont indiquées ci-après. Tout produit MQSeries répertorié ci-après est installé en tant que produit de base et serveur (produit de base et fonction de connexion de clients pour MQSeries pour OS/390). Ces produits MQSeries acceptent les connexions de clients MQSeries sur les plateformes proposées, bien qu il puisse exister des différences au niveau de l ID de jeu de caractères codés (CCSID) et du protocole de communication utilisés. Si vous utilisez des versions antérieures de produits MQSeries, assurez-vous que la conversion de code à partir du CCSID de votre client est prise en charge par le serveur. Pour plus de détails, reportez-vous aux tables de codes du manuel MQSeries Application Programming Reference. Les produits MQSeries suivants : v Produits en version 5 : MQSeries pour AIX V5.1 MQSeries pour AS/400 V5.1 MQSeries pour HP-UX V5.1 MQSeries pour OS/2 Warp V5.1 MQSeries pour Sun Solaris V5.1 MQSeries pour Windows NT V5.1 v Autres produits : MQSeries pour AT&T GIS UNIX V2.2 MQSeries pour Digital OpenVMS version 2.2 MQSeries pour Digital UNIX version MQSeries pour OS/390 version 2 édition 1 (et MQSeries pour MVS/ESA version 1 édition 2) MQSeries pour SINIX et DC/OSx V2.2 MQSeries pour Tandem NonStop Kernel V MQSeries pour VSE/ESA version 2 édition 1 acceptent les connexions de clients MQSeries sous : v AIX v AT&T GIS UNIX (cette plateforme s appelle désormais NCR UNIX) v Digital UNIX v DOS v HP-UX v OS/2 Warp v SINIX et DC/OSx v Sun Solaris v VM/ESA v Windows 3.1 Copyright IBM Corp. 1994,

28 Plateformes prises charge pour les clients MQSeries Communications v Windows 95 v Windows 98 v Windows NT MQSeries pour Windows version 2.0 et MQSeries pour Windows version 2.1 ne sont pas abordés dans le présent manuel. Les produits MQSeries pour Windows sont des gestionnaires de files d attente MQSeries destinés aux plateformes Microsoft Windows. Ils sont conçus pour occuper un minimum d espace sur des postes de travail de faible puissance. Vous ne pouvez pas utiliser les gestionnaires de files d attente MQSeries pour Windows comme clients MQSeries, ni vous en servir pour prendre en charge des clients MQSeries. Pour plus de détails à ce sujet, reportez-vous aux manuels MQSeries pour Windows version Guide de l utilisateur et MQSeries pour Windows version Guide de l utilisateur. Applications sur les clients en version 5 Un client en version 5 peut se connecter à tous les gestionnaires de files d attente dotées de la version 5 ou d une autre version. Cependant, si vous vous connectez à un gestionnaire de files d attente doté d une autre version, vous ne pouvez pas utiliser les nouveaux dispositifs et les nouvelles structures de la version 5.1 pour l application MQSeries de votre client. Clients MQSeries sur d autres plateformes Chaque produit MQSeries (à l exception de MQSeries pour AS/400, MQSeries pour MVS/ESA, MQSeries pour OS/390, MQSeries pour Tandem NSK et MQSeries pour VSE/ESA) inclut des fichiers pour des clients installables sur la même plateforme que le serveur et des fichiers permettant d installer des clients sur d autres plateformes. Pour plus de détails, reportez-vous à la section «Plateformes MQSeries pour Digital OpenVMS et UNIX» àla page 69 et au «Chapitre 3. Installation des composants clients MQSeries à partir de produits en version 5.1» à la page 29. D autres clients MQSeries sont disponibles via Internet sous forme de kits SupportPacs. Reportez-vous à la section «Informations relatives à MQSeries sur Internet»àla page 187. Les clients MQSeries utilisent des canaux MQI pour communiquer avec le serveur. Une définition de canal doit être créée aux deux extrémités (client et serveur MQSeries) de la connexion. Pour plus de détails, reportez-vous à la section «Connexion client-serveur MQSeries - Définitions de canaux» àla page 118. Les protocoles de communication autorisés figurent dans le tableau suivant : Tableau 1. Protocoles de communication pour canaux MQI Plateforme client LU 6.2 TCP/IP NetBIOS SPX DECnet Digital OpenVMS U U U DOS U U U OS/2 Warp U U U U UNIX U(1) U VM/ESA U U Windows 3.1 U U U 12 MQSeries - Clients

29 Communications Tableau 1. Protocoles de communication pour canaux MQI (suite) Plateforme client LU 6.2 TCP/IP NetBIOS SPX DECnet Windows 95 U U U Windows 98 U U U Windows NT U U U U Remarque : 1. Sauf sous DIGITAL UNIX (Compaq Tru64 UNIX) Le tableau 2 à la page 80 présente les différentes combinaisons possibles de plateformes client-serveur MQSeries utilisant ces protocoles de communication. Une application MQSeries sur un client MQSeries peut utiliser tous les appels MQI de la même manière que lorsque le gestionnaire de files d attente est local. L appel MQCONN ou MQCONNX associe l application MQSeries au gestionnaire de files d attente sélectionné, créant ainsi un identificateur de connexion. Les autres appels utilisant cet identificateur de connexion sont ensuite traités par le gestionnaire de files d attente connecté. La communication client MQSeries est synchrone, contrairement à la communication entre gestionnaires de files d attente qui est asynchrone (indépendante de la connexion et de la durée). Le protocole de communication est précisé dans la définition du canal et n affecte en rien l application. Ainsi, une même application Windows 3.1 peut se connecter à un gestionnaire de files d attente via TCP/IP et à un autre via NetBIOS. Performances Le type de protocole de communication utilisé peut affecter les performances du système client-serveur MQSeries. Pour une connexion via le RTC sur une ligne à faible débit, il est conseillé de recourir à des exits de canal pour compresser les données transmises. Chapitre 2. Préparation de l installation 13

30 Compatibilité an 2000 Compatibilité an 2000 Lorsqu il est utilisé conformément à sa documentation, MQSeries a la capacité de correctement traiter, fournir ou recevoir des données de date pour les 20e et 21e siècles eux-mêmes, et des données de date comprises entre les 20e et 21e siècles. Et ce, dans la mesure où tous les produits - matériel, logiciels et microcode (firmware), par exemple - avec lesquels ce logiciel opère, échangent correctement avec lui des données de date exactes. Pour les autres produits, les clients doivent prendre contact avec les fournisseurs ou propriétaires correspondants. IBM se réserve le droit de mettre à jour les informations présentes. Pour obtenir les dernières informations concernant les niveaux de logiciels pris en charge, reportez-vous à l URL suivante : Pour obtenir les dernières instructions d IBM concernant le passage à l An 2000, reportez-vous à l URL suivante : Configurations matérielle et logicielle requises Le tableau ci-après fournit la description des configurations matérielle et logicielle recommandées pour les diverses plateformes. Plateforme Page AIX 15 AT&T GIS UNIX (NCR UNIX) 16 Digital OpenVMS 17 Digital UNIX 17 DOS 19 HP-UX 20 OS/2 Warp 21 SINIX et DC/OSx 22 VM/ESA 24 Sun Solaris 23 Windows Windows 95 et Windows Windows NT 27 En ce qui concerne les configurations matérielles et logicielles des plateformes serveur, reportez-vous au manuel d installation pour la plateforme concernée. Pour vous aider dans votre travail de planification des ressources, reportez-vous au manuel MQSeries - Guide de planification. 14 MQSeries - Clients

31 Client AIX : matériel et logiciels requis Cette section présente le matériel et les logiciels requis pour un client MQSeries pour AIX. Matériel Un client MQSeries peut fonctionner sur n importe quel système IBM RS/6000 équipé de AIX version 4.2 ou suivante. Les autres systèmes AIX sont également utilisables, qu ils proviennent d IBM ou d autres distributeurs tels que Bull, Zenith ou Motorola. Il doivent disposer de suffisamment de mémoire vive (RAM) et d espace disque pour installer et prendre en charge les logiciels (voir ci-après), le client MQSeries, les méthodes d accès et les programmes d application requis. Logiciels Les logiciels requis pour les applications MQSeries fonctionnant sur un client AIX sont indiqués ci-après. La version indiquée est la version logicielle minimale prise en charge. Les versions suivantes (le cas échéant) sont prises en charge, sauf indication contraire : v AIX version 4.2 ( ou 5765-C34) ou AIX version 4.3 ou suivante. Les versions suivantes de certains des produits répertoriés peuvent être nécessaires pour AIX version 4.2, SMP et SP. Certains des produits requis peuvent exiger des versions suivantes du système d exploitation. Connectivité : TCP/IP : v TCP/IP (inclus dans le système d exploitation) SNA LU 6.2 : v IBM enetwork Communications Server pour AIX, version 5.0 Matériel et logiciels, AIX Logiciels facultatifs : v IBM DCE version 2.2. Utilisez la version prenant en charge le codage DES si vous voulez exécuter les exits d émission, de réception ou de messages DCE fournis avec MQSeries. Les noms et les modules de sécurité DCE sont livrés avec MQSeries pour AIX. Compilateurs pour applications MQSeries sur clients AIX Les compilateurs suivants sont pris en charge : v IBM C pour AIX, version 4.4 v IBM C Set++ pour AIX, version 3.1 ( ) v IBM C et compilateur C++, version 3.6 v IBM VisualAge C++ Professional pour AIX, version 4.0 v IBM COBOL Set pour AIX, version 1.1 v Compilateur COBOL Micro Focus pour UNIX, version 4.0 v IBM PL/I Set pour AIX, version 1.1 v IBM VisualAge Java Enterprise Edition pour AIX, version 2.0 Chapitre 2. Préparation de l installation 15