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

TCPIPServerReceive

Utilize o nó TCPIPServerReceive para receber dados através de uma conexão TCP/IP do servidor.

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

Propósito

O nó TCPIPServerReceive aguarda o recebimento de dados em uma conexão TCP/IP e recupera os dados. Se a conexão for fechada, será emitida uma exceção.

Quando uma conexão for estabelecida, os dados serão enviados para o nó TCPIPServerReceive. Se o nó TCPIPServerReceive falhar em receber todos os dados dentro do tempo especificado na propriedade Tempo limite ao aguardar um registro de dados, a mensagem será enviada ao terminal Timeout; se nenhum terminal Timeout estiver conectado, uma exceção será lançada.

É possível configurar o broker para utilizar SSL para nós TCP/IP; consulte SSL e os Nós TCP/IP.

Propriedades no ambiente local podem substituir a conexão TCP/IP usada pelo nó.

Table 1. Propriedades do ambiente local de entrada
Local no ambiente local para entrada no nó Descrição
$LocalEnvironment//TCPIP/Receive/Hostname O nome do host utilizado para fazer uma conexão.
$LocalEnvironment//TCPIP/Receive/Port O número da porta utilizado para fazer uma conexão.
$LocalEnvironment/TCPIP/Receive/Id O ID do soquete que está sendo utilizado. Este ID é um identificador interno utilizado por WebSphere® Message Broker exclusivamente para identificar uma conexão.
$LocalEnvironment/TCPIP/Receive/ReplyId O ID de Resposta a ser armazenado nesta conexão. Este ID poderá então ser utilizado, quando os dados forem retornados em um nó de entrada. O ID de Resposta pode ser qualquer cadeia de texto.
$LocalEnvironment/TCPIP/Receive/Timeout O valor de tempo limite usado ao aguardar dados na conexão do servidor TCP/IP. Este valor substitui a propriedade Tempo limite ao aguardar um registro de dados especificada no nó.
$LocalEnvironment/TCPIP/Receive/Length O valor usado para substituir o número de bytes a serem lidos ao usar registros de tamanho fixo. Este valor substitui a propriedade Comprimento (bytes) especificada no nó. Se a propriedade Detecção de Registro for configurada com algo diferente de Comprimento Fixo, o campo do ambiente local será ignorado. Se este campo não estiver presente ou for avaliado como nulo, ele será ignorado e o valor no nó será usado.

Essas propriedades permitem que os detalhes da conexão (nome do host e número da porta) e a conexão utilizada (ID) sejam selecionados dinamicamente. O ID de Resposta também pode ser configurado na conexão, o que permite que uma cadeia seja armazenada na conexão e apareça no ambiente local. Desta maneira, você pode armazenar IDs de Resposta a partir de outros nós TCPIP ou de outros transportes, tais como WebSphere MQ.

Quando um registro tiver sido recuperado, o campo ConnectionDetails na árvore de ambiente local será preenchido com os detalhes da conexão que está sendo usada.

Table 2. Propriedades do ambiente local de saída
Local no ambiente local para saída do nó Descrição
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/Type O Servidor.
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/Hostname O nome do host utilizado para fazer uma conexão.
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/Port O número da porta utilizado para fazer uma conexão.
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/OpenTimestamp O registro de data e hora em que a conexão foi aberta pela primeira vez
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/CloseTimestamp O registro da data e hora em que a conexão foi fechada (nulo se ainda não estiver fechada).
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/SequenceNumber/InputRecord O número de seqüência da mensagem recebida nesta conexão. O primeiro registro possui um número de seqüência 1; O segundo registro é 2 e assim por diante.
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/SequenceNumber/OutputRecord O número de seqüência da mensagem enviada nesta conexão. O primeiro registro possui um número de seqüência 1; O segundo registro é 2 e assim por diante.
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/Id O ID do soquete que está sendo utilizado. Este ID é um identificador interno utilizado por WebSphere Message Broker exclusivamente para identificar uma conexão.
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/ReplyId O ID de Resposta que está armazenado nesta conexão. Pode ser qualquer cadeia de texto.
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/ClientDetails/Hostname O nome completo do domínio do computador a partir do qual o cliente conectou-se.
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/ClientDetails/Address O endereço IP do computador a partir do qual o cliente conectou-se.

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

Ícone do nó TCPIPServerReceive

Estrutura da mensagem

O nó TCPIPServerReceive manipula mensagens nos seguintes domínios de mensagem:
  • DFDL
  • XMLNSC
  • DataObject
  • JSON
  • BLOB
  • MIME
  • MRM
  • JMSMap
  • JMSStream
  • XMLNS

Utilizando o Nó TCPIPServerReceive em um Fluxo de Mensagens

Examine as amostras a seguir para saber como utilizar o nó TCPIPServerReceive:

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.

Configurando o Nó TCPIPServerReceive

