Este tópico contém as seguintes seções:
Utilize o nó JMSOutput para enviar mensagens para destinos JMS. O nó JMSOutput age como um produtor de mensagens JMS e pode publicar todos os seis tipos de mensagens definidos no Especificação Java Message Service, Versão 1.1. As mensagens são publicadas utilizando chamadas de método, que são descritas na especificação JMS.
O nó JMSOutput é representado no workbench pelo seguinte ícone:
Os fluxos de mensagens, que manipulam mensagens recebidas de conexões com provedores JMS, sempre devem ser iniciados com um nó JMSInput. Se você incluir o nó JMSOutput em um fluxo de mensagens, não precisará incluir um nó JMSInput. No entanto, se você não incluir um nó JMSInput, deverá incluir o nó MQJMSTransform para transformar a mensagem no formato esperado pelo nó JMSOutput.
Se estiver propagando mensagens JMS e criando um fluxo de mensagens para ser utilizado como um subfluxo, será necessário utilizar uma instância do nó JMSOutput como o último nó para criar um terminal de saída para o subfluxo.
Para plataformas distribuídas, copie os arquivos .jar java e quaisquer bibliotecas nativas para o cliente do provedor JMS para o diretório de classes compartilhadas do intermediário. Por exemplo, no Windows C:\Documents and Settings\All Users\Application Data\IBM\MQSI\shared-classes. Isso assegura que o caminho de classe Java para os nós JMS sejam configurados corretamente.
Para o z/OS, não há nenhum diretório de classes compartilhadas. Em vez disso, você deve especificar cada arquivo .jar Java do provedor JMS no caminho de classe no membro BIPPROF do PDS (Partitioned Data Set) do intermediário. Em seguida, atualize o LIBPATH com quaisquer bibliotecas nativas e envie a tarefa BIPGEN JCL para atualizar o intermediário ENVFILE.
Quando tiver colocado uma instância do nó JMSOutput em um fluxo de mensagens, será possível configurá-lo. Clique com o botão direito na visualização do editor clique em Propriedades. As propriedades básicas do nó serão exibidas no diálogo de propriedades.
Todas as propriedades obrigatórias, que não possuem um valor padrão definido, são marcadas com um asterisco no diálogo das propriedades.
Configure o nó JMSOutput da seguinte forma:
com.sun.jndi.fscontext.RefFSContextFactory, que define o depósito de informações do provedor de contexto inicial baseado em arquivo para o provedor JMS do WebSphere MQ.
Para identificar o nome do Depósito de Informações do Provedor de Contexto Inicial para o provedor JMS, consulte a documentação do provedor JMS.
Ao digitar um valor para Ligações de JNDI de Local, assegure que esteja de acordo com as seguintes instruções:
Para obter informações sobre como construir o arquivo de ligações de objetos administrados de JNDI, consulte a documentação fornecida com o provedor JMS.
O valor padrão é vazio e, neste caso, a mensagem de saída JMS pode ser considerada um datagrama. Se o campo estiver em branco, o nó JMSOutput não esperará uma resposta do cliente JMS de recebimento.
Digite um valor em milissegundos para especificar por quanto tempo a mensagem será mantida pelo provedor JMS. O valor padrão 0 é utilizado para indicar que a mensagem não deve expirar.
Digite um valor, no qual os valores válidos para prioridade de mensagem sejam de 0 (o mais baixo) a 9 (o mais alto). 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.
Para obter detalhes adicionais, consulte Validando Mensagens e Propriedades de Validação para Mensagens no Domínio MRM.
Clique em Cancelar para fechar o diálogo e descartar todas as alterações feitas nas propriedades.
Conecte o terminal de entrada do nó JMSOutput ao nó a partir do qual as mensagens de saída serão roteadas.
Conecte o terminal de saída deste nó a outro nó no fluxo de mensagens, se desejar processar mais a mensagem, para processar erros ou para enviar a mensagem para um destino adicional.
Quando incluir um nó JMSOutput em um fluxo de mensagens, o valor configurado para o Modo de Transação define se as mensagens serão recebidas sob o ponto de sincronização.
O provedor JMS pode fornecer arquivos jar adicionais requeridos para suporte transacional. Consulte a documentação do provedor JMS. Por exemplo, em plataformas Distribuídas (não-z/OS), o provedor JMS do WebSphere MQ fornece um arquivo jar extra com.ibm,mqetclient.jar . Esse jar também deve ser incluído no diretório shared_classes do intermediário. Consulte Disponibilizando o Cliente do Provedor JMS para os Nós JMS neste tópico.
<Broker Installation Path>/bin/ JMSSwitch.dll XAOpenString=<Initial Context >,<location JNDI>, <Optional> ThreadOfControl=THREAD
XAResourceManager: Name=<Jms_Provider_Name> SwitchFile=/<Broker Installation Path>/bin/ JMSSwitch.so XAOpenString=<Initial Context >,<location JNDI>, <Optional> ThreadOfControl=THREADOnde
name é um nome definido pela instalação que identifica um Gerenciador de Recursos do provedor JMS.
SwitchFile é o caminho do sistema de arquivos para a biblioteca JMSSwitch que é fornecida no diretório bin do intermediário.
Os parâmetros opcionais são separados por vírgula e são determinados por posição. Portanto, quaisquer parâmetros que estejam faltando devem ser representados por uma vírgula.
<Broker Installation Path>/classes/xarecovery.jar
<Broker Installation Path>/bin
XA não pode utilizar o mesmo Gerenciador de Filas para o intermediário e o provedor até o WebSphere MQ Versão 5.3, CSD12 e WebSphere MQ Versão 6 FixPack 1.
O controle do ponto de sincronização para o provedor JMS é gerenciado com a coordenação do ponto de sincronização RRS do gerenciador de filas do intermediário. Não é necessário modificar o arquivo .ini .
Os terminais do nó JMSOutput são descritos na tabela a seguir.
Terminal | Descrição |
---|---|
Defeito | O terminal de saída para o qual a mensagem é encaminhada se um ocorrer erro. Mesmo que a propriedade Validação 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. |
Capturar | 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 tabelas a seguir descrevem as propriedades do nó; a coluna com cabeçalho M indica se a propriedade é obrigatória (marcado com um asterisco no diálogo de propriedades 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 no arquivo bar para implementá-lo).
As propriedades Básicas do nó JMSOutput são descritas na tabela a seguir.
Propriedade | M | A | O padrão | Descrição |
---|---|---|---|---|
Depósito de Informações do Provedor de Contexto Inicial | Sim | com.sun.jndi.fscontext.RefFSContextFactory | Esse é o ponto de partida de um espaço de nomes de 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. O valor padrão é o utilizado quando o WebSphere MQ Java é utilizado como o provedor JMS. |
|
Ligações JNDI de Local | Não | O caminho do sistema ou local LDAP para o arquivo de ligações | ||
Nome da Connection Factory | Não | O nome da connection factory utilizada pelo nó JMSOutput para criar uma conexão com o provedor JMS. |
As propriedades de Publicação/Assinatura do nó JMSOutput são descritas na tabela a seguir.
Propriedade | M | A | O padrão | Descrição |
---|---|---|---|---|
Tópico do Publicador | Não | O nome do tópico a partir do qual o nó recebe mensagens publicadas. |
As propriedades Ponto a Ponto do nó JMSOutput são descritas na tabela a seguir.
Propriedade | M | A | O padrão | Descrição |
---|---|---|---|---|
Fila de Destino | Não | O nome da fila para a qual o nó publica mensagens de saída. |
As propriedades de Pedido do nó JMSOutput são descritas na tabela a seguir.
Propriedade | M | A | O padrão | Descrição |
---|---|---|---|---|
Modo de Destino | Não | Nome do Destino | Essa propriedade é utilizada para determinar se a mensagem deve ser tratada como um pedido de um datagrama ou como uma resposta. | |
Destino de Resposta | Não | Esse valor é o nome do destino JMS para o qual o aplicativo de recebimento deve enviar uma mensagem de resposta. Para retornar uma mensagem de resposta a esse destino JMS, o nome do destino JMS deve ser conhecido para o domínio do provedor JMS que é utilizado pelo cliente receptor. |
As propriedades Avançadas do nó JMSOutput são descritas na tabela a seguir.
Propriedade | M | A | O padrão | Descrição |
---|---|---|---|---|
Novo ID de Correlação | Não | Essa propriedade é selecionada se um Novo ID de Correlação for requerido. | ||
Modo de Transação | Sim | Não | Automático | Essa propriedade é para determinar se a mensagem que chega é recebida sob o ponto de sincronização. Os valores válidos são Automático, Sim e Não. |
Modo de Entrega | Não | Não Persistente | Seletor de mensagens que irá filtrar mensagens de acordo com o modo de entrega de mensagens. | |
Expiração de Mensagem | Não | 0 | O valor dessa propriedade deve solicitar que o provedor JMS mantenha a mensagem JMS de saída por um período especificado. Os valores estão em milissegundos e o valor padrão 0 é utilizado para indicar que a mensagem não deve expirar. |
|
Prioridade de Mensagem | Não | 4 | O valor dessa propriedade designa a importância relativa da mensagem. Esse valor pode ser utilizado para seleção de mensagem por um aplicativo cliente JMS receptor ou um nó JMSOutput. |
As propriedades de Validação do nó JMSOutput são descritas na tabela a seguir.
Consulte Propriedades de Validação para Mensagens no Domínio MRM para obter uma descrição completa dessas propriedades.Propriedade | M | A | O padrão | Descrição |
---|---|---|---|---|
Validate | Sim | Sim | Nenhum | Essa propriedade determina se a validação ocorrerá. Os valores válidos são Nenhum, Conteúdo e Conteúdo e Valor. |
Ação de Defeito | Sim | Não | Exceção | Essa propriedade determina o que acontece 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, Registro de Erros Local, Exceção e Lista de Exceção. |
Incluir Todas as Limitações do Valor | Sim | Não | Selecionado | Essa propriedade não pode ser editada. A ação padrão, indicada pela seleção da caixa de opções, é que as verificações básicas de limitação de valor estão incluídas na validação Conteúdo e Valor. |
Corrigir | Sim | Não | Nenhum | Essa propriedade não pode ser editada. |
As propriedades de Descrição do nó JMSOutput são descritas na tabela a seguir.
Propriedade | M | A | O padrão | Descrição |
---|---|---|---|---|
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. |