Configuration d'une passerelle JMS
Pour créer des passerelles
JMS, procédez comme suit :
- Cliquez sur Administrateur du compte > Profils > Passerelles.
- Cliquez sur Créer.
Caractéristiques de la passerelle
Depuis la page Liste des passerelles, exécutez les étapes suivantes :
- Entrez un nom pour identifier la passerelle. Cette zone est obligatoire.
- 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.
- Indiquez éventuellement si la passerelle est en ligne ou hors ligne.
La valeur par défaut est En ligne.
- Entrez éventuellement une description de la passerelle.
Configuration de la passerelle
Dans la section Configuration de la passerelle de la page, procédez comme suit :
- Sélectionnez JMS dans la liste Transfert.
- Dans la zone Adresse, entrez l'URI correspondant à
l'emplacement de livraison du document. Cette zone est obligatoire.
Pour WebSphere MQ JMS, le format de l'URI cible est le suivant :
file:///<chemin_liaisons_JNDI_MQ_défini_utilisateur>
Par 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 est obligatoire.
- Entrez éventuellement un nom d'utilisateur et un mot de passe,
si l'accès à la file d'attente JMS le nécessite.
- Dans la zone Nombre de relances, indiquez le nombre de tentatives
que la passerelle doit effectuer pour envoyer un document avant que l'opération n'échoue. La valeur par défaut est 3.
- Dans la zone Intervalle de relance, entrez la durée pendant laquelle la passerelle doit attendre avant de tenter d'envoyer le document une nouvelle fois. La valeur par défaut est 300 secondes.
- Dans la zone Nombre d'unités d'exécution, entrez
le nombre de documents pouvant être traités simultanément. La valeur par défaut est 3.
- Dans la zone Validation de l'IP du client, sélectionnez Oui si
vous souhaitez 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.
La valeur par défaut est Non.
- Dans la zone Mise en file d'attente automatique,
sélectionnez Oui si vous souhaitez que la passerelle
soit mise hors ligne (automatiquement) lorsqu'un incident de livraison est
sur le point de se produire du fait que le nombre de relances est épuisé. Dans le cas
contraire, sélectionnez Non.
La valeur par défaut est Non.
Lorsque vous sélectionnez l'option Mise en file
d'attente automatique, tous les documents restent dans la file d'attente
jusqu'à ce que la passerelle soit mise en ligne manuellement.
- Dans la zone Authentification obligatoire,
indiquez si un nom d'utilisateur et un mot de passe doivent être fournis
pour le document. La valeur par défaut est Non.
- Dans la zone Nom de la fabrique JMS, saisissez
le nom de la classe Java utilisée par le fournisseur JMS pour se connecter
à la file d'attente JMS.
Cette zone est obligatoire.
- 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 est obligatoire.
- Dans la zone Type de message JMS, entrez le type de message.
Cette zone est facultative.
- Dans la zone Modules d'URL du fournisseur, entrez
le nom des classes (ou du fichier JAR) utilisé 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é.
- Dans la zone Nom de file d'attente JMS, entrez
le nom de la file d'attente vers laquelle les documents doivent être
envoyés. Cette zone est obligatoire.
- Dans la zone Nom de la fabrique du JNDI du JMS, entrez
le nom de la fabrique utilisé pour la connexion au service annuaire. Cette zone est obligatoire.
- Si vous souhaitez configurer l'étape Traitement préalable ou Traitement ultérieur
de la passerelle, voir Configuration de récupérateurs.
Sinon, cliquez sur Sauvegarder.