Quando tiver colocado uma instância do nó TCPIPServerReceive em um fluxo de mensagens, você poderá configurá-lo; consulte Configurando um Nó do Fluxo de Mensagens. As propriedades do nó são exibidas na visualização Propriedades.

Todas as propriedades obrigatórias que não tiverem um valor padrão definido serão marcadas com um asterisco.

Configure o nó TCPIPServerReceive:

  1. Opcional: Na guia Descrição , digite uma Descrição curta, uma Descrição longa, ou ambas. Você também pode renomear o nó nessa guia.
  2. Na guia Básico, configure as propriedades que determinam como a conexão TCP/IP é controlada.
    • Utilize a propriedade Detalhes da Conexão para especificar o nome do host e o número da porta a serem utilizados, ou o nome de um serviço configurável. Essa propriedade é obrigatória. Os seguintes formatos são suportados:
      • Nome do serviço configurável. Este valor é utilizado para consultar a porta e o nome do host em serviços configuráveis. Por exemplo, TCPIPProfile1.
      • <Nome do Host>:<Porta>. Este valor é o nome do host seguido do número da porta (separado por dois pontos); por exemplo, tcpip.server.com:1111
      • <Porta>. Este valor é o número da porta. Neste caso, o nome do host é assumido como localhost.
    • Utilize a propriedade Tempo limite para aguardar um registro de dados (segundos) para especificar por quanto tempo o nó atenderá em uma conexão para mais dados após a chegada do primeiro byte de dados. É possível especificar qualquer período de tempo em segundos. O padrão é de 60 segundos. Quando o tempo especificado tiver sido excedido, todos os dados disponíveis serão enviados para o terminal de Falha.
  3. Na guia Avançado, configure as propriedades que determinam como o fluxo de dados é controlado.
    • Utilize a propriedade Fechar Conexão para especificar quando e como fechar a conexão.
      • Selecione Não para deixar a conexão aberta. Este valor é o padrão.
      • Selecione Após Tempo Limite para fechar a conexão quando ocorrer um tempo limite.
      • Selecione Após o recebimento de dados para fechar a conexão quando for atingido o final do registro.
    • Selecione Fechar fluxo de entrada após o recebimento de um registro para fechar o fluxo de entrada logo após a recuperação dos dados. Por padrão, esta propriedade não será selecionada. Quando o fluxo de entrada da da conexão estiver reservado, nenhum outro nó poderá utilizá-lo sem saber o ID.
    • Utilize a propriedade Modificação do Fluxo de Entrada para reservar o fluxo de entrada para ser utilizado apenas por nós de entrada e recebimento que especificam o ID da conexão ou para liberar o fluxo de entrada no final do fluxo.
      • Selecione Deixar Inalterado para deixar o fluxo de entrada como ele estava quando entrou no nó. Esse valor é selecionado por padrão.
      • Selecione Liberar Fluxo de Entrada para especificar que este fluxo de entrada será retornado ao conjunto e ficará disponível para utilização por qualquer nó de entrada ou de recebimento.
      • Selecione Reservar fluxo de entrada (para utilização por futuros nós de entrada e recebimento TCPIP) para especificar que este fluxo de entrada pode ser utilizado apenas por este nó e por outros nós de entrada ou de recebimento que o solicitam especificando o ID de conexão. Quando o fluxo de entrada da conexão estiver reservado, nenhum outro nó poderá utilizá-lo sem especificar o ID de conexão correto.
      • Selecione Reservar fluxo de entrada (para utilização por futuros nós de entrada e de recebimento TCPIP), em seguida, liberar após a propagação para especificar que este fluxo de entrada pode ser utilizado apenas por este nó e pelos nós de recebimento que o solicitam, especificando o ID de conexão correto. Quando a mensagem tiver sido propagada, este fluxo de entrada será retornado ao conjunto e se tornará disponível para utilização por qualquer nó de entrada ou de recebimento.
    • Utilize a propriedade Modificação do Fluxo de Saída para especificar se o fluxo de saída será reservado ou liberado. Estas opções estarão disponíveis apenas se você não tiver selecionado a propriedade Fechar fluxo de saída após o envio de um registro.
      • Selecione Deixar Inalterado para deixar o fluxo de saída como ele estava quando entrou no nó. Esse valor é selecionado por padrão.
      • Selecione Liberar Fluxo de Saída para especificar que este fluxo de saída será retornado ao conjunto e ficará disponível para utilização por qualquer nó de saída.
      • Selecione Reservar fluxo de saída (para utilização por futuros nós de saída TCPIP) para especificar que este fluxo de saída pode ser utilizado apenas por este nó e por outros nós de saída que o solicitam, especificando o ID de conexão. Quando o fluxo de entrada da conexão estiver reservado, nenhum outro nó poderá utilizá-lo sem especificar o ID de conexão correto.
      • Selecione Reservar fluxo de saída (para utilização por futuros nós de saída TCPIP), em seguida, liberar após a propagação para especificar que este fluxo de saída pode ser utilizado apenas por este nó e por nós de saída que o solicitam, especificando o ID de conexão correto. Após a propagação da mensagem, este fluxo de saída será retornado ao conjunto e se tornará disponível para utilização por qualquer nó de saída.
  4. Na guia Pedido, especifique o local dos dados a serem gravados. Você pode especificar as propriedades nessa guia como as expressões XPath ou ESQL. O Assistente de Conteúdo está disponível na visualização Propriedades e também no XPath Expression Builder, que pode ser executado clicando em Editar à direita de cada propriedade.
    • Em Local do Nome do Host, especifique o local do valor para substituir o Nome do Host configurado na propriedade Detalhes da Conexão da guia Básico. Se você não especificar um local, o valor padrão será $LocalEnvironment/TCPIP/Receive/Hostname.
    • Em Local da Porta, especifique o local do valor para substituir a Porta configurada na propriedade Detalhes da conexão da guia Básico. Se você não especificar um local, o valor padrão será $LocalEnvironment/TCPIP/Receive/Port.
    • Em Local do ID, especifique o local do Id do soquete que está sendo utilizado. Esse identificador interno é utilizado por WebSphere Message Broker exclusivamente para identificar uma conexão. Se você não especificar um local, o valor padrão será $LocalEnvironment/TCPIP/Receive/Id.
    • Em Local do ID de Resposta, especifique o local do ID de Resposta que está armazenado na conexão que está sendo utilizada. O ID de Resposta pode ser utilizado quando os dados forem retornados em um nó de entrada. Se você não especificar um loca, o valor padrão será $LocalEnvironment/TCPIP/Receive/ReplyId.
  5. Na guia Resultado, configure valores para as propriedades que determinam onde a resposta será armazenada.
    • Utilize a propriedade Local de Dados de Saída para especificar o local de início na árvore de mensagens de saída, em que os elementos analisados a partir da cadeia de bits da mensagem estão armazenados. O valor padrão é $OutputRoot.
    • Utilize a propriedade Copiar Ambiente Local para especificar se o ambiente local será ou não copiado para a mensagem de saída.
      • Se Copiar Ambiente Local for selecionado, uma nova cópia de ambiente local será criada na árvore e será preenchida com o conteúdo do ambiente local a partir do nó precedente. Isto significa que, se um nó alterar o ambiente local, os nós de envio de dados não serão afetados por essas alterações, porque eles possuem suas próprias cópias. Este valor é o padrão.
      • Se Copiar Ambiente Local não for selecionado, o nó não gerará sua própria cópia de ambiente local, mas utilizará o ambiente local transmitido para ele pelo nó precedente. Portanto, se um nó alterar o ambiente local, as alterações serão refletidas pelos nós de envio de dados.
  6. Na guia Análise de Mensagem de Entrada, defina os valores para as propriedades que o nó utiliza para determinar como analisar a mensagem de entrada.
    Se a mensagem recebida tiver um cabeçalho MQRFH2, você não precisa configurar valores para as propriedades Análise da Mensagem de Entrada porque os valores são derivados da pasta <mcd> no cabeçalho MQRFH2; por exemplo:
    <mcd><Msd>MRM</Msd><Set>DHM4UO906S001</Set><Type>receiptmsg1</Type>
    <Fmt>XML</Fmt></mcd>

    Se você configurar valores, e se eles forem diferentes dos valores no cabeçalho MQRFH2, os valores no cabeçalho MQRFH2 terão precedência.

    • Em Domínio de Mensagem, selecione da lista o nome do analisador que está sendo utilizado. O padrão é BLOB. Você pode escolher a partir das seguintes opções:
      • DFDL
      • XMLNSC
      • DataObject
      • JSON
      • BLOB
      • MIME
      • MRM
      • JMSMap
      • JMSStream
      • XMLNS
      Também é possível especificar um analisador definido pelo usuário, se apropriado.
    • Se você estiver usando o analisador DFDL, MRM ou XMLNSC no modo de validação, selecione o modelo de mensagem relevante na lista. Essa lista é preenchida com conjuntos de mensagens disponíveis quando você seleciona MRM ou XMLNSC como o domínio de mensagem ou com arquivos de esquema DFDL disponíveis ao selecionar DFDL como o domínio de mensagem.
    • Se você estiver utilizando o analisador DFDL ou MRM, selecione a mensagem correta na lista em Mensagem. Essa lista é preenchida com mensagens definidas no modelo de mensagem que você selecionou.
    • Se você estiver utilizando o analisador MRM, selecione o formato da mensagem a partir da lista em Formato Físico. Essa lista inclui todos os formatos físicos definidos para este modelo de mensagem.
    • Especifique o ID do conjunto de caracteres codificado pela mensagem no ID do Conjunto de Caracteres Codificados pela Mensagem.
    • Selecione a codificação da mensagem na lista em Codificação da Mensagem ou especifique um valor de codificação numérico. Para obter informações adicionais sobre codificação, consulte Conversão de Dados.
  7. Na subguia Opções do Analisador:
    • Analisar Tempo é, por padrão, configurado como On Demand, o que faz com que a análise da mensagem seja atrasadas. Para que a mensagem seja analisa imediatamente, consulte Analisando On Demand.
    • Se você está utilizando o analisador XMLNSC, configure os valores para as propriedades que determinam como o analisador XMLNSC opera. Para obter informações adicionais, consulte Manipulando Mensagens no Domínio XMLNSC.
  8. Use a guia Registros e Elementos para especificar como os dados são interpretados como registros. Somente um registro é recuperado cada vez que o nó TCPIPServerReceive é iniciado; portanto, se o fluxo TCP/IP contiver várias mensagens lógicas, você deverá iniciar o nó várias vezes para receber todas as mensagens.
    • Utilize a propriedade Detecção de Registro para determinar como os dados são divididos em registros, cada um deles gera uma única mensagem. Escolha a partir das seguintes opções:
      • Conexão Fechada especifica que todos os dados enviados durante uma conexão são um único registro.
      • Comprimento Fixo especifica que cada registro é um número fixo de bytes em comprimento. Cada registro deve conter o número de bytes especificado na propriedade Comprimento, exceto possivelmente um registro final menor no arquivo.
      • Selecione Delimitado se os registros que você está processando forem separados, ou finalizados, por um final de linha do DOS ou UNIX ou por uma seqüência de bytes do delimitador definido pelo usuário. Especifique o delimitador e tipo de delimitador nas propriedades Delimitador e Tipo de Delimitador.
      • Selecione Seqüência de Registro Analisada se os dados contiverem uma seqüência de um ou mais registros que são serialmente reconhecidos pelo analisador que é especificado no Domínio de Mensagem. O nó propaga cada registro reconhecido como uma mensagem separada. Se você selecionar esta opção de Detecção de Registro, o analisador especificado no Domínio de Mensagem deverá ser XMLNSC ou MRM (formato físico CWF ou TDS).
    • Se você configurou Detecção de Registro para Comprimento Fixo, utilize Comprimento para especificar o comprimento necessário para o registro de saída. Esse valor deve estar entre 1 byte e 100 MB. O padrão é 80 bytes.

      Se você configurar Detecção de Registro para Conexão Fechada, Comprimento Fixo ou Delimitado, um limite de 100 MB se aplicará ao comprimento dos registros. Se você configurar Detecção de Registro para Sequência de Registros Analisados, o nó TCPIPServerReceive não determina ou limita o comprimento de um registro. Os nós que são recebidos no fluxo de mensagens podem tentar determinar o comprimento do registro ou processar um registro longo. Se você tiver a intenção de processar registros grandes dessa forma, assegure que seu intermediário tenha memória suficiente. Talvez seja necessário aplicar as técnicas de fluxo de mensagens descritas na amostra Sistema de Mensagens Grande para fazer melhor uso da memória disponível.

    • Se você configurou Detecção de Registro para Delimitado, utilize Delimitador para especificar o delimitador que deverá ser utilizado. Escolha a partir das seguintes opções:
      • O Final da Linha do DOS ou UNIX que, nos sistemas UNIX, especifica o caractere de avanço de linha (<LF>, X'0A') e, nos sistemas Windows, especifica um caractere de retorno de carro seguido por um caractere de avanço de linha (<CR><LF>, X'0D0A'). O nó trata ambas cadeias como delimitadores, independentemente do sistema no qual o intermediário está em execução. Se ambas cadeias aparecerem no mesmo arquivo, o nó reconhece ambas como delimitadores. O nó não reconhece X'15' que, nos sistemas z/OS® é o byte 'newline'; configure esta propriedade para Delimitador Customizado e configure Delimitador Customizado para 15 se seu arquivo de entrada for codificado utilizando novas linhas EBCDIC.
      • Delimitador Customizado (hexadecimal), permite que uma seqüência de bytes seja especificada em Delimitador Customizado (hexadecimal)
    • Em Delimitador Customizado (hexadecimal), especifique o byte ou os bytes do delimitador a serem utilizados quando Delimitador estiver configurado como Delimitador Customizado (hexadecimal). Especifique esse valor como uma cadeia de dígitos hexadecimal com números pares. O padrão é X'0A' e o comprimento máximo da cadeia é 16 bytes (representados por 32 dígitos hexadecimais).
    • Se você configurou Detecção de Registro para Delimitado, utilize tipo de Delimitador para especificar o tipo do delimitador. Os valores permitidos são:
      • Infix. Se você selecionou esse valor, cada delimitador separa os registros. Se os dados terminarem com um delimitador, os dados (comprimento zero)após o delimitador final ainda são propagados, embora não contenha dados.
      • Sufixo. Se você especificar esse valor, cada delimitador terminará os registros. Se os dados terminarem com um delimitador, nenhum registro vazio será propagado após o delimitador. Se os dados não terminarem com um delimitador, eles serão processados como se um delimitador seguisse os bytes finais dos dados. Sufixo é o valor padrão.
    • O nó TCPIPServerReceive considera cada ocorrência do delimitador na entrada como separando (prefixo) ou terminando (sufixo) cada registro. Se os dados começarem com um delimitador, o nó tratará o conteúdo (comprimento zero) precedendo esse delimitador como um registro e propagará um registro vazio para o fluxo. O delimitador nunca é incluído na mensagem propagada.
  9. Utilize a guia Validação para fornecer validação com base no conjunto de mensagens para mensagens predefinidas. Para obter informações adicionais sobre validação, consulte Validando Mensagens. Para obter mais informações sobre como completar essa guia, consulte Propriedades da Guia Validação.

