Configuration du concentrateur pour le protocole de transfert JMS

Cette section indique comment paramétrer le concentrateur pour utiliser le transfert JMS. Si vous comptez utiliser le transfert JMS pour envoyer des documents à partir du concentrateur ou en recevoir, procédez de la façon indiquée ici. Dans le cas contraire, passez à la section suivante.

Remarque : Cette section indique comment utiliser l'implémentation JMS de WebSphere MQ pour paramétrer l'environnement JMS. Ces procédures décrivent également comment définir les files d'attente locales. Si vous voulez définir les file d'attente éloignée et de transmission, consultez la documentation de WebSphere MQ.

Dans les sections suivantes de ce document, vous apprendrez comment configurer des passerelles ou cibles JMS (ou les deux). Ces tâches sont décrites dans les sections Définition d'une cible JMS et Configuration d'une passerelle JMS.

Création d'un répertoire pour JMS

Vous devez tout d'abord créer un répertoire pour JMS. Par exemple, supposons que vous vouliez créer un répertoire nommé JMS sous le répertoire temporaire c:\temp d'une installation Windows. Voici comment procéder :

  1. Ouvrez l'Explorateur Windows.
  2. Ouvrez le répertoire C:\temp.
  3. Créez un nouveau dossier nommé JMS.

Modification de la configuration JMS par défaut

Cette section vous indique comment mettre à jour le fichier JMSAdmin.config, qui fait partie de l'installation de WebSphere MQ, afin de modifier la fabrique de contextes et l'URL du fournisseur.

  1. Accédez au répertoire Java\bin de WebSphere MQ. Par exemple, dans le cas d'une installation Windows, accédez au répertoire C:\IBM\MQ\Java\bin
  2. Ouvrez le fichier JMSAdmin.config dans un éditeur de texte en clair, tel que le Bloc-Notes ou vi.
  3. Ajoutez le caractère # au début des lignes suivantes :
    INITIAL_CONTEXT_FACTORY=com.sun.jndi.ldap.LdapCtxFactory
     PROVIDER_URL=ldap://polaris/o=ibm,c=us
  4. Supprimez le caractère # situé au début des lignes suivantes :
    #INITIAL_CONTEXT_FACTORY=com.sun.jndi.fscontext.RefFSContextFactory 
     #PROVIDER_URL=file:/C:/JNDI-Directory
  5. Modifiez la ligne PROVIDER_URL=file:/C:/JNDI-Directory de sorte qu'elle indique le nom du répertoire JMS défini à l'étape Création d'un répertoire pour JMS. Par exemple, si vous avez défini le répertoire c:/temp/JMS la ligne doit se présenter comme suit :
    PROVIDER_URL=file:/c:/temp/JMS
  6. Enregistrez le fichier.

Création des files d'attente et du canal

Cette section vous indique comment utiliser WebSphere MQ pour créer les files d'attente qui serviront à l'envoi et à la réception de documents, ainsi que le canal pour cette communication. On suppose que le gestionnaire de files d'attente a été créé. Le nom du gestionnaire de files d'attente doit être remplacé à l'emplacement où le <nom du gestionnaire de files d'attente> apparaît dans les étapes suivantes.On suppose également qu'un programme d'écoute a été démarré pour cette file d'attente sur le port TCP 1414.

  1. Ouvrez une invite de commande.
  2. Entrez la commande suivante pour lancer le serveur de commande WebSphere MQ :
    strmqcsv <nom du gestionnaire de files d'attente>
  3. Entrez la commande suivante pour lancer l'environnement de commande WebSphere MQ :
    runmqsc <nom du gestionnaire de files d'attente>
  4. Entrez la commande suivante pour créer la file d'attente WebSphere MQ où seront mis en attente les documents entrants envoyés au concentrateur :
    def ql(<nom_file_attente>)

    Ainsi, pour créer une file d'attente appelée JMSIN, vous devez entrer :

    def ql(JMSIN)
  5. Entrez la commande suivante pour créer la file d'attente WebSphere MQ où seront mis en attente les documents envoyés à partir du concentrateur :
    def ql(<nom_file_attente>)

    Par exemple, pour créer une file d'attente nommée JMSOUT, vous devriez entrer :

    def ql(JMSOUT)
  6. Entrez la commande suivante pour créer un canal WebSphere MQ qui sera utilisé pour les documents envoyés à partir du concentrateur :
    def channel(<nom_canal>) CHLTYPE(SVRCONN)

    Par exemple, pour créer un canal appelé java.channel, vous devez entrer :

    def channel(java.channel) CHLTYPE(SVRCONN)
  7. Entrez la commande suivante pour quitter l'environnement de commande WebSphere MQ :
    end

Ajout d'une phase d'exécution Java à votre environnement

Entrez la commande suivante pour ajouter une phase d'exécution Java à votre chemin système :

set PATH=%PATH%;<ProductDir>\_jvm\jre\bin 

ProductDir indique le répertoire dans lequel WebSphere Partner Gateway est installé.

Définition de la configuration JMS

Pour définir la configuration JMS, procédez comme suit :

  1. Passez dans le répertoire WebSphere MQ Java (répertoire <chemin d'accès au répertoire d'installation Websphere MQ>\java\bin)
  2. Démarrez l'application JMSAdmin en tapant la commande suivante :
    JMSAdmin
  3. Définissez un nouveau contexte JMS en tapant les commandes suivantes à partir de l'invite InitCtx> :
    define ctx(<nom_contexte>)
    change ctx(<nom_contexte>)

    Par exemple, si le nom_contexte est JMS, les commandes seront du type :

    define ctx(JMS)

    change ctx(JMS) 
  4. A partir de l'invite InitCtx/jms>, entrez la configuration JMS suivante :
    define qcf(nom_de_fabrique_de_connexion)
         tran(CLIENT) 
         host(<votre_adresse_IP>) 
         port(1414) 
         chan(java.channel) 
         qmgr(<nom_du_gestionnaire_de_file_d'attente>)
    define q(<nom>) queue(<nom_file>) qmgr(<nom_du_gestionnaire_de_file_d'attente>)
    define q(<nom>) queue(<nom_file>) qmgr(<nom_du_gestionnaire_de_file_d'attente>)
    end

Les étapes précédentes ont créé le fichier .bindings, qui se trouve dans un sous-dossier du dossier indiqué à l'étape 5. Le nom du sous-dossier et le nom indiqué pour votre contexte JMS.

Ainsi, la session JMSAdmin suivante sert à définir la fabrique de connexions aux files d'attente sous le nom Hub, avec l'adresse IP sample.ibm.com où réside le gestionnaire de files d'attente MQ (<nom du gestionnaire de file d'attente> de sample.queue.manager).L'exemple utilise les noms de file d'attente JMS et le nom de canal créé dans Création des files d'attente et du canal. Notez que les informations entrées par l'utilisateur suivent l'invite >.

InitCtx> define ctx(jms)
 InitCtx> change ctx(jms) 
 InitCtx/jms> define qcf(Hub) 
     tran(CLIENT) 
     host(sample.ibm.com) 
     port(1414) 
     chan(java.channel) 
     qmgr(sample.queue.manager) 
 InitCtx/jms> define q(inQ) queue(JMSIN) qmgr(sample.queue.manager) 
 InitCtx/jms> define q(outQ) queue(JMSOUT) qmgr(sample.queue.manager) 
 InitCtx/jms>end 

Dans cet exemple, le fichier .bindings se trouvera dans le répertoire c:/temp/JMS/JMS , où c:/temp/JMS est le PROVIDER_URL, et JMS le nom de contexte.

Copyright IBM Corp. 2003, 2005