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

FTEInput

Use o nó FTEInput para receber arquivos usando o WebSphere MQ File Transfer Edition.

Este tópico contém as seguintes seções:

Propósito

É possível usar o nó FTEInput para estender o suporte ao WebSphere Message Broker Versão 8.0 para processamento do arquivo através de sua integração com o WebSphere MQ File Transfer Edition. O WebSphere MQ File Transfer Edition é um produto de transferência de arquivos gerenciado que usa WebSphere MQ como o transporte.

O nó FTEInput está contido no repositório Arquivo da paleta e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:

ícone do nó FTEInput

Utilizando Este Nó em um Fluxo de Mensagens

É possível usar o nó FTEInput em qualquer fluxo projetado para aceitar arquivos de uma rede do WebSphere MQ File Transfer Edition. Examine a amostra a seguir para ver como utilizar esse nó:

Você só pode visualizar informações sobre amostras quando usa o centro de informações que está integrado ao WebSphere Message Broker Toolkit ou o centro de informações on-line. Você só poderá executar amostras quando usar o centro de informações que está integrado ao WebSphere Message Broker Toolkit.

Terminais e Propriedades

Os terminais do nó FTEInput são descritos na tabela a seguir.

Terminal Descrição
Falha O terminal de saída para o qual a mensagem é roteada se ocorrer um erro antes de uma mensagem ser propagada para o terminal de Saída. As mensagens propagadas neste terminal não são validadas, mesmo que você tenha especificado, utilizando a propriedade Validar, que a validação deve ocorrer.
Out O terminal de saída para o qual uma mensagem será roteada se ela tiver sido extraída com sucesso do arquivo de entrada. Se não ocorrerem erros no nó de entrada, uma mensagem recebida de um recurso externo será sempre enviada para o terminal Out primeiro.
Fim dos Dados O terminal de saída para o qual a mensagem Fim de Dados é roteada depois que todas as mensagens em um arquivo forem processadas. A transação do fluxo de mensagens Fim de Dados será iniciada somente se o terminal estiver anexado.
Catch O terminal de saída para o qual a mensagem será roteada se for emitida uma exceção downstream e capturada por este nó. As exceções serão capturadas somente se o terminal estiver anexado.

As tabelas a seguir descrevem as propriedades do nó que você pode definir em uma guia especificada. A coluna com título O indica se a propriedade é obrigatória (marcada no kit de ferramentas com um asterisco se precisar inserir um valor quando nenhum padrão está definido). A coluna com cabeçalho C indica se a propriedade é configurável (é possível alterar o valor ao incluir o fluxo de mensagens no arquivo BAR para implementá-lo).

Quando o nó FTEInput propaga uma mensagem, ele armazena informações sobre ele nas árvores de mensagens LocalEnvironment.FTE e LocalEnvironment.FTE.Transfer. Se o arquivo de entrada estiver vazio, a mensagem será propagada (assumindo que ela seja válida). Se você especificar um padrão de nome de arquivo que contenha caracteres curingas na propriedade Filtro do nome de arquivo, o nó FTEInput copia os caracteres no nome de arquivo que correspondem aos curingas, juntamente com todos os caracteres intermediários, para a árvore de mensagens LocalEnvironment.Wildcard.WildcardMatch. Consulte a seção Usando Variáveis de Ambiente Locais com Nós de Arquivo para obter informações adicionais.

Propriedades de Descrição

Propriedade M A O padrão Descrição
Nome de nó Não Não Entrada FTE O nome do nó.
Descrição Curta Não Não Nenhum Uma breve descrição do nó.
Descrição Longa Não Não Nenhum Texto que descreve a finalidade do nó no fluxo de mensagens.

Propriedades básicas

Propriedade M A O padrão Descrição Propriedade do Comando mqsiapplybaroverride
Filtro de diretório Não Sim Nenhum O diretório de destino do WebSphere MQ File Transfer Edition a partir do qual os arquivos de entrada são processados. inputDirectory
Filtro de nome de arquivo Sim Sim * Um nome de arquivo ou cadeia contendo caracteres curinga opcionais (* ou ?) identificando o arquivo ou arquivos a serem processados a partir do diretório de Entrada. filenamePattern
Ação no processamento com êxito Sim Não Nenhuma Ação A ação executada pelo nó no arquivo após o processamento bem-sucedido do conteúdo. As opções válidas são:
  • Nenhuma Ação
  • Exclusão
  • Incluir Registro de Data e Hora
 

Propriedades Análise de Mensagem de Entrada