Terminais e Propriedades

Os terminais do nó TCPIPServerReceive são descritos na tabela a seguir.

Terminal Descrição
In O terminal de entrada que aceita a mensagem para processamento pelo nó.
Saída O terminal de saída para o qual a mensagem será roteada se for recuperada com êxito de um recurso externo. Se não ocorrerem erros no nó de entrada, uma mensagem recebida de um recurso externo será sempre enviada para o terminal Out primeiro.
Timeout O terminal para o qual uma mensagem é enviada quando o tempo especificado na propriedade Tempo limite para aguardar um registro de dados tiver sido excedido. O texto da mensagem é O valor de tempo limite foi excedido.
Failure O terminal de saída para o qual a mensagem é encaminhada se um ocorrer erro. Estes erros incluem falhas causadas por processamento de repetições. Mesmo que a propriedade Validação esteja definida, as mensagens propagadas para esse terminal não serão validadas.

As tabelas a seguir descrevem as propriedades do nó. A coluna com cabeçalho M indica se a propriedade é obrigatória (marcada com um asterisco caso seja necessário digitar um valor quando nenhum padrão for definido); a coluna com cabeçalho C indica se a propriedade é configurável (você poderá alterar o valor quando incluir o fluxo de mensagens ao arquivo BAR para implementá-lo).

