IBM Rational Application Developer 6.0.0.1 版 J2EE 連接器工具特性 - 版本注意事項

(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.

歡迎使用 IBM Rational Application Developer 6.0.0.1 版 J2EE 連接器特性(本軟體採用 Eclipse 技術版 3.0.1)。

如果要檢視這個 Readme 檔的最新版本,請移至下列網址: www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rad/6001/J2C/html/readme.html

這個檔案有下列國家語言的版本:

法文 巴西葡萄牙文 德文
簡體中文 義大利文 西班牙文
日文 繁體中文 韓文

目錄

1.0 相關這個版本
2.0 安裝資訊
2.1 硬體需求
2.2 支援的軟體
2.2.1 WebSphere Application Server
2.2.2 資源配接器
2.2.3 IMS
3.0 已知的限制、問題和暫行解決方法
3.1 限制
3.1.1 IMS Connector for Java TCP/IP 和區域選項連線
3.1.2 IMS Connector for Java MFS 支援和 Rational Application Developer 的 J2C 更新
3.1.3 安裝在相同執行時期伺服器實例中的多個資源配接器
3.2 已知的問題和暫行解決方案
3.2.1 利用公用程式 JAR 所提供的資料連結類別,將 J2C 實作 Bean 部署成 Session EJB
3.2.2 部署時期異常狀況
3.2.3 無法利用 J2C 精靈來變更 ConnectionSpec
3.2.4 無法利用 IMS Connector for Java 應用程式來擷取未遞送的輸出
3.2.5 如果 IMS Connector for Java executionTimeout 內容是「永遠等待」,可能會重新啟動 WebSphere Application Server for z/OS 服務者區域
3.2.6 系統不處理專用持續性 Socket 連線的 IMS Connector for Java purgeAsyncOutput 和 reRoute 內容
4.0 文件更新
5.0 洽詢客戶支援中心
6.0 關於 Eclipse
7.0 注意事項和商標

1.0 關於這個版本

J2EE 連接器 (J2C) 架構工具可讓您建立 J2EE 應用程式來整合和延伸現有企業資訊系統 (EIS) 的作業和資料。

利用 J2C 工具來存取 EIS 系統的好處包括:

開發時間較短
J2C 精靈利用適當管理的 Connection Factory 來建立目標 EIS 的程式碼。
標準化
利用標準 J2C 基礎架構來存取您的 EIS(例如,資源配接器和 Common Client Interface)。
簡化
直接建立 Java Bean,速度很快。 每個方法都對應於一項 EIS 作業。 當使用所建立的方時,您可以利用其餘 Rational Application Developer 功能來開發網頁、Web 服務和 EJB。

J2C 工具由下列主要元件組成:

精靈
Java Bean 編輯
指導教學

安裝好 J2C 特性之後,您可以按一下主功能表中的說明 > 指導教學展示區 > 做中學來存取指導教學。 指導教學包括:

如果需要 J2C 工具的詳細資訊,請按一下說明 > 說明內容,展開開發企業應用程式 > 連接至企業資訊系統來參閱線上說明文件。

2.0 安裝資訊

如果需要安裝 Rational Application Developer J2C 特性的相關資訊,請參閱 www.software.ibm.com/ibmdl/pub/software/rationalsdp/rad/6001/install_instruction/ifeature_j2c/install_6001.html

2.1 硬體需求

請參閱安裝指示,以瞭解安裝 Rational Application Developer J2C 特性的硬體需求。

2.2 支援的軟體

如果您利用 Rational Application Developer 中的 J2C 工具來開發應用程式,並在 WebSphere Application Server 第 5 版中執行它,請確定您已將必要的維護套用在 WebSphere Application Server 第 5 版上。 請參閱 2.2.1 節 WebSphere Application Server,以取得詳細資料。

請參閱安裝指示,以取得 Rational Application Developer J2C 特性所支援的軟體和規格。

如果需要 Rational Application Developer 專屬工具所支援之軟體和規格的詳細資訊,請參閱線上說明。

您必須先安裝 IBM Rational Application Developer 6.0.0.1 版,才能安裝這項特性。

2.2.1 WebSphere Application Server

WebSphere 5.0 版和 5.1 版支援 J2C 1.0。 下表列出需要使用 J2EE 連接器工具的 WebSphere Application Server 服務層次。 Rational Application Developer 6.0 版所提供的舊式測試環境需要表格中的「需要的 WAS 分散式服務層次」直欄下所列出的服務。 WebSphere Application Server 支援網站 (www.ibm.com/software/webservers/appserv/was/support) 提供 WebSphere Application Server 的累加修正程式,例如,WAS 5.0.2.8。 www.ibm.com/support/docview.wss?rs=180&context=SSEQTP&dc=D410&dc=D420&uid=swg24004796&loc=en_US&cs=utf-8&lang=en 提供 5.0 和 5.1 的 Integration Edition 執行時期修正程式。 WebSphere Application Server for z/OS 支援網站 /www.ibm.com/software/webservers/appserv/zos_os390/support/ 提供 WebSphere Application Server for z/OS PTF。

WebSphere Application Server 需要 WAS 分散式服務層次 需要 WAS for z/OS 服務層次
5.0.x 版
  • 累加修正程式 5.0.2.8
  • 5.0 Integration Edition 執行時期修正程式
W502023 (PTF UK00329)
5.1.x 版
5.1 Integration Edition 執行時期修正程式
W510205 (PTF UK0028)

WebSphere 第 6 版支援 J2C 1.5 應用程式。

2.2.2 資源配接器

J2C 工具支援下列資源配接器:

2.2.3 IMS

在 IMS Connector for Java 9.1.0.1.1 版和 IMS Connector for Java 9.1.0.2 版中,下列類別已棄用:

3.0 已知的限制、問題和暫行解決方法

版本注意事項包括產品文件完成時尚未發佈的特定版本專用資訊(如問題和限制)。

如果需要 Eclipse 基本程式中已知問題和暫行解決方案的相關資訊,請參閱產品安裝目錄 eclipse\readme 子目錄中的 readme_eclipse.html。 這項資訊只有英文版。

3.1 限制

3.1.1 IMS Connector for Java TCP/IP 和區域選項連線
3.1.2 IMS Connector for Java MFS 支援和 Rational Application Developer 的 J2C 更新
3.1.3 安裝在相同執行時期伺服器實例中的多個資源配接器

3.1.1 IMS Connector for Java TCP/IP 和區域選項連線
3.1.2 IMS Connector for Java MFS 支援和 Rational Application Developer 的 J2C 更新
Rational Application Developer 所提供的 J2C 工具目前不包括從 MFS 來源產生 Java 資料連結的精靈。 不過,WebSphere Application Server 第 6 版仍會執行利用 WebSphere Studio Application Developer Integration Edition 從 MFS 來源建立的企業應用程式。 如果需要如何執行這個動作的相關資訊,請參閱 IMS MFS Web 支援網頁 (www.ibm.com/software/data/ims/toolkit/mfswebsupport/) 中,標題為 "Migrating MFS-based IMS applications to run on WebSphere Application Server 6.0" 的 Technote。
3.1.3 安裝在相同執行時期伺服器實例中的多個資源配接器
在 WAS 中,不應該安裝相同 EIS 資源配接器的多個獨立式版本,當它們不是針對相同 EIS 類型時,尤其如此。 比方說,如果您安裝了 CICS ECI 5.1 和 CICS ECI 6.0,可能會發生衝突。 這是因為所有獨立式資源配接器都共用相同的類別載入器。

3.2 已知的問題和暫行解決方案

3.2.1 利用公用程式 JAR 所提供的資料連結類別,將 J2C 實作 Bean 部署成 Session EJB
3.2.2 部署時間異常狀況
3.2.3 無法利用 J2C 精靈來變更 ConnectionSpec
3.2.4 無法利用 IMS Connector for Java 應用程式來擷取未遞送的輸出
3.2.5 如果 IMS Connector for Java executionTimeout 內容是「永遠等待」,可能會重新啟動 WebSphere Application Server for z/OS 服務者區域
3.2.6 系統不處理專用持續性 Socket 連線的 IMS Connector for Java purgeAsyncOutput 和 reRoute 內容


3.2.1 利用公用程式 JAR 所提供的資料連結類別,將 J2C 實作 Bean 部署成 Session EJB
當利用 J2C 工具來產生的 J2C 實作 Bean 使用工作區內個別 Java 專案中的資料連結類型(相當於對於 EAR 範圍公用程式 JAR 的執行時期相依關係)時,不會自動更新 EJB 專案的 MANIFEST.MF 檔來反映這類相依關係。 如果要避免執行時期錯誤,使用者應該手動更新 EJB 專案 META-INF/MANIFEST.MF 檔中的 "Class-Path" 屬性來併入資料連結類型所在的 EAR 範圍公用程式 JAR。 您應該在 EJB 專案部署至執行時期伺服器之前,完成這個動作。
3.2.2 部署時期異常狀況
在網頁、EJB 或 Web 服務建立期間,您可能會在 WAS 第 6 版伺服器主控台中發現一個異常狀況。 這不會影響伺服器或 J2C Bean 的正常作業。 WebSphere Application Server 6.0.1 版已修正這個問題,網址如下:www.ibm.com/software/webservers/appserv/was/support/

[2/21/05 18:55:49:781 EST] 00000017 SystemErr R java.lang.reflect.InvocationTargetException at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:85) at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:58) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java(Compiled Code)) at java.lang.reflect.Method.invoke(Method.java(Compiled Code)) at com.ibm.ws.ffdc.DiagnosticModule.getDataForDirective(DiagnosticModule.java:316) at com.ibm.ws.ffdc.DiagnosticModule.getDataForDirectives(DiagnosticModule.java:287) at com.ibm.ws.ffdc.DiagnosticModule.dumpComponentData(DiagnosticModule.java:143) at com.ibm.ws.ffdc.DiagnosticEngine.processIncident(DiagnosticEngine.java:159) at com.ibm.ws.ffdc.FFDCFilter.filterEngine(FFDCFilter.java:434) at com.ibm.ws.ffdc.FFDCFilter.processException(FFDCFilter.java:195) at com.ibm.ws.management.AdminServiceImpl.outputWarningAndFFDC(AdminServiceImpl.java:1660) at com.ibm.ws.management.AdminServiceImpl.checkForOpDeprecation(AdminServiceImpl.java:1737) at com.ibm.ws.management.AdminServiceImpl.preInvoke(AdminServiceImpl.java:1670) at com.ibm.ws.management.AdminServiceImpl.access$400(AdminServiceImpl.java:100) at com.ibm.ws.management.AdminServiceImpl$1.run(AdminServiceImpl.java:899) at com.ibm.ws.security.util.AccessController.doPrivileged(AccessController.java(Compiled Code)) at com.ibm.ws.management.AdminServiceImpl.invoke(AdminServiceImpl.java:817) at com.ibm.ws.management.connector.AdminServiceDelegator.invoke(AdminServiceDelegator.java:139) at sun.reflect.GeneratedMethodAccessor23.invoke(Unknown Source) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java(Compiled Code)) at java.lang.reflect.Method.invoke(Method.java(Compiled Code)) at com.ibm.ws.management.connector.soap.SOAPConnector.invoke(SOAPConnector.java:325) at com.ibm.ws.management.connector.soap.SOAPConnector.service(SOAPConnector.java:193) at com.ibm.ws.management.connector.soap.SOAPConnection.handleRequest(SOAPConnection.java:55) at com.ibm.ws.http.HttpConnection.readAndHandleRequest(HttpConnection.java:641) at com.ibm.ws.http.HttpConnection.run(HttpConnection.java:469) at com.ibm.ws.util.ThreadPool$Worker.run(ThreadPool.java(Compiled Code)) Caused by: java.lang.NullPointerException at com.ibm.ws.management.dm.JmxDM.processAdminService(JmxDM.java:50) at com.ibm.ws.management.dm.JmxDM.ffdcDumpDefaultJmx(JmxDM.java:34) ... 28 more


