Ce tutoriel décrit comment utiliser l'assistant de bean J2C pour créer un bean géré par message qui traite une transaction entrante IMS™.
Ce tutoriel peut nécessiter certains composants dont l'installation est optionnelle. Si, pendant son exécution, vous rencontrez des erreurs ou que ne trouvez pas certaines options dans l'interface utilisateur, assurez-vous d'avoir installé les composants appropriés :
- IBM® WebSphere® Application Server V7.0, V8.0 ou V8.5.
Pour utiliser cet exemple, vous devez disposer
d'un serveur d'applications installé et configuré. Pour vérifier qu'un environnement d'exécution serveur est
disponible, cliquez sur , développez
la branche Serveur et cliquez sur
Environnements d'exécution installés. Vous pouvez utiliser ce volet pour ajouter,
supprimer ou éditer des définitions d'environnements d'exécution serveur installés. Vous pouvez aussi
télécharger et installer le support d'un nouveau serveur.
Ce tutoriel contient plusieurs exercices qui doivent être effectués en séquence pour que le tutoriel fonctionne correctement. Ce tutoriel vous montre comment utiliser l'assistant de bean Java™ J2C pour créer un Bean Java qui exécute une transaction dans IMS. En effectuant les exercices, vous apprendrez comment :
- Utiliser l'assistant de bean J2C pour créer un bean géré par message qui exécute une transaction entrante IMS
- Déployer et exécuter le bean géré par message dans WebSphere Application Server
- Configurer et exécuter l'exemple d'application d'appel IMS pour émettre un message d'appel synchrone
Présentation
Lorsqu'une application IMS envoie une demande à une application
Java ou un service Web externe et s'attend à recevoir une réponse dans la même transaction, la
demande est appelée "demande synchrone sortante" du point de vue de l'application
IMS et "transaction entrante" du point de vue de
WebSphere Application Server.
Lorsqu'une application IMS émet une demande synchrone sortante, elle doit spécifier un descripteur de destination IMS OTMA qui gère le routage du message. Cette destination contient le nom du tpipe qui est utilisé pour mettre en attente le message d'appel sortant. L'adaptateur de ressources IMS TM qui est déployé sur WebSphere Application Server extrait les demandes sortantes de la file d'attente de stockage temporaire.
Voici les étapes nécessaires pour implémenter une solution d'appels synchrones sortants pour une application IMS :
- Créer ou modifier une application IMS pour émettre une demande sortante en utilisant l'appel DL/I ICAL (sur le système hôte IMS)
- Définir un descripteur de destination OTMA (sur le système hôte IMS)
- Créer une application J2C pour une transaction entrante IMS
- Exécuter l'application IMS pour émettre la demande synchrone sortante (sur le système hôte IMS)
Remarque : Ce tutoriel montre l'étape 3 de l'implémentation globale.
Pour le test et la vérification de bout en bout, si vous choisissez d'importer l'exemple entrant IMS, ce tutoriel fournit également des instructions pour modifier l'exemple entrant pour vous permettre d'utiliser l'exemple d'application entrante IMS qui est fourni avec la fonction d'appel entrant synchrone IMS via le programme de vérification de l'installation (IVP). Ce programme IVP d'exemple d'appel IMS inclut :
- Une exemple d'application IMS qui, lors de l'exécution, émet une demande synchrone sortante. Cette application spécifie l'utilisation d'un descripteur de destination OTMA prédéfini (IVPDTOR4) et un tpipe (IVPPIPE4) pour le routage et la mise en file d'attente du message d'appel. Tout ce que fait cet exemple d'application IMS est d'émettre une demande sortante
avec un message "HELLO FROM IMS" et d'attendre une réponse.
- Des travaux et des tâches du programme IVP que vous pouvez exécuter pour configurer le descripteur de destination OTMA requis pour le routage du message d'appel et du tpipe (une file d'attente) pour la mise en file d'attente du message d'appel.
Le diagramme suivant décrit le flux de messages d'appel synchrone IMS à l'aide du nom du descripteur de destination OTMA et de la valeur TPIPE (nom de la file d'attente) qui sont fournis dans le programme IVP de l'exemple d'appel IMS.
Objectifs d'apprentissage Dans ce tutoriel, vous allez :
- Utiliser l'assistant de bean J2C pour créer un bean géré par message qui exécute une transaction entrante IMS
- Déployer et exécuter le bean géré par message dans WebSphere Application Server
- Configurer et exécuter l'application IMS pour des messages d'appels synchrones
Temps requis
Ce tutoriel prend environ 30 minutes. Comptez plus de temps si vous explorez d'autres concepts
relatifs aux sujets qui y sont traités.
Niveau de
compétences
Expérimenté
Audience
Ce tutoriel est destiné à des utilisateurs qui sont familiers des systèmes d'information d'entreprise (EIS) et d'IMS en particulier.
Configuration requise
Pour effectuer ce tutoriel, les outils et composants suivants doivent être installés sur votre ordinateur :
- IBM® WebSphere® Application Server V7.0, V8.0 ou V8.5.
- Outils J2EE Connector (J2C) installés
- Informations sur votre environnement IMS :
dans ce tutoriel, votre application interagit avec un programme d'application dans IMS. Vous devez obtenir des informations telles que le nom d'hôte et le numéro de port d'IMS Connect, ainsi que le nom du magasin de données IMS où la transaction s'exécute. Contactez votre administrateur système IMS pour ces informations. En outre, vous devez effectuer certaines tâches de configuration dans IMS si vous voulez exécuter cet exemple.
- Une copie du fichier COBOL SYCALOUT.cpy :
vous pouvez trouver ce fichier dans le répertoire d'installation de votre produit : <rép_installation>\IBM\SDP70Shared\plugins\com.ibm.j2c.cheatsheet.content_7.0.0\samples\IMS\inbound.
Si vous voulez le stocker localement, vous pouvez copier le code à partir d'ici :
dsycalout.cpy
- Un espace de travail vierge.
Prérequis
Pour exécuter ce tutoriel, vous devez maîtriser les concepts suivants :
- Programmation J2EE et Java
- Concepts de base du gestionnaire de transactions IMS (IMS TM)
- Prérequis sur le système hôte IMS :
- IMS v 1.0
- Pour les correctifs APAR permettant d'activer cette fonction d'appel synchrone dans IMS version 10 et pour le correctif APAR qui fournit cet exemple d'application IVP, voir Fonction d'appel synchrone d'IMS version 10.