As propriedades Descrição do nó TCPIPServerReceive são descritas na tabela a seguir.

Propriedade M A Padrão Descrição
Nome do Nó Não Não TCPIPServerReceive O nome do nó.
Short description Não Não   Uma breve descrição do nó.
Descrição Longa Não Não   Texto que descreve a finalidade do nó no fluxo de mensagens.

As propriedades Básicas do nó TCPIPServerReceive determinam como a conexão TCP/IP é controlada e são descritas na tabela a seguir.

Propriedade M A Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Detalhes da Conexão SIM SIM   Uma cadeia contendo o número da porta a ser utilizado ou o nome de um serviço configurável. Os seguintes formatos são suportados:
  • Nome do serviço configurável. Este valor é utilizado para consultar a porta e o nome do host em serviços configuráveis. Por exemplo, TCPIPProfile1.
  • <Porta>. Este valor é número da porta; por exemplo, 1111.
  • <Porta>. Este valor é o número da porta. Neste caso, o nome do host é assumido como localhost.
connectionDetails
Tempo limite de espera por um registro de dados (segundos) SIM SIM 60 Especifica por quanto tempo o nó atenderá em uma conexão por dados adicionais, após a chegada do primeiro byte de dados. É possível especificar qualquer período de tempo em segundos. O padrão é de 60 segundos. Quando o tempo especificado tiver sido excedido, todos os dados disponíveis serão enviados para o terminal de Falha. timeoutWaitingForData

