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 pode ser encontrada 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 publicar/assinar 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-se de 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 Iniciação Rápida específica 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 a partir do pacote de instalação fornecido com o DB2 7.2 ou fazendo download de uma cópia da AMI a partir do Web site MQSeries Support Pacs 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 leia-me da AMI contida na imagem de instalação compactada.

20.1.3 Ativar as Funções do DB2 MQSeries

Durante essa 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 instala e cria uma configuração padrão para as funções do DB2 MQSeries, ativa o banco de dados especificado com essas funções e confirma 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 essas 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 essa etapa apenas 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 essas funções utilizando o Processador da Linha de Comandos, emita os comandos a seguir após ter se conectado 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ão criados. 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.