Avant de commencer
Procédure
Pour envoyer une demande à un service Java MQ :
- Cliquez sur Ouvrir le client de services générique
(
) et sélectionnez la page Demandes. - Cliquez sur Ajouter (
) ou, dans
Bibliothèque de demandes, cliquez avec le bouton droit sur Points d'extrémité et sélectionnez un type de demande à envoyer. - Dans la fenêtre Configuration du protocole, sélectionnez WebSphere Java MQ et indiquez la configuration de transport. Si nécessaire, créez la configuration de transport pour l'appel en cliquant sur Nouveau (voir Création d'une configuration de transport WebSphere Java MQ).
- Fournissez les informations suivantes dans l'onglet Général :
- File d'attente
- Nom de la file d'attente défini sur le serveur WebSphere MQ.
- Type de message
- Les types de message sont les suivants :
- Datagramme signifie que le message ne requiert pas de réponse.
- Demande signifie que le message nécessite une réponse.
- Réponse signifie que le message est une réponse à un message de demande antérieur.
- Rapport signifie que le message signale une occurrence prévue ou imprévue, généralement liée à un autre message. Par exemple, un message de demande qui contenait des données non valides.
- Persistance du message
Cette valeur indique si le message est persistant ou non. S'il l'est, il n'est pas affecté par les pannes du système et les redémarrages du gestionnaire de files d'attente. S'il ne l'est pas, il ne survit à un redémarrage que s'il se trouve dans une file d'attente ayant l'attribut NPMCLASS(HIGH). Cependant, même avec l'attribut NPMCLASS (HIGH), un message ne survit pas à une classe QMGR. Les messages non persistants sur les files d'attente avec l'attribut NPMCLASS(NORMAL) sont ignorés au redémarrage du gestionnaire de files d'attente, même si le message se trouve sur une mémoire secondaire lors de la procédure de redémarrage.
- Réponse dynamique
- Cochez cette case pour que le serveur WebSphere MQ crée dynamiquement une file d'attente temporaire comme réponse. Si elle n'est pas cochée, c'est le message de la File d'attente de réponse qui est utilisé.
- File d'attente de réponses
Cet attribut représente le nom de la file d'attente de messages à laquelle l'application qui a envoyé la demande d'extraction du message doit envoyer les messages de réponse et de rapport.
- Gestionnaire de réponses
Il s'agit du nom du gestionnaire de files d'attente sur lequel est définie la file d'attente de réponses.
- Propriétés supplémentaires
- Spécifiez les propriétés supplémentaires des files d'attente.
- Facultatif : Si nécessaire,
fournissez les informations suivantes dans l'onglet Configuration :
- Priorité du message
Il s'agit de la priorité du message. La priorité la plus faible est 0.
- Encodage
Cet attribut spécifie l'encodage des données numériques du message. Il ne s'applique pas aux données numériques de la structure MQMD elle-même.
- Intervalle d'expiration
Il s'agit du délai, en dixièmes de seconde, au-delà duquel le message peut être supprimé s'il n'a pas été extrait de la file d'attente cible. L'intervalle d'expiration est fixé par l'application qui insère (put) le message.
- Jeu de caractères
Identificateur du jeu de caractères des données caractères contenues dans le message de l'application.
- Facultatif : Dans l'onglet Rapport, sélectionnez les messages de rapport à recevoir.
- Facultatif : Si nécessaire, fournissez les informations suivantes dans l'onglet Contexte :
- Données d'identification d'application
Ces informations sont définies par la suite applicative. Utilisez-les pour fournir des informations sur le message ou son émetteur.
- Données d'origine de l'application
Ces informations sont définies par la suite applicative. Utilisez-les pour fournir des informations supplémentaires sur l'origine du message.
- Jeton de comptabilité
Cette information est requise par l'application pour imputer correctement le travail effectué suite au message.
- ID Utilisateur
Il s'agit de l'ID utilisateur de l'application ayant généré le message.
- Facultatif : Dans l'onglet Identificateurs, pour les messages qui nécessitent une entrée binaire, spécifiez l'ID au format chaîne dans la seconde colonne. La première colonne est remplie automatiquement au format hexadécimal.
- Facultatif : Dans l'onglet Segmentation, sélectionnez le segment du message et cliquez sur Suivant.
- Cette étape ne s'applique pas une demande Texte. Sur la page Sélection d'un élément racine, si le service utilise utilise une définition XSD spécifique, sélectionnez-en une dans la liste. Si le fichier XSD voulu ne figure pas dans la liste, cliquez sur Parcourir pour l'importer, puis sélectionnez l'élément racine pour la demande. Si aucun fichier XSD n'est disponible pour le service, sélectionnez Pas de schéma.
- Cliquez sur Terminer. La demande est ajoutée à la section Points d'extrémité de la Bibliothèque des demandes.
- Dans la Bibliothèque des demandes, sélectionnez l'élément de la demande. Le client de service générique présente trois étapes : Editer les données, Appeler et Afficher la réponse. Les détails pour la demande sont affichés sous l'étape Editer les données.
- En fonction de la demande sélectionnée à l'étape 2, sur la page Message, utilisez les vues Formulaire, Arborescence ou Source pour éditer le contenu de la demande. Chaque vue propose un affichage différent des mêmes données. Pour ajouter ou supprimer des éléments XML dans les vues Formulaire ou Arborescence, cliquez sur Schéma > Validation et assistance afin de respecter une définition XSD indiquée dans le catalogue de schémas.
- Sur la page Transport, changez si besoin est la configuration de transport que la demande doit utiliser. Pour créer et éditer des configurations de transport et de sécurité, utilisez l'onglet Transport.
- Si vous avez sélectionné une demande SOAP XML à l'étape 2,
sur la page Pile de demande,
indiquez s'il faut remplacer les algorithmes de sécurité ou de traitement appliqués à la demande sortante pour le fichier WSDL. Pour ajouter une page Pile de réponse afin d'éditer les algorithmes de sécurité ou de traitement pour les réponses entrantes,
cliquez sur Afficher la pile de réponse.
Remarque : Ces paramètres s'appliquent uniquement à la demande en cours. Pour éditer la pile de demande ou de réponse pour toutes les demandes utilisant le fichier WSDL en cours, cliquez sur Modifier la sécurité WSDL pour ouvrir l'Editeur de sécurité WSDL.
- Une fois que vous êtes prêt, cliquez sur Appeler pour envoyer la demande de service. Le client de service générique envoie la demande et affiche le retour de message sous l'étape Afficher la réponse.
Que faire ensuite
).