MQSeries pour AS/400. Mise en route. Version 5.1 GC

Dimension: px
Commencer à balayer dès la page:

Download "MQSeries pour AS/400. Mise en route. Version 5.1 GC11-1588-00"

Transcription

1 MQSeries pour AS/400 Mise en route Version 5.1 GC

2

3 MQSeries pour AS/400 Mise en route Version 5.1 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 109. Première é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 All rights reserved.

5 Table des matières Tableaux vii Bienvenue dans l environnement MQSeries pour AS/ ix Conventions ix Chapitre 1. À propos de MQSeries Mise en file d attente des messages Interface MQI Communication asynchrone Processus géré par messages Messages et files d attente Messages Files d attente Objets MQSeries Gestionnaires de files d attente Files d attente Définitions de processus Canaux Listes de noms Clients et serveurs Événements outils Types d événements Support transactionnel Chapitre 2. Nouveautés de MQSeries pour AS/400, version Chapitre 3. Préparation à l installation du serveur MQSeries pour AS/ Configuration matérielle requise Espace disque requis Configuration logicielle requise Connectivité Répertoires et bibliothèques d installation sur l AS/ Structure des bibliothèques AS/ Système de fichiers racine IFS Profils utilisateur Compilateurs utilisables pour la création d applications MQSeries pour AS/400, version Support de livraison Composants MQSeries pour AS/ Création des objets par défaut du système 17 Chapitre 4. Procédures d installation, de migration et de suppression de MQSeries pour AS/ Avant l installation Définition des valeurs système Procédure d installation Installation d autres versions traduites.. 21 Réinstallation Vérification de l installation Tâches à effectuer après l installation Mise au repos de MQSeries Mise au repos des versions précédentes de MQSeries pour AS/ Mise au repos de MQSeries pour AS/400, version Migration vers MQSeries pour AS/400, version Différences entre les versions Présentation du processus de migration.. 26 Avant la migration Migration Vérification de la migration Après la migration Suppression de MQSeries pour AS/400, version Suppression standard Suppression totale Chapitre 5. Utilisation de MQSeries pour AS/400, version Opérations préliminaires Présentation des jeux de commandes Commandes de contrôle Commandes MQSeries (MQSC) Commandes PCF Gestion de MQSeries Création d un gestionnaire de files d attente Démarrage d un gestionnaire de files d attente Création d une file d attente locale Envoi d un message de test Consultation des files d attente Effacement d un file d attente locale Suppression d une file d attente locale.. 44 Copyright IBM Corp iii

6 Arrêt d un gestionnaire de files d attente 44 Suppression d un gestionnaire de files d attente Contrôle des gestionnaires de files d attente en cours d exécution Autres tâches à effectuer Exits utilisateur Définition du CCSID du gestionnaire de files d attente pour MQSeries pour AS/ Chapitre 6. Planification de l installation des clients MQSeries Applications sur les clients de la version Client AIX : Configurations matérielle et logicielle requises Configuration matérielle Logiciels Compilateurs d applications MQSeries sur clients AIX Composants pour AIX Client Digital UNIX : Configurations matérielle et logicielle requises Matériel Logiciels Compilateurs d applications MQSeries sur clients Digital UNIX Client DOS : Configurations matérielle et logicielle requises Matériel Logiciels Compilateurs d applications MQSeries sur clients DOS Composants pour DOS Client HP-UX : Configurations matérielle et logicielle requises Matériel Logiciels Compilateurs d applications MQSeries pour clients HP-UX Composants pour HP-UX Client OS/2 Warp : Configurations matérielle et logicielle requises Matériel Logiciels Compilateurs d applications MQSeries pour clients OS/2 Warp Composants pour OS/2 Warp Client Sun Solaris : Configurations matérielle et logicielle requises Matériel Logiciels Compilateurs d applications MQSeries pour clients Sun Solaris Composants pour Sun Solaris Client Windows 3.1 : Configurations matérielle et logicielle requises Matériel Logiciels Compilateurs d applications MQSeries pour clients Windows Composants pour Windows Clients Windows 95 et Windows 98 : Configurations matérielle et logicielle requises 56 Matériel Logiciels Compilateurs d applications MQSeries pour clients Windows 95 et Windows Composants pour Windows 95 et Windows Client Windows NT : Configurations matérielle et logicielle requises Matériel Logiciels Compilateurs d applications MQSeries pour clients Windows NT Composants pour Windows NT Chapitre 7. Installation des clients MQSeries Installation des composants client et serveur MQSeries sur le même poste Installation sous 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 Suppression d un client MQSeries sous AIX Installation sous DOS Utilisation de la commande setup Suppression d un client MQSeries sous DOS Installation sous HP-UX Avant l installation Installation Configuration du noyau Messages traduits iv MQSeries pour AS/400, version 5.1 Quick Beginnings

7 Suppression d un client MQSeries sous HP-UX Installation sous OS/2 Warp Installation Installation automatique sous OS/2 Warp 72 Paramètres d installation et de maintenance Fichiers de réponses d installation Suppression d un client MQSeries sous OS/2 Warp Installation sous Sun Solaris Avant l installation Installation Configuration du noyau Messages traduits Suppression d un client MQSeries sous Sun Solaris Installation sous Windows 95 ou Windows Installation Installation automatique sous Windows 95 et Windows Suppression d un client MQSeries sous Windows 95 et Windows Installation sous Windows Installation Suppression d un client MQSeries sous Windows Installation sous Windows NT Installation Installation à partir d un réseau local Utilisation de SMS avec MQSeries pour Windows NT Installation automatique sous Windows NT Suppression d un client MQSeries sous Windows NT Classes Java Configuration et vérification d un client Chapitre 8. Informations complémentaires 95 Manuels sur papier Informations en ligne CD-ROM de documentation Manuels HTML et PDF sur le Web CD-ROM au format BookManager Aide en ligne Annexe A. Programmes exemples MQI 103 Programmes exemples en langages C, COBOL et RPG Annexe B. Maintenance de MQSeries pour AS/ Réinstallation de MQSeries pour AS/ Annexe C. Remarques Marques Index Envoi de vos remarques à IBM Table des matières v

