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

Guide de l'utilisateur


Configuration de MQSeries Internet Gateway

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 :


Mots clés MQSeries Internet Gateway

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 :
  1. 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.)

  2. Vous pouvez stocker les valeurs de mots clés dans vos propres fichiers 'INI'.

  3. 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 :

  1. le formulaire HTML ;
  2. le fichier 'INI' spécifié dans le mot clé MQIGwIniFile ;
  3. 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é :

Définition des mots clés

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.

  1. 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.

  2. Lorsque la page s'affiche :

  3. Une page s'affiche qui répertorie les mots clés, et leurs valeurs courantes, du fichier que vous avez choisi.

  4. 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.

  5. 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'.

[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.