Guía del usuario
Para utilizar aplicaciones MQ a través de MQSeries Internet Gateway debe:
- Configurar e iniciar el servidor Web
- Configurar algunos recursos MQSeries
- Iniciar sus aplicaciones habilitadas para la Web
- Entrar el mensaje en un formulario HTML especial y someterlo para una aplicación
MQSeries habilitada para la Web.
Las aplicaciones habilitadas para la Web son aplicaciones que están escritas para interactuar con
Gateway.
MQSeries Internet Gateway incluye formularios de ejemplo y una aplicación habilitada para la Web de ejemplo. Puede
utilizar el ejemplo dmqsamp1, con los recursos por omisión que se facilitan
durante la instalación, para ejecutar una prueba de verificación inicial de la
instalación.
Una vez haya verificado el sistema con el ejemplo, podrá configurar Gateway para utilizar sus propios
recursos y utilizar los formularios y las aplicaciones de ejemplo como plantillas desde las que
escribir sus propias aplicaciones.
Una vez que haya instalado los archivos de
MQSeries Internet Gateway, deberá configurar el servidor Web para
que busque y reconozca Gateway. La configuración de todos los servidores asigna una extensión
'.mqf' a los archivos del programa MQSeries Internet Gateway. Los formularios de entrada HTML son los
mismos para todas las interfaces de servidor Web y, si configura más de una interfaz para el
servidor, Gateway utilizará la primera interfaz configurada que encuentre.
Haga clic en el nombre de un servidor Web para ver los procedimientos de configuración para
dicho servidor.
Cuando haya completado la configuración, reinicie el servidor Web.
Es recomendable utilizar los recursos de MQSeries por omisión que incluye MQSeries Internet Gateway
para verificar la instalación inicial. Los procedimientos que se describen a continuación indican cómo
configurar y utilizar dichos recursos.
Todas las acciones que se indican deben ejecutarse en la máquina del servidor Web. En cada una de las estapas deberá, ir al directorio
en el que están almacenados los archivos que esté llamando o, si lo desea, puede incluir la vía de acceso completa en el mandato.
- Para que el servidor Web pueda acceder a los recursos MQ, el
nombre de usuario bajo el que se ejecuta debe estar incluido en el
grupo mqm group. Si el nombre del servidor no está incluido ya
en dicho grupo, añadalo mediante el método que prefiera.
Debe detener y reiniciar el QMGR para utilizar el nombre nuevo.
- Si no tiene un gestor de colas MQSeries por omisión, cree uno cuyo nombre sea DMQSAMP
mediante este mandato:
CRTMQM -Q DMQSAMP
- Inicie el gestor de colas por omisión emitiendo el mandato siguiente:
STRMQM
- Cree las colas de ejemplo de MQSeries Internet Gateway utilizando este mandato:
RUNMQSC < DMQSAMP.TST
Las colas de la aplicación de ejemplo se llaman DMQSAMP1 y DMQSAMP2, y la cola
desde la cual Gateway espera recuperar mensajes se llama DMQGATEWAY.
- Defina las conexiones con el servidor y el cliente tal como se indica en MQSeries Clientes
(GC33-1632), Parte 2, Utilización de canales, 'Creación de las dos definiciones en el servidor'.
Esto crea un archivo llamado AMQCLCHL.TAB que debe copiarse en modalidad binaria en /var/mqm
en las plataformas UNIX y en el directorio mqm en OS/2 y WindowsNT.
Al crear las definiciones, tenga en cuenta lo siguiente:
- Entre el ID de usuario del servidor Web en el campo MCAUSER.
- Si está utilizando el gestor de colas por omisión, dé al campo QMNAME el valor ' ' (fíjese en el
espacio entre los apóstrofos).
- Para AIX, HP_UX y Solaris, ejecute el siguiente mandato:
chmod 666 AMQCLCHL.TAB
para asegurarse de que el ID de usuario del servidor Web tiene la autorización suficiente para leer
el archivo AMQCLHCL.TAB.
Inicie las aplicaciones MQSeries de ejemplo en la máquina
servidor entrando los siguientes mandatos:
- Para AIX, HP-UX & Solaris
-
dmqsamp1 DMQSAMP1 DMQSAMP &
- Para OS/2 y Windows/NT
-
start dmqsamp1 DMQSAMP1 DMQSAMP
Si no está utilizando el gestor de colas por omisión de MQSeries Internet Gateway, sustituya
'DMQSAMP' por el nombre del gestor de colas que desea utilizar.
Si está utilizando el gestor de colas por omisión del sistema, no es necesario que incluya el
nombre del gestor de colas en los mandatos.
El subdirectorio 'mqm\dmqgate\doc' de la instalación de MQSeries Internet
Gateway contiene formularios de ejemplo. Existe un formulario para ejecutar el programa de
ejemplo dmqsamp1 que envía y recibe un mensaje simple. Si está verificando la instalación,
siga los procedimientos que se indican a continuación para enviar un mensaje al sistema MQSeries.
Si desea utilizar sus propios recursos y aplicaciones, utilice el ejemplo como una plantilla
para crear sus propios formularios.
- Abra el formulario de ejemplo dmqsamp1.htm en el navegador Web.
Nota: si está visualizando esta información en la instalación del servidor Web, podrá
someter el formulario que se visualiza en el enlace. De lo contrario, sólo podrá ver el formulario desde
el enlace.
- Entre los datos que desee enviar a la aplicación MQ
- Si está utilizando un servidor Web Apache o
Lotus Domino, edite la línea ACTION del archivo fuente de ejemplo tal
como se indica dentro del archivo.
(El archivo fuente del ejemplo visualizado por el anterior
'dmqsamp1.htm' es 'dmqsam1d.htm' en el Directorio de documentation de la
instalación de MQSeries Internet Gateway.
Otros archivos de html de ejemplo están almacenados en el directorio
'dir_instal\tools\dmqgate\samples\'.)
- Someta el formulario
Si está conectado a un servidor Web y ha realizado todas las tareas descritas anteriormente,
el mensaje se envía a través de MQSeries Internet Gateway y, cuando la aplicación ha finalizado la tarea,
se envía una respuesta al navegador Web.
Haga clic aquí para ver ejemplos de las respuestas que se reciben utilizando los formularios de ejemplo.
Si la aplicación no puede responder dentro del período de tiempo definido para la pasarela por
un motivo u otro, incluyendo que la aplicación de servidor no se esté ejecutando, recibirá un mensaje en el
navegador Web. La página del mensaje también contiene el botón Reintentar. Puede seguir
utilizando el navegador Web para realizar otras tareas, y cuando desee verificar si la respuesta
del mensaje ya está disponible, regrese a la página del mensaje de tiempo de espera excedido y
haga clic en el botón.
Si el programa no finaliza satisfactoriamente, el navegador debería recibir un mensaje de
error.
Si no puede solucionar el problema con la información que se facilita en el mensaje de error, vaya a
'Resolución de problemas de MQSeries Internet Gateway' para obtener información más detallada.
Una vez haya verificado la instalación utilizando los recursos por omisión que se facilitan, puede configurar la
Gateway para utilizar sus propios recursos MQ y puede escribir sus propias aplicaciones habilitadas para la Web y
formularios HTML.
Haga clic en uno de los elementos de la lista siguiente para ver los procedimientos correspondientes.
![[Ayuda]](images/help.gif)
[ Página de presentación |
Pedido |
Buscar |
Contactar con IBM |
Términos legales ]
(C) IBM Corporation 1997. 1999. Reservados todos los derechos