As propriedades Avançadas do nó do TCPIPServerReceive determinam como o fluxo de dados é controlado e são descritas na tabela a seguir.

Propriedade M A Padrão Descrição
Fechar Conexão SIM Não Não Controla quando a conexão é fechada ou se ela permanecerá aberta. As opções válidas são:
  • Selecione Não para deixar a conexão aberta. Este valor é o padrão.
  • Selecione Após Tempo Limite para fechar a conexão quando ocorrer um tempo limite.
  • Selecione Após o recebimento de dados para fechar a conexão quando for atingido o final do registro.
Fechar fluxo de entrada após o recebimento de um registro SIM Não Não selecionada Especifica se o fluxo de entrada será fechado logo após a recuperação dos dados. Quando o fluxo de entrada da da conexão estiver reservado, nenhum outro nó poderá utilizá-lo sem saber o ID. Por padrão, esta propriedade não será selecionada.
Modificação do Fluxo de Entrada Não Não Deixar Inalterado Especifica se o fluxo de entrada será reservado para ser utilizado apenas por nós de entrada e de recebimento que especificam o ID da conexão ou para liberar o fluxo de entrada no final do fluxo. As opções válidas são:
  • Selecione Deixar Inalterado para deixar o fluxo de entrada como ele estava quando entrou no nó. Esse valor é selecionado por padrão.
  • Selecione Liberar Fluxo de Entrada para especificar que este fluxo de entrada será retornado ao conjunto e ficará disponível para utilização por qualquer nó de entrada ou de recebimento.
  • Selecione Reservar fluxo de entrada (para utilização por futuros nós de entrada e recebimento TCPIP) para especificar que este fluxo de entrada pode ser utilizado apenas por este nó e por outros nós de entrada ou de recebimento que o solicitam especificando o ID de conexão. Quando o fluxo de entrada da conexão estiver reservado, nenhum outro nó poderá utilizá-lo sem especificar o ID de conexão correto.
  • Selecione Reservar fluxo de entrada (para utilização por futuros nós de entrada e de recebimento TCPIP), em seguida, liberar após a propagação para especificar que este fluxo de entrada pode ser utilizado apenas por este nó e pelos nós de recebimento que o solicitam, especificando o ID de conexão correto. Quando a mensagem tiver sido propagada, este fluxo de entrada será retornado ao conjunto e se tornará disponível para utilização por qualquer nó de entrada ou de recebimento.
