Documentation IBM [Retour à la bibliothèque] [Contenu] [Rubrique précédente] [Fin de la rubrique] [Rubrique suivante] [Aide]

Guide de l'utilisateur


Vérification et utilisation de MQSeries Internet Gateway

Pour utiliser les applications MQ via la passerelle Internet MQSeries, vous devez  :
  1. Configurer et démarrer votre serveur Web  ;
  2. Configurer certaines ressources MQSeries  ;
  3. Démarrer vos applications dotées de fonctions Web  ;
  4. Entrer votre message dans un formulaire HTML spécial et le soumettre à une application MQSeries dotée de fonctions Web.
Les applications dotées de fonctions Web sont des applications conçues pour s'exécuter en interaction avec la passerelle.

Des formulaires exemples ainsi qu'une application exemple dotée de fonctions Web sont fournis avec MQSeries Internet Gateway. Vous pouvez utiliser l'exemple dmqsamp1 avec les ressources par défaut fournies pendant l'installation, pour exécuter un test initial de vérification de votre installation.

Une fois que vous avez vérifié votre système à l'aide de l'exemple mentionné, vous pouvez configurer la passerelle pour utiliser vos propres ressources, et utiliser les formulaires et applications exemples comme modèles.


Configuration et démarrage de votre serveur Web

Une fois vos fichiers MQSeries Internet Gateway installés, vous devez configurer votre serveur Web pour qu'il détecte et reconnaisse la passerelle. La configuration de tous les serveurs attribue le suffixe '.mqf' aux fichiers de programmes MQSeries Internet Gateway. Les formulaires d'entrée HTML sont identiques pour toutes les interfaces de serveur Web. Si vous utilisez plus d'une interface pour votre serveur, la passerelle utilise la première interface configurée qu'elle détecte.

Cliquez sur le nom d'un serveur Web pour afficher les procédures de configuration correspondantes.

Une fois la configuration terminée, redémarrez votre serveur Web.

Configuration de vos ressources MQSeries

Certaines ressources MQSeries par défaut sont fournies avec MQSeries Internet Gateway ; il est recommandé d'utiliser ces ressources pour vérifier votre installation initiale. Les procédures suivantes décrivent le mode de définition et d'utilisation des ressources par défaut.

Vous devez effectuer l'ensemble des opérations ci-dessous sur votre poste serveur Web. A chaque étape, vous devez vous placer dans le répertoire contenant les fichiers appelés, ou spécifier leur chemin d'accès complet dans la commande.

  1. Pour permettre au serveur Web d'accéder aux ressources MQ, vous devez inclure son nom d'utilisateur dans le groupe mqm. Si le nom de votre serveur n'est pas déjà inclus dans le groupe, ajoutez-le selon la méthode que vous maîtrisez le mieux.
    Vous devez arrêter et redémarrer votre gestionnaire de files d'attente QMGR pour que le nouveau nom soit pris en compte.
  2. Si vous ne disposez pas d'un gestionnaire MQSeries par défaut, créez-en un, appelé DMQSAMP, à l'aide de la commande suivante : CRTMQM -Q DMQSAMP

  3. Démarrez le gestionnaire de files d'attente par défaut à l'aide de la commande : STRMQM

  4. Créez les files d'attente exemples de MQSeries Internet Gateway à l'aide de la commande : RUNMQSC < DMQSAMP.TST Les files d'attente exemples sont appelées DMQSAMP1 et DMQSAMP2, et la file d'attente à partir de laquelle la passerelle extrait les messages est appelée DMQGATEWAY.

  5. Définissez les connexions client et serveur comme décrit dans la section "Création des deux définitions sur le serveur" du chapitre "Utilisation des canaux" du manuel MQSeries - Clients (GC11-1139).
    Un fichier AMQCLCHL.TAB est créé. Sur les plateformes UNIX, ce fichier doit être copié en mode binaire dans /var/mqm. Sous OS/2 et Windows NT, copiez-le dans le répertoire mqm.
    Lors de la création des définitions, vous devez :