Propriedade M A O padrão Descrição Propriedade do Comando mqsiapplybaroverride
Domínio de Mensagens Não Não Nenhum O domínio utilizado para analisar a mensagem que chega.  
Conjunto de Mensagens Não Não Nenhum O nome ou identificador do conjunto de mensagens no qual a mensagem que chega está definida.

Se você configurar esta propriedade e, em seguida, atualizar as dependências do projeto para remover esta referência do conjunto de mensagens, será emitido um aviso. Atualize a propriedade Conjunto de Mensagens ou restaure a referência para este projeto do conjunto de mensagens.

 
Tipo de Mensagem Não Não Nenhum O nome da mensagem que chega.  
Formato de Mensagem Não Não Nenhum O nome do formato físico da mensagem que chega.  
ID do conjunto de caracteres codificados de mensagens Sim Sim Sistema Intermediário Padrão O ID do conjunto de caracteres codificados utilizados para interpretar os bytes do arquivo que está sendo lido. messageCodedCharSetIdProperty
Codificação de mensagens Sim Sim Sistema Intermediário Determinado O esquema de codificação para números usado para interpretar bytes do arquivo que está sendo lido. Os valores válidos são Determinado pelo Sistema do Broker ou um valor de codificação numérico. Para obter informações adicionais sobre codificação, consulte Conversão de Dados. messageEncodingProperty

Propriedades Opções do Analisador

Propriedade M A O padrão Descrição
Cronometragem de análise Não Não On Demand Especifica quando uma mensagem de entrada é analisada. Os valores válidos são:
  • On Demand
  • Imediato
  • Completo

Para obter uma descrição completa desta propriedade, consulte Analisando On Demand.

Construir árvore utilizando tipos de dados de esquema XML Não Não Desmarcada Especifica se os elementos da sintaxe na árvore de mensagens possuem tipos de dados obtidos do esquema XML.
Utilizar analisador compacto XMLNSC para domínio XMLNS Não Não Desmarcada Especifica se o Analisador Compacto XMLNSC é usado para mensagens no Domínio XMLNS. Se você configurar esta propriedade, os dados da mensagem aparecerão em XMLNSC nos nós que estão conectados ao terminal de saída quando um dos itens a seguir é XMLNS:
  • O cabeçalho MQRFH2 de entrada.
  • A propriedade Análise da Mensagem de Entrada, Domínio de Mensagem.
Reter conteúdo misto Não Não Desmarcada Especifica se o analisador XMLNSC cria elementos na árvore de mensagens para texto misto em uma mensagem de entrada. Se você selecionar a caixa de opções, serão criados elementos para texto misto. Se você desmarcar a caixa de opções, texto misto será ignorado e nenhum elemento será criado.
Reter comentários Não Não Desmarcada Especifica se o analisador XMLNSC cria elementos na árvore de mensagens para comentários em uma mensagem de entrada. Se você selecionar a caixa de opções, serão criados elementos para comentários. Se você desmarcar a caixa de opções, comentários serão ignorados e nenhum elemento será criado.
Reter instruções de processamento Não Não Desmarcada Especifica se o analisador XMLNSC cria elementos na árvore de mensagens para instruções de processamento em uma mensagem de entrada. Se você selecionar a caixa de opções, serão criados elementos para instruções de processamento. Se você desmarcar a caixa de opções, instruções de processamento serão ignoradas e nenhum elemento será criado.
Elementos opacos Não Não Em Branco Especifica uma lista de elementos na mensagem de entrada que devem ser analisados em segundo plano pelo analisador XMLNSC. A análise de ignorados será desempenhada apenas se a validação não estiver ativada (ou seja, se Validar for Nenhum); as entradas especificadas em Elementos Ignorados serão ignoradas se a validação estiver ativada.

Propriedades Tentar Novamente

Propriedade M A O padrão Descrição Propriedade do Comando mqsiapplybaroverride
Tentar mecanismo novamente Sim Não Failure Como o nó manipula uma falha de fluxo. As opções válidas são:
  • Failure
  • Repetição Curta
  • Repetição Curta e Longa
 