8 vi MQSeries pour AS/400, version 5.1 Quick Beginnings

9 Tableaux 1. Langues prises en charge par MQSeries pour AS/400, version Droits d accès requis pour ouvrir un objet Droits d accès requis pour Context et AlternateUserID Manuels MQSeries pour AS/ Intitulé des fichiers correspondant aux manuels MQSeries Fichiers source des programmes exemples Copyright IBM Corp vii

10 viii MQSeries pour AS/400, version 5.1 Quick Beginnings

11 Bienvenue dans l environnement MQSeries pour AS/400 Le présent manuel décrit le lociciel IBM MQSeries pour AS/400, version 5.1 ; il contient les instructions nécessaires à son installation et à son utilisation. Pour obtenir les informations les plus récentes sur MQSeries pour AS/400, version 5.1, consultez également le fichier README du CD-ROM de documentation et le site Web consacré à la gamme MQSeries, à l adresse suivante : Conventions Prenez connaissance des conventions typographiques utilisées dans ce manuel pour mieux en tirer parti. v Les caractères en gras signalent le nom d un élement à sélectionner. v Les caractères en italique font référence à de nouveaux termes, à des titres de manuels ou à des variables qui doivent être remplacées par des valeurs réelles. v Les caractères à espacement fixe signalent un exemple (comme un nom de fichier ou un chemin d accès fictif) ou un texte affiché àl écran. Copyright IBM Corp ix

12 Conventions x MQSeries pour AS/400, version 5.1 Quick Beginnings

13 Chapitre 1. À propos de MQSeries Ce chapitre présente MQSeries IBM et décrit son fonctionnement avec d autres produits. Il comporte les sections suivantes : v «Mise en file d attente des messages» v «Messages et files d attente»àla page 2 v «Objets MQSeries»àla page 3 v «Clients et serveurs»àla page 5 v «Événements outils»àla page 6 v «Support transactionnel»àla page 7 Pour une description plus détaillée, reportez-vous au manuel MQSeries - Guide de planification. Mise en file d attente des messages La mise en file d attente des messages est une méthode de communication interprogramme. Les applications peuvent échanger des messages grâce à des logiciels appropriés, et ce, indépendamment de la plateforme sur laquelle elles résident, sans se soucier des mécanismes de communication sous-jacents. Interface MQI Tous les produits MQSeries mettent en œuvre une interface de programmation commune (appelée Message Queue Interface ou MQI), indifféremment de la plateforme sur laquelle fonctionnent les applications. Les appels effectués par les applications et les messages échangés sont communs. Ainsi, l écriture et la mise à jour des applications s effectuent beaucoup plus facilement qu au moyen des méthodes traditionnelles, et leur portage d une plateforme à une autre est également simplifié. L interface MQI est décrite de façon détaillée dans le manuel MQSeries Application Programming Reference. Copyright IBM Corp

14 Mise en file d attente des messages Communication asynchrone Du fait du traitement assynchrone des échanges de données, l envoi et la réception de messages entre les applications peuvent être décalés dans le temps. Les applications sont découplées, ce qui permet à l émetteur de continuer de travailler sans devoir attendre que le destinataire accuse réception du message. En fait, il n est même pas nécessaire que l application cible soit en cours d exécution au moment de l envoi du me ssage. Elle peut néanmoins récupérer ce message dès qu elle est lancée. Processus géré par messages Une fois intégrés à la file d attente, les messages peuvent lancer automatiquement une application, selon un mécanisme appelé déclenchement. Éventuellement, les applications peuvent être arrêtées quand le ou les messages ont été traités. Messages et files d attente Les deux composantes principales d un système de mise en file d attente de messages sont les messages et les files d attente. Messages Un message est une chaîne ayant une signification pour les applications qui l utilisent. Les messages transmettent des informations d une application à une autre (ou entre différents modules d une même application). Ces applications peuvent s exécuter sur la même plateforme ou sur des plateformes différentes. Les messages MQSeries sont constitués de deux parties : les données applicatives et un descripteur de message. Le contenu et la structure des données applicatives sont définis par les programmes d application qui les utilisent. Le descripteur de message identifie le message et contient d autres informations de contrôle, comme le type du message et la priorité affectée à celui-ci par l application émettrice. Files d attente Une file d attente est une structure de données qui sert au stockage des messages. Les messages peuvent y être placés par des applications ou par un gestionnaire de files d attente dans le cadre de son fonctionnement normal. Les files d attente existent indépendamment des applications qui les utilisent. Une file d attente peut résider en mémoire centrale (si elle est temporaire), ou être stockée sur disque ou un autre support de stockage (si elle doit être conservée dans l éventualité d une procédure de restauration), ou au deux endroits (si elle est en cours d utilisation et doit parallèlement être conservée 2 MQSeries pour AS/400, version 5.1 Quick Beginnings

15 Messages et files d attente en cas de procédure de restauration). Chaque file appartient à un gestionnaire de files d attente, chargé de la gérer. Le gestionnaire place les messages reçus dans la file d attente appropriée. Une file d attente peut se trouver soit sur votre système local (il s agit d une file d attente locale), ou appartenir à un autre gestionnaire de files d attente (il s agit d une file d attente éloignée). Les applications effectuent des appels MQI pour envoyer et recevoir des messages. Une application peut ainsi placer un message dans une file d attente, d où une autre application pourra l extraire. Objets MQSeries Un objet MQSeries est une ressource récupérable gérée par MQSeries. De nombreuses tâches décrites dans ce manuel impliquent la manipulation des divers types d objet MQSeries suivants : v Gestionnaires de files d attente v Files d attente v Définitions de processus v Canaux v Listes de noms MQSeries crée des objets par défaut lorsque vous créez un gestionnaire de files d attente. Chaque objet dispose d un nom qui lui est associé. Vous pouvez indiquer ce nom pour faire référence à cet objet dans vos commandes MQSeries et appels MQI. Les noms doivent être uniques pour chaque type d objet. Par exemple, une file d attente et un processus peuvent porter le même nom, à la différence de deux files d attente. Gestionnaires de files d attente Un gestionnaire de files d attente fournit des services de mise en file d attente aux applications et gère les files d attente qui lui appartiennent. Il s assure que : v les attributs des objets sont modifiés en fonction des commandes reçues ; v les événements spéciaux (tels que les événements de déclenchement et les événements outils) sont générés quand les conditions adéquates sont réunies ; v les messages sont placés dans la file correcte conformément à la demande de l application qui a effectué l appel MQPUT. L application est informée des échecs éventuels et un code anomalie approprié est alors envoyé. Chapitre 1. À propos de MQSeries 3

