Guide de l'utilisateur
Cette page décrit le mode de configuration de MQSeries Internet
Gateway vous permettant d'utiliser vos propres
ressources et applications MQSeries.
Elle traite les rubriques suivantes :
Les mots clés indiqués ci-dessous transmettent les informations
déterminant les ressources MQSeries utilisées par les messages envoyés via MQSeries
Internet Gateway.
- MQIGwQueue
- Nom de file d'attente d'application MQSeries - file d'attente
dans laquelle le message est inséré.
- MQIGwReplyQueue
- Nom de file d'attente MQSeries Gateway - file d'attente à
partir de laquelle MQSeries Internet Gateway extrait des messages.
- MQIGwQueueManager
- Nom du gestionnaire de files d'attente MQSeries à utiliser.
- MQIGwWaitInterval
- Délai d'attente d'une réponse par la passerelle (exprimé en
millisecondes).
- MQIGwWaitHTML
- Nom du fichier HTML devant s'afficher en cas de dépassement du
délai d'attente.
Ce fichier HTML doit contenir un message signalant
l'expiration du délai d'attente ainsi qu'un
bouton permettant l'extraction de la réponse à une date ultérieure. Reportez-vous
à la rubrique
Création de formulaires HTML pour MQSeries Internet Gateway
pour consulter un exemple de page relative à l'expiration
d'un délai, timedout.htm ; cet exemple se trouve dans
répertoire de fichiers Gateway créé
lors de l'installation.
- MQIGwContext
- Informations contextuelles devant être envoyées à
l'application.
Ce mot clé peut être défini par les valeurs suivantes :
- Aucune
- Aucune information contextuelle n'est transmise à l'application
serveur.
- Toutes
- Toutes les informations contextuelles suivantes sont transmises à
l'application serveur :
- AUTH_TYPE | - REQUEST_METHOD | - QUERY_STRING |
- HTTP_ACCEPT | - REMOTE_HOST | - REMOTE_USER |
- HTTP_REFERER | - REMOTE_ADDR | - REMOTE_IDENT |
- HTTP_USER_AGENT | - SCRIPT_NAME | - SERVER_SOFTWARE |
- HTTP_RESPONSE | - CONTENT_TYPE | - SERVER_NAME |
- HTTP_REASON | - CONTENT_LENGTH | - GATEWAY_INTERFACE |
- SERVER_PROTOCOL | - PATH_INFO |
- SERVER_PORT | - PATH_TRANSLATED |
Cliquez ici pour consulter des exemples
d'informations renvoyées lorsque ce mot clé est défini.
- MQIGwIniFile
- Nom d'un fichier INI pouvant être utilisé pour stocker les
valeurs par défaut de tout autre mot clé.
La valeur de ces mots clés peut être déterminée de l'une des façons
suivantes :
- Tous les mots clés peuvent être définis par des valeurs
spécifiées dans le formulaire HTML utilisé pour l'envoi de messages
via la passerelle.
Remarque : Vous ne pouvez pas définir
MQIGwIniFile à un autre emplacement lorsque vous
souhaitez utiliser des valeurs stockées dans votre propre fichier
'INI'. (Voir l'étape (2) ci-dessous.)
- Vous pouvez stocker les valeurs de mots clés dans vos propres
fichiers 'INI'.
- Les valeurs par défaut des mots clés ci-dessous sont fournies
dans le fichier 'dmq.ini' livré avec MQSeries Internet Gateway
et situé dans le répertoire /var/mqm sur les plateformes UNIX et dans
le répertoire mqm\bin sous OS/2 et WindowsNT.
- MQIGwReplyQueue
- DMQGATEWAY
- MQIGwWaitInterval
- 10000 ms
- MQIGwContext
- Tous
Remarque : Bien qu'il soit possible de définir un mot
clé à un ou tous les emplacements indiqués ci-dessus, prenez garde
de ne pas définir un mot clé particulier plus d'une fois à
un même emplacement, sous peine de conséquences imprévisibles.
MQSeries Internet Gateway recherche les diverses sources de
définition d'un mot clé, en procédant dans l'ordre suivant :
- le formulaire HTML ;
- le fichier 'INI' spécifié dans le mot clé MQIGwIniFile ;
- le fichier dmq.ini.
Si l'application ne trouve aucune valeur correcte pour les mots clés
suivants, elle utilise les valeurs par défaut :
- MQIGwQueueManager
- Par défaut, gestionnaire de files d'attente MQSeries.
Remarque : Sur MVS, aucun gestionnaire de files
d'attente par défaut n'est défini ; vous devez donc définir la valeur de
MQIGwQueueManager selon l'une des méthodes décrites
ci-dessus.
- MQIGwWaitInterval
- Par défaut, délai d'attente illimité.
- MQIGwWaitHTML
- Par défaut, fichier 'timedout.htm' stocké dans le
répertoire de fichiers Gateway
créé lors de l'installation.
- MQIGwContext
- Par défaut, Toutes.
Si l'application ne trouve aucune valeur correcte pour les mots clés
suivants, la transaction ne peut pas aboutir et un message d'erreur
est envoyé :
- MQIGwQueue
- MQIGwReplyQueue
- MQIGwQueueManager
Vous pouvez modifier les valeurs par défaut des mots clés dans le
fichier 'dmq.ini' et également créer vos propres fichiers 'INI'
pour stocker les valeurs.
Un programme de configuration est livré avec
MQSeries Internet Gateway pour vous aider à modifier ou à créer le
fichier par défaut, ainsi que pour créer vos propres fichiers 'INI'.
Remarque : Il est fortement recommandé d'utiliser ce
programme et non un simple éditeur pour la modification de vos
fichiers 'INI'. En effet, l'utilisation d'un éditeur est susceptible
d'altérer le format des fichiers 'INI'.
Le programme de configuration est fourni au format de fichier
HTML qui peut être exécuté dans un navigateur Web.
Procédez
comme suit pour effectuer les opérations de configuration.
- Ouvrez le fichier MQSeries Internet Gateway 'dmqcnf.htm' dans votre navigateur
Web. (Remarque : Si vous êtes en train de consulter la documentation
installée sur votre poste serveur Web, ce lien est le seul moyen
d'exécuter le programme.)
Ce fichier est stocké dans le
répertoire documentation créé à
l'installation de MQSeries Internet Gateway.
- Lorsque la page s'affiche :
- si vous souhaitez modifier le fichier INI par défaut (dmq.ini)
livré avec la passerelle, cliquez sur le bouton
Envoi ;
- si vous souhaitez modifier ou créer un autre fichier INI, entrez
le nom du fichier voulu et cliquez sur Envoi.
- Une page s'affiche qui répertorie les mots clés, et leurs
valeurs courantes, du fichier que vous avez choisi.
- Pour modifier la valeur de l'un des mots clés
affichés, saisissez la nouvelle valeur en écrasant la valeur
courante.
- Pour modifier la valeur par défaut d'un autre mot clé, tapez
cette valeur dans la zone de saisie Nom et la nouvelle valeur
dans la zone Valeur.
- Pour supprimer un mot clé de la liste des valeurs par défaut,
cliquez sur la case de suppression située en regard du mot clé.
Remarque : Il est conseillé de ne pas supprimer les
mots clés MQSeries Internet Gateway dans le fichier
'dmq.ini'. Si vous supprimez MQIGwQueueManager,
MQIGwReplyQueue ou
MQIGwQueue dans ce fichier sans définir de valeurs dans
un autre fichier INI spécifié ou dans votre formulaire HTML, la transaction
risque de ne pas aboutir.
-
- Pour enregistrer vos modifications dans le fichier affiché dans
la zone Enregistrer sous, cliquez sur Validation.
- Pour enregistrer le fichier modifié sous un nouveau nom,
tapez ce dernier dans la zone Enregistrer sous
et cliquez sur Validation.
La liste des mots clés est mise à jour selon vos modifications.
Si vous avez choisi d'enregistrer un fichier existant contenant
déjà des mots clés, la liste complète des mots clés du fichier
s'affiche.
- Si vous souhaitez ajouter des mots clés supplémentaires ou
apporter d'autres modifications aux valeurs de la liste, répétez
les procédures décrites ci-dessus.
Remarque : L'insertion de blancs dans les mots
clés n'est pas autorisée.
Si vous avez modifié le fichier 'dmq.ini', les nouvelles
valeurs sont prises en compte comme valeurs par défaut lors de la
prochaine utilisation de MQSeries Internet Gateway pour l'envoi d'un
message MQ. Si vous avez modifié ou créé votre propre fichier
'INI', les nouvelles valeurs sont prises en compte lors de la
prochaine utilisation d'un formulaire dans lequel le mot clé
MQIGwIniFile spécifie le nom de votre fichier 'INI'.
![[Aide]](images/help.gif)
[ Page d'accueil |
Commande |
Recherche |
Contact IBM |
Infos légales ]
(C) IBM Corporation 1997. 1999. Tous droits réservés.