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

FTEOutput

Use o nó FTEOutput para gravar mensagens em arquivos usando o WebSphere MQ File Transfer Edition.

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

Propósito

É possível usar o nó FTEOutput 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ó FTEOutput está contido no repositório Arquivo da paleta e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:

ícone do nó FTEOutput

Utilizando Este Nó em um Fluxo de Mensagens

É possível usar o nó FTEOutput em qualquer fluxo que esteja projetado para enviar um arquivo em 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ó FTEOutput são descritos na seguinte tabela:

Terminal Descrição
In O terminal de entrada que aceita a mensagem para processamento pelo nó.
Concluir Arquivo O terminal de entrada que aceita uma mensagem que ativa o processamento final de um arquivo.
Out A mensagem recebida no terminal In é propagada para esse terminal se o registro for gravado com sucesso. A mensagem fica inalterada exceto para informações de status no Ambiente Local.
Fim dos Dados A mensagem recebida no terminal Concluir Arquivo é propagada para este terminal se o arquivo for processado com êxito.
Falha O terminal de saída para o qual a mensagem é roteada se uma falha for detectada quando uma mensagem for propagada.

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ó FTEOutput propaga uma mensagem, seja para o terminal Out ou para o terminal End of Data, ele armazena informações sobre ele na árvore de mensagens LocalEnvironment.WrittenDestination.FTE. É possível substituir as propriedades Agente de destino, Gerenciador de filas de destino, Nome da tarefa, Diretório do arquivo de destino, Nome do arquivo de destino e Substituir arquivos no sistema de destino utilizando inclusões na árvore de mensagens LocalEnvironment.Destination.FTE. Consulte 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 Saída 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
Nome da Tarefa Não SIM Nenhum O nome para a transferência que aparece nos logs de transferência e os metadados. jobName
Agente de Destino Não SIM Nenhum O nome do agente de destino ao qual enviar o arquivo. Se o Agente de destino não for especificado e não substituído utilizando a árvore LocalEnvironment, ele assumirá o padrão para o agente integrado no Grupo de Execução. destinationAgent
Gerenciador de filas de destino Não SIM Nenhum O nome do gerenciador de filas de destino ao qual enviar o arquivo. destinationQMgr
Diretório do Arquivo de Destino Não SIM Nenhum O diretório remoto no qual o agente de destino grava o arquivo. destinationDirectory
Nome do Arquivo de Destino SIM SIM Nenhum O nome do arquivo específico ou um padrão contendo um único curinga que define o nome do arquivo a ser criado pelo agente de destino. destinationFileName
Modo Não SIM Transferência binária (nenhuma conversão) O modo no qual transferir o arquivo. Os valores válidos são:
  • Transferência binária (nenhuma conversão)
  • Transferência de texto (automatizada por ASCII/EBCDIC e CR/LF)
transferMode
Desativar cálculo da soma de verificação de MD5 SIM SIM FALSE Especifica se o cálculo da soma de verificação de MD5 no arquivo transferido está desativado. checkSumDisabled
Sobrescrever arquivos no sistema de destino SIM SIM FALSE Especifica se os arquivos no sistema de destino podem ser sobrescritos quando o agente de destino move arquivos com o mesmo nome lá. Se o agente de destino falhar ao sobrescrever o arquivo, a transferência falhará e os logs de transferência relatarão a falha. O nó FTEOutput não lança ou registra qualquer erro. overwriteDestination

Propriedades do Pedido

Propriedade M A O padrão Descrição
Local dos dados Não Não $Body O local na árvore de mensagens de entrada que contém o registro a ser gravado no arquivo de saída. O valor-padrão, $Body, significa a mensagem inteira.

Propriedades Registros e Elementos

Propriedade M A O padrão Descrição
Definição do registro SIM Não O registro é o arquivo inteiro Especifica como os registros são colocados no arquivo de saída. As opções válidas são:
  • O registro é o arquivo inteiro
  • O registro são dados não modificados
  • O registro são dados de comprimento fixo
  • O registro são dados delimitados
Comprimento (bytes) SIM Não 80 O comprimento necessário do registro de saída. A propriedade está disponível apenas quando Registro são Dados de Comprimento Fixo é especificado em Definição de Registro.
Byte de preenchimento (hexadecimal) SIM Não 20 O byte hexadecimal de 2 dígitos a ser usado para preencher mensagens curtas. A propriedade está disponível apenas quando Registro são Dados de Comprimento Fixo é especificado em Definição de Registro.
Delimitador SIM Não Final de linha do sistema broker O delimitador a ser usado. A propriedade está disponível apenas quando Registro são Dados Delimitados é especificado em Definição de Registro. As opções válidas são:
  • Final de linha do sistema broker
  • Delimitador Customizado (hexadecimal)
Delimitador Customizado (hexadecimal) SIM Não Nenhum A sequência de byte do delimitador a ser usada. A propriedade está disponível apenas quando Registro são Dados Delimitados é especificado na propriedade Definição de Registro e Delimitador Customizado (hexadecimal) é especificado na propriedade Delimitador.
Tipo de delimitador SIM Não Postfix Esta propriedade especifica como os delimitadores devem ser inseridos entre registros. A propriedade está disponível apenas quando Registro são Dados Delimitados é especificado em Definição de Registro. As opções válidas são:
  • Postfix
  • Infix

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 SIM SIM Herdar Essa propriedade controla se a validação ocorre. Os valores válidos são:
  • Nenhum(a)
  • Conteúdo e Valor
  • Conteúdo
  • Herdar
validateMaster
Ação de falha SIM Não Exceção Essa propriedade controla o que acontecerá se a validação falhar. A propriedade estará disponível apenas se você configurar Validar como Conteúdo ou Conteúdo e Valor. Os valores válidos são:
  • Rastreio do Usuário
  • Registro de Erros Local
  • Exceção
  • Lista de Exceções
 
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:01


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | bc34030_