16 Objets MQSeries Une file d attente ne peut appartenir qu à un seul gestionnaire ; il s agit de la file d attente locale de ce gestionnaire. Le gestionnaire de files d attente auquel une application est connectée est considéré comme le gestionnaire local. Pour cette dernière, les files d attente qui appartiennent à son gestionnaire local sont dites locales. Une file d attente éloignée est une file appartenant à un autre gestionnaire de files d attente. Un gestionnaire de files d attente éloigné désigne tout gestionnaire autre que le gestionnaire local ; il peut résider sur un poste éloigné appartenant au réseau, mais aussi sur la même machine que le gestionnaire local. MQSeries pour AS/400, version 5.1 peut prendre en charge plusieurs gestionnaires de files d attente sur la même machine. Files d attente Une file d attente est un objet MQSeries capable de conserver des messages. Chaque file d attente comporte des attributs de file d attente, qui déterminent ce qui se produit lorsque des applications font référence à cette file dans les appels MQI. Ces attributs définissent : v si les applications peuvent extraire des messages de la file (extraction activée) ; v si les applications peuvent insérer des messages dans la file (insertion activée) ; v si l accès à la file est réservé àune application ou partagé entre plusieurs applications ; v le nombre maximal de messages qui peuvent être stockés simultanément dans la file (longueur maximale de file) ; v la taille maximale des messages qui peuvent être insérés dans la file d attente (taille maximale de message). Définitions de processus Un objet définition de processus désigne une application qui doit être démarrée en réponse à un événement de déclenchement se produisant au niveau d un gestionnaire de files d attente MQSeries. Un événement de déclenchement est une combinaison logique de conditions détectée par un gestionnaire de files d attente. Par exemple, un événement de déclenchement peut être généré lorsque le nombre de messages présents dans une file d attente atteint un certain seuil prédéfini. Cet événement amène le gestionnaire à insérer un message de déclenchement dans une file d attente d initialisation indiquée. Ce message de déclenchement est récupéré par un moniteur de déclenchement, application spécifique conçue pour contrôler une file d attente d initialisation. Le moniteur de déclenchement lance alors le programme d application spécifié dans le message de déclenchement. Si un gestionnaire de files d attente doit utiliser le déclenchement, il faut définir au moins une file d attente d initialisation pour ce gestionnaire. 4 MQSeries pour AS/400, version 5.1 Quick Beginnings

17 Objets MQSeries Pour plus de détails sur le déclenchement, reportez-vous au manuel MQSeries Application Programming Guide. Canaux Le rôle d un canal est de fournir une liaison de communication entre les gestionnaires de files d attente. Il en existe deux types : les canaux de messages et les canaux MQI. Un canal de messages établit une liaison de communication entre deux gestionnaires de files d attente résidant sur la même plateforme ou sur des plateformes différentes. Il sert à transmettre les messages d un gestionnaire de files d attente à un autre, et rend transparente aux programmes d application la complexité des protocoles réseau sous-jacents. Un canal de messages ne peut transmettre les messages que dans une seule direction. Si une communication bidirectionnelle doit être établie entre deux gestionnaires de files d attente, deux canaux de messages sont alors nécessaires. Un canal MQI permet de connecter un client MQSeries à un gestionnaire de files d attente sur un serveur. Ce canal bidirectionnel peut être utilisé uniquement pour le transfert d appels (par exemple, MQPUT) et de réponses MQI. Une définition de canal existe pour chaque extrémité de la liaison. Sur certaines plateformes, certains types de canaux MQI peuvent être définis automatiquement. Pour plus de détails sur les canaux, reportez-vous au manuel MQSeries Intercommunication. Listes de noms Une liste de noms est un objet MQSeries qui contient une liste d autres objets MQSeries. Généralement, les listes de noms sont utilisées par les applications telles que les moniteurs de déclenchement, pour lesquels elles permettent d identifier une liste de files d attente. L avantage d une liste de noms est qu elle est gérée indépendamment des applications ; il est ainsi possible de la mettre à jour sans devoir arrêter les applications qui l utilisent. De plus, si une application échoue, la liste de noms n en est pas affectée et d autres applications peuvent continuer de l utiliser. Clients et serveurs MQSeries prend en charge les configurations client-serveur pour les applications MQSeries. Un client MQSeries fait partie du produit MQSeries qui est installé sur une machine pour recevoir des appels MQI d une application et les transférer à un Chapitre 1. À propos de MQSeries 5

