Guide de l'utilisateur
Pour utiliser les applications MQ via la passerelle Internet
MQSeries, vous devez :
- Configurer et démarrer votre serveur Web
;
- Configurer certaines ressources MQSeries
;
- Démarrer vos applications dotées de fonctions Web
;
- 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.
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.
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.
- 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.
- 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
- Démarrez le gestionnaire de files d'attente par défaut à
l'aide de la commande :
STRMQM
- 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.
- 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 :
- entrer l'ID utilisateur de votre serveur Web dans la zone
MCAUSER ;
- indiquer ' ' (sans omettre l'espace) dans la zone QMNAME si vous
utilisez le gestionnaire de files d'attente par
défaut ;
- lancer la commande suivante sur les systèmes AIX, HP_UX et
Solaris :
chmod 666 AMQCLCHL.TAB
pour vous assurer que l'ID du serveur Web dispose des droits
nécessaires à la lecture du fichier
AMQCLHCL.TAB.
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.
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.
- 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.
- Entrez les données à envoyer à l'application MQ.
- 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\'.)
- 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.
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.
![[Aide]](images/help.gif)
[ Page d'accueil |
Commande |
Recherche |
Contact IBM |
Infos légales ]
(C) IBM Corporation 1997. 1999. Tous droits réservés.