Modificação do Fluxo de Saída Não Não Deixar Inalterado Especifica se este fluxo de saída será reservado ou liberado e retornado ao conjunto para utilização por qualquer nó de saída. Estas opções estarão disponíveis apenas se você não tiver selecionado a propriedade Fechar fluxo de saída após o envio de um registro.
  • Selecione Deixar Inalterado para deixar o fluxo de saída como ele estava quando entrou no nó. Esse valor é selecionado por padrão.
  • Selecione Liberar Fluxo de Saída para especificar que este fluxo de saída será retornado ao conjunto e ficará disponível para utilização por qualquer nó de saída.
  • Selecione Reservar fluxo de saída (para utilização por futuros nós de saída TCPIP) para especificar que este fluxo de saída pode ser utilizado apenas por este nó e por outros nós de saída que o solicitam, especificando o ID de conexão. Quando o fluxo de entrada da conexão estiver reservado, nenhum outro nó poderá utilizá-lo sem especificar o ID de conexão correto.
  • Selecione Reservar fluxo de saída (para utilização por futuros nós de saída TCPIP), em seguida, liberar após a propagação para especificar que este fluxo de saída pode ser utilizado apenas por este nó e por nós de saída que o solicitam, especificando o ID de conexão correto. Após a propagação da mensagem, este fluxo de saída será retornado ao conjunto e se tornará disponível para utilização por qualquer nó de saída.

As propriedades de Pedido do nó do TCPIPServerReceive especificam o local dos dados a serem gravados. Você pode especificar as propriedades nessa guia como as expressões XPath ou ESQL. O Assistente de Conteúdo está disponível na visualização Propriedades e também no XPath Expression Builder, que pode ser executado clicando em Editar à direita de cada propriedade. As propriedades de Pedido são descritas na seguinte tabela:

Propriedade M P Padrão Descrição
Local da Porta SIM Não $LocalEnvironment/TCPIP/Receive/Port O local do elemento de mensagem que contém a porta. Especifique o local do valor para substituir a Porta que está configurada na propriedade Detalhes da Conexão da guia Básico. Se você não especificar um local, o valor padrão será $LocalEnvironment/TCPIP/Receive/Port.
Local do ID SIM Não $LocalEnvironment/TCPIP/Receive/Id O local do elemento de mensagem que contém o ID. Especifique o local do ID do soquete que está sendo usado. Esse identificador interno é utilizado por WebSphere Message Broker exclusivamente para identificar uma conexão. Se você não especificar um local, o valor padrão será $LocalEnvironment/TCPIP/Receive/Id.
Local do ID de Resposta SIM Não $LocalEnvironment/TCPIP/Receive/ReplyId O local do elemento de mensagem que contém o ID de Resposta. Especifique o local do ID de Resposta que está armazenado na conexão que está sendo usada. O ID de Resposta pode ser utilizado quando os dados forem retornados em um nó de entrada. Se você não especificar um loca, o valor padrão será $LocalEnvironment/TCPIP/Receive/ReplyId.
Local da duração do registro Não Não $LocalEnvironment/TCPIP/Receive/Length O local do elemento de mensagem que contém a duração do registro a ser lida. Especifique o local do valor para substituir a propriedade Comprimento (bytes) na guia Registros e Elementos. Se você não especificar um local, o valor-padrão será $LocalEnvironment/TCPIP/Receive/Length.

As propriedades de Resultado do nó do TCPIPServerReceive determinam onde a resposta deve ser armazenada e são descritas na tabela a seguir:

Propriedade M A Padrão Descrição
Local de dados de saída Não Não $OutputRoot O local de início na árvore de mensagens de saída no qual os elementos analisados a partir da cadeia de bits da mensagem estão armazenados.

Consulte o Combinando uma Mensagem de Resultado com uma Mensagem Recebida.