3.2.3 無法利用 J2C 精靈來變更 ConnectionSpec
J2C 精靈並不提供任何 UI 支援,供使用者變更 ConnectionSpec。 使用者必須在產生的 Java 實作程式碼中,直接變更它。 他們必須執行的動作是利用編輯器來開啟產生的實作 Java 檔,導覽至他們需要修改的方法,再變更/新增/移除這個方法的 Doclet。
3.2.4 無法利用 IMS Connector for Java 應用程式來擷取未遞送的輸出
為了能夠利用相同應用程式中的 SYNC_RECEIVE_ASYNCOUTPUT 互動,在可共用持續性 Socket 連線上擷取未遞送的輸出, IMS Connector for Java 允許 IMSInteractionSpec 的 purgeAsyncOutput 內容和 reRoute 內容都使用 FALSE 值。 不過,如果 SYNC_RECEIVE_ASYNCOUTPUT 互動未在將輸出放入佇列的應用程式中順利擷取輸出,未遞送的輸出就會在名稱為可共用持續性 Socket 連線的 OTMA TPIPE 上保留在佇列中。 這項輸出無法利用 IMS Connector for Java 應用程式來擷取,因此,將 purgeAsyncOutput 和 reRoute 同時設為 FASLE 時,必須非常小心。
3.2.5 如果 IMS Connector for Java executionTimeout 內容是「永遠等待」,可能會重新啟動 WebSphere Application Server for z/OS 服務者區域
在 WebSphere Application Server for z/OS 應用程式中,依預設,分派給服務者區域的工作是計時的。 一般而言,當分派的應用程式到達它的逾時值之後,所分派的服務者區域會異常中止,再重新啟動。 因此,強烈建議您在 WebSphere Application Server for z/OS 中執行應用程式時,executionTimeout 不要使用 -1 值(「永遠等待」)。
3.2.6 系統不處理專用持續性 Socket 連線的 IMS Connector for Java purgeAsyncOutput 和 reRoute 內容
專用持續性 Socket 連線上的互動不適合使用 purgeAsyncOutput 和 reRoute 這兩個 IMSInteractionSpec 內容。 您不能清除或重新遞送專用持續性 Socket 連線上未遞送的輸出訊息。 不過,如果您在專用持續性 Socket 連線上執行一項互動,且提供了 purgeAsyncOutput 和 reRoute 的值,IMS Connector for Java 會忽略這些值。 您的 Java 應用程式不會收到異常狀況。

