Usando os aplicativos de amostra IBM MQ classes for JMS

Os aplicativos de amostra IBM® MQ classes for JMS fornecem uma visão geral dos recursos comuns da API JMS . É possível usá-los para verificar a sua instalação e o servidor de sistema de mensagens configurado e para ajudar a construir os seus próprios aplicativos.

Sobre esta tarefa

Se você precisar de ajuda para criar seus próprios aplicativos, será possível usar os aplicativos de amostra como um ponto de início. Tanto a origem quanto uma versão compilada são fornecidas para cada aplicativo. Revise o código-fonte de amostra e identifique as etapas principais para criar cada objeto necessário para seu aplicativo (ConnectionFactory, Conexão, Sessão, Destino, e um Produtor, ou um Consumidor, ou ambos) e para configurar quaisquer propriedades específicas que sejam necessárias para especificar como você deseja que seu aplicativo funcione. Para obter mais informações, consulte Escrevendo classes IBM MQ para aplicativos JMS/Jakarta Messaging. As amostras podem estar sujeitas a alterações em releases futuros de IBM MQ.

Para JMS 2.0, a Tabela 1 mostra onde os IBM MQ classes for JMS aplicativos de amostra estão instalados em cada plataforma.

Nota:

[Jakarta Messaging 3.0 ] Para IBM MQ classes for Jakarta Messaging, novas amostras estão sendo preparadas.

Tabela 1. Diretórios de instalação para os aplicativos de amostra IBM MQ classes for JMS
Plataforma	Diretório
AIX® Linux®	`MQ_INSTALLATION_PATH`/samp/jms/samples
Windows	`MQ_INSTALLATION_PATH`\tools\jms\samples
IBM i	/qibm/proddata/mqm/java/samples/jms/samples
z/OS®	`MQ_INSTALLATION_PATH`/java/samples/jms

Dentro desse diretório, há subdiretórios que contêm um ou mais aplicativos de amostra, conforme mostrado na Tabela 2.

