Configuration d'une passerelle JMS

Pour créer des passerelles JMS, procédez comme suit :

  1. Cliquez sur Administrateur du compte > Profils > Participant de communauté.
  2. Entrez les critères de recherche et cliquez sur Rechercher, ou cliquez sur Rechercher sans entrer aucun critère de recherche pour afficher la liste de tous les participants.
  3. Cliquez sur l'icône Afficher les détails pour afficher le profil du participant.
  4. Cliquez sur Passerelles.
  5. Cliquez sur Créer.

Détails sur la passerelle

Dans la page Liste des passerelles, procédez comme suit :

  1. Entrez un nom pour identifier la passerelle. Cette zone doit être renseignée.
  2. Indiquez éventuellement l'état de la passerelle. L'état par défaut est Activé. Une passerelle activée est prête à envoyer des documents. Une passerelle désactivée ne peut pas envoyer de documents.
  3. Indiquez éventuellement si la passerelle est en ligne ou hors ligne. Par défaut, elle est en ligne (Connecté).
  4. Entrez éventuellement une description de la passerelle.

Configuration de la passerelle

Dans la section Configuration de la passerelle, procédez comme suit :

  1. Sélectionnez JMS dans la liste des transferts.
  2. Dans la zone Adresse, entrez l'URI de la destination du document. Cette zone doit être renseignée.

    Pour WebSphere MQ JMS, le format de l'identificateur URI de la cible est le suivant :

    file:///<chemin_liaisons_JNDI_MQ_défini_utilisateur>

    Exemple :

    file:///opt/JNDI-Directory

    Le répertoire contient le fichier ".bindings" (liaisons) pour le JNDI à partir de fichiers. Ce fichier indique à WebSphere Partner Gateway comment acheminer le document à destination.

    Cette zone doit être renseignée.

  3. Entrez éventuellement un nom d'utilisateur et un mot de passe s'ils sont obligatoires pour accéder à la file d'attente JMS.
  4. Dans la zone Nombre de relances, indiquez le nombre de fois que la passerelle doit tenter d'envoyer un document avant d'abandonner. La valeur par défaut est 3.
  5. Dans la zone Intervalle de relance, indiquez le délai d'attente que la passerelle doit observer avant de tenter de renvoyer le document. La valeur par défaut est 300 secondes.
  6. Dans la zone Nombre d'unités d'exécution, indiquez le nombre de documents qui peuvent être traités simultanément. La valeur par défaut est 3.
  7. Dans la zone Validation de l'IP du client, sélectionnez Oui si vous voulez que l'adresse IP de l'expéditeur soit validée avant que le document ne soit traité. Dans le cas contraire, sélectionnez Non. Par défaut, Non est sélectionné.
  8. Dans la zone Mise en file d'attente automatique, sélectionnez Oui si vous voulez que la passerelle soit mise hors ligne (automatiquement) lorsque le nombre de relances a été épuisé. Dans le cas contraire, sélectionnez Non. Par défaut, Non est sélectionné.

    Si vous sélectionnez Mise en file d'attente automatique, tous les documents restent en file d'attente tant que la passerelle n'a pas été mise en ligne manuellement.

  9. Dans la zone Authentification obligatoire, indiquez si un nom d'utilisateur et un mot de passe doivent être fournis pour le document. Par défaut, Non est sélectionné.
  10. Dans la zone Nom de la fabrique JMS, indiquez le nom de la classe Java qu'utilise le fournisseur JMS pour se connecter à la file d'attente JMS. Cette zone doit être renseignée.

    Pour des passerelles JMS internes, ce nom doit correspondre à celui que vous avez indiqué par la commande define qcf, lors de la création du fichier de liaison (étape 4).

    Si vous avez entré le sous-dossier pour le contexte JMS à l'étape 2, n'entrez ici que le nom de fabrique (par exemple Hub). Si vous n'avez pas indiqué le sous-dossier du contexte JMS dans la zone Adresse, indiquez ici le sous-dossier, devant le nom de la fabrique (par exemple JMS/Hub).

  11. Dans la zone Classe de message JMS, entrez la classe de message. Toutes les classes de message JMS valides peuvent être sélectionnées, telles que TextMessage ou BytesMessage. Cette zone doit être renseignée.
  12. Dans la zone Type de message JMS, indiquez le type de message. Cette zone est facultative.
  13. Dans la zone Modules d'URL du fournisseur, entrez le nom des classes (ou du fichier JAR) utilisées par Java pour comprendre l'URL de contexte JMS. Cette zone est facultative. Si vous ne définissez pas de valeur, le chemin au fichier de liaisons est utilisé.
  14. Dans la zone Nom de file d'attente JMS, entrez le nom de la file d'attente JMS vers laquelle les documents doivent être envoyés. Cette zone doit être renseignée.

    Pour des passerelles JMS internes, ce nom doit correspondre à celui que vous avez indiqué par la commande define q, lors de la création du fichier de liaison (étape 4).

    Si vous avez entré le sous-dossier pour le contexte JMS à l'étape 2, n'entrez ici que le nom de file d'attente (par exemple outQ). Dans le cas contraire (si vous n'avez pas indiqué le sous-dossier du contexte JMS dans l'URL du fournisseur JMS), indiquez ici le sous-dossier, devant le nom de la fabrique (par exemple JMS/outQ).

  15. Dans la zone Nom de la fabrique du JNDI du JMS, indiquez le nom de la fabrique utilisée pour se connecter au service désigné. Cette zone doit être renseignée. Vous utiliserez probablement la valeur com.sun.jndi.fscontext.RefFSContextFactory, si vous définissez votre configuration JMS comme indiqué à la section Configuration du concentrateur pour le protocole de transfert JMS.
  16. Pour configurer l'étape Preprocess ou Postprocess de la passerelle, voir Configuration de récupérateurs.Sinon, cliquez sur Sauvegarder.

Copyright IBM Corp. 2003, 2005