適用於 z/OS 平台

使用 Liberty 的最佳化本端配接器 API,來呼叫外部位址空間中的服務

使用 WebSphere® 最佳化本端配接器 (WOLA) API,從 Liberty 伺服器,呼叫外部位址空間或子系統上的服務。

開始之前

依照使用最佳化本端配接器,從 Liberty 應用程式連接外部位址空間中的應用程式的說明,將應用程式連接至外部位址空間或子系統。

如果您想傳遞 Rational® Application Developer CICS®/IMS™ Java™ 資料連結精靈所產生的記錄資料,您必須先啟用連線,以使用產生的記錄資料。如需相關資訊,請參閱在 Liberty 出埠最佳化本端配接器連線中啟用產生的記錄資料

程序

  1. 在應用程式中,從您所建立的 Connection 物件來建立互動。 下列範例是從 con Connection 物件來建立 int 互動:
    Interaction int = con.createInteraction();
  2. 建立 InteractionSpecImpl 物件並提供服務名稱,來建立互動規格,這是您要在外部位址空間或子系統中呼叫的方法名稱。 服務名稱必須是您在呼叫「接收要求(任何)」、「接收要求(特定)」或「主機服務」等 API 時所設定的名稱,如果您使用「客戶資訊控制系統 (CICS)」伺服器作業,則服務名稱是 CICS 程式的名稱。 下列範例是在 isi InteractionSpecImpl 物件上提供 MYSERVICE 服務名稱:
    InteractionSpecImpl isi = new InteractionSpecImpl();
    isi.setServiceName("MYSERVICE");
  3. 使用互動規格來執行互動。 下列範例使用 isi 互動規格來執行 int 互動,並且不傳送任何資料:
    int.execute(isi, null);

範例

下列範例顯示如何啟動互動,並以位元組陣列形式 (byte[]) 提供輸入及輸出資料:
public byte[] driveInteraction(javax.resource.cci.ConnectionFactory cf,
javax.resource.cci.Connection con,byte[] inputDataBytes),throws javax.resource.ResourceException
	{
	// 使用最佳化本端配接器連線來建立互動
		 javax.resource.cci.Interaction i = con.createInteraction();
	// InteractionSpec 說明我們想呼叫的服務
		 com.ibm.websphere.ola.InteractionSpecImpl isi = new com.ibm.websphere.ola.InteractionSpecImpl();
		 isi.setServiceName("MYSERVICE");
	// 使用 IndexedRecord 來指定輸入資料。檢索記錄中的第一個
	// 位置含有輸入資料位元組。
		 javax.resource.cci.RecordFactory rf = cf.getRecordFactory();
		 javax.resource.cci.IndexedRecord ir = rf.createIndexedRecord(null);
		 ir.add(inputDataBytes);
		 		 
	// 互動傳回另一個 IndexedRecord,其第一個
	// 位置含有輸出資料位元組。
		 javax.resource.cci.Record or = i.execute(isi, ir);
		 byte[] outputDataBytes = null;
		 		 
		 if (or != null)
		 {
		 		 outputDataBytes = (byte[])((javax.resource.cci.IndexedRecord)or).get(0);
		 }
		 		 
	// 將輸出資料傳回給呼叫端
			return outputDataBytes;
		 }

下列範例顯示如何使用 Rational Application Developer 產生的記錄定義檔 Record 物件,來啟動互動。.

 /**
  * 驅動最佳化本端配接器互動的範例,其中,使用 Rational
  * Application Developer 記錄定義檔對映類別作為輸入 (inputRecord),並接收
  * Rational Application Developer 記錄定義檔對映作為輸出。
	*/		 
			public javax.resource.cci.Record driveInteraction(
		 	javax.resource.cci.Connection con,
		 	javax.resource.cci.Record inputRecord)
		 	throws javax.resource.ResourceException
	  {
	// 使用 OLA 連線來建立互動
		 	javax.resource.cci.Interaction i = con.createInteraction();
	// InteractionSpec 說明我們想呼叫的服務 com.ibm.websphere.ola.InteractionSpecImpl isi =
		 new com.ibm.websphere.ola.InteractionSpecImpl();
		 isi.setServiceName("MYSERVICE");
	// Rational Application Developer 產生的記錄定義檔會實作
	// javax.resource.cci.Record,並且可直接傳遞給互動。
	// 互動傳回 IndexedRecord,其第一個位置含有
  // 輸出資料位元組。
		 	javax.resource.cci.Record or = i.execute(isi, inputRecord);
		 	javax.resource.cci.Record outputRecord = null;
		 	if (or != null)
		 {
	// 在本例中,RADGeneratedOutputType 是 Rational Application Developer
  // 產生之記錄定義檔對映類別的名稱。
		 	outputRecord = new RADGeneratedOutputType();
 // 輸出位元組儲存在互動所傳回的輸出記錄中, // 這是一個 IndexedRecord。
		 byte[] outputDataBytes = 
     (byte[])((javax.resource.cci.IndexedRecord)or).get(0);
		 		 		 
 // 如果要將輸出位元組轉換成 Rational Application Developer 所產生的另一個記錄定義檔, // 請呼叫該類別的 setBytes(byte[]) 方法。該類別會
 // 實作 com.ibm.etools.marshall.RecordBytes 介面。
		 ((com.ibm.etools.marshall.RecordBytes)outputRecord)
        .setBytes(outputDataBytes);
		 }
		 		 
// 將輸出資料傳回給呼叫端
		 		 return outputRecord;
		 }

指示主題類型的圖示 作業主題



「時間戳記」圖示 前次更新: 2016 年 6 月 3 日
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_dat_useoutboundconnection
檔名:twlp_dat_useoutboundconnection.html