Notas sobre o Release

20.1 Instalação e Configuração das Funções do DB2 MQSeries

Esta seção descreve como configurar um ambiente DB2 para utilizar as Funções do DB2 MQSeries. Na conclusão bem-sucedida do procedimento a seguir, você conseguirá utilizar as Funções do DB2 MQSeries do SQL. Uma descrição dessas funções podem ser encontradas na seção Referência de SQL das Notas sobre o Release.

O procedimento básico para configuração e ativação das Funções do DB2 MQSeries é:

1. Instale o MQSeries em cada máquina física.
2. Instale o MQSeries AMI na máquina física.
3. Ative e configure as Funções do DB2 MQSeries.

Além disso, para utilizar os recursos de publicação/associação fornecidos pelas Funções do DB2 MQSeries, também é preciso instalar as Funções do MQSeries Integrator ou do MQSeries Publish/Subscribe em cada máquina. As informações sobre o MQSeries Integrator podem ser encontradas em http://www.ibm.com/software/ts/mqseries/integrator. As informações sobre o recurso do MQSeries Publish/Subscribe podem ser encontradas em http://www.ibm.com/software/ts/mqseries/txppacs na categoria 3.

20.1.1 Instalar o MQSeries

A primeira etapa é assegurar que, no mínimo, a Versão 5.1 do MQSeries com o FixPak mais recente esteja instalado no seu servidor DB2. Se essa versão do MQSeries já estiver instalada, passe para a próxima etapa, "Instalar o MQSeries AMI." O DB2 Versão 7.2 inclui uma cópia do servidor MQSeries a ser utilizada com o DB2. As instruções específicas da plataforma para instalação do MQSeries ou para atualização de uma instalação existente do MQSeries podem ser encontradas na publicação Quick Beginnings específico da plataforma em http://www.ibm.com/software/ts/mqseries/library/manuals. Certifique-se de configurar um gerenciador de filas padrão à medida que você efetua o processo de instalação.

20.1.2 Instalar o MQSeries AMI

A próxima etapa é instalar o MQSeries AMI (Application Messaging Interface). Essa é uma extensão para as interfaces de programação do MQSeries que fornece uma separação limpa de tarefas administrativas e de programação. As Funções do DB2 MQSeries requerem a instalação dessa interface. Se o MQSeries AMI já estiver instalado em seu servidor DB2, passe para a próxima etapa, "Ativar as Funções do DB2 MQSeries". Se o MQSeries AMI não estiver instalado, você poderá fazer isso do pacote de instalação fornecido com o DB2 7.2 ou fazendo download de uma cópia da AMI do site MQSeries Support Pacs da web em http://www.ibm.com/software/ts/mqseries/txppacs. A AMI pode ser encontrada na "Categoria 3 - Extensões do Produto". Para conveniência, fornecemos uma cópia do MQSeries AMI com o DB2. Esse arquivo está localizado no diretório sqllib/cfg. O nome do arquivo é dependente do sistema operacional:

Siga o processo de instalação normal da AMI conforme destacado no arquivo readme da AMI contida na imagem de instalação compactada.

20.1.3 Ativar as Funções do DB2 MQSeries

Durante esta etapa, você configurará e ativará um banco de dados para as Funções do DB2 MQSeries. O enable_MQFunctions utility é um comando flexível que primeiro verifica se o ambiente correto do MQSeries foi configurado em seguida instale e crie uma configuração padrão para as funções do DB2 MQSeries, ative o banco de dados especificado com estas funções e confirme se a configuração funciona.

1. Para Windows NT ou Windows 2000, vá para a etapa 5.
2. Definindo Grupos no UNIX: Se você estiver ativando estas funções no UNIX, deverá primeiro incluir o proprietário da instância do DB2 (freqüentemente db2inst1) e o ID do usuário associado aos UDFs limitados (freqüentemente db2fenc1) no grupo mqm do MQSeries. Isso é necessário para as funções do DB2 para acessar o MQSeries.
3. Definir as Variáveis de Ambiente do DB2 no UNIX: Inclua a variável de ambiente AMT_DATA_PATH na lista entendida pelo DB2. Você pode editar o arquivo $INSTHOME/sqllib/profile.env, inclua AMT_DATA_PATH em DB2ENVLIST. O comando db2set também pode ser utilizado.
4. Em UNIX, reinicie a instância do banco de dados: Para as alterações da variável de ambiente se efetivarem, a instância do banco de dados deve ser reiniciada.
5. Altere o diretório para $INSTHOME/sqllib/cfg para UNIX ou %DB2PATH%/cfg no Windows.
6. Execute o comando enable_MQFunctions para configurar e ativar um banco de dados para as Funções do DB2 MQSeries. Em um ambiente DB2 UDB EEE, realize apenas esta etapa no nó do catálogo. Consulte 20.6, enable_MQFunctions para obter uma descrição completa desse comando. Alguns exemplos comuns são determinados abaixo. Após a conclusão bem-sucedida, o banco de dados especificado terá que ser ativado e a configuração testada.
7. Para testar estas funções utilizando o Processador da Linha de Comandos, emita os comandos a seguir após ter conectado-se ao banco de dados ativado:

   values DB2MQ.MQSEND('a test')
   values DB2MQ.MQRECEIVE()
   

   A primeira instrução enviará a mensagem "a test" para a fila DB2MQ_DEFAULT_Q e a segunda a receberá novamente.

Nota:

Como resultado da execução do enable_MQFunctions, um ambiente MQSeries padrão será estabelecido. O gerenciador de filas do MQSeries DB2MQ_DEFAULT_MQM e a fila padrão DB2MQ_DEFAULT_Q será criada. Os arquivos amt.xml, amthost.xml e amt.dtd serão criados, se ainda existirem no diretório indicado pelo AMT_DATA_PATH. Se um arquivo amthost.xml não existir e não contiver uma definição para connectionDB2MQ, uma linha será incluída no arquivo com as informações apropriadas. Uma cópia do arquivo original será salva como DB2MQSAVE.amthost.xml.