IBM J2EE 連接器工具特性 6.0.1 版

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

精靈

J2C Java^™ Bean 精靈。用來產生 EIS 專用的 Java Bean。
CICS/IMS^™ Java 資料連結精靈。用來建立 CICS/IMS 交易的輸入或輸出能夠重複使用的資料類型。
J2C Java Bean 精靈的網頁、Web 服務或 EJB。用來從 J2C Java Bean 建立 J2EE 資源，以部署至您的 WebSphere Application Server。
指令 Bean 精靈。用來將特定的執行作業封裝在 EIS 中。
J2C 服務移轉精靈。用來將在 WebSphere Application Developer Integration Edition 中建立的 WSDL 檔案，移轉至現行的 Rational^® Application Developer 專案。

Java Bean 編輯

新增方法片段。新增新的方法來存取 EIS 作業。
J2C Doclet 標示程式碼輔助。變更 J2C Java Bean 來顯現或修改產生的 J2C 標示。

指令行移轉工具

J2C 移轉工具。在批次指令中，將在 WebSphere Application Developer Integration Edition 中建立的 WSDL 檔案，移轉至現行的 Rational Application Developer 專案。

指導教學

您可以從主功能表按一下說明 > 指導教學展示區 > ，以存取教學課程。做中學教學課程包括：

建立 J2C 應用程式來處理輸入和輸出資料含有陣列的 IMS 交易
建立 J2C 應用程式來處理輸入和輸出資料含有可變長度和多重區段的 IMS 交易
建立 IMS 電話簿交易的 J2C 應用程式
建置 CICS^® COBOL 記錄定義檔的 J2C 應用程式：有多種可能的輸出

還有一個看中學教學指導，叫做「建置 CICS COBOL 記錄定義檔的 J2C 應用程式：相同輸入和輸出」。

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

1.1 這個版本的新功能

1.2 產品修正歷程

這個版本的 Rational Application Developer J2EE 連接器工具特性中，包括下列修正程式：

2.0 安裝資訊

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 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)

2.2.2 資源配接器

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

這個版本注意事項包括版本特定的資訊，例如：在產品說明文件完成之後才可使用的問題和限制。

3.1 限制

3.1.1 部署時間異常狀況

在建立網頁、EJB 或 Web 服務期間，您可能會在 WebSphere Application Server 第 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.1.2 安裝在相同執行時期伺服器上的多個資源配接器

在 WebSphere Application Server 中，不應安裝相同 EIS 資源配接器的多個獨立式版本，尤其是當它們適用於相同的 EIS 類型時。比方說，如果您安裝了 CICS ECI 5.1 和 CICS ECI 6.0，可能會發生衝突。這是因為所有獨立式資源配接器都共用相同的類別載入器。

3.2 問題和暫行解決方法

3.2.1 無法利用 J2C 精靈來變更 ConnectionSpec

J2C 精靈沒有提供任何使用者介面支援來讓使用者變更 ConnectionSpec。您必須在所產生的實作 Java 程式碼中直接將它變更。在編輯器中開啟所產生的實作 Java 檔，導覽至您要修改的方法，然後變更、新增或移除該方法的 Doclet。

3.2.2 無法匯入包含 DBCS 的 COBOL 檔案

若您匯入包含 NL 字元的 COBOL 檔案，則必須變更「編譯時間語言環境名稱」（請使用視窗 > 喜好設定 > 匯入器 > COBOL > 其他 COBOL 選項）。您將會收到預設 en_US 的錯誤。

3.2.3 在新建 J2C JavaBean 精靈中輸入某些 IMSInteractionSpec 內容值有困難

在「新建 J2C JavaBean 精靈」中，若您選取 com.ibm.connector2.ims.ico.IMSInteractionSpec，則當您在「進階」輸入欄位的重新遞送名稱、LTERM 名稱及對映名稱中輸入值時，可能會發生問題。由於這些欄位都已填入空格，所以您應先清除欄位中的空格，再輸入您的值。否則，您會收到錯誤指示，而且無法再繼續。

4.0 客戶支援中心

5.0 注意事項和商標

© Copyright IBM Corporation 2000, 2005. All Rights Reserved.

本 IBM 產品所附的 XDoclet 文件，必須具備許可權才能使用，而且必須遵守下列著作權聲明：Copyright (c) 2000-2005, XDoclet Team. All rights reserved.

本軟體之若干部分係以 Addison-Wesley Publishing Company, Inc. 出版之 Design Patterns: Elements of Reusable Object-Oriented Software 為基礎，其作者為 Erich Gamma、Richard Helm、Ralph Johnson 及 John Vlissides，其著作權標示如下：Copyright (c) 1995 by Addison-Wesley Publishing Companny, Inc. All rights reserved.

本資訊係針對 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 不保證或暗示這些程式的可靠性、有用性或功能。

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

如果貴客戶閱讀的是這項資訊的電子檔，可能不會有照片和彩色說明。

程式設計介面資訊

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

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

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

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

商標和服務標記

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

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

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

Intel^® 和 Pentium^® 是 Intel Corporation 或其子公司在美國及/或其他國家或地區的商標或註冊商標。

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

IBM J2EE 連接器工具特性 6.0.1 版 - 版本注意事項

適用於 IBM Rational Application Developer 6.0.0.1 或 6.0.1 版

內容

1.0 關於這個版本

精靈