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

Guia do Usuário


Como configurar o MQSeries Internet Gateway

Esta página descreve como configurar seu MQSeries Internet Gateway para utilizar seus próprios recursos e aplicações do MQSeries.

São abordados os seguintes tópicos:


Palavras-chave do MQSeries Internet Gateway

As informações sobre como os recursos do MQSeries devem ser utilizados por mensagens passando através do MQSeries Internet Gateway, são transmitidas através das seguintes palavras-chave:
MQIGwQueue
Nome da fila de aplicação do MQSeries - a fila onde a mensagem será colocada
MQIGwReplyQueue
Nome da fila do Gateway do MQSeries - a fila de onde o MQSeries Internet Gateway obtém suas mensagens
MQIGwQueueManager
Nome do gerenciador de filas do MQSeries que deverá ser utilizado
MQIGwWaitInterval
O tempo em milissegundos que o gateway deverá aguardar por uma resposta.
MQIGwWaitHTML
O nome do arquivo HTML que deve ser exibido se ocorrer um tempo de espera excedido.
Este arquivo HTML deverá conter uma mensagem indicando que o tempo de espera expirou, e ele também deverá conter um botão para possibilitar a resposta da mensagem a ser obtida em uma data posterior. Consulte Como criar formulários HTML para o MQSeries Internet Gateway para obter um exemplo simples de uma página de tempo de espera, timedout.htm, que está armazenado no diretório de arquivos do Gateway de sua instalação.
MQIGwContext
Quais informações de contexto devem ser enviadas à aplicação.
Esta palavra-chave pode ser definida para os seguintes valores:
None
Nenhuma das informações de contexto é transmitida à aplicação de serviço.
All.
Todas as informações de contexto são transmitidas à aplicação de serviço:
- 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
Dê um clique aqui para visualizar exemplos das informações que são retornadas quando esta palavra-chave for definida.
MQIGwIniFile
O nome do arquivo INI que pode ser utilizado para manter valores padrão para quaisquer das outras palavras-chave.
O valor para estas palavras-chave pode ser fornecido das seguintes formas:
  1. Todas as palavras-chave podem ter valores especificados no formulário HTML que é utilizado para enviar mensagens através do Gateway.
    Nota: Este é o único lugar onde você pode definir MQIGwIniFile se desejar utilizar valores que são armazenados em seu próprio arquivo nomeado 'INI'. (Consulte (2) abaixo.)

  2. Valores de palavras-chave podem ser armazenados em seus próprios arquivos 'INI' nomeados.

  3. Valores padrão para as seguintes palavras-chave são fornecidos no arquivo 'dmq.ini', que é fornecido com o MQSeries Internet Gateway e está localizado em /var/mqm nas plataformas UNIX e mqm\bin no OS/2 e WindowsNT.
    MQIGwReplyQueue
    DMQGATEWAY
    MQIGwWaitInterval
    10000 ms
    MQIGwContext
    Todos
Nota: Embora qualquer palavra-chave possa ser definida em qualquer ou todos os lugares descritos acima, tome cuidado para não definir uma palavra-chave particular mais de uma vez em qualquer lugar pois isto poderá acarretar resultados imprevisíveis.

O MQSeries Internet Gateway pesquisa as várias origens de definição de palavra-chave na seguinte ordem:

  1. O formulário HTML
  2. O arquivo 'INI' nomeado na palavra-chave MQIGwIniFile
  3. O arquivo dmq.ini
Se não foram encontrados valores válidos para as seguintes palavras-chave, serão utilizados valores padrão básicos:
MQIGwQueueManager
O padrão básico é o gerenciador de filas padrão do MQSeries
Nota: No MVS não há gerenciador de filas padrão e você deverá definir o valor de MQIGwQueueManager através de um dos métodos descritos acima.

MQIGwWaitInterval
O padrão básico é um intervalo de espera ilimitado

MQIGwWaitHTML
O padrão básico é 'timedout.htm', o qual é armazenado no diretório de arquivos do Gateway de sua instalação.

MQIGwContext
O padrão básico é all
Se não forem encontrados valores válidos para qualquer das palavras-chave a seguir, a transação não será concluída e será exibida uma mensagem de erro:

Como definir palavras-chave

Você poderá alterar o valor dos padrões de palavra-chave no 'dmq.ini' e também poderá criar seus próprios arquivos 'INI' para armazenar valores de palavra-chave.

É fornecido um programa configurador com o MQSeries Internet Gateway para auxiliar na alteração e criação do padrão, e seus próprios arquivos 'INI'.
Nota: É altamemte recomendado que você utilize este programa e não utilize um editor para modificar ou editar seus arquivos 'INI'. Provavelmente os editores corromperão o formato dos arquivos 'INI'.

O configurador é fornecido como um arquivo HTML que pode ser executado em um navegador Web.

Utilize o seguinte procedimento para executar sua configuração.

  1. Abra seu arquivo do MQSeries Internet Gateway 'dmqcnf.htm' em seu navegador da Web. (Nota: O programa será executado somente a partir desta ligação se você estiver visualizando a documnetação que está instlada em sua máquina do servidor Web.)

    Este arquivo é armazenado no diretório da documentação de sua instalação do MQSeries Internet Gateway.

  2. Quando o painel for exibido,

  3. É exibido um painel mostrando as palavras-chave no arquivo que você selecionou e seus valores atuais.

  4. A lista de palavras-chave é atualizada com suas alterações.

    Se você escolheu salvar para um arquivo que já existe e contém algumas palavras-chave, a lista completa de palavras-chave no arquivo será exibida.

  5. Se desejar incluir palavras-chave adicionais ou fazer modificações adicionais aos valores da lista, repita os procedimentos descritos acima.

    Nota: Não são permitidos espaços em branco incorporados em nomes de palavras-chave.

Se você modificou o arquivo 'dmq.ini', os novos valores serão utilizados como padrão na próxima vez que utilizar o MQSeries Internet Gateway para enviar uma mensagem MQ. Se você modificou ou criou seu próprio arquivo 'INI', os novos valores serão utilizados a próxima vez em que utilizar um formulário que definie a palavra-chave MQIGwIniFile em seu nome de arquivo 'INI'.

[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