Guia do Usuário
Para utilizar aplicações do MQ através do MQSeries Internet Gateway será necessário:
- Configurar e iniciar seu servidor Web
- Configurar alguns recursos do MQSeries
- Iniciar suas aplicações compatíveis com a Web
- Digitar sua mensagem em um formulário especial HTML e submetê-lo a uma
aplicação compatível com a Web do MQSeries.
Aplicações compatíveis com a Web são aplicações que foram criadas para interagir com o
Gateway.
São fornecidos exemplos de formulário e um exemplo de aplicação compatível com a Web com o MQSeries
Internet Gateway. Você poderá utilizar o exemplo dmqsamp1, com os recursos padrão que
são fornecidos durante a instalação, para executar um teste de verificação inicial de sua
instalação.
Ao verificar seu sistema com o exemplo, você poderá configurar o Gateway para utilizar seus próprios
recursos e utilizar os formulários e aplicações de exemplo como gabaritos para criar os seus
próprios.
Ao instalar os arquivos do
MQSeries Internet Gateway, você precisará configurar seu servidor Web
para encontrar e reconhecer o Gateway. A configuração para todos os servidores mapeia uma
extensão de '.mqf' para os arquivos de programa do MQSeries Internet Gateway. Os formulários de entrada HTML
são os mesmos para todas as interfaces de servidor Web e se você configurar mais de uma
interface para seu servidor, o Gateway utilizará a primeira interface configurada que ele encontrar.
Dê um clique sobre o nome de um servidor Web para ver os procedimentos de configuração
para esse servidor.
Ao completar a configuração, reinicialize seu servidor Web.
Alguns recursos padrão do MQSeries são fornecidos com o MQSeries Internet Gateway
e é recomendado que você utilize estes padrões para verificar sua instalação inicial. Os seguintes procedimentos descrevem como
configurar e utilizar os padrões.
Todas as seguintes ações devem ser executadas em sua máquina do servidor Web. Em cada etapa, será necessário mover para o
diretório onde os arquivos que está chamando estão armazenados ou você poderá incluir o caminho completo para os arquivos no comando.
- Para permitir que o servidor da Web acesse os recursos do MQ, o nome do usuário sob o qual ele
executa deve estar incluído no grupo mqm. Se este nome ainda não estiver incluído no
grupo, inclua-o utilizando qualquer método que lhe for familiar.
Você precisará encerrar e reinicializar seu QMGR para utilizar o novo nome.
- Se você não possuir um gerenciador de filas padrão do MQSeries, crie um chamado DMQSAMP
digitando o comando:
CRTMQM -Q DMQSAMP
- Inicie o gerenciador de filas padrão digitando o comando:
STRMQM
- Crie filas de exemplo do MQSeries Internet Gateway utilizando o seguinte
comando:
RUNMQSC < DMQSAMP.TST
As filas de aplicação de exemplo são chamadas de DMQSAMP1 e DMQSAMP2, e a
fila da qual o Gateway espera recuperar mensagens é chamada de DMQGATEWAY.
- Defina as conexões de servidor e de cliente conforme descrito em MQSeries Clients (GC33-1632), Part2, Using Channels, 'Creating
both definitions on the server'.
O arquivo AMQCLCHL.TAB é criado e pode ser copiado em modo binário para /var/mqm nas plataformas UNIX e seu diretório mqm no OS/2 e no WindowsNT.
Ao criar as definições, observe o seguinte:
- Digite o id do usuário do seu servidor Web no campo MCAUSER.
- Se estiver utilizando o gerenciador de filas padrão, defina o campo QMNAME para ' ' (Observe o
espaço entre as aspas).
- Para AIX, HP_UX, e Solaris, execute o seguinte comando:
chmod 666 AMQCLCHL.TAB
para garantir que o id do servidor Web tem autoridade suficiente para ler o arquivo AMQCLHCL.TAB.
Inicie as aplicações de exemplo do MQSeries em sua máquina do
servidor digitando os comandos:
- Para AIX, HP-UX e Solaris
-
dmqsamp1 DMQSAMP1 DMQSAMP &
- Para OS/2 e Windows/NT
-
start dmqsamp1 DMQSAMP1 DMQSAMP
Se você não estiver utilizando o gerenciador de filas padrão do MQSeries Internet Gateway, substitua
'DMQSAMP' pelo nome do gerenciador de filas que deseja utilizar.
Se você está utilizando seu gerenciador de filas padrão, não será necessário incluir o
nome do gerenciador de filas nos comandos.
São fornecidos formulários de exemplo no subdiretório 'mqm\dmqgate\doc' de sua instalação do MQSeries Internet
Gateway. É fornecido um formulário para executar o programa de
exemplo dmqsamp1 que envia e recebe uma mensagem simples. Se estiver verificando sua
instalação, utilize os seguintes procedimentos para enviar uma mensagem para seu sistema MQSeries.
Se deseja utilizar seus próprios recursos e aplicações, utilize o exemplo como um
gabarito para criar seus próprios formulários.
- Abra um formulário de exemplo dmqsamp1.htm em seu navegador Web.
Nota:Se estiver visualizando esta informação de sua instalação do
servidor Web, você poderá Submeter o formulário que é exibido pela ligação. Caso contrário,
poderá somente visualizar o formulário da ligação.
- Digite os dados que deseja enviar para a aplicação do MQ
- Se estiver utilizando um Apache ou Lotus Domino Web Server, edite a linha ACTION
no arquivo de origem de exemplo de arquivo, conforme indicado dentro do arquivo.
(O arquivo de origem de exemplo exibido pelo 'dmqsamp1.htm' acima é 'dmqsam1d.htm' no Diretório de documentação de sua Instalação do MQSeries Internet
Gateway. Outros arquivos html de exemplos estão armazenados no diretório
'install_dir\tools\dmqgate\samples\'.)
- Submeta o formulário
Se estiver conectado a um servidor Web e executou todas as tarefas descritas acima,
sua mensagem será enviada através do MQSeries Internet Gateway e será enviada uma resposta a seu navegador
assim que a aplicação completar a tarefa.
Dê um clique aqui para visualizar exemplos de respostas que você recebe utilizando formulários de exemplo.
Se não for possível para a aplicação responder dentro do tempo de espera definido para o gateway por qualquer
razão, incluindo que a aplicação do servidor não está executando, você receberá uma mensagem em seu
navegador Web. A página de mensagem também contém um botão Repetir. Você
poderá continuar a utilizar seu navegador Web para outras tarefas,
e quando desejar verificar se sua resposta de mensagem está disponível, retorne à página de mensagem de tempo de espera
e dê um clique sobre o botão.
Se o programa não completar com êxito, deverá ser retornada uma mensagem de erro para
seu navegador.
Se você não puder corrigir o problema com as informações fornecidas na mensagem de erro, vá para
'Como resolver problemas do MQSeries Internet Gateway' para obter assistências adicionais.
Uma vez que você verificou sua instalação utilizando os padrões fornecidos, você poderá configurar o
Gateway para utilizar seus próprios recursos do MQ, e poderá criar suas próprias aplicações compatíveis com a Web e
formulários HTML.
Dê um clique sobre um dos itens na seguinte lista para visualizar os procedimentos necessários.
![[Auxílio]](images/help.gif)
[ Home |
Pedidos |
Busca |
Contacte a IBM |
Legal ]
(C) IBM Corporation 1997. 1999. Todos os Direitos Reservados