Guía del usuario
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:
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:
- 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).)
- Los valores de las palabras clave pueden almacenarse en archivos 'INI' que usted designe.
- 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:
- En el formulario HTML
- En el archivo 'INI' que indica la palabra clave MQIGwIniFile
- 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:
- MQIGwQueue
- MQIGwReplyQueue
- MQIGwQueueManager
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.
- 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.
- Cuando aparezca el panel:
- Si desea modificar el archivo INI por omisión (dmq.ini) que se suministra con la pasarela, haga clic en el
botón Someter.
- Si desea modificar o crear otro archivo INI, entre el nombre del archivo y haga clic en Someter.
- Aparece un panel que indica las palabras clave que contiene el archivo que se ha seleccionado y sus valores actuales.
- Si desea alterar el valor de una palabra clave, escriba el valor nuevo sobre el valor existente.
- Si desea modificar el valor por omisión de otra palabra clave, escriba el valor de la palabra clave en el campo de entrada Nombre y el valor nuevo en el
campo Valor.
- Si desea suprimir una palabra clave de la lista de valores por omisión, haga clic en el recuadro de supresión
que aparece junto a la palabra clave.
Nota: Las palabras clave del archivo 'dmq.ini' de MQSeries Internet Gateway no deben
suprimirse. Si suprime MQIGwQueueManager, MQIGwReplyQueue o
MQIGwQueue de este archivo y no suministra valores en otro archivo INI especificado o en el formulario HTML, es posible
que la transacción no pueda finalizar.
-
- Si desea guardar los cambios en el archivo que se indica en el campo Guardar como, haga clic en Aplicar.
- Si desea guardar el archivo que ha modificado con un nombre nuevo, entre el nombre nuevo en el campo Guardar como y haga clic en Aplicar.
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.
- 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'.
![[Ayuda]](images/help.gif)
[ Página de presentación |
Pedidos |
Buscar |
Contactar con IBM |
Términos legales ]
(C)IBM Corporation 1997. 1999. Reservados todos los derechos.