Manuais IBM [Retornar à Biblioteca] [Conteúdo] [Tópico Anterior] [Final do Tópico] [Próximo Tópico] [Auxílio]

Guia do Usuário


Como Verificar e Utilizar o MQSeries Internet Gateway

Para utilizar aplicações do MQ através do MQSeries Internet Gateway será necessário:
  1. Configurar e iniciar seu servidor Web
  2. Configurar alguns recursos do MQSeries
  3. Iniciar suas aplicações compatíveis com a Web
  4. 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.


Como configurar e iniciar seu servidor Web

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.

Como configurar seus recursos do MQSeries

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.

  1. 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.
  2. Se você não possuir um gerenciador de filas padrão do MQSeries, crie um chamado DMQSAMP digitando o comando: CRTMQM -Q DMQSAMP

  3. Inicie o gerenciador de filas padrão digitando o comando: STRMQM

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

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

Inicie suas aplicações compatíveis com a Web

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.

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

  2. Digite os dados que deseja enviar para a aplicação do MQ

  3. 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\'.)

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


Como utilizar seus próprios recursos e aplicações

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.


[Retornar à Biblioteca] [Conteúdo] [Tópico Anterior] [Início do Tópico] [Próximo Tópico] [Auxílio]


[ Home | Pedidos | Busca | Contacte a IBM | Legal ]
(C) IBM Corporation 1997. 1999. Todos os Direitos Reservados