Manuales de IBM [Volver a la biblioteca] [Contenido] [Tema anterior] [Final del tema] [Tema siguiente] [Ayuda]

Guía del usuario


Configuración de MQSeries Internet Gateway

En esta página se describe cómo configurar MQSeries Internet Gateway para utilizar sus propios aplicaciones y recursos MQSeries.

Los temas que se abarcan son:


Palabras clave de MQSeries Internet Gateway

Las palabras clave siguientes contienen información sobre los recursos MQSeries que deben utilizar los mensajes que pasan a través de MQSeries Internet Gateway:
MQIGwQueue
Nombre de cola de la aplicación MQSeries - cola en la que se colocará el mensaje.
MQIGwReplyQueue
Nombre de cola de MQSeries Gateway - cola desde la que MQSeries Internet Gateway recupera los mensajes.
MQIGwQueueManager
Nombre del gestor de colas MQSeries que debe utilizarse.
MQIGwWaitInterval
Período de tiempo expresado en milisegundos durante el que la pasarela debe esperar para recibir una respuesta.
MQIGwWaitHTML
Nombre del archivo HTML que debería visualizarse si se excede el tiempo de espera.
Este archivo HTML debe contener un mensaje que indique que el tiempo de espera ha vencido y debe contener un botón que permita recuperar la respuesta al mensaje más tarde. Consulte Creación de formularios HTML para MQSeries Internet Gateway para ver un ejemplo simple de una página de tiempo de espera excedido, timedout.htm, que se halla en el directorio de archivos de Gateway de la instalación.
MQIGwContext
Información de contexto que debe enviarse a la aplicación.
Esta palabra clave puede estar establecida en dos valores:
None
No se pasa ningún tipo de información de contexto a la aplicación a la que se presta servicio.
All
Se pasa toda la información de contexto a la aplicación a la que se presta servicio:
- 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
Haga clic aquí para ver ejemplos de la información que se devuelve cuando se define esta palabra clave.
MQIGwIniFile
Nombre de un archivo INI que puede utilizarse para almacenar valores por omisión para las otras palabras clave.
El valor de estas palabras clave puede proporcionarse de distintas maneras:
  1. Todas las palabras clave pueden tener valores especificados en el formulario HTML que se utiliza para enviar mensajes a través de Gateway.
    Nota: Éste es el único lugar en el que puede definir MQIGwIniFile si desea utilizar valores que están almacenados en su archivo 'INI'. (Consulte el punto siguiente (2).)

  2. Los valores de las palabras clave pueden almacenarse en archivos 'INI' que usted designe.

  3. Los valores por omisión de las siguientes palabras clave se facilitan en el archivo 'dmq.ini' suministrado con MQSeries Internet Gateway que se encuentra en /var/mqm en las plataformas UNIX y en mqm\bin en OS/2 y WindowsNT.
    MQIGwReplyQueue
    DMQGATEWAY
    MQIGwWaitInterval
    10000 ms
    MQIGwContext
    All
Nota: Aun cuando cualquiera de las palabras clave puede definirse en cualquiera o en todas las ubicaciones descritas anteriormente, una palabra clave determinada no debe definirse más de una vez en ninguna de las ubicaciones, ya que ello podría dar lugar a resultados imprevisibles.

MQSeries Internet Gateway busca las distintas fuentes de definición de palabras clave por este orden:

  1. En el formulario HTML
  2. En el archivo 'INI' que indica la palabra clave MQIGwIniFile
  3. En el archivo dmq.ini
Si no se encuentra ningún archivo válido para las palabras clave que se indican a continuación, se utilizan los valores por omisión básicos:
MQIGwQueueManager
El valor por omisión básico es el gestor de colas MQSeries por omisión.
Nota: En MVS no existe ningún gestor de colas por omisión, por lo que debe definirse el valor de MQIGwQueueManager siguiendo alguno de los métodos descritos anteriormente.

MQIGwWaitInterval
El valor por omisión básico es un intervalo de espera ilimitado.

MQIGwWaitHTML
El valor por omisión básico es el archivo 'timedout.htm', que está almacenado en el directorio de archivos de Gateway de la instalación.

MQIGwContext
El valor por omisión básico es all.
Si no se encuentran valores válidos para ninguna de las palabras clave siguientes, la transacción no puede completarse y se visualiza un mensaje de error:

Definición de las palabras clave

Si lo desea, puede cambiar los valores por omisión de las palabras clave en el archivo 'dmq.ini' y, asimismo, puede crear sus propios archivos 'INI' para almacenar los valores de las palabras clave.

MQSeries Internet Gateway incluye un programa de configuración que le servirá de ayuda para cambiar y crear el archivo 'INI' por omisión y sus propios archivos 'INI'.
Nota: Es muy recomendable utilizar este programa en lugar de utilizar un editor para modificar o editar los archivos 'INI'. Un editor convencional podría corromper el formato de los archivos 'INI'.

El configurador se suministra en formato de archivo HTML que puede ejecutarse en un navegador Web.

Siga el procedimiento que se indica a continuación para llevar a cabo la configuración.

  1. Abra el archivo 'dmqcnf.htm' de MQSeries Internet Gateway en el navegador Web. (Nota: El programa sólo se ejecutará desde este enlace si está visualizando la documentación que está instalada en la máquina del servidor Web.)

    Este archivo está almacenado en el directorio de documentación de la instalación de MQSeries Internet Gateway.

  2. Cuando aparezca el panel:

  3. Aparece un panel que indica las palabras clave que contiene el archivo que se ha seleccionado y sus valores actuales.

  4. La lista de palabras clave se actualizará con los cambios realizados.

    Si ha seleccionado guardar los cambios en un archivo que ya existe y que contiene algunas palabras clave, se visualizará una lista completa de todas las palabras clave.

  5. Si desea añadir otras palabras clave, o realizar otras modificaciones en los valores de la lista, repita los procedimientos que se han descrito.

    Nota: Los nombres de palabra clave no pueden incluir espacios en blanco.

Si ha modificado el archivo 'dmq.ini', los valores nuevos se utilizarán como valores por omisión la próxima vez que utilice MQSeries Internet Gateway para enviar un mensaje MQ. Si ha modificado o creado su propio archivo 'INI', los valores nuevos se utilizarán la próxima vez que utilice un formulario en el que la palabra clave MQIGwIniFile esté establecida en el nombre de su archivo 'INI'.

[Volver a la biblioteca] [Contenido] [Tema anterior] [Principio del tema] [Tema siguiente] [Ayuda]


[ Página de presentación | Pedidos | Buscar | Contactar con IBM | Términos legales ]
(C)IBM Corporation 1997. 1999. Reservados todos los derechos.