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

CDInput

Uso do nó CDInput para visualizar arquivos ao usar o IBM® Sterling Connect:Direct em conjunto com o WebSphere Message Broker.

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

Propósito

É possível usar o nó CDInput para estender o suporte ao WebSphere Message Broker para processamento do arquivo através de sua integração com o IBM Sterling Connect:Direct.

No z/OS®, quando o nó CDInput recebe notificação de chegada de um banco de dados que ele precisa processar, o nó copia esse conjunto de dados no Unix System Services temporariamente, antes do processamento.

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

Ícone do nó CDnput

Utilizando Este Nó em um Fluxo de Mensagens

É possível usar o nó CDInput em qualquer fluxo que esteja projetado para aceitar arquivos de uma rede do IBM Sterling Connect:Direct.

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ó CDInput são descritos na tabela a seguir.

Terminal Descrição
Defeito 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.
Saída 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.

A estrutura de fim de dados consiste em um corpo de mensagem vazio e nas informações de Ambiente Local propagadas a partir do terminal de saída.

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ó CDInput propaga uma mensagem, ele armazena informações sobre ele nas árvores de mensagens LocalEnvironment.CD e LocalEnvironment.CD.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 de Nome de Arquivo, o nó CDInput copiará os caracteres no nome de arquivo que correspondem aos caracteres 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 C O padrão Descrição
Nome do Nó Não Não CDInput O nome do nó.
Descrição Curta Não Não Nenhuma Uma breve descrição do nó.
Descrição Longa Não Não Nenhuma Texto que descreve a finalidade do nó no fluxo de mensagens.

Propriedades básicas

Propriedade M C O padrão Descrição
Filtro de diretório Não SIM Nenhuma Especifique o diretório a partir do qual o nó pode processar arquivos. Se esta propriedade for deixada em branco, o nó pode processar os arquivos de todos os diretórios. Se diversos nós do CDInput forem implementados no mesmo grupo de execução, os arquivos serão distribuídos aleatoriamente entre os nós a menos que a filtragem seja definida.

O diretório deve existir.

Se os servidores WebSphere Message Broker e IBM Sterling Connect:Direct estiverem em máquinas diferentes, esse será o caminho para o diretório na máquina do broker. Para obter informações sobre várias configurações ao usar o IBM Sterling Connect:Direct, consulte Propriedades de Configuração Avançada ao Usar os Nós IBM Sterling Connect:Direct e consulte as seções de Entrada.

Se o campo brokerPathToInputDir no serviço configurável estiver configurado, o filtro de diretório poderá ser um caminho relativo para esse valor; caso contrário, ele deverá ser um caminho absoluto.

No z/OS, se o arquivo for um conjunto de dados sequencial, um conjunto de dados particionado ou um membro do conjunto de dados particionado, deixe o campo de filtro Diretório em branco.

Filtro de nome de arquivo SIM SIM Nenhuma Especifique um nome de arquivo ou uma sequência de caracteres que corresponda a um nome de arquivo.

O nome do arquivo ou a sequência de caracteres pode conter, pelo menos, um dos seguintes caracteres curinga:

  • * (qualquer sequência de zero ou mais caracteres)
  • ? (qualquer caractere simples)

Por padrão, o nó processa todos os arquivos. Se diversos nós do CDInput forem implementados no mesmo grupo de execução, os arquivos serão distribuídos aleatoriamente entre os nós a menos que a filtragem seja definida.

O nó CDInput pode processar conjuntos de dados sequenciais do z/OS, conjuntos de dados particionados inteiros ou membros do conjunto de dados particionado. A sintaxe para endereçar um conjunto de dados baseia-se no nome completo do conjunto de dados, por exemplo, MBUSER.TEST1.

Os caracteres curinga podem ser usados em qualquer lugar em um filtro de nome de arquivo do banco de dados, isso funciona da mesma maneira que para padrões de filtro de nome arquivo normal.

Para um membro dentro de um conjunto de dados particionado, use colchetes para especificar o nome do membro, por exemplo, MBUSER.TEST(MEME01).

Ao receber um conjunto de dados particionado inteiro, cada membro do conjunto de dados recebido é processado como uma mensagem individual.

Servidor Connect:Direct serviço configurável Não SIM O padrão O nome do serviço configurável está sendo usado para conectar ao Servidor Connect:Direct, a fim de coletar informações de transferência.

Se este valor não estiver configurado, o serviço configurável padrão (denominado "Padrão") será usado.

O serviço configurável padrão se conecta ao Servidor Connect:Direct, localizado na mesma máquina do broker e usando configurações de porta padrão.

O serviço configurável padrão também usa a identidade de segurança "padrão", que deve ser criada usando o comando mqsisetdbparms; por exemplo: mqsisetdbparms MB8BROKER -n cd::default -u mqbroker -p xxxxxxx

Para obter informações sobre várias configurações ao usar o IBM Sterling Connect:Direct, consulte Propriedades de Configuração Avançada ao Usar os Nós IBM Sterling Connect:Direct e consulte as seções de Entrada.

Ação no processamento com êxito SIM Não Nenhuma Ação Selecione a ação a ser adotada assim que o nó tiver processado com êxito o arquivo.

É possível optar por deixar o arquivo no diretório de entrada se outros processos também precisarem acessar o arquivo. Nesse caso, a notificação do IBM Sterling Connect:Direct será excluída e o arquivo será mantido no lugar.

A exclusão de arquivos impede o acúmulo de arquivos processados.

Use a opção de registro de data e hora se um archive do arquivo for necessário para registrar todas as transferências feitas.

Observe que no z/OS, a opção Incluir Registro de Data e Hora não é suportada ao usar conjuntos de dados.

Propriedades Análise de Mensagem de Entrada

Propriedade M C O padrão Descrição Propriedade do Comando mqsiapplybaroverride
Domínio de Mensagens Não Não Nenhuma O domínio utilizado para analisar a mensagem que chega.  
Conjunto de Mensagens Não Não Nenhuma 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 Nenhuma O nome da mensagem que chega.  
Formato de Mensagem Não Não Nenhuma 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 C 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 Não Selecionada 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 Não Selecionada 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 Não Selecionada 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 Não Selecionada 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 Não Selecionada 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 C 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 Essa opção não está disponível no z/OS
 

Propriedades Registros e Elementos

Propriedade M C 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
  • Sequê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 SIM 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 SIM Nenhuma 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 C O padrão Descrição Propriedade do Comando mqsiapplybaroverride
Validar Não SIM Nenhum(a) Essa propriedade controla se a validação ocorre. Os valores válidos são:
  • Nenhum(a)
  • 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 C O padrão Descrição
Modo de Transação Não Não Não O modo de transação nesse nó de entrada determina se o restante dos nós no fluxo são processados sob o 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 C 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 Utilizar Conjunto Associado ao Nó, as instâncias adicionais sã alocadas 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:30:42


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