18 Clients et serveurs serveur MQI. Les appels sont traités sur ce serveur par un gestionnaire de files d attente. En général, le client et le serveur résident sur deux machines distinctes, mais ils peuvent cohabiter sur une même machine. Un serveur MQI est un gestionnaire de files d attente qui fournit des fonctions de gestion de files à un ou plusieurs clients. Tous les objets MQSeries (par exemple les files d attente) n existent que sur la machine du gestionnaire de files, c est-à-dire sur le serveur MQI. Un serveur peut également prendre en charge des applications MQSeries locales. Les principaux avantages de l utilisation d un client MQSeries sont les suivants : v Configuration matérielle réduite, v Administration système réduite, v Faible encombrement au niveau de l installation, v Possibilité d utiliser des canaux faisant appel à des protocoles de transmission différents. Pour plus de détails sur les clients, leur prise en charge, et la création de canaux pour clients et serveurs, reportez-vous au manuel MQSeries - Clients. Événements outils Les événements outils MQSeries permettent de contrôler le fonctionnement des gestionnaires de files d attente. Les événements outils génèrent des messages spéciaux, appelés messages d événement, lorsque le gestionnaire de files d attente détecte une série de conditions prédéfinies. Par exemple, les conditions suivantes provoquent un événement File d attente saturée : v les événements File d attente saturée sont activés pour une file d attente particulière et v une application émet un appel MQPUT pour insérer un message dans cette file d attente, mais l appel échoue car la file est saturée. D autres conditions peuvent générer des événements outils : v Le nombre maximal de messages autorisés dans une file d attente est atteint. v Une file d attente n a pas été gérée pendant une période déterminée. v Une instance de canal est démarrée ou arrêtée. Si vous définissez vos files d attente d événements en tant que files d attente éloignées, vous pouvez toutes les placer sous le contrôle du même gestionnaire de files d attente (pour les nœuds prenant en charge les événements outils). Vous pouvez ensuite utiliser les événements générés pour contrôler un réseau de gestionnaires de files d attente depuis un seul nœud. 6 MQSeries pour AS/400, version 5.1 Quick Beginnings

19 Événements outils Types d événements Les événements MQSeries se répartissent dans les catégories suivantes : Événement de gestionnaire de files d attente Ces événements concernent les définitions de ressources dans les gestionnaires de files d attente Par exemple, si une application tente d ouvrir une file d attente et que l ID utilisateur associé ne dispose pas du droit d accès requis, un événement de gestionnaire de files d attente est généré. Événements Performances Ces événements signalent qu un seuil a été atteint par une ressource. Par exemple, une file d attente a atteint sa limite de longueur à la suite d une demande MQGET, ou bien elle n a pas été gérée depuis une durée prédéfinie. Événements Canal Ces événements sont signalés par les canaux, à la suite de conditions détectées lors de leur fonctionnement (par exemple, un événement Canal est généré lors de l arrêt d une instance de canal). Support transactionnel Un programme d application peut regrouper une série de mises à jour de données dans une unité de travail. En général, ces mises à jour sont toutes liées logiquement et doivent réussir pour que l intégrité des données soit préservée. Si une mise à jour aboutissait et qu une autre échouait, cette intégrité serait perdue. Une unité de travail est validée lorsqu elle aboutit. À ce moment-là, toutes les mises à jour contenues dans cette unité de travail deviennent permanentes et irréversibles. À l inverse, si l unité de travail échoue, toutes les mises à jour sont annulées. Le processus qui est appelé coordination des points de synchronisation permet de valider ou d annuler une unité de travail en préservant l intégrité des données. Dans une unité de travail locale, les seules ressources mises à jour appartiennent au gestionnaire de files d attente MQSeries. La coordination de synchronisation est assurée par le gestionnaire lui-même, au cours d une procédure de validation en une phase. Dans une unité de travail globale, les ressources appartenant à d autres gestionnaires de ressources (par exemple une base de données DB2/400) sont également mises à jour. Dans ce cas, il convient d utiliser une procédure de validation en deux phases, l unité de travail pouvant être coordonnée en externe par le contrôleur de validation du système d exploitation. Chapitre 1. À propos de MQSeries 7

20 Support transactionnel Les unités de travail globales permettent d intégrer des mises à jour de base de données à des unités de travail MQSeries. En d autres termes, vous pouvez écrire une application mettant à jour à la fois des files d attente MQSeries et des bases de données. Vous pouvez alors utiliser ces commandes pour valider ou annuler les modifications apportées aussi bien aux files d attente qu aux bases de données. Pour ce faire, le contrôleur de validation du système d exploitation utilise une procédure de validation en deux phases. Lorsqu une unité de travail doit être validée, il commence par demander à chacun des gestionnaires de ressources intervenants s il est prêt à valider ses propres mises à jour. Ce n est que si tous les intervenants, y compris le gestionnaire de files d attente, sont prêts à valider, que les modifications apportées aux files d attente et aux bases de données deviendront effectives. En revanche, si le gestionnaire de base de données n est pas prêt, l unité de travail est annulée. En outre, un outil de récupération intégrale a été prévu, au cas où le gestionnaire de files d attente perdrait le contact avec le gestionnaire de base de données durant la procédure de validation. Si ce dernier devenait indisponible alors qu il se trouve en phase d attente (c est-à-dire qu il a été appelé àvalider, mais n a toujours pas reçu de décision de validation ou d annulation), le contrôleur de validation réservera l issue à attribuer à l u nité de travail jusqu à ce qu il soit à nouveau disponible. De même, si le gestionnaire de files d attente est arrêté alors qu il y a des opérations de validation en cours, celles-ci seront conservées lorsqu il est relancé. 8 MQSeries pour AS/400, version 5.1 Quick Beginnings

