Use o nó CDOutput ao usar o IBM® Sterling Connect:Direct com WebSphere Message Broker.
Este tópico contém as seguintes seções:
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:
É 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ó.
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ó 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.
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:
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:
|
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:
|
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:
|
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:
|
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. |