Configurando o adaptador IMS para uso com IBM MQ classes for JMS/Jakarta Messaging

IBM® MQ classes for JMS e IBM MQ classes for Jakarta Messaging fazem uso do mesmo adaptador IBM MQ-IMS como usado por outras linguagens de programação. Este adaptador usa o IMS Recurso de anexação do subsistema externo (ESAF).

Antes de Começar

Antes de concluir o procedimento a seguir, você deve configurar o adaptador IMS para os gerenciadores de filas relevantes, e IMS controlar e regiões dependentes, conforme descrito em Configurando o adaptador IMS.
Atenção: Você não precisa executar a etapa que descreve a construção de um stub dinâmico, a menos que você precise do stub dinâmico para outros fins.

Depois de configurado o adaptador IMS , realize o procedimento a seguir.

Procedimento

  1. Atualize a variável LIBPATH no membro do seu IMS PROCLIB que é referenciada pelo parâmetro ENVIRON em sua região dependente de JCL (por exemplo, DFSJVMEV) para que ele inclua as bibliotecas nativas IBM MQ classes for JMS .
    Ou seja, o diretório zFS que contém libmqjims.so. Por exemplo, o DFSJVMEV pode se parecer com o seguinte, em que a última linha é o diretório contendo as bibliotecas nativas IBM MQ classes for JMS ou IBM MQ classes for Jakarta Messaging :
    
    LIBPATH=>
    /java/latest/bin/j9vm:> 
    /java/latest/bin:>
    /ims/latest/dbdc/imsjava/lib:> 
    /mqm/latest/java/lib 
    
  2. Adicionar o IBM MQ classes for JMS ou IBM MQ classes for Jakarta Messaging para o caminho de classe da JVM, usado por sua região dependente IMS , atualizando a opção java.class.path .
    Faça isso seguindo as instruções em DFSJVMMS membro do conjunto de dados do IMS PROCLIB.

    Por exemplo, é possível usar o seguinte, em que a linha em negrito indica a atualização:

    [Jakarta Messaging 3.0 ]
    
    -Djava.class.path=/ims/latest/dbdc/imsjava/imsutm.jar:/ims/latest/dbdc/imsjava/imsudb.jar:
    /mqm/latest/java/lib/com.ibm.mq.jakarta.client.jar
    
    [JMS 2.0 ]
    
    -Djava.class.path=/ims/latest/dbdc/imsjava/imsutm.jar:/ims/latest/dbdc/imsjava/imsudb.jar:
    /mqm/latest/java/lib/com.ibm.mq.allclient.jar
    
    Observação: Embora haja muitos arquivos jar diferentes disponíveis no diretório que contém IBM MQ classes for JMS ou IBM MQ classes for Jakarta Messaging, você precisa apenas de com.ibm.mq.allclient.jar (JMS 2.0) ou com.ibm.mq.jakarta.client.jar (Jakarta Messaging 3.0).
  3. Pare e reinicie quaisquer IMS regiões dependentes que farão uso do IBM MQ classes for JMS ou IBM MQ classes for Jakarta Messaging.

O Que Fazer A Seguir

Crie e configure connection factories e destinos.

Há três abordagens possíveis para instanciar as IBM MQ implementações de fábricas de conexão e destinos. Consulte Criação e configuração de fábricas e destinos de conexão para obter detalhes.

Observe que essas três abordagens são todas válidas em um ambiente IMS .