21 Chapitre 2. Nouveautés de MQSeries pour AS/400, version 5.1 MQSeries pour AS/400, version 5.1 est une mise à jour de MQSeries pour AS/400, version Ne se limitant pas à une simple mise à niveau des fonctionnalités du produit, cette version intègre désormais de nouvelles fonctions essentielles et a entraîné une refonte complète de la conception du produit. MQSeries pour AS/400, version 5.1 est donc au même niveau fonctionnel que les autres produits de la version 5.1, toutes plateformes confondues : v MQSeries pour AIX v MQSeries pour OS/2 v MQSeries pour HP-UX v MQSeries pour Sun Solaris v MQSeries pour Windows NT Les principales modifications apportées au produit sont les suivantes : Clusters de gestionnaires de files d attente MQSeries Vous pouvez réunir plusieurs gestionnaires de files d attente au sein d un cluster. Dans un cluster, chaque gestionnaire peut mettre ses propres files d attente à la disposition de tous les autres gestionnaires. Tout gestionnaire de files d attente peut envoyer un message à tout autre gestionnaire du même cluster sans qu il soit nécessaire de définir des canaux explicites, des files d attente éloignées ou des files d attente de transmission pour chaque destination. Les principaux bénéfices sont les suivants : v Allègement des tâches d administration système v Taux de disponibilité accru v Équilibrage des charges Les clusters sont pris en charge par tous les produits MQSeries de la version 5.1, ainsi que par MQSeries pour OS/390, version 2.1. Pour plus de détails, reportez-vous au manuel MQSeries Queue Manager Clusters. Interface d administration MQSeries (MQAI) L interface d administration MQSeries est une interface de programmation qui simplifie le traitement des messages PCF MQSeries dans le cadre des tâches d administration. Elle est décrite dans le manuel MQSeries Administration Interface Programming Guide and Reference. Copyright IBM Corp

22 Nouveautés Prise en charge des clients Windows 98 Vous pouvez connecter un client Windows 98 au serveur MQSeries pour AS/400, version 5.1. Prise en charge de Java Les classes MQSeries pour Java prennent en charge MQSeries pour AS/400, version 5.1. Nouveaux appels MQSeries pour AS/400, version 5.1 prend en charge les nouveaux appels suivants : v MQCONNX, qui permet de spécifier les options de connexion d un gestionnaire de files d attente. v MQCMIT, MQBACK et MQBEGIN, qui permettent à MQSeries de coordonner une unité de travail locale. Validation en deux phases En tant que ressource de validation en deux phases, MQSeries pour AS/400, version 5.1 participe au traitement des unités de travail (UOW) globales gérées par l OS/400. Création automatique d objets Lors de la création d un gestionnaire de files d attente, MQSeries pour AS/400, version 5.1 crée automatiquement des objets par défaut. Conversion du caractère EBCDIC de nouvelle ligne Vous pouvez commander la conversion des caractères EBCDIC de nouvelle ligne, ce qui garantit que les données transmises entre systèmes EBCDIC et systèmes ASCII ne sont pas altérées par la conversion ASCII. Gestionnaires de files d attente multiples MQSeries pour AS/400 prend désormais en charge les gestionnaires de files d attente multiples. Parmi ces gestionnaires, vous pouvez désigner un gestionnaire par défaut. Ainsi, pour toutes les actions applicables à ce gestionnaire, il est inutile de spécifier son nom dans les commandes. Niveau de priorité des travaux Les utilisateurs peuvent définir individuellement le niveau de priorité de chaque travail MQSeries, par exemple les agents Canal. Sous-système MQSeries MQSeries pour AS/400, version 5.1 dispose de son propre sous-système. Les versions précédentes recouraient à QSYSWRK. Prise en charge de l euro MQSeries prend en charge les nouvelles pages de codes et les pages 10 MQSeries pour AS/400, version 5.1 Quick Beginnings

23 Nouveautés de codes modifiées contenant le symbole de l euro. Pour plus de détails, reportez-vous au manuel MQSeries Application Programming Reference. Canaux à unités d exécution multiples MQSeries pour AS/400, version 5.1 prend en charge les canaux à unités d exécution multiples. Applications à unités d exécution multiples MQSeries pour AS/400, version 5.1 prend en charge les applications à unités d exécution multiples. Taille d une file d attente de messages Une file d attente de messages peut désormais atteindre la taille de 2 Go. Taille des messages Un message peut désormais atteindre la taille de 100 Mo. Application d administration L application d administration n est plus prise en charge dans MQSeries pour AS/400, version 5.1. Chapitre 2. Nouveautés de MQSeries pour AS/400, version

24 Nouveautés 12 MQSeries pour AS/400, version 5.1 Quick Beginnings

