Guia do Usuário
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:
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:
- 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.)
- Valores de palavras-chave podem ser armazenados em seus próprios arquivos 'INI' nomeados.
- 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:
- O formulário HTML
- O arquivo 'INI' nomeado na palavra-chave MQIGwIniFile
- 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:
- MQIGwQueue
- MQIGwReplyQueue
- MQIGwQueueManager
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.
- 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.
- Quando o painel for exibido,
- Se deseja modificar o arquivo INI padrão (dmq.ini) que é fornecido com o gateway, dê um clique sobre
o botão Submeter
- Se desejar modificar ou criar, outro arquivo INI, digite o nome do arquivo e, em seguida, dê um clique sobre Submeter
- É exibido um painel mostrando as palavras-chave no arquivo que você selecionou e seus valores atuais.
- Se deseja alterar o valor de uma das palavras-chave exibidas, substitua o valor atual
- Se desejar modificar o valor padrão da outra palavra-chave, digite o valor no campo de entrada Nome e o novo
valor no campo Valor.
- Se desejar eliminar a palavra-chave da lista de valores padrão, dê um clique sobre o quadro de eliminação
junto a palavra-chave.
Nota:É aconselhável que você não elimine as palavras-chave do MQSeries Internet Gateway do arquivo
'dmq.ini'. Se você eliminar MQIGwQueueManager, MQIGwReplyQueue ou
MQIGwQueue deste arquivo e não fornecer valores em outro arquivo INI especificado, ou em seu
formulário HTML, provavelmente sua transação não será concluída.
-
- Se desejar salvar suas alterações para o arquivo que é exibido no campo Salvar como, dê um clique sobre Aplicar
- Se deseja salvar o arquivo modificado com um novo nome, digite o novo nome no campo Salvar como e, em seguida, dê um clique sobre Aplicar
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.
- 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'.
![[Auxílio]](images/help.gif)
[ Home |
Pedidos |
Busca |
Contacte a IBM |
Legal ]
(C) IBM Corporation 1997. 1999. Todos os Direitos Reservados