Tabela 2. IBM MQ classes for JMS aplicativos de amostra
Nome da amostra	Descrição
JmsBrowser.java	Um aplicativo de navegador de fila JMS que olha para todas as mensagens disponíveis na fila nomeada, sem removê-las, na ordem em que seriam recebidas por um aplicativo de consumidor.
JmsConsumer.java	Um aplicativo de navegador de fila JMS que analisa todas as mensagens disponíveis na fila nomeada, sem removê-las, na ordem em que seriam recebidas por um aplicativo consumidor, ao olhar para a instância de fábrica de conexão e a instância de destino em um contexto inicial (Esta amostra suporta apenas o contexto do sistema de arquivos).
JmsJndiConsumer.java	Um aplicativo JMS consumidor (receptor ou assinante) que recebe uma mensagem do destino nomeado (fila ou tópico) olhando para cima a instância de fábrica de conexão e a instância de destino em um contexto inicial (Esta amostra suporta apenas o contexto do sistema de arquivos).
JmsJndiProducer.java	Um aplicativo JMS produtor (remetente ou editor) que envia uma mensagem simples para o destino nomeado (fila ou tópico) olhando para a instância de fábrica de conexão e a instância de destino em um contexto inicial (Esta amostra suporta apenas o contexto do sistema de arquivos).
JmsProducer.java	Um aplicativo de produtor (remetente ou editor) JMS que envia uma mensagem simples para o destino nomeado (fila ou tópico).
/interativo/
SampleConsumerJava.java	Receber mensagens de um tópico/fila.
SampleProducerJava.java	Enviar mensagens para um tópico/fila.
/interativo/helper/
BaseOptions.java	Uma classe abstrata que pode ser estendida para fornecer a funcionalidade de opções de usuário.
IsValidType.java	Classe abstrata para classes verificadoras de validade.
JmsApp.java	Uma classe abstrata que pode ser estendida para fornecer funcionalidade de consumidor/produtor.
Keys.java	Um conjunto de chaves que definem opções para os aplicativos de amostra.
Literals.java	Um conjunto de literais constantes.
MyContext.java	O contexto no qual as opções são apresentadas.
Options.java	Fornece funcionalidade para opções de usuário.
OptionsPresenter.java	Contexto no qual as opções atuais são apresentadas.
/simples/
SimpleAsyncPutPTP.java	Um aplicativo simples para o sistema de mensagens ponto a ponto; a mensagem é enviada de forma assíncrona (também conhecida como o sistema de mensagens fire-and-forget). Nenhuma mensagem é recebida.
SimpleDurableSub.java	Um aplicativo simples que demonstra o recurso de assinatura durável.
SimpleJNDILookup.java	Um aplicativo mínimo e simples que demonstra consulta de objetos JMS usando o contexto inicial. Nenhuma conexão com o gerenciador de filas é feita e nenhuma mensagem é enviada ou recebida.
SimpleMQMDRead.java	Um aplicativo simples que demonstra como um aplicativo JMS pode avalizar os campos do MQ Message Descriptor (MQMD) como JMS propriedades da mensagem. Nenhuma mensagem é enviada; supõe-se que a fila em uso seja preenchida com algumas mensagens.
SimpleMQMDWrite.java	Um aplicativo simples que demonstra como um aplicativo JMS pode gravar campos do MQ Message Descriptor (MQMD). Nenhuma mensagem é recebida.
SimplePTP.java	Um aplicativo mínimo e simples para o sistema de mensagens ponto a ponto.
SimplePubSub.java	Um aplicativo mínimo e simples para o sistema de mensagens de publicação/assinatura.
SimpleReadAheadPTP.java	Um aplicativo simples para o sistema de mensagens ponto a ponto; as mensagens são transmitidas por meio do gerenciador de filas (também conhecido como recurso de leitura antecipada). Nenhuma mensagem é enviada; supõe-se que a fila em uso seja preenchida com algumas mensagens.
SimpleRequestor.java	Um aplicativo simples que usa um solicitante para enviar uma mensagem de solicitação e, em seguida, aguardar e receber a resposta. Nota: supõe-se que algum outro aplicativo processará a mensagem de solicitação e enviará a mensagem de resposta.
SimpleResponder.java	Um aplicativo simples que recebe uma mensagem em um destino e, em seguida, envia uma resposta para o destino replyTo da mensagem. O aplicativo é escrito para operar em conjunto com a amostra SimpleRequestor.
SimpleRetainedPub.java	Um aplicativo simples que demonstra uma publicação retida. Nenhuma mensagem é recebida.
SimpleWMQJMSPTP.java	Um aplicativo mínimo e simples para o sistema de mensagens ponto a ponto.
SimpleWMQJMSPubSub.java	Um aplicativo mínimo e simples para o sistema de mensagens de publicação/assinatura.

O IBM MQ classes for JMS fornece um script chamado runjms que pode ser usado para executar os aplicativos de amostra. Este script configura o ambiente IBM MQ para permitir que você execute os aplicativos de amostra IBM MQ classes for JMS .

A Tabela 3 mostra o local do script em cada plataforma:

Tabela 3. Localização do script runjms
Plataforma	Diretório
AIX Linux	`MQ_INSTALLATION_PATH`/java/bin/runjms
Windows	`MQ_INSTALLATION_PATH`\java\bin\runjms.bat
IBM i	/qibm/proddata/mqm/java/bin/runjms ou /qibm/proddata/mqm/java/bin/runjms64
z/OS	`MQ_INSTALLATION_PATH`/java/bin/runjms

Para usar o script runjms para chamar um aplicativo de amostra, conclua as seguintes etapas:

Procedimento

Ative um prompt de comandos e navegue até o diretório que contém o aplicativo de amostra que você deseja executar.
Insira o seguinte comando:
```
Path to the runjms script/runjms sample_application_name
```
O aplicativo de amostra exibe uma lista dos parâmetros necessários.
Insira o comando a seguir para executar a amostra com estes parâmetros:
```
Path to the runjms script/runjms sample_application_name parameters
```

exemplo

Por exemplo, para executar a amostra JmsBrowser em Linux, digite os seguintes comandos:

cd /opt/mqm/samp/jms/samples
/opt/mqm/java/bin/runjms JmsBrowser -m QM1 -d LQ1