Pour plateformes z/OS

Utilisation des API des adaptateurs locaux optimisés Liberty pour l'appel des services dans un espace adresse externe

Utilisez les API WebSphere Optimized Local Adapters (WOLA) pour appeler des services dans un espace adresse externe ou un sous-système depuis un serveur Liberty.

Avant de commencer

Connectez l'application à un espace adresse externe ou un sous-système comme décrit dans Utilisation des adaptateurs locaux optimisés pour la connexion à une application dans un espace adresse externe depuis une application Liberty.

Si vous voulez transmettre des données d'enregistrement qui sont générées par l'assistant de liaison de données Java™ CICS/IMS de Rational Application Developer, vous devez d'abord permettre à la connexion d'utiliser les données d'enregistrement générées. Pour plus d'informations, voir Activation des données d'enregistrement générées sur des connexions d'adaptateur local optimisé dans Liberty

Procédure

  1. Dans l'application, créez une interaction depuis l'objet de connexion que vous avez créé. L'exemple suivant crée l'interaction int depuis l'objet de connexion con :
    Interaction int = con.createInteraction();
  2. Créez une spécification d'interaction en créant un objet InteractionSpecImpl et en fournissant le nom de service, qui est le nom de la méthode à appeler dans l'espace adresse externe ou le sous-système. Le nom de service doit être le nom que vous avez défini lorsque vous avez appelé l'API Receive Request Any, Receive Request Specific ou Host Service ou, si vous utilisez une tâche de serveur CICS (Customer Information Control System), le nom du programme CICS. L'exemple suivant fournit le nom de service MYSERVICE dans l'objet InteractionSpecImpl isi :
    InteractionSpecImpl isi = new InteractionSpecImpl();
    isi.setServiceName("MYSERVICE");
  3. Exécutez l'interaction avec la spécification d'interaction. L'exemple suivant exécute l'interaction int avec la spécification d'interaction isi et n'envoie pas de données :
    int.execute(isi, null);

Exemple

L'exemple suivant explique comment démarrer une interaction avec des données d'entrée et de sortie sous forme de tableau d'octets (byte[]) :
public byte[] driveInteraction(javax.resource.cci.ConnectionFactory cf,
javax.resource.cci.Connection con,byte[] inputDataBytes),throws javax.resource.ResourceException
	{
	// Créez une interaction à l'aide d'une connexion d'adaptateur local optimisé
		 javax.resource.cci.Interaction i = con.createInteraction();
	// L'élément InteractionSpec décrit le service que vous voulez appeler
		 com.ibm.websphere.ola.InteractionSpecImpl isi = new com.ibm.websphere.ola.InteractionSpecImpl();
		 isi.setServiceName("MYSERVICE");
	// Les données d'entrée sont spécifiées dans un IndexedRecord.  La première
	// section du groupe d'entrées d'index contient les données d'entrée.
		 javax.resource.cci.RecordFactory rf = cf.getRecordFactory();
		 javax.resource.cci.IndexedRecord ir = rf.createIndexedRecord(null);
		 ir.add(inputDataBytes);
		 		 
	// L'interaction renvoie un autre IndexedRecord dont la première
	// section contient les données d'entrée.
		 javax.resource.cci.Record or = i.execute(isi, ir);
		 byte[] outputDataBytes = null;
		 		 
		 if (or != null)
		 {
		 		 outputDataBytes = (byte[])((javax.resource.cci.IndexedRecord)or).get(0);
		 }
		 		 
	// Renvoyez les données de sortie au programme appelant 
			return outputDataBytes;
		 }

L'exemple suivant explique comment démarrer une interaction avec un objet d'enregistrement de fichier de stockage généré par Rational Application Developer : .

 /**
  * Exemple de conduite d'une interaction d'adaptateur local optimisé, en utilisant une classe de mappage de fichier de stockage 
  * Rational Application Developer en tant qu'entrée (inputRecord) et en recevant un mappage de fichier de
  * stockage Rational Application Developer en tant que sortie.
	*/		 
			public javax.resource.cci.Record driveInteraction(
		 	javax.resource.cci.Connection con,
		 	javax.resource.cci.Record inputRecord)
		 	throws javax.resource.ResourceException
	  {
	// Créer une interaction à l'aide de la connexion OLA
		 	javax.resource.cci.Interaction i = con.createInteraction();
	// L'élément InteractionSpec décrit le service que vous voulez appeler    com.ibm.websphere.ola.InteractionSpecImpl isi = 
		 new com.ibm.websphere.ola.InteractionSpecImpl();
		 isi.setServiceName("MYSERVICE");
	// Le fichier de stockage généré par Rational Application Developer implémente 
	// javax.resource.cci.Record et peut être transmis directement à l'interaction.
	// L'interaction renvoie un IndexedRecord dont la première section contient 
  // les données de sortie.
		 	javax.resource.cci.Record or = i.execute(isi, inputRecord);
		 	javax.resource.cci.Record outputRecord = null;
		 	if (or != null)
		 {
	// Dans cet exemple, RADGeneratedOutputType est le nom de la classe de mappage de fichier de stockage
  // générée par Rational Application Developer.
		 	outputRecord = new RADGeneratedOutputType();
 // Les octets de sortie sont stockés dans l'enregistrement de sortie renvoyé dans
 // l'interaction, qui est un IndexedRecord.
		 byte[] outputDataBytes = 
     (byte[])((javax.resource.cci.IndexedRecord)or).get(0);
		 		 		 
 // Pour convertir les octets de sortie en un autre fichier de stockage généré par Rational Application Developer, 
 // appelez la méthode setBytes(byte[]) de cette classe.  La classe 
 // implémentera l'interface com.ibm.etools.marshall.RecordBytes.
		 ((com.ibm.etools.marshall.RecordBytes)outputRecord)
        .setBytes(outputDataBytes);
		 }
		 		 
// Renvoyez les données de sortie au programme appelant
		 		 return outputRecord;
		 }

Icône indiquant le type de rubrique Rubrique Tâche



Icône d'horodatage Dernière mise à jour: 7 juin 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_dat_useoutboundconnection
Nom du fichier : twlp_dat_useoutboundconnection.html