4.0 文件更新

產品首頁IBM developerWorks 都有 Library 區段,用來提供更新的指導教學文件和其他文件。

www.ibm.com/developerworks/rational 的 IBM Rational 區,提供了技術文章、「如何使用」資訊、指導教學、範例以及新技術的預覽。

5.0 洽詢客戶支援中心

Rational Application Developer 的產品首頁是 www.ibm.com/software/awdtools/developer/application/index.html。 如果需要 FAQ、已知問題與修正程式清單,以及其他支援資訊,請造訪該網站的 Support 網頁。

6.0 關於 Eclipse

Eclipse 是一種開放程式碼專案,它採用開發外掛程式所用的組織架構,方便您建立、整合和使用軟體工具。 工具產生者可以藉由協同作業和共用核心整合技術,全心投入專業領域和建立新的開發技術。 Eclipse 平台是用 Java 語言來撰寫的,它檢附了大量建構外掛程式的工具箱和範例。 它已部署在一系列作業系統環境中,其中包括 Linux、Mac OS X、QNX 和 Windows 型的系統。 如果需要 Eclipse 社群和說明 Eclipse 平台設計之白皮書的完整詳細資料,請造訪下列網站:www.eclipse.org

同樣利用開放程式碼 Eclipse 平台來建置的其他供應商外掛工具,也與 Rational Developer 環境整合為一,為開發人員帶來額外的價值。

