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:
É 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:
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.
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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. |