Utilize o nó JMSReply para enviar mensagens para destinos JMS.
O nó JMSReply possui uma função semelhante ao nó JMSOutput, mas o nó JMSReply envia mensagens JMS apenas para o destino de resposta fornecido no campo de cabeçalho JMSReplyTo da árvore de mensagens JMS. Use o nó JMSReply quando deseja tratar uma mensagem JMS que seja produzida a partir de um fluxo de mensagens como uma resposta a uma mensagem de entrada JMS e onde você não tem nenhum outro requisito de roteamento.
O nó JMSReply está contido no repositório JMS da paleta e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:
Considere uma situação em que você cria um fluxo de mensagens no qual uma mensagem do nó JMSInput obtém mensagens ponto a ponto de um destino JMS chamado MyJMSInputQueue. O fluxo de mensagens atualiza um banco de dados utilizando o conteúdo da mensagem, em seguida, responde a um destino JMS chamado MyJMSReplyQueue, que é configurado pela geração do aplicativo no cabeçalho JMSReplyTo da mensagem de entrada.
Em um cenário semelhante para o modelo de mensagem de Publicação/Assinatura, um nó JMSInput efetua assinatura em TopicA, e o nó JMSReply publica no destino TopicB, que foi recuperado do cabeçalho JMSReplyTo da mensagem de entrada.
A função cciOutputMessageCallback pode ser registrada como um retorno e chamada sempre que uma mensagem for enviada por um nó JMSReply. Consulte o cciOutputMessageCallback.
Se o estado de saída do usuário estiver ativo, a função cciOutputMessageCallback será chamada para cada mensagem de saída que é enviada com êxito a partir de um nóJMSReply em que a chamada de retorno é registrada.
Se o nó fornece informações WrittenDestination na árvore LocalEnvironment, o retorno de chamada será chamado após estas informações serem criadas. Consulte o Usando Variáveis LocalEnvironment com Nós JMSOutput e JMSReply.
Conecte um nó Compute ao terminal de Saída de um nó JMSReply e interrogue a Lista WrittenDestination. Para obter informações adicionais, consulte Visualizando a Árvore Mensagem Lógica na Saída do Rastreio.
WrittenDestination = (
JMS = (
DestinationData = (
destinationName = 'queue://jmsQueue1'
initialContext = 'com.sun.jndi.fscontext.RefFSContextFactory'
JMSMessageID = ID:414d512054657374514d2020202020206ab98b4520017a02'
JMSCorrelationID = 'ABCDEFGHIJKLMNOPQRSTUVW'
)
)
)
Quando tiver colocado uma instância do nó JMSReply 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.
Os terminais do nó JMSReply são descritos na tabela a seguir.
Terminal | Descrição |
---|---|
Failure | O terminal de saída para o qual a mensagem é encaminhada se um ocorrer erro. Mesmo que a propriedade Validação (Validation) esteja definida, as mensagens propagadas para esse terminal não serão validadas. |
Saída | O terminal de saída para o qual a mensagem será roteada se for recuperada com êxito da fila do WebSphere MQ. |
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 se você precisar inserir um valor quando nenhum padrão estiver definido), a coluna com cabeçalho C indica se a propriedade é configurável (você pode alterar o valor quando incluir o fluxo de mensagens no arquivo BAR para implementá-lo).
Propriedade | M | P | Default | Descrição |
---|---|---|---|---|
Nome de nó | Não | Não | O tipo de nó | O nome do nó. |
Descrição Breve | 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. |
Propriedade | M | P | Default | Descrição | Propriedade do Comando mqsiapplybaroverride |
---|---|---|---|---|---|
Enviar para a lista de destino no ambiente local | Não | Sim | Não selecionada | Quando você tiver construído uma lista de destinos JMS no ambiente local, selecione esta caixa de opção para usar a lista de destino. Se você não selecionar esta caixa de opção, o nó utilizará o destino JMS configurado. Se você selecionar esta caixa de opção mas não tiver criado uma lista de destinos de JMS no ambiente local, o nó usará o destino de JMS configurado. | useDistList |
Propriedade | M | P | Default | Descrição | Propriedade do Comando mqsiapplybaroverride |
---|---|---|---|---|---|
Nome do provedor JMS | Sim | Não | WebSphere MQ | Selecione um nome de fornecedor JMS na lista ou digite um nome de sua preferência. Quando você selecione um nome na lista, a propriedade Gerador de Contexto Inicial é atualizada
automaticamente com a classe Java™ relevante. Se você digitar seu próprio nome de
provedor JMS, também deverá digitar um valor para o Gerador
de Contexto Inicial. O valor padrão é WebSphere
MQ. Alternativamente, é possível especificar o serviço configurável JMSProviders. |
|
Fábrica de Contexto Inicial | Não | Sim |
|
Essa propriedade é o ponto de início de um namespace JNDI. Um aplicativo JMS utiliza o contexto inicial para obter e consultar a connection factory e objetos de fila
ou tópico para o provedor JMS. Se você selecionar um nome de provedor JMS na lista em Nome de Provedor JMS, a propriedade Gerador de Contexto Inicial é atualizada automaticamente com a classe Java relevante. Se você digitar seu próprio nome de
provedor JMS, também deverá digitar um valor para o Gerador
de Contexto Inicial. O valor padrão de
define o factory de contexto inicial com base em arquivo
para o provedor JMS do WebSphere MQ.Se o nó for configurado para utilizar seu próprio Provedor JMS e a Propriedade de serviços configuráveis da definição mqsichangeproperties tiver o conjunto de atributos InitialContextFactory, isso substituirá a configuração no nó. |
initialContextFactory |
Ligações JNDI de Local | Não | Sim | Esta propriedade especifica o caminho do sistema de arquivo
ou o local de LDAP para o arquivo de ligações. O arquivo de ligações contém definições
para objetos administrados JNDI que são utilizados pelo nó JMSReply. Ao digitar um valor para Ligações JNDI de Local (Location JNDI Bindings), assegure-se de que ele esteja de acordo com as seguintes instruções:
Para obter informações sobre como construir o arquivo de ligações de objetos administrados por JNDI, consulte a documentação fornecida com o provedor JMS. Se o nó estiver configurado para usar seu próprio Provedor JMS e a Propriedade de serviços configuráveis correspondente da definição mqsichangeproperties possuir o atributo jndiBindingsLocation configurado, isso substituirá a configuração no nó. |
locationJndiBindings | |
Nome da Connection Factory | Não | Sim | O nome da connection utilizada pelo nó JMSReply para criar uma conexão com o provedor JMS. Esse nome já deve existir no arquivo de ligações. | connectionFactoryName |
Propriedade | M | P | Default | Descrição |
---|---|---|---|---|
Novo ID de Correlação | Não | Sim | Não selecionada | Se o nó JMSReply precisar gerar um novo ID de Correlação para a mensagem, selecione a caixa de opção. A caixa de opções fica desmarcada por padrão; se você deixar a caixa de opções desmarcada, o ID de Correlação (Correlation ID) da mensagem de saída será obtido do campo JMSCorrelationID na seção JMSTransport_Header_Values da árvore de mensagens. |
Modo de Transação | Não | Não | Não | Essa propriedade controla se a mensagem é recebida em uma
transação JMS. Os valores válidos são Sim e
Não.
|
Modo de Entrega | Não | Sim | Automático | Essa propriedade controla o modo de persistência que um
provedor JMS utiliza para uma mensagem. Os valores válidos são:
|
Expiração da Mensagem (Message Expiration (ms)) | Sim | Sim | 0 | Esta propriedade controla o período de tempo, em milissegundos,
durante o qual o provedor JMS mantém a mensagem JMS de saída.
O
valor padrão, 0, é utilizado para
indicar que a mensagem não deve expirar. Selecione Herdar
do Cabeçalho ou digite um inteiro que representa um número de milissegundos. Se você selecionar Herdar do Cabeçalho, a propriedade herdará o valor do campo JMSExpiry na mensagem JMS,
que está localizada no seguinte local:
|
Prioridade de Mensagem | Não | Sim | 4 | Esta propriedade designa a importância relativa à mensagem e pode ser
utilizada para seleção de mensagem por um aplicativo cliente JMS de recebimento
ou um nó JMSReply. Selecione um valor entre 0 (prioridade mais baixa) e 9 (prioridade mais alta) ou selecione Herdar do Cabeçalho. O valor padrão é 4,
que indica prioridade média.
As prioridades no intervalo de 0 a 4
estão relacionadas à entrega normal.
As prioridades no intervalo de 5 a 9
estão relacionadas a graus de entrega expedida. Se você selecionar Herdar
do Cabeçalho, a propriedade herdará o valor do campo JMSPriority
na mensagem JMS, que está localizada no seguinte local:
|
Tipo de Mensagem | Não | Sim | TextMessage | Esta propriedade controla a classe da mensagem de saída JMS. O valor padrão é TextMessage.
Os valores válidos são:
|
Propriedade | M | P | Default | Descrição | Propriedade do Comando mqsiapplybaroverride |
---|---|---|---|---|---|
Validar | Não | Sim | Herdar | Essa propriedade controla se a validação ocorre. Os valores válidos são:
|
validateMaster |
Ação de Defeito | 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:
|
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. |