Como o Broker Processa Arquivos

O broker lê arquivos com os nós FileInput, FTEInput e FileRead e grava arquivos com os nós FileOutput e FTEOutput.

O WebSphere Message Broker pode ler mensagens dos arquivos e gravar mensagens nos arquivos, no sistema de arquivos local, ou em um sistema de arquivos de rede que é local para o broker. Os nós a seguir fornecem este recurso:

Você pode usar os nós FTEInput e FTEOutput para receber ou enviar arquivos para um destino em uma rede WebSphere MQ File Transfer Edition.

É possível usar os nós CDInput e CDOutput para receber ou enviar arquivos para um destino em uma rede do IBM® Sterling Connect:Direct.

Um arquivo, ou um registro dentro de um arquivo, é análogo a uma mensagem em uma fila. O diretório que contém o arquivo é análogo a uma fila de mensagens.

Como o broker lê um arquivo no início de um fluxo

O nó FileInput processa mensagens que são lidas a partir de arquivos. O nó FileInput pesquisa, em um diretório de entrada especificado (no sistema de arquivos conectado ao broker), os arquivos que atendem aos critérios especificados. Opcionalmente, os arquivos de um servidor FTP ou SFTP remoto podem ser movidos para o diretório local sempre que o diretório deve ser varrido. É possível localizar o arquivo necessário especificando um nome do arquivo explícito ou um padrão de nome do arquivo que inclua caracteres curingas. Se o arquivo estiver bloqueado, ele será ignorado durante a varredura de diretório.

O nó FileInput cria um subdiretório mqsitransitin no diretório de entrada. O subdiretório mqsitransitin mantém e bloqueia os arquivos de entrada enquanto eles estão sendo processados. O broker lê o arquivo e propaga a mensagem ou as mensagens, usando o conteúdo do arquivo.

Se um grupo de execução que processa arquivos neste diretório de entrada for removido, verifique o subdiretório mqsitransitin para obter arquivos parcialmente processados ou não processados. Retorne todos os arquivos ao diretório de entrada e remova o prefixo UUID do grupo de execução dos nomes de arquivo, de modo que eles possam ser processados por um grupo de execução diferente. Para obter informações adicionais sobre o subdiretório mqsitransitin, consulte Como Múltiplos Nós de Arquivos Compartilham o Acesso a Arquivos no mesmo Diretório.

No nó FileInput, é possível especificar como os registros se derivam do arquivo. O conteúdo de um arquivo pode ser interpretado como:
  • Um único registro (arquivo inteiro)
  • Registros separados, cada um com comprimento fixo (registros de comprimento fixo)
  • Registros separados, cada um delimitado por um delimitador especificado (registros delimitados)
  • Registros separados que são reconhecidos por um analisador especificado (sequência de registros do analisador)

Após o arquivo ter sido processado com êxito, ele é excluído do sistema de arquivos ou movido para um subdiretório de archive do diretório (local) especificado.

Depois que o último registro do arquivo tiver sido processado com sucesso, o terminal End of Data do nó FileInput é conectado no fluxo de mensagem e uma mensagem de Fim de Dados é propagada para o terminal End of Data. A mensagem de Fim de Dados consiste em uma mensagem BLOB vazia e uma estrutura LocalEnvironment.File, e ela permite que o processamento de final do fluxo explícito seja executado em outra parte do fluxo de mensagem.

A mensagem (ou mensagens) propagada do arquivo pode ser usada como entrada para qualquer fluxo de mensagem e nó de saída. É possível criar um fluxo de mensagens que receba mensagens de arquivos e gere mensagens para clientes que utilizem qualquer um dos transportes suportados para conectar ao intermediário.

Sempre que uma mensagem é propagada a partir de um arquivo, o nó FileInput armazena informações sobre o arquivo na árvore de mensagem LocalEnvironment.File. Essas informações incluem o deslocamento do registro da mensagem no arquivo que está sendo processado e o número do registro nesse arquivo. Além disso, quando um curinga é usado em um padrão de nome de arquivo, os caracteres correspondidos no nome do arquivo são colocados no elemento WildcardMatch da árvore de ambiente local.