25 Chapitre 3. Préparation à l installation du serveur MQSeries pour AS/400 Le présent chapitre récapitule les éléments nécessaires pour utiliser MQSeries pour AS/400. Il présente les compilateurs et protocoles de réseau pris en charge, ainsi que le support de livraison et les différents composants du produit. Les informations fournies dans ce chapitre ne s appliquent qu à l environnement serveur. Pour plus de détails sur les environnements client, reportez-vous au «Chapitre 6. Planification de l installation des clients MQSeries»àla page 47. Configuration matérielle requise MQSeries pour AS/400, version 5.1 fonctionne sur toute machine capable d exécuter l OS/400 version 4 édition 4 et dotée de suffisamment de mémoire pour répondre à la fois aux exigences des logiciels requis, de MQSeries pour AS/400, version 5.1, des méthodes d accès et des programmes d application (IBM ou autres). Les détails de la configuration requise dépendent des composants que vous installez et de l espace de travail dont vous avez besoin. Lequel espace de travail dépend du nombre de files d attente que vous utilisez, du nombre et de la taille des messages placés dans ces files d attente et du caractère, persistant ou non, des messages. Une certaine capacité d archivage, sur disque, sur bande ou sur tout autre support, est également requise. Espace disque requis MQSeries pour AS/400, version 5.1 requiert environ 60 Mo d espace disque pour le code de base et le serveur. Configuration logicielle requise 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. OS/400 version 4 édition 4 Copyright IBM Corp

26 Connectivité Connectivité Les protocoles de réseau pris en charge par MQSeries pour AS/400 sont les suivants : v TCP v SNA LU 6.2 Répertoires et bibliothèques d installation sur l AS/400 MQSeries pour AS/400 s installe dans la structure de bibliothèques de l AS/400 et utilise aussi les répertoires du système de fichiers racine IFS. Structure des bibliothèques AS/400 L installation de MQSeries pour AS/400 entraîne la création des bibliothèques suivantes : QMQM Bibliothèque du produit de base MQSeries. QMQMSAMP Bibliothèque des exemples MQSeries (si vous avez choisi d installer les exemples). QMQM29xx Bibliothèque contenant un fichier de messages dans votre langue. Ce fichier de messages est automatiquement copié dans le répertoire QSYS29xx approprié lors de l installation du produit. MQSeries pour AS/400, version 5.1 est disponible dans les langues suivantes : Tableau 1. Langues prises en charge par MQSeries pour AS/400, version 5.1 ID langue Langue 2909 Anglais (Belgique) 2966 Français (Belgique) MNCS (Jeu de caractères multinational) 2981 Français (Canada) MNCS 2950 Anglais majuscules 2924 Anglais majuscules et minuscules 2938 Anglais majuscules DBCS (Jeu de caractères à deux octets) 2984 Anglais majuscules et minuscules DBCS 2928 Français 2940 Français MNCS 2932 Italien 2942 Italien MNCS 2931 Espagnol 2962 Japonais 2986 Coréen 2989 Chinois simplifié 14 MQSeries pour AS/400, version 5.1 Quick Beginnings

27 Remarque : La version en langue japonaise de ce produit ne s exécute pas correctement si le CCSID du travail est Pour plus de détails sur les CCSID à utiliser avec cette version, reportez-vous au fichier Readme. Bibliothèque QMxxxx Chaque fois que vous créez un gestionnaire de files d attente, MQSeries crée automatiquement une bibliothèque associée. Celle-ci contient des objets propres au gestionnaire de files d attente, comprenant des journaux et des récepteurs associés. Le nom de cette bibliothèque est dérivé du nom du gestionnaire de files d attente, préfixé des caractères QM. Ainsi, pour un gestionnaire de files d attente nommé TEST, la bibliothèque créée s appellerait QMTEST. La commande WRKLIB vous permet d obtenir la liste de toutes les bibliothèques créées par MQSeries pour AS/400. En regard de chaque bibliothèque s inscrit la mention QMGR: NOMGESTFILES. La syntaxe de cette commande est la suivante : WRKLIB LIB(QM*) Ces bibliothèques associées à des gestionnaires de files d attente sont conservées lorsque le produit est supprimé. Connectivité Système de fichiers racine IFS Le système de fichiers intégré (Integrated File System ou IFS) offre une interface commune aux différents systèmes présents sur l AS/400. Lors de l installation de MQSeries pour AS/400, version 5.1, deux répertoires sont créés dans le système de fichiers racine. Ils agit de : /QIBM/ProdData/mqm Les sous-répertoires de ce répertoire contiennent toutes les données du produit, par exemple les classes C++. Ces données sont supprimées et remplacées à chaque nouvelle installation du produit. /QIBM/UserData/mqm Les sous-répertoires de ce répertoire contiennent toutes les données utilisateur liées aux gestionnaires de files d attente. Trois sous-répertoires (QIBM/UserData/mqm/errors, /QIBM/UserData/mqm/qmgrs et /QIBM/UserData/mqm/trace) sont également créés lors de l installation du produit. Lorsque vous installez le produit, un fichier mqs.ini est créé dans le répertoire /QIBM/UserData/mqm/ (sauf s il existe déjà suite à une installation antérieure). Lorsque vous créez un gestionnaire de files d attente, un fichier qm.ini est créé dans le répertoire /QIBM/UserData/mqm/qmgrs/NOMGESTFILES/ (NOMGESTFILES Chapitre 3. Préparation à l installation du serveur MQSeries pour AS/400 15

28 Connectivité étant le nom de ce gestionnaire de files d attente.) Le fichier qm.ini est l équivalent du fichier QMINI des versions précédentes de MQSeries pour AS/400. Les données de ce répertoire sont conservées lorsque le produit est supprimé. La structure de fichiers IFS est décrite dans le manuel MQSeries for AS/400 V5.1 System Administration. Profils utilisateur Lors de l installation de MQSeries pour AS/400, version 5.1, un certain nombre de profils utilisateur sont créés, parmi lesquels QMQM, QMQMADM et NOBODY. Ces trois objets sont essentiels au bon fonctionnement de MQSeries pour AS/400. Vous ne devez en aucun cas les modifier ou les supprimer. Si vous le faites, IBM ne garantit pas le bon fonctionnement de votre produit. Ces profils sont conservés lorsque le produit est supprimé. Compilateurs utilisables pour la création d applications MQSeries pour AS/400, version 5.1 MQSeries pour AS/400, version 5.1 prend en charge les compilateurs suivants : v Compilateur IBM ILE C pour AS/400 (5768-CX2) v Compilateur IBM ILE C++ pour AS/400 (5799-GDW) v Compilateur IBM VisualAge C++ pour AS/400 (5769-CX4) v Compilateur IBM ILE COBOL pour AS/400, version 3 (5769-CB1) v Compilateur IBM ILE RPG pour AS/400 (5769-RG1) v Kit de développement Java pour AS/400 (5769-JV1) Support de livraison MQSeries pour AS/400, version 5.1 est livré sur CD-ROM. Trois CD-ROM sont fournis : v Le premier contient le produit de base et les programmes exemples. v Le deuxième contient les logiciels client utilisables avec MQSeries pour AS/400. v Le troisième contient la documentation MQSeries pour AS/400. Le support de Java est assuré sur le site Web MQSeries, à l adresse suivante : 16 MQSeries pour AS/400, version 5.1 Quick Beginnings