7.0 注意事項和商標

U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

本資訊係針對 IBM 在美國所提供之產品與服務所開發;而在其他國家中,IBM 不見得有提供本文所提及之各項產品、服務或功能。 請洽詢當地的 IBM 業務代表,以取得當地目前提供的產品和服務之相關資訊。本文件在提及 IBM 的產品、程式或服務時,不表示或暗示只能使用 IBM 的產品、程式或服務。 只要未侵犯 IBM 的智慧財產權,任何功能相當的產品、程式或服務都可以取代 IBM 的產品、程式或服務。 不過,任何非 IBM 的產品、程式或服務,使用者必須自行負責作業的評估和驗證責任。

本文件所說明之主題內容,IBM 可能擁有其專利或專利申請案。 提供本文件不代表提供這些專利的授權。您可以書面提出授權查詢,來函請寄到:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

如果是有關雙位元組 (DBCS) 資訊的授權查詢,請洽詢所在國的 IBM 智慧財產部門,或書面提出授權查詢,來函請寄到:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

下列段落若與該國之法律條抵觸時,即視為不適用:International Business Machines Corporation 只依「現況」提供本出版品,不提供任何明示或默示之保證, 其中包括且不限於不違反規定、可商用性或特定目的之適用性的隱含保證。 有些國家在某些交易上並不接受明示或默示保證的排除,因此,這項聲明對 貴客戶不見得適用。

