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:
É 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:
É possível usar o nó CDInput em qualquer fluxo que esteja projetado para aceitar arquivos de uma rede do IBM Sterling Connect:Direct.
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ó 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:
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:
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:
|
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:
|
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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.
|
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 |
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. |