O nó de FTEInput recebe arquivos da rede WebSphere MQ File Transfer Edition. O broker lê o arquivo e propaga a mensagem ou as mensagens, usando o conteúdo do arquivo. Depois de um nó de FTEInput processar um arquivo, o arquivo é excluído. Para obter detalhes sobre as informações que o nó de FTEInput fornece no ambiente local, consulte Usando Variáveis de Ambiente Locais com Nós de Arquivo.

O nó de CDInput recebe arquivos da rede IBM Sterling Connect:Direct. O broker lê o arquivo e propaga a mensagem ou as mensagens, usando o conteúdo do arquivo. Depois que um nó CDInput processa um arquivo, o arquivo é excluído. Para obter detalhes sobre as informações que o nó de CDInput fornece no ambiente local, consulte Usando Variáveis de Ambiente Locais com Nós de Arquivo.

O nó FileRead pode ler um arquivo inteiro, ou um registro único, nominado. Um uso comum do nó FileRead é rotear ou enriquecer as mensagens com base no conteúdo do arquivo. Ao desenvolver o fluxo de mensagens, você pode especificar o nome e o local do arquivo a ser lido. Você pode substituir esses valores no tempo de execução com base no conteúdo de uma mensagem. O nó FileRead lê um arquivo no meio de um fluxo de mensagens.

O nó FileRead complementa os nós FileInput e FileOutput existentes.

Como o broker lê um arquivo do meio de um fluxo

O nó FileRead bloqueia arquivos quando eles estão sendo lidos e não os move para um subdiretório para que sejam lidos. Os arquivos podem ser lidos de modo completo ou separado nos registros, da mesma maneira que o nó FileInput. Após o arquivo ter sido processado pelo nó FileRead, ele poderá ser excluído, arquivado ou ser deixado inalterado.

Como o Intermediário Grava um Arquivo

Os nós FileOutput, CDOutput e FTEOutput gravam mensagens em arquivos no sistema de arquivos do broker. Quando uma mensagem é recebida no terminal In do nó, ela cria e grava um arquivo como uma série de um ou mais registros. Um registro é gravado em um arquivo para cada mensagem recebida. O nome do arquivo é especificado por um padrão de nome do arquivo no nó ou um nome do arquivo explícito que é especificado no nó ou derivado da mensagem.

É possível especificar como os registros são acumulados nos arquivos:
  • Um único registro (arquivo inteiro). O arquivo que é criado consiste em um registro.
  • Registros concatenados (registros não modificados). Os registros não são preenchidos em nenhum comprimento necessário e não são separados por um delimitador.
  • Registros de comprimento uniforme (registros de comprimento fixo). Os registros que são mais curtos do que o comprimento especificado são preenchidos até o comprimento especificado.
  • Registros separados (registros delimitados). Os registros são terminados ou separados por um delimitador especificado.
O fluxo de mensagens informa ao nó de saída que não há mais registros a gravar enviando uma mensagem para seu terminal Finish File. O arquivo é fornecido no destino apropriado:
  • Nó FileOutput: o arquivo é então movido para o diretório de saída especificado.

    Opcionalmente, o arquivo pode ser movido para um diretório em um servidor FTP ou SFTP remoto. O servidor é identificado pela propriedade Servidor Remoto e Porta no nó.

  • Nó FTEOutput: o arquivo é enviado ao agente de destino na rede do WebSphere MQ File Transfer Edition.
  • Nó CDOutput: O arquivo é enviado para a rede do IBM Sterling Connect:Direct.

Se o nó de saída produzir um único registro a partir do arquivo (arquivo inteiro), o arquivo será movido imediatamente para o diretório de saída sem precisar que uma mensagem seja propagada ao terminal Finish File. Neste caso, qualquer mensagem enviada o terminal Finish File do nó não tem efeito em nenhum arquivo, mas a mensagem ainda é propagada para um fluxo de mensagem anexado ao terminal End of Data.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Última atualização
        
        Última atualização : 2012-08-02 07:46:13


Tópico de ConceitoTópico de Conceito | Versão 7.0.0.5 | ac55280_