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.
2. |Instale o MQSeries AMI.
3. |Ative e configure as Funções do DB2 MQSeries. |

|Além disso, para utilizar as capacidades publicar/associar fornecidas pelas |Funções do DB2 MQSeries, você também deve instalar o MQSeries Integrator ou o |MQSeries Publish/Subscribe Functions. 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. 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. |