Tentar limite novamente Sim Sim 0 O número de vezes para tentar a transação do fluxo novamente quando o valor da propriedade Mecanismo de Nova Tentativa é Nova Tentativa Curta. retryThreshold
Intervalo de Repetição curto (segundos) Não Sim 0 O intervalo, em segundos, entre cada nova tentativa se a propriedade Limite de Nova Tentativa não for zero. shortRetryInterval
Intervalo de Repetição longo (segundos) Não Sim 300 O intervalo entre novas tentativas, se a propriedade Tentar Mecanismo Novamente for Nova Tentativa Curta e Longa e o limite de novas tentativas tiver se exaurido. longRetryInterval
Ação no arquivo com falha Sim Sim Nenhuma Ação A ação que o nó executa com o arquivo de entrada se todas as tentativas de processar o conteúdo do arquivo de entrada falharem. As opções válidas são:
  • Nenhuma Ação
  • Exclusão
  • Incluir Registro de Data e Hora
 

Propriedades Registros e Elementos

Propriedade M A O padrão Descrição
Detecção de registro Sim Não Arquivo Inteiro O mecanismo utilizado para identificar registros no arquivo de entrada. As opções válidas são:
  • Arquivo Inteiro
  • Comprimento Fixo
  • Delimitado
  • Seqüência de Registro Analisado
Comprimento Sim Não 80 O comprimento de cada registro, em bytes, quando a detecção de registroComprimento Fixo está selecionada.
Delimitador Sim Não Final de linha do DOS ou do UNIX O tipo de bytes do delimitador que separa ou finaliza cada registro quando a detecção de registro Delimitado está selecionada. As opções válidas são:
  • Final de linha do DOS ou do UNIX
  • Delimitador Customizado
Delimitador customizado Não Não Nenhum Os bytes do delimitador, expressos em hexadecimal, quando a detecção de registro Delimitado e Delimitador Customizado estão selecionados. Esta propriedade é obrigatória somente se a propriedade Delimitador estiver configurada como Delimitador Customizado.
Tipo de delimitador Sim Não Postfix A posição do delimitador quando a detecção de registro Delimitado for selecionada. As opções válidas são:
  • Postfix
  • Infix
Essa propriedade é ignorada, a menos que a propriedade Delimitador seja configurada para Delimitador Customizado.

Propriedades de validação

Para obter uma descrição completa destas propriedades, consulte Propriedades de Validação.

Propriedade M A O padrão Descrição Propriedade do Comando mqsiapplybaroverride
Validate Não Sim Nenhuma Essa propriedade controla se a validação ocorre. Os valores válidos são:
  • Nenhuma
  • Conteúdo e Valor
  • Conteúdo
validateMaster
Ação de falha Não Não Exceção Essa propriedade controla o que acontecerá se a validação falhar. Os valores válidos são:
  • Rastreio do Usuário
  • Registro de Erros Local
  • Exceção
  • Lista de Exceções
 

Propriedades Transações

Propriedade M A O padrão Descrição
Modo de Transação Não Não Não O modo de transação neste nó de entrada determina se o restante dos nós no fluxo são executados no ponto de sincronização. As opções válidas são:
  • Sim
  • Não

Propriedades de Instâncias.

Para obter uma descrição completa destas propriedades, consulte Propriedades Configuráveis do Fluxo de Mensagens.

Propriedade M A O padrão Descrição Propriedade do Comando mqsiapplybaroverride
Conjunto de instâncias adicionais Não Sim Utilizar Conjunto Associado ao Fluxo de Mensagens O conjunto do qual as instâncias adicionais são obtidas.
  • Se você selecionar Utilizar Conjunto Associado ao Fluxo de Mensagens, as instâncias adicionais serão obtidas a partir do conjunto de fluxos de mensagens.
  • Se você selecionar Usar Conjunto Associado ao Nó, instâncias adicionais serão alocadas a partir das instâncias adicionais do nó com base no número especificado na propriedade Instâncias Adicionais.
componentLevel
Instâncias Adicionais Não Sim 0 O número de instâncias adicionais que o nó pode iniciar se a propriedade do Conjunto de Instâncias Adicionais estiver configurada como Utilizar Conjunto Associado ao Nó. additionalInstances
As propriedades Monitoramento do nó são descritas na tabela a seguir.
Propriedade M P Default Descrição
Eventos Não Não Nenhum Eventos definidos para o nó são exibidos nesta guia. Por padrão, nenhum evento de monitoramento é definido em um nó do fluxo de mensagens. Utilize Incluir, Editar, e Excluir para criar, alterar ou excluir eventos de monitoração no nó; consulte Configurando fontes de eventos de monitoramento utilizando propriedades de monitoramento para detalhes.

É possível ativar e desativar eventos mostrados aqui selecionando ou desmarcando a caixa de opções Ativado.

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 ReferênciaTópico de Referência | Versão 8.0.0.5 | bc34034_