WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Preparando o Ambiente para Nós WebSphere MQ File Transfer Edition

Prepare o sistema de arquivos e os gerenciadores de filas, e determine o nome do agente do broker.

Preparando o Sistema de Arquivos

O WebSphere Message Broker usa um local em seu caminho de trabalho para armazenar transferências para agentes remotos. Ele utiliza outro local como o diretório padrão para arquivos recebidos. O caminho do diretório de alto nível para ambos os locais é: Assegure-se de que haja espaço disponível aqui para arquivos que você irá transferir para e a partir do broker pelo WebSphere MQ File Transfer Edition.

Preparando o Gerenciador de Filas

O WebSphere Message Broker tenta criar todos os artefatos necessários no gerenciador de filas para o agente e o gerenciador de filas de coordenação, se for adequado. Pode ser que ele não possa criar todos os artefatos devido à configuração de sua máquina ou às permissões. Se ele falha ao criá-los ou desejar criá-los por si só antecipadamente, consulte Scripts para Criação de Artefatos Necessários Para o WebSphere MQ File Transfer Edition.

Configurando o Gerenciador de Filas de Coordenação

Quando um fluxo de mensagens que contém um nó WebSphere MQ File Transfer Edition é implementado em um grupo de execução, um agente é criado e iniciado automaticamente nesse grupo de execução. Pelo padrão, o agente utiliza o gerenciador de filas locais do broker como o gerenciador de filas de coordenação.
  • Se o gerenciador de filas do broker estiver sendo utilizado como um gerenciador de filas de coordenação, o broker o configura como um gerenciador de filas de coordenação.
  • Se você estiver utilizando um gerenciador de filas diferente como o gerenciador de filas de coordenação, consulte Centro de Informações do WebSphere File Transfer Edition para obter detalhes sobre como configurá-lo como um gerenciador de filas de coordenação.
A menos que você tenha definido o gerenciador de filas de coordenação anteriormente, o agente é temporário; ele será excluído quando o fluxo for desimplementado ou o broker for interrompido. Este comportamento é aceitável em um ambiente de teste. Entretanto, para produção, o administrador deve especificar o gerenciador de filas de coordenação para o grupo de execução. Especificando um gerenciador de filas de coordenação:
  • Assegure que o gerenciador de filas correto seja usado quando o agente for criado.
  • Torne o agente permanente. Se um gerenciador de filas de coordenação tiver sido definido, o agente será excluído apenas após você indefinir o gerenciador de filas de coordenação (por exemplo, configurando-o com uma cadeia vazia) e reiniciar o grupo de execução.
Um aviso é gravado no log se o gerenciador de filas de coordenação não foi alterado a partir do padrão.

O diagrama de estado a seguir ilustra a presença de nós e um gerenciador de filas de coordenação definido afeta o estado do agente.

Diagrama da máquina de estado mostrando como a presença de nós e um gerenciador de filas de coordenação definido afeta o estado do agente. Esse diagrama resume as informações no parágrafo precedente.

Use um dos métodos a seguir para configurar o gerenciador de filas de coordenação.

  1. Opcional: Utilize o comando mqsichangeproperties.
    Por exemplo, para configurar o gerenciador de filas de coordenação como QM2 para o grupo de execução myExecutionGroup no broker MB8BROKER:
    mqsichangeproperties MB8BROKER -e myExecutionGroup
    -o FTEAgent -n coordinationQMgr -v QM2
    Após executar este comando, é necessário recarregar o grupo de execução para que a alteração tenha efeito.
  2. Opcional: Use o WebSphere Message Broker Explorer. Clique com o botão direito do mouse no grupo de execução e selecione as opções apropriadas no menu pop-up.

Nomeando Grupos de Execução

O nome do grupo de execução é usado para formar o nome da fila para as filas do WebSphere MQ File Transfer Edition. Consequentemente, os nomes de seus grupos de execução devem estar de acordo com as regras para denominar os objetos doWebSphere MQ. Não é possível implementar um fluxo que contenha um nó WebSphere MQ File Transfer Edition a menos que este requisito seja atendido. Os caracteres permitidos são:
  • Maiúsculas A-Z
  • Minúsculas a-z (mas há restrições no uso de letras minúsculas para o suporte do console do z/OS)

    Em sistemas que usam EBCDIC Katakana, você não pode usar caracteres minúsculos.

  • Numéricos 0-9
  • Ponto final (.)
  • Barra (/)
  • Sublinhado (_)
  • Sinal de percentual (%)
Consulte o Centro de Informações Online do WebSphere MQ Versão 7 para obter os detalhes completos de requisitos de nomenclatura.

Determinando o Nome do Agente

Para enviar um arquivo para um determinado grupo de execução, os usuários precisam saber o nome do agente que o broker cria. O nome do agente é derivado de Broker.ExecutionGroup e não é configurável. O comprimento total do nome é limitado a 28 caracteres, com um máximo de 12 caracteres para o nome do broker e 15 caracteres para o grupo de execução. Os nomes do broker e do grupo de execução maiores que estes limites são truncados para formar o nome do agente. O nome deve ter um formato válido para gerar o nome da fila do MQ Series. Assegure que:
  • O nome do broker tenha 12 caracteres ou menos (ou pelo menos exclusivo nos primeiros 12 caracteres).
  • Os nomes do grupo de execução tenham 15 caracteres ou menos (ou pelo menos exclusivos nos primeiros 15 caracteres).
  • O broker e os grupos de execução não contenham quaisquer caracteres que sejam inválidos para os nomes da fila.
  • As tuplas broker.executiongroup sejam todas exclusivas, mesmo se maiúsculas e minúsculas forem ignoradas.
O valor usado é gravado no log de eventos na mensagem BIP3358. Use um dos métodos a seguir para determinar o nome do agente.
  1. Opcional: Utilize o comando mqsireportproperties.
    Por exemplo, para exibir o nome do agente FTE para o grupo de execução FTESAMPLE no broker MB8BROKER:
    mqsireportproperties MB8BROKER -e FTESAMPLE -o FTEAgent -n agentName
    Se o agente tiver sido criado, o comando retornará o nome do agente. Se o agente não tiver sido criado, o comando retornará uma cadeia vazia.
  2. Opcional: Use o WebSphere Message Broker Explorer. Clique com o botão direito do mouse no grupo de execução e selecione as opções apropriadas no menu pop-up.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:31:02


Tópico de TarefaTópico de Tarefa | Versão 8.0.0.5 | bc34035_