Gravando Dados

Para gravar mensagens que passam por um fluxo de mensagens, crie um banco de dados, configure as definições de segurança, crie serviços configuráveis apropriados e configure o monitoramento do fluxo de mensagens.

Antes de iniciar:

Assegure-se de que o fluxo de mensagens do qual você deseja gravar dados tenha sido implementado. Para obter mais informações, consulte Implementando Recursos.

É possível gravar dados em um banco de dados para auditoria, ou para ajudar na determinação de problema. Foi fornecido um script com o WebSphere Message Broker que pode ser usado para criar o banco de dados DB2 e as tabelas de banco de dados. É possível executar esse script sem modificação ou customizá-lo. O script cria um banco de dados chamado MBRECORD com um esquema padrão.

Para configurar o WebSphere Message Broker para gravar dados, conclua as etapas a seguir.

  1. Use o script fornecido com o WebSphere Message Broker para criar e configurar um banco de dados para armazenar as mensagens gravadas.
    1. Localize o script de seu sistema operacional:
      • Windows: install_dir\ddl\db2\DataCaptureSchema.sql
      • UNIX: install_dir/ddl/db2/DataCaptureSchema.sql
      • z/OS: o script JCL está localizado no conjunto de dados e membro SBIPPROC(BIPRRDB)
      install_dir é o local da instalação do WebSphere Message Broker.
    2. Opcional: Para especificar seu próprio banco de dados ou esquema, customize o script DataCaptureSchema fornecido e salve as mudanças.
      Talvez você também queira editar o script pelos seguintes motivos:
      • Se você tiver executado o script uma vez e desejar executá-lo novamente, deverá eliminar o banco de dados MBRECORD primeiro. Insira o comando drop database MBRECORD antes da linha que informa create database MBRECORD.
      • O tamanho máximo do corpo da mensagem que pode ser gravado (depois que a codificação tiver ocorrido) é de 5 MB. É possível aumentar esse máximo editando o script para aumentar a coluna WMB_BINARY_DATA.DATA.
    3. Em uma linha de comandos, navegue até o local do script e execute-o: Por exemplo, em sistemas Windows ou UNIX, insira o seguinte comando:
      db2 -tvf DataCaptureSchema.sql
  2. Crie uma definição ODBC para o banco de dados.

    Se você tiver usado o script fornecido para criar seu banco de dados sem modificações, crie uma definição ODBC para o banco de dados chamada MBRECORD, com MBRECORD como o nome da origem de dados (DSN). Para obter informações adicionais, consulte Ativando as Conexões ODBC para os Bancos de Dados.

  3. Use o comando mqsisetdbparms para configurar um identificador de usuários e uma senha para o broker usar ao se conectar ao banco de dados; por exemplo:
    mqsisetdbparms brokerName -n dataSourceName -u userID -p password
    • brokerName é o nome do broker.
    • dataSourceName identifica o banco de dados no qual você deseja gravar dados.
    • userID e password especificam o identificador de usuários e a senha que o broker usa para se conectar ao banco de dados.
  4. Para assegurar-se de que as mudanças no comando mqsisetdbparms entrem em vigor, reinicie o broker. Para obter mais informações, consulte Iniciando e Parando um Intermediário.
  5. Teste a conexão com o banco de dados usando o comando mqsicvp. Para obter mais informações, consulte Comando mqsicvp.
  6. Especifique as propriedades de tempo de execução para captura de dados criando os serviços configuráveis apropriados.

    Para especificar informações de processamento de dados e de conexão para o banco de dados, crie um serviço configurável DataCaptureStore.

    Para identificar o tópico de monitoramento e o armazenamento de captura de dados a serem usados para o processamento de dados do evento deste tópico, crie um serviço configurável DataCaptureSource. Diversas instâncias do serviço configurável DataCaptureSource podem usar o mesmo serviço configurável DataCaptureStore.

    1. Configure o serviço configurável DataCaptureStore.

      É possível usar o serviço configurável DefaultCaptureStore fornecido ou criar seu próprio serviço configurável do tipo DataCaptureStore. É possível usar o WebSphere Message Broker Explorer para criar o serviço configurável; para obter mais informações, consulte Usando o WebSphere Message Broker Explorer para Trabalhar com Serviços Configuráveis. Alternativamente, use o comando mqsicreateconfigurableservice; para obter mais informações, consulte o Comando mqsicreateconfigurableservice. Para obter descrições de propriedades desse serviço configurável, consulte o Serviço Configurável DataCaptureStore.

      Por exemplo, insira o seguinte comando em uma linha de comandos:
      mqsicreateconfigurableservice brokerName -c DataCaptureStore -o dataCaptureStoreName
       -n dataSourceName,egForRecord -v dataSource,executionGroup
      • brokerName é o nome do broker.
      • dataCaptureStoreName é o nome do objeto de serviço configurável.
      • dataSource é o nome da origem de dados.
      • executionGroup é o nome do grupo de execução que processa dados para gravação.
    2. Configure o serviço configurável DataCaptureSource.

      Crie um serviço configurável do tipo DataCaptureSource. É possível usar o WebSphere Message Broker Explorer ou o comando mqsicreateconfigurableservice para criar o serviço configurável. Se você usar o DataCaptureSourceTemplate no WebSphere Message Broker Explorer, deverá criar um novo serviço configurável com base no modelo. Se você editar o modelo sem criar um novo serviço configurável, será emitido um erro no tempo de execução. Para obter informações sobre as propriedades desse serviço configurável, consulte Serviço Configurável DataCaptureSource.

      Por exemplo, em sistemas UNIX, insira o seguinte comando em uma linha de comandos:
      mqsicreateconfigurableservice brokerName -c DataCaptureSource -o dataCaptureSourceName -n dataCaptureStore,topic
       -v dataCaptureStoreName,'$SYS/Broker/myBroker/Monitoring/executionGroupName/msgFlowName'
       
      • brokerName é o nome do broker.
      • dataCaptureSourceName é o nome do objeto de serviço configurável.
      • dataCaptureStoreName é o nome do serviço configurável DataCaptureStore que você deseja usar para esta assinatura.
      • myBroker, executionGroupName e msgFlowName são os nomes do broker, do grupo de execução e do fluxo de mensagens do qual você deseja capturar dados. Esses valores fazem parte de uma sequência de tópicos e são usados para subscrever eventos configurados usando o monitoramento de negócios. É possível usar curingas de tópicos nesta sequência de tópicos.

      Em sistemas UNIX, coloque a sequência de tópicos entre aspas ao inseri-los em uma linha de comandos. Em sistemas Windows, use aspas duplas. As aspas não serão necessárias se você criar o serviço configurável usando o WebSphere Message Broker Explorer.

      Teste se a subscrição do tópico especificado para a propriedade topic foi bem-sucedida exibindo as assinaturas no gerenciador de filas de brokerName. Use o WebSphere Message Broker Explorer ou o comando runmqsc.

      Para verificar as assinaturas usando o WebSphere Message Broker Explorer, conclua as seguintes etapas:
      1. Expanda o gerenciador de filas na pasta Gerenciadores de Filas
      2. Para abrir a área de janela Assinaturas, clique em Assinaturas.
      3. Clique em Atualizar e verifique se existe uma assinatura com uma sequência de tópicos $SYS/Broker/myBroker/Monitoring/executionGroupName/msgFlowName
      Para verificar a assinatura usando runmqsc, conclua as seguintes etapas:
      1. Em um prompt de comandos, digite runmqsc qmName, em que qmName é o nome do gerenciador de filas.
      2. Para exibir todas as assinaturas dos gerenciadores de filas, digite dis sub(*)
      3. Verifique se a sequência de tópicos $SYS/Broker/myBroker/Monitoring/executionGroupName/msgFlowName é retornada na lista de tópicos de assinatura
      4. Para sair do ambiente runmqsc, digite end
  7. Para configurar o monitoramento em um fluxo de mensagens para emitir eventos para captura, use um dos métodos a seguir.
    • Configure e ative as origens de eventos e ative o monitoramento do fluxo de mensagens concluindo as etapas de Monitoramento de Nível de Negócios.

      Não é necessário subscrever o tópico de monitoramento; o broker gerencia a assinatura do tópico especificado no serviço configurável DataCaptureSource.

    • Configure as origens do evento de monitoramento usando o perfil de monitoramento de amostra fornecido em install_dir/sample/RecordReplay/basicMonitoringProfile.xml.

      O perfil de monitoramento de amostra funciona para um único nó de entrada. Você deve atualizar o perfil para substituir NODENAME pelo nome do nó de entrada. Para ativar esse perfil de monitoramento, execute os comandos mqsicreateconfigurableservice, mqsichangeproperties e mqsichangeflowmonitoring no broker no qual o fluxo foi implementado. Para obter detalhes sobre como executar esses comandos, consulte Configurando fontes de eventos de monitoramento utilizando um perfil de monitoramento.

Em seguida:

Depois de ter gravado as mensagens, é possível visualizá-las. Para obter mais informações, consulte Visualizando Dados Gravados.

Talvez você queira desativar a gravação de um grupo de execução específico temporariamente (por motivos de desempenho, por exemplo). Para obter mais informações, consulte Desativando e Ativando a captura de dados. Para obter mais informações sobre como ajustar a captura de dados, consulte Ajustando a Captura de Dados.

Avisos | Marcas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
        Última atualização
        
        Última atualização : 2012-01-20 12:01:21


Tópico de TarefaTópico de Tarefa | Versão 8.0.0.0 | bj23560_