Copiar ambiente local Não Não Selecionada Especifica se o ambiente local será copiado na mensagem de saída.
  • Se Copiar Ambiente Local for selecionado, uma nova cópia de ambiente local será criada na árvore e será preenchida com o conteúdo do ambiente local a partir do nó precedente. Isto significa que, se um nó alterar o ambiente local, os nós de envio de dados não serão afetados por essas alterações, porque eles possuem suas próprias cópias. Este valor é o padrão.
  • Se Copiar Ambiente Local não for selecionado, o nó não gerará sua própria cópia de ambiente local, mas utilizará o ambiente local transmitido para ele pelo nó precedente. Portanto, se um nó alterar o ambiente local, as alterações serão refletidas pelos nós de envio de dados.

As propriedades de Análise da Mensagem de Entrada do nó do TCPIPServerReceive determinam como analisar a mensagem recebida.

Se a mensagem recebida tiver um cabeçalho MQRFH2, você não precisa configurar valores para as propriedades de Análise da Mensagem de Entrada porque os valores são derivados da pasta <mcd> no cabeçalho MQRFH2; por exemplo:
<mcd><Msd>MRM</Msd><Set>DHM4UO906S001</Set><Type>receiptmsg1</Type>
<Fmt>XML</Fmt></mcd>

Se você configurar valores, e se eles forem diferentes dos valores no cabeçalho MQRFH2, os valores no cabeçalho MQRFH2 terão precedência.

As propriedades Análise de Mensagem de Entrada do nó TCPIPServerReceive são descritas na tabela a seguir.

Propriedade M A Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Domínio de mensagem Não Não BLOB O domínio utilizado para analisar a mensagem que chega.  
Modelo de mensagem Não Não   O nome ou local do modelo de mensagem no qual a mensagem recebida é definida.  
Message Não Não   O nome ou o local de um elemento global que modela um documento de dados inteiro e está contido no arquivo de esquema do modelo de mensagem. Essa lista é preenchida com todas as mensagens disponíveis definidas no modelo de mensagem que você selecionou.  
Formato Físico Não Não   O nome do formato físico da mensagem que chega.  
ID do conjunto de caracteres codificados de mensagens SIM Não Sistema Intermediário Padrão O ID do conjunto de caracteres codificados utilizado para interpretar os dados que estão sendo lidos. messageCodedCharSetIdProperty
Codificação de mensagens SIM Não Sistema Intermediário Determinado O esquema de codificação para números e caracteres grandes utilizado para interpretar os dados que estão sendo lidos. Os valores válidos são Determinado pelo Sistema do Intermediário ou um valor de codificação numérico. Para obter informações adicionais sobre codificação, consulte Conversão de Dados. messageEncodingProperty

As propriedades Opções de Analisador do nó TCPIPServerReceive são descritas na tabela a seguir.

Propriedade M A Padrão Descrição
Cronometragem de análise (Parse timing) Não Não On Demand Esta propriedade controla quando uma mensagem de entrada é analisada. Os valores válidos são:
  • On Demand
  • Imediato
  • Completo
Analisar Tempo é, por padrão, configurado como On Demand, o que faz com que a análise da mensagem seja atrasadas. Para que a mensagem seja analisa imediatamente, consulte Analisando On Demand.
Construir árvore utilizando tipos de dados de esquema XML Não Não Não selecionada Esta propriedade controla 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 Essa propriedade controla se o Analisador Compacto XMLNSC (XMLNSC Compact Parser) é utilizado para mensagens no Domínio XMLNS (XMLNS Domain). Se você configurar essa propriedade, os dados da mensagem serão exibidos em XMLNSC nos nós que estão conectados ao terminal de saída quando o cabeçalho MQRFH2 de entrada ou a propriedade Análise da Mensagem de Entrada, Domínio de Mensagem, for XMLNS.
Reter conteúdo misto Não Não Não selecionada Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar 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 Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar 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 Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar instruções de processamento na 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 Branco Essa propriedade é utilizada para especificar uma lista de elementos na mensagem de entrada que devem ser analisados em segundo plano pelo analisador XMLNSC.

As propriedades Registros e Elementos do nó do TCPIPServerReceive especificam como os dados são interpretados como registros e são descritas na seguinte tabela:

Propriedade M A Padrão Descrição
Detecção de registro SIM Não Conexão Fechada O mecanismo utilizado para identificar registros nos dados de entrada.
  • Conexão Fechada especifica que todos os dados enviados durante uma conexão são um único registro.
  • Comprimento Fixo especifica que cada registro é um número fixo de bytes em comprimento. Cada registro deve conter o número de bytes especificado na propriedade Comprimento, exceto possivelmente um registro final menor no arquivo.
  • Selecione Delimitado se os registros que estão sendo processados forem separados, ou finalizados por um final de linha do DOS ou do UNIX ou por uma seqüência de bytes do delimitador definidos pelo usuário. Especifique o delimitador e tipo de delimitador nas propriedades Delimitador e Tipo de Delimitador.
  • Selecione Seqüência de Registro Analisada se os dados contiverem uma seqüência de um ou mais registros que são serialmente reconhecidos pelo analisador especificado no Domínio de mensagem. O nó propaga cada registro reconhecido como uma mensagem separada. Se você selecionar esta opção de Detecção de Registro, o analisador especificado no Domínio de Mensagem deverá ser XMLNSC ou MRM (formato físico CWF ou TDS).
