Configuration du concentrateur pour le protocole de transfert JMS

Vous avez installé WebSphere MQ en même temps que WebSphere Business Integration Connect. WebSphere MQ intègre une mise en oeuvre de JMS, que vous pouvez utiliser pour configurer la communication JMS.

Toutefois, WebSphere MQ n'est pas configuré pour utiliser le protocole JMS par défaut. Vous trouverez la procédure de configuration de JMS dans cette section.

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 est intégré à l'installation WebSphere MQ, dans le but de modifier la fabrique de contextes et l'URL du fournisseur.

  1. Naviguez jusqu'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 seront utilisées pour l'envoi et la réception de documents et 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 gestionnaire de files d'attente>
     
  3. Entrez la commande suivante pour lancer l'environnement de commande WebSphere MQ :
    runmqsc <nom 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%;<chemin d'accès au répertoire d'installation>\_jvm\jre\bin
 

répertoire d'installation indique le répertoire où WebSphere Business Integration Connect 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(jms)
     
    change ctx(jms) 
     
  4. A partir de l'invite InitCtx/jms>, entrez la configuration JMS suivante :
    define qcf(ConcWBIC) 
         tran(CLIENT) 
         host(<votre_adresse_IP>)
         port(1414) 
         chan(java.channel) 
         qmgr(<nom de la file d'attente>)
     
    define q(<nom>) queue(<nom de la file>) qmgr(<nom gestionnaire files>)
     
    define q(<nom>) queue(<nom de la file>) qmgr(<nom gestionnaire files>)
     
    end
     

Ainsi, la session JMSAdmin suivante utilisée pour définir la la fabrique de connexions aux files d'attente sous le nom ConcWBIC, avec une adresse IP sample.ibm.com où le gestionnaire de files d'attente MQ réside (<nom de la 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(WBICHub) 
     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 
 

Copyright IBM Corp. 1997, 2004