29 Composants MQSeries pour AS/400 Composants MQSeries pour AS/400 Les différents composants sont les suivants : Produit de base Module permettant de créer et de prendre en charge vos propres applications. Il comprend le composant run-time nécessaire à la prise en charge des applications externes et assure également la prise en charge des connexions client émanant d autres produits MQSeries. Exemples Programmes exemples. Les fichiers source se trouvent dans la bibliothèque QMQMSAMP, et les exécutables, dans la bibliothèque QMQM. Reportez-vous à l «Annexe A. Programmes exemples MQI» à la page 103. Documentation en ligne MQSeries Les manuels sont fournis aux formats HTML et PDF sur le CD-ROM contenant la documentation. Ils ne font pas l objet d une procédure d installation particulière. Vous pouvez les consulter directement à partir du CD-ROM, ou bien les copier sur votre système. Par exemple, vous pouvez les copier sur le disque dur de votre ordinateur, ou les stocker dans le système IFS de votre AS/400 et y accéder en vous connectant à une unité réseau. Chaque manuel est fourni en anglais et, pour certains d entre eux, dans une ou plusieurs des langues suivantes : v Français v Allemand v Italien v Japonais v Coréen v Espagnol v Chinois simplifié Pour plus de détails, reportez-vous à la section «Chapitre 8. Informations complémentaires» àla page 95. Fichier Readme Informations de dernière minute sur le produit, mises à disposition après la publication de ce manuel. Le fichier Readme se trouve sur le CD-ROM de documentation ; lisez-le avant de lancer l installation de MQSeries pour AS/400. Pour plus de détails, reportez-vous au «Chapitre 8. Informations complémentaires»àla page 95. Création des objets par défaut du système Ces objets sont créés automatiquement lorsque vous lancez la commande CRTMQM de création d un gestionnaire de files d attente. Chapitre 3. Préparation à l installation du serveur MQSeries pour AS/400 17

30 Composants MQSeries pour AS/400 Vous pouvez les régénérer à l aide de la commande STRMQM. Pour plus d informations sur l utilisation de cette commande, reportez-vous à l aide en ligne. 18 MQSeries pour AS/400, version 5.1 Quick Beginnings

31 Chapitre 4. Procédures d installation, de migration et de suppression de MQSeries pour AS/400 Le présent chapitre décrit l installation de MQSeries pour AS/400, version 5.1 et la migration vers cette nouvelle version. Il aborde les points suivants : v «Avant l installation» v «Procédure d installation»àla page 21 v «Vérification de l installation» àla page 22 v «Mise au repos de MQSeries» àla page 23 v «Migration vers MQSeries pour AS/400, version 5.1» àla page 25 v «Vérification de la migration» àla page 30 v «Suppression de MQSeries pour AS/400, version 5.1» àla page 32 En plus de la lecture de ce chapitre, lisez également le fichier README qui se trouve sur le CD-ROM de documentation et consultez les informations les plus récentes disponibles sur le site Web MQSeries, à l adresse suivante : Avant l installation Si vous effectuez une migration à partir d une version antérieure de MQSeries pour AS/400, reportez-vous à la section «Migration vers MQSeries pour AS/400, version 5.1»àla page 25. Le système d exploitation OS/400 V4R4 doit obligatoirement être installé sur votre machine pour pouvoir exécuter MQSeries pour AS/400, version 5.1. Si vous disposez du système d exploitation OS/400 V4R2 ou V4R3, vous pouvez seulement utiliser MQSeries pour AS/400 version Définition des valeurs système Avant d installer MQSeries pour AS/400, utilisez la commande DSPSYSVAL pour vérifier que les valeurs système suivantes sont définies conformément aux besoins de votre entreprise : v QCCSID v QUTCOFFSET v QSYSLIBL v QALWOBJRST Si nécessaire, vous pouvez modifier ces valeurs à l aide de la commande CHGSYSVAL. Copyright IBM Corp