Comprimento (bytes) SIM Não 0 Se você configurar a Detecção de Registro como Comprimento Fixo, use Comprimento para especificar o comprimento necessário do registro de saída em bytes. Esse valor deve estar no intervalo de 1 byte até 100 MB. O padrão é 80 bytes.

Se você configurar Detecção de Registro para Conexão Fechada, Comprimento Fixo ou Delimitado, um limite de 100 MB se aplicará ao comprimento dos registros. Se você configurar Detecção de Registro para Sequência de Registros Analisados, o nó TCPIPServerReceive não determina ou limita o comprimento de um registro. Os nós que são recebidos no fluxo de mensagens podem tentar determinar o comprimento do registro ou processar um registro longo. Se você tiver a intenção de processar registros grandes dessa forma, assegure que seu intermediário tenha memória suficiente. Talvez seja necessário aplicar as técnicas de fluxo de mensagens descritas na amostra Sistema de Mensagens Grande para fazer melhor uso da memória disponível.

Delimitador SIM Não Final de linha do DOS ou do UNIX Se você configurou Detecção de Registro para Delimitado, utilize Delimitador para especificar o delimitador que deverá ser utilizado. Escolha a partir das seguintes opções:
  • O Final da Linha do DOS ou UNIX que, nos sistemas UNIX, especifica o caractere de avanço de linha (<LF>, X'0A') e, nos sistemas Windows, especifica um caractere de retorno de carro seguido por um caractere de avanço de linha (<CR><LF>, X'0D0A'). O nó trata ambas cadeias como delimitadores, independentemente do sistema no qual o intermediário está em execução. Se ambas cadeias aparecerem no mesmo arquivo, o nó reconhece ambas como delimitadores. O nó não reconhece X'15' que, nos sistemas z/OS é o byte 'newline'; configure esta propriedade para Delimitador Customizado e configure Delimitador Customizado para 15 se seu arquivo de entrada for codificado utilizando novas linhas EBCDIC, como arquivos EBCDIC de um sistema z/OS.
  • Delimitador Customizado (hexadecimal), permite que uma seqüência de bytes seja especificada em Delimitador Customizado (hexadecimal)
Delimitador customizado (hexadecimal) Não Não   O byte ou bytes do delimitador a serem usados quando a detecção de registro Delimitada e o Delimitador Customizado (Hexadecimal) são selecionados. Esta propriedade é obrigatória somente se a propriedade Delimitador estiver configurada como Delimitador Customizado (Hexadecimal). Especifique esse valor como uma cadeia de dígitos hexadecimal com números pares. O padrão é X'0A' e o comprimento máximo da cadeia é 16 bytes (representados por 32 dígitos hexadecimais).
Tipo de delimitador SIM Não Postfix A posição do delimitador quando a detecção de registro Delimitado e Delimitador Customizado (Hexadecimal) são selecionados. As opções válidas são:
  • Infix. Se você selecionou esse valor, cada delimitador separa os registros. Se os dados terminarem com um delimitador, os dados (comprimento zero)após o delimitador final ainda são propagados, embora não contenha dados.
  • Sufixo. Se você especificar esse valor, cada delimitador terminará os registros. Se os dados terminarem com um delimitador, nenhum registro vazio será propagado após o delimitador. Se os dados não terminarem com um delimitador, eles serão processados como se um delimitador seguisse os bytes finais dos dados. Sufixo é o valor padrão.

O nó TCPIPServerReceive considera cada ocorrência do delimitador na entrada como separando (prefixo) ou terminando (sufixo) cada registro. Se os dados começarem com um delimitador, o nó tratará o conteúdo (comprimento zero) precedendo esse delimitador como um registro e propagará um registro vazio para o fluxo. O delimitador nunca é incluído na mensagem propagada.

Esta propriedade será ignorada, a menos que a propriedade Delimitador seja configurada para Delimitador Customizado (Hexadecimal).

As propriedades Validação do nó TCPIPServerReceive são descritas na tabela a seguir.

Para obter uma descrição completa destas propriedades, consulte Propriedades de Validação.

Propriedade M A Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Validar Não SIM Nenhuma Essa propriedade controla se a validação ocorre. Valores válidos são
  • Nenhuma
  • Conteúdo e Valor (Content and Value)
  • Conteúdo
  • Herdar
validateMaster
Ação de falha Não Não Exceção Essa propriedade controla o que acontecerá se a validação falhar. Você pode configurar essa propriedade somente se configurar Validar como Conteúdo ou Conteúdo e Valor. Os valores válidos são:
  • Rastreio do Usuário
  • Local Error Log
  • Exceção
  • Lista de Exceções (Exception List)
 
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:28:57


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