Vous pouvez créer une application pour utiliser
IMS TM Resource Adapter afin
d'interagir avec
IMS
à l'aide de l'interface CCI (Common Client
Interface).
Vous pouvez utiliser le code d'application qui est généré par l'assistant J2C dans un environnement de développement intégré Rational ou WebSphere pour accéder à des transactions IMS via IMS TM Resource Adapter.
Aucun codage n'est nécessaire lorsque vous utilisez cette approche. Sinon, vous pouvez écrire le code source
de l'application sans utiliser d'environnement de développement intégré.
Pour écrire le code vous-même, vous devez utiliser l'interface de programmation CCI (Common Client Interface).
Cette API CCI fournit un accès aux systèmes dorsaux d'information d'entreprise (EIS) tels
qu'IMS
à partir des clients
Java™
EE, tels que les beans enterprise, les pages JSP (JavaServer Pages) et les servlets.
Les applications qui suivent le modèle de l'interface de programmation CCI ont une structure commune, indépendante de l'EIS utilisé. La spécification de l'architecture J2EE Connector (JCA) comprend deux objets
nécessaires pour
l'application :
- Les objets connexion qui représentent les connexions à un système EIS.
- Les objets ConnectionFactory qui créent les objets connexion.
Ces objets permettent à un serveur d'applications de gérer la sécurité, le contexte de transaction et les pools de connexions pour un adaptateur de ressources.
Une application qui utilise l'interface de programmation CCI de
IMS TM Resource Adapter commence par obtenir un objet
IMSConnectionFactory.
L'objet
IMSConnectionFactory peut être obtenu de deux manières :
- Géré : si vous utilisez un serveur d'application, l'objet
IMSConnectionFactory est normalement créé à partir de l'adaptateur de
ressources au moyen d'une interface d'administration telle que la console d'administration de
WebSphere Application Server. Ce type d'environnement est appelé environnement géré car il permet à un serveur d'applications de gérer la qualité de service des connexions dans son environnement. Par exemple, vous créez un objet IMSConnectionFactory et vous configurez ses
propriétés personnalisées à l'aide de la console d'administration de
WebSphere Application Server.
Les propriétés personnalisées telles que le nom d'hôte et le numéro de port du
système IMS cible sont configurées dans l'objet IMSConnectionFactory.
Lorsque l'objet IMSConnectionFactory est créé,
il peut être mis à la disposition de toutes les applications d'entreprise via JNDI.
- Non géré : Si vous n'utilisez pas de serveur d'applications pour gérer la connexion
(par exemple, exécution de l'application comme application Java autonome),
ce type d'environnement est appelé environnement non géré.
Dans ce type de configuration :
- Vous devez créer manuellement un objet IMSManagedConnectionFactory
et définir ses propriétés personnalisées. Vous pouvez ensuite créer un objet IMSConnectionFactory à partir de l'objet
IMSManagedConnectionFactory.
- IMS TM Resource Adapter utilise
la classe DefaultConnectionManager de l'API JCA 1.5 Connection Management pour les connexions. Cette classe n'assure aucune gestion de pool de connexions
et toutes les propriétés de pool de connexion seraient ignorées. IMS TM Resource Adapter ouvrirait et fermerait une connexion socket
avec IMS Connect pour chaque demande de transaction. L'ouverture et la fermeture de connexions socket
introduit une charge supplémentaire sur les ressources et a de bonnes chances d'entraîner une dégradation des performances
par rapport à un scénario géré. Vous pouvez construire votre propre gestion de pool de connexions en implémentant une classe PoolManager
à utiliser avec la classe DefaultConnectionManager. Pour plus d'informations, voir la section sur l'API JCA 1.5 Connection Management.
Comme les transactions CM0 sont récupérables, IMS Connect crée
un TPIPE séparé pour chaque client utilisant le mode CM0. Sans la fonction de gestion de pool de connexions fournie par un serveur d'applications,
trop de TPIPEs seraient créés et surchargeraient le système.
Connexions IMS
Vous pouvez ensuite créer un objet IMSConnection à partir de cet objet IMSConnectionFactory.
Les propriétés de l'objet IMSConnection peuvent être définies dans un objet IMSConnectionSpec
transmis en tant que paramètre à la méthode getConnection,
autrement ce sont les valeurs par défaut définies dans l'objet IMSConnectionFactory qui sont utilisées. Après l'obtention d'un objet IMSConnection, une instance IMSInteraction
peut être créée à partir de l'instance IMSConnection.
Une instance IMSInteraction représente l'interaction qui va être exécutée sur cette connexion. Comme pour les connexions, les interactions peuvent avoir des propriétés personnalisées prises dans la classe IMSInteractionSpec.
Entrées et sorties
Pour effectuer l'interaction, l'application appelle la méthode execute() de l'objet IMSInteraction,
lui transférant des objets en entrée et en sortie destinés à héberger les données. Un tableau d'octets d'entrée doit être créé et contenir les valeurs de chaque zone du message d'entrée vers IMS. Un tableau d'octets de sortie doit également être créé pour mettre en attente le message de réponse renvoyé par IMS. La valeur de chaque zone du message de sortie est extraite du tableau d'octets de sortie.
Vous pouvez écrire les tableaux d'octets d'entrée et de sortie vous-même
ou utiliser les options J2C d'un environnement de développement
Rational ou WebSphere
pour créer des liaisons de données Java
pour les messages d'entrée et de sortie de votre application CCI.
Conditions requises pour les applications qui extraient des données d'un système IMS :
- Utilisez l'objet IMSConnectionFactory pour créer un objet IMSConnection.
- Utilisez l'objet IMSConnection pour créer un objet IMSInteraction.
- Utilisez l'objet IMSInteraction pour exécuter des transactions sur le système dorsal IMS.
- Fermez les objets IMSInteraction et IMSConnection.