32 Avant l installation QCCSID Chaque message contient dans son en-tête un identificateur de jeu de caractères codés (CCSID). Ce CCSID identifie la page de codes et le jeu de caractères de la source. Pour connaître les CCSID pris en charge sur l AS/400, consultez le manuel AS/400 National Language Support. La valeur du CCSID est tirée, à la création d un gestionnaire de files d attente, du CCSID du travail. Si ce dernier ne contient pas une valeur valide (située entre 1 et 65534), c est le CCSID par défaut du travail qui est utilisé. Remarque : Le CCSID doit désigner soit un jeu de caractères SBCS, soit un jeu mixte, c est-à-dire SBCS et DBCS. Il ne doit pas désigner uniquement un jeu DBCS. Vous pouvez modifier, à l aide de la commande CL CHGMQM, le CCSID utilisé par le gestionnaire de files d attente MQSeries. Pour plus de détails, reportez-vous à la section «Définition du CCSID du gestionnaire de files d attente pour MQSeries pour AS/400» àla page 46. QUTCOFFSET Vérifiez que la valeur représentant le décalage par rapport au Temps Universel Coordonné ou UTC (QUTCOFFSET) a bien été définie et indique l écart entre l heure système et l heure GMT (Greenwich Mean Time). Pour cela, utilisez la commande CHGSYSVAL. Si la valeur QUTCOFFSET n est pas définie, elle prend la valeur par défaut de zéro. MQSeries pour AS/400 considère alors que l heure locale du système est l heure UTC (ou GMT) et horodate les messages en conséquence. QSYSLIBL Assurez-vous que QSYS2 figure bien dans la liste des bibliothèques qui composent la partie système de cette liste. MQSeries pour AS/400 utilise les programmes de cette bibliothèque pour convertir des données et communiquer sous SNA LU 6.2. QALWOBJRST Assurez-vous que la valeur système QALWOBJRST est définie sur *ALL ou *ALWPGMADP avant d installer MQSeries pour AS/400. Si elle est définie sur *NONE, l installation échouera. Après l installation, rétablissez la valeur d origine de QALWOBJRST pour préserver la sécurité du système. 20 MQSeries pour AS/400, version 5.1 Quick Beginnings

33 Procédure d installation 1. Pour installer le produit de base MQSeries pour AS/400, version 5.1, lancez la commande suivante : RSTLICPGM LICPGM(5733A38)DEV(unité installation)option(*base) où : v 5733A38 est le code produit de MQSeries pour AS/400, version 5.1 ; v unité installation est l unité àpartir de laquelle le produit doit être chargé, c est-à-dire en général un CD-ROM, par exemple OPT Pour installer les applications exemples, lancez la commande suivante : RSTLICPGM LICPGM(5733A38)DEV(unité installation)option(1) Remarque : Vous ne pouvez installer qu une instance de MQSeries for AS/400 sur chaque partition de votre machine AS/400. Installation d autres versions traduites MQSeries pour AS/400 s installe dans la langue correspondant à la langue principale de votre système. Vous pouvez installer d autres versions du produit, disponibles dans les langues indiquées au tableau 1 à la page 14. Pour cela, utilisez la commande suivante, en précisant l ID de langue voulu : RSTLICPGM LICPGM(5733A38)DEV(unité installation)rstobj(*lng)lng(id langue) Cette commande entraîne l installation des commandes, du fichier de messages et des groupes d écrans dans la bibliothèque QSYS correspondant à la langue choisie. Par exemple, la bibliothèque QSYS2928 est utilisée pour le français. Réinstallation La réinstallation du produit est décrite à la section «Réinstallation de MQSeries pour AS/400»àla page 107. Installation Chapitre 4. Procédures d installation, de migration et de suppression de MQSeries pour AS/400 21

34 Vérification de l installation Vérification de l installation Pour vous assurer que le produit a été correctement installé, lancez la commande DSPSFWRSC (Display Software Resources) : le programme sous licence 5733A38 doit figurer dans la liste. Si vous avez installé le produit de base et les exemples, les lignes suivantes s affichent : Ressource ID Option Dispositif Description 5733A38 *BASE 5050 MQSeries pour AS/ A38 *BASE 2924 MQSeries pour AS/ A MQSeries pour AS/400 - Exemples Si vous appuyez sur F11 lorsque l écran des ressources système s affiche, la bibliothèque et le numéro de version des produits installés apparaissent : Ressource Dispositif ID Option Dispositif Type Bibliothèque Version 5733A38 *BASE 5050 *CODE QMQM V5R1M0 5733A38 *BASE 2924 *LNG QMQM V5R1M0 5733A *CODE QMQMSAMP V5R1M0 Si vous avez installé d autres versions traduites, elles apparaissent également. Si, par exemple, vous avez installé la version française (ID langue = 2928) du produit, la ligne suivante est affichée : Ressource ID Option Dispositif Description 5733A38 *BASE 2928 MQSeries pour AS/400 et lorsque vous appuyez sur F11 : Ressource Dispositif ID Option Dispositif Type Bibliothèque Version 5733A38 *BASE 2928 *LNG QSYS2928 V5R1M0 Tâches à effectuer après l installation À l issue de l installation de MQSeries pour AS/400, version 5.1 sur votre système, effectuez les opérations ci-dessous. 1. Consultez le site Web MQSeries, à l adresse suivante : Vous pourrez ainsi obtenir les informations les plus récentes sur le produit, et installer toutes les PTF (correctifs temporaires de programme) recommandées. 2. Lancez le sous-système MQSeries à l aide de la commande suivante : STRSBS SBSD(QMQM/QMQM) 22 MQSeries pour AS/400, version 5.1 Quick Beginnings