本資訊中可能會有技術上或排版印刷上的訛誤。 因此,IBM 會定期修訂;並將修訂後的內容納入新版中。IBM 隨時會改進及/或變更本出版品所提及的產品及/或程式,不另行通知。

本資訊中任何對非 IBM 網站的敘述僅供參考,IBM 對該網站並不提供保證。 這些網站所提供的資料不是 IBM 本產品的資料內容,如果要使用這些網站的資料,您必須自行承擔風險。

IBM 得以各種 IBM 認為適當的方式使用或散布 貴客戶提供的任何資訊,而無需對 貴客戶負責。

如果本程式的獲授權人為了 (i) 在個別建立的程式和其他程式(包括本程式)之間交換資訊, 以及 (ii) 相互使用所交換的資訊,因而需要相關的資訊,請洽詢:

Intellectual Property Dept. for Rational Software
IBM Corporation
3600 Steeles Avenue East
Markham, Ontario
Canada L3R 9Z7

上述資料之取得有其特殊要件,在某些情況下必須付費方得使用。

IBM 基於雙方之 IBM 國際程式授權合約(或任何同等合約)條款, 提供本文件所提及的授權程式與其所有適用的授權資料。

本文件中所含的任何效能資料是在控制環境中得出。 因此,在其他作業環境中獲得的結果可能有明顯的差異。 部分測量可能是在開發階段的系統上測定,無法保證這些測量在一般可用的系統上維持不變。 再者,有些測定可能是透過推測方式來評估。 實際結果可能不同。 本文件的使用者應驗證適用於其特定環境的資料。

本文件所提及之非 IBM 產品資訊,取自產品的供應商,或其公佈聲明或其他公開管道。 IBM 未測試過這些產品,也無法確認這些非 IBM 產品的執行效能、相容性、或任何對產品的其他主張是否完全無誤。 有關非 IBM 產品的性能問題應直接洽詢產品供應商。

所有關於 IBM 未來方針或目的之聲明,隨時可以更改或撤消,不必另行通知,而且僅代表目標與主旨。

這份資訊含有日常商業運作所用的資料和報告範例。 為了盡可能地加以完整說明,範例中含有個人、公司、品牌及產品的名稱。 所有這些名稱全屬虛構,如果與實際商場企業使用的名稱和地址雷同,純屬巧合。

著作權:

這份資訊含有原始語言的範例應用程式,用以說明各作業平台中的程式設計技術。 貴客戶可以為了研發、使用、銷售或散佈符合範例應用式所適用的作業平台之應用程式介面的應用程式,以任何形式複製、修改及散佈這些範例程式,不必向 IBM 付費。 這些範例並未在所有情況下完整測試。 因此,IBM 不保證或暗示這些程式的可靠性、有用性或功能。 您可以免費為了開發、使用、銷售或散布應用程式,利用任何形式來複製、修改和散布這些程式範例,不過,這些應用程式必須符合 IBM 的應用程式設計介面。

這些範例程式或任何衍生成果的每份複本或任何部分,都必須依照下列方式併入著作權聲明:

(C)(您的公司名稱)(年份)。本程式的若干部分係衍生自 IBM 公司的範例程式。 (C) Copyright IBM Corp. 2000, 2005. All rights reserved.

若 貴客戶正在閱讀本項資訊的電子檔,可能不會有照片和彩色說明。

程式設計介面資訊

程式設計介面資訊之目的,是要協助您利用這個程式來建立應用軟體。

通用程式設計介面可讓您撰寫應用軟體,以取得本程式工具的服務。

不過,這份資訊也可能包含診斷、修正和調整資訊。提供診斷、修正和調整資訊,是要協助您進行應用軟體的除錯。

警告:請勿將這份診斷、修正和調整資訊當作程式設計介面使用,因為它隨時會改變。

商標和服務標記

下列詞彙是 International Business Machines Corporation 在美國及/或其他國家/地區的商標:

Java 和所有以 Java 為基礎的商標是 Sun Microsystems, Inc. 在美國及/或其他國家/地區的商標。

Microsoft 及 Windows 是 Microsoft Corporation 在美國及/或其他國家/地區的商標。

Linux 是 Linus Torvalds 在美國及/或其他國家之商標。

其他公司、產品或服務名稱,可能是第三者的商標或服務標誌。