Démarrage de vos applications dotées de fonctions Web

Démarrez les applications exemples MQSeries sur votre poste serveur à l'aide des commandes suivantes :

Sous AIX, HP-UX et Solaris
dmqsamp1 DMQSAMP1 DMQSAMP &
Sous OS/2 et Windows/NT
start dmqsamp1 DMQSAMP1 DMQSAMP
Si vous n'utilisez pas le gestionnaire de files d'attente par défaut MQSeries Internet Gateway, remplacez 'DMQSAMP' par le nom du gestionnaire que vous souhaitez utiliser.
Si vous utilisez le gestionnaire de files d'attente par défaut du système, il n'est pas nécessaire de spécifier son nom dans les commandes.

Entrer votre message dans un formulaire HTML spécial

Des formulaires exemples sont fournis dans le sous-répertoire 'mqm\dmqgate\doc' créé à l'installation de MQSeries Internet Gateway. Un formulaire permet d'exécuter le programme exemple dmqsamp1 d'émission et de réception d'un message simple. Si vous êtes en train de vérifier l'installation, utilisez les procédures décrites ci-dessous pour envoyer un message à votre système MQSeries. Pour utiliser vos propres ressources et applications, utilisez cet exemple comme modèle pour créer vos propres formulaires.
  1. Ouvrez le formulaire exemple dmqsamp1.htm dans votre navigateur Web.

    Remarque : si vous affichez ces informations sur votre poste serveur Web, vous pouvez soumettre le formulaire affiché à l'aide du lien hypertexte associé. Si tel n'est pas le cas, ce lien autorise uniquement l'affichage du formulaire.

  2. Entrez les données à envoyer à l'application MQ.

  3. Si vous utilisez un serveur Web Apache ou Lotus Domino, modifiez la ligne ACTION du fichier source exemple comme l'indique le fichier. (Le fichier source exemple affiché par le fichier 'dmqsamp1.htm' ci-dessus est le fichier 'dmqsam1d.htm' du répertoire documentation créé à l'installation de MQSeries Internet Gateway. D'autres fichiers html exemples sont stockés dans le répertoire 'install_dir\tools\dmqgate\samples\'.)

  4. Soumettez le formulaire.
Si vous êtes connecté à un serveur Web et avez effectué toutes les tâches décrites ci-dessus, votre message est envoyé via la passerelle Internet MQSeries ; une réponse est transmise en retour à votre navigateur lorsque l'application a terminé la tâche.

Cliquez ici pour consulter des exemples de réponses reçues pour les formulaires exemples.

Si, pour un motif quelconque (tel que la non exécution de l'application serveur), l'application ne peut pas répondre dans le délai d'attente défini pour la passerelle, vous recevez un message dans votre navigateur Web. La page de message comporte un bouton Relance sur lequel il vous suffit de cliquer pour vérifier si la réponse à votre message est disponible. Entre-temps, vous pouvez poursuivre vos autres tâches dans le navigateur.

Si le programme n'aboutit pas, un message d'erreur est envoyé au navigateur. Si les explications fournies par le message d'erreur ne vous permettent pas de corriger l'erreur, allez à la rubrique 'Résolution des incidents liés à MQSeries Internet Gateway' pour obtenir une aide supplémentaire.


Utilisation de vos propres ressources et applications

Après avoir vérifié votre installation à l'aide des valeurs par défaut fournies, vous pouvez configurer la passerelle pour utiliser vos propres ressources MQ et écrire vos propres applications dotées de fonctions Web et vos formulaires HTML.

Cliquez sur l'un des éléments de la liste ci-dessous pour afficher les procédures correspondantes.


[Retour à la bibliothèque] [Contenu] [Rubrique précédente] [Début de la rubrique] [Rubrique suivante] [Aide]


[ Page d'accueil | Commande | Recherche | Contact IBM | Infos légales ]
(C) IBM Corporation 1997. 1999. Tous droits réservés.