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

CDOutput

Use o nó CDOutput ao usar o IBM® Sterling Connect:Direct com WebSphere Message Broker.

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

Propósito

Use o nó CDOutput para serializar a árvore de mensagens para um arquivo e, em seguida, transferi-lo entre dois Servidores Connect:Direct. Um diretório sob o caminho de trabalho dentro do grupo de execução é usado como a área temporária até que o arquivo esteja pronto para ser transferido. Depois que o arquivo é transferido, ele é excluído da área temporária.

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

Ícone do nó CDOutput

Utilizando Este Nó em um Fluxo de Mensagens

É possível usar o nó CDOutput em conjunto com outro nó de entrada de transporte, por exemplo, MQInput. Todos os dados recebidos do WebSphere MQ são enviados para o nó CDOutput que grava o arquivo em um diretório interno usando o nome de arquivo fornecido no nó. O arquivo é então transferido para o Servidor Connect:Direct de destino, em que ele foi gravado no diretório e com o nome do arquivo fornecido no nó.

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ó CDOutput 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.
Saída 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.
Defeito 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ó CDOutput 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.CD.

É possível substituir o:
  • Nome do Servidor Connect:Direct Secundário (SNODE)
  • Nome do Processo
  • Dados Contábeis
  • Diretório do Arquivo de Destino
  • Nome do Arquivo de Destino
  • Copiar de Opções incluindo SYSOPTS
  • Copiar para Opções incluindo SYSOPTS
fazendo alterações na árvore de mensagens LocalEnvironment.Destination.CD; consulte 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 CDOutput 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 Propriedade do Comando mqsiapplybaroverride
SNODE Não SIM O mesmo que o PNODE que está sendo usado O Servidor Connect:Direct secundário (SNODE) para o qual o arquivo está sendo transferido.

Se ele não estiver configurado, o arquivo será transferido novamente para o servidor Servidor Connect:Direct primário (PNODE).

Você deve configurar um Netmap no PNODE para assegurar que a transferência atinja o SNODE.

A entrada Netmap para este SNODE deve conter o tipo de sistema operacional no campo apropriado. Se o PNODE estiver em um sistema operacional UNIX, você deverá usar o campo de descrição no Netmap para armazenar essas informações.

A descrição deve conter a sequência remoteos=xxx, em que o valor é Windows, UNIX ou OS390. O nó CDOutput não pode ser usado para transferir para um SNODE em sistemas operacionais diferentes destes.

snode
Diretório do Arquivo de Destino Não SIM Cadeia vazia O diretório para o qual o arquivo está sendo transferido no Servidor Connect:Direct secundário (SNODE).

Observe que o diretório deve existir.

Se este campo for deixado em branco, o diretório padrão será usado pelo SNODE.

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

destinationDirectory
Nome do Arquivo de Destino SIM SIM Nenhuma O nome do arquivo especificado ou um padrão contendo um único curinga que define o nome do arquivo a ser criado pelo Servidor Connect:Direct secundário (SNODE).

O nome do Arquivo pode ser um padrão que contém um único curinga. O valor do curinga é obtido a partir do elemento na pasta de ambiente local chamada LocalEnvironment.Wildcard.WildcardMatch . Esse valor é normalmente configurado pelos nós CDInput ou FileInput.

Por exemplo, se o nó CDInput configurar seu padrão de arquivo como *.in, ele corresponderá o arquivo test.in como "test". Se o padrão do arquivo do nó CDOutput estiver configurado como *.out, "test" será substituído para criar um nome de arquivo de test.out.

O nome do arquivo deve ser configurado, mas poderá ser substituído usando o campo do ambiente local LocalEnvironment.Destination.CD.Name

É possível especificar conjuntos de dados sequenciais z/OS ou membros do conjunto de dados particionado. De modo geral, para conjuntos de dados sequenciais, especifique o nome completo do conjunto de dados, por exemplo, MBUSER.TEST1

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

Um caractere curinga pode ser usado em qualquer lugar em um nome do conjunto de dados e funciona da mesma maneira que para padrões de nome de fila normal.

destinationFileName
Serviço configurável CDServer Não SIM O padrão O nome do serviço configurável que está sendo usado para conectar ao Servidor Connect:Direct primário (PNODE), a fim de iniciar a 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 a um PNODE, 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 Saída.

 
Nome do processo Não SIM Nenhuma O nome usado para o script do processo gerado para enviar o arquivo a partir do Servidor Connect:Direct primário (PNODE) para o Servidor Connect:Direct secundário (SNODE).

Use essa opção se desejar identificar esta transferência exclusivamente.

Se esse valor não estiver configurado, o nome do processo WMBPROC será usado.

É possível usar qualquer nome desejado no script do processo. No entanto, observe que o nome deve ter, no máximo, oito caracteres e não pode conter qualquer espaço.

processName
Disposição SIM SIM RPL - substituir arquivo Como criar o arquivo no sistema secundário:
  • RPL - Substituir ou criar um novo arquivo
  • MOD - Anexar a um arquivo existente. Essa opção não está disponível no z/OS
  • NEW - Criar um novo arquivo

No z/OS, para conjuntos de dados particionados, apenas as opções RPL e NEW são suportadas. Tentativas NEW para alocar um novo conjunto de dados particionado, com as seguintes opções IBM Sterling Connect:Direct SPACE: '(23036,(2,1,1))'

É possível substituir esse valores no ambiente local usando: LocalEnvironment.Destination.CD.Copy.To.Option.SPACE =

disposição
Modo de Transferência sim SIM Transferência binária (nenhuma conversão)

O modo no qual transferir o arquivo.

binário - O arquivo é transferido como binário, sem conversão

text - O arquivo é transferido com conversão entre as páginas de código locais, conforme necessário.

Ao usar o modo de transferência "text" no z/OS, o IBM Sterling Connect:Direct exigirá que o arquivo contenha pelo menos um caractere de nova linha. Você deve assegurar-se de que o arquivo seja criado no formato correto para o IBM Sterling Connect:Direct para concluir com êxito a transferência do texto.

transferMode

Propriedades do Pedido

Propriedade M C 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 C 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 intermediário 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 intermediário
  • Delimitador Customizado (hexadecimal)
Delimitador Customizado (hexadecimal) SIM Não Nenhuma 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 C O padrão Descrição Propriedade do Comando mqsiapplybaroverride
Validar 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:30:42


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