WebSphere^TM Development Tools for iSeries V5.1 版本注意事項

本文件提供的資訊僅適用於本版次的 WebSphere Development Tools for iSeries 產品。此版次將先前只能以個別產品取得的元件整合在一起。我們提供硬體基本需求 (記憶體及磁碟空間)、軟體基本需求 (開發及執行時間使用) 及移轉實務。

README 文件包含了先決條件資訊、產品的限制以及本文件中所沒有包含的資訊。

安裝須知文件包含所有安裝須知及程序。這包括回應檔的使用、如何解除安裝以及如何新增或移除產品元件。

WebFacing Tool 可讓您顯示在使用 DDS 顯示檔案的 Web 傳統程式上。自訂產生的 JSP 檔和 Java beans 取代 DDS 程式碼並使 Web 存取成為可能。
WebSphere Studio for iSeries，內含一些精靈，讓您可以建立 JavaBeans^TM、Java servlets 及輕鬆部署電子商務應用程式。
VisualAge for Java for iSeries 提供 Java 開發的有力環境。您可以選擇性地安裝 ET/400，它可提供工具、精靈、Java Bean 與 AS/400 Toolbox for Java 類別。這可以讓針對 iSeries 開發 Java 從屬站與伺服器程式的工作變得更簡單。
Cooperative Development Environment (CODE)，可以讓您編輯、編譯及除錯 RPG、COBOL、C、C++、CL、DDS 及 Java（包括 CODE Designer，它是一種 WYSIWYG DDS 工具）。
VisualAge RPG，支援具有 Windows GUI 的應用程式、對 iSeries 資源的透通存取以及產生 Java 應用程式和 applet。

將 WebSphere Studio 及 VisualAge for Java 整合，可讓各團隊通信及合作，以從事下列作業：

建立新的電子商務應用程式
從其他伺服器移轉現有的電子商務應用程式
啟用現有的 Web 應用程式

此外，藉由下列功能，簡化了 WebSphere Development Tools for iSeries 的安裝作業：

自動啟動功能表驅動的安裝程序
「主電腦及伺服器配置」精靈，可在工作站及伺服器之間設定通信作業。

工作站基本要求

硬體基本需求

WebSphere Development Tools for iSeries 具有下列硬體基本需求：

處理器 - Intel Pentium II（建議使用更快的相容處理器）
顯示器 - SVGA 800x600（建議 1024x768）
光碟機或影碟機
滑鼠或其他指標裝置
適當的通信配接卡 (必須是工作站作業系統所支援的配接卡)

記憶體與磁碟基本要求如下：

元件	記憶體		磁碟
元件	最小需求	建議值	最小需求	建議值
WebFacing Tool（第一版）	128 MB		200 MB
WebSphere Studio for iSeries (V3.5)	96 MB	128 MB	385 MB	500 MB
VisualAge for Java for iSeries (V3.5)	128 MB	192 MB	495 MB	550 MB
CODE	64 MB	96 MB	235 MB
VisualAge RPG	64 MB	96 MB	285 MB
產品總計	128 MB	256 MB	1.2 GB	1.5 GB

如果您選擇只安裝所需的元件，則可減少系統需求。

軟體基本需求

WebSphere Development Tools for iSeries 具有下列軟體基本要求：

特性	開發時間	執行時間
WebFacing Tool（第一版）	Windows 98/NT/2000/ME Netscape Communicator 4.7 或更新的版本或 Internet Explorer 5.0 或更新的版本	OS/400 V4R5 Internet Explorer 5.0 或更新的版本 WAS 3.5.2 或更新的版本
WebSphere Studio for iSeries (V3.5)	Windows 98/NT/2000/ME Internet Explorer 4.0 或更新的版本 OS/400 V4R5 或更新的版本 WebSphere 應用程式伺服器 V3.5.2 或更新的版本	OS/400 V4R5 或更新的版本 Netscape Communicator 4.7 或更新的版本或 Internet Explorer 4.0 或更新的版本 Internet Explorer 5.0（適用於 Page Detailer） WebSphere 應用程式伺服器 V3.5.2 或更新的版本
VisualAge for Java for iSeries (V3.5)	Windows 98/NT/2000 OS/400 V4R3 或更新的版本 Netscape Communicator 4.7 或更新的版本或 Internet Explorer 5.0 或更新的版本	OS/400 V4R5 或更新的版本 JRE V1.2.2 或更新的版本
CODE	Windows 98/NT/2000/ME OS/400 V4R5 或更新的版本 Netscape Communicator 4.7 或更新的版本或 Internet Explorer 5.0 或更新的版本	N/A
VisualAge RPG	Windows 98/NT/2000/ME OS/400 V4R5 或更新的版本 Netscape Communicator 4.7 或更新的版本或 Internet Explorer 5.0 或更新的版本	Windows 98/NT/2000/ME 任何 JRE V1.2.2 或更新的版本，包括瀏覽器 OS/400 V4R5 或更新的版本

移轉程序

必要時，此版次會移除之前的元件版次，然後才安裝它自己。

VisualAge(R) for Java(TM)

版本 3.5.3

Enterprise Toolkit for AS/400(R)

版本注意事項

1.0 簡介
2.0 先決條件
3.0 限制與已知的問題
     3.1 轉換顯示檔引導精靈
     3.2 AS400eList Bean 效能
     3.3 DFU Bean 中產生程式碼
4.0 提示與秘訣
      4.1 執行時間檔案
      4.2 部署有 DFU Bean 的 VCE 應用程式
      4.3 除錯
5.0 AS/400 Java 網站
6.0 文件

1.0 簡介

這些「版本注意事項」含有 VisualAge for Java Enterprise Toolkit for AS/400 的先決條件資訊。此外，亦包含了產品限制與文件中所沒有的資訊。 and information not included in the documentation.

AS/400 伺服器現在稱為 IBM eServer iSeries。但是，就此版次的 VisualAge for Java 而言，對伺服器的所有參照均是使用之前的名稱 "AS/400"。

2.0 先決條件

一般而言，我們建議您在您的 AS/400 上載入最新的累計修正程式 (PTF)。

Distributed Debugger 需要套用下列 PTF 到適當的版次：

OS/400 版次	LPP 號碼	PTF 號碼

V4R3M0	5769SS1*	SF49975*
V4R3M0	5769999	MF19487
V4R4M0	5769999	MF24806
V4R4M0	5769SS1	SF54570
V4R4M0	5769SS1	SF56682
V4R4M0	5769SS1	SF56281
V4R4M0	5769SS1	SF63732
V4R5M0	5769SS1	SF63034

*註：此 PTF 不久就會被另一個 PTF 取代。

如需 Distributed Debugger 的最新 PTF 相關資訊，請參閱 http://www-1.ibm.com/support/search.wss?rs=715&tc=SSZND2&dc=DA400。

「轉換顯示檔引導精靈」的編輯碼支援已加強。若要利用此功能，則必須套用適當的 PTF：

OS/400 版次	LPP 號碼	PTF 號碼

V3R1M0	5763PW100	SF47783
V3R2M0	5763PW100	SF47784
V3R6M0	5716PW100	SF47785
V3R7M0	5716PW100	SF47786
V4R2M0	5769PW100	SF47774

「ET/400 執行」動作需要下列 PTF：

OS/400 版次	LPP 號碼	PTF 號碼

V4R3M0	5769SS100*	SF49975*
V4R4M0	5769SS100	SF63732
V4R5M0	5769SS100	SF63034

*註：此 PTF 不久就會被另一個 PTF 取代。

數個範例均會使用 ADTSLAB 檔案庫中已更新的 AS/400 檔案。若要能夠執行這些範例，則必須套用下面列出的 "Application Development ToolSet/400" 產品的適當 PTF：

OS/400 版次	LPP 號碼	PTF 號碼

V4R2M0	5769PW100	SF63545
V4R4M0	5769PW100	SF63703

如需最新的 PTF，請參閱：http://www.software.ibm.com/ad/as400/vajava/

如需 IBM(R) AS/400 Toolbox for Java(TM) PTF，請參閱下列網站： http://www.as400.ibm.com/Toolbox
您必須先在 AS/400 上啟動所有主電腦伺服器（發出 STRHOSTSVR *ALL）且必須在伺服器上啟動 TCP/IP（發出指令 STRTCPSVR *DDM），才能連接 AS/400 伺服器。

3.0 限制與已知的問題

3.1 轉換顯示檔引導精靈

在具有 IBM Personal Communications 較早版本的系統上，可能無法在「轉換顯示檔引導精靈」執行時啟動 IBM Personal Communications 階段作業。一旦「引導精靈」執行完成，即可以啟動 IBM Personal Communications 階段作業。

由此「引導精靈」產生的 Bean 可以在 VCE 中開啟，且會在執行「從來源建構視覺化」後儲存。最後 Bean 的外觀或行為可能會與原來的不同。

3.2 AS400eList Bean 效能

從 AS/400 伺服器取出清單時，如果清單非常大或如果選取了二進位或日期欄位，則資料轉換會需要較長的時間才能完成。若要達到最佳效能，請遵循下列建議：

請使用 OBJL0100 或 OBJL0200 格式，可以容許在一個步驟中執行資料轉換。
如果選取了 OBJL0300 或更高的格式，則除非必要，否則請試著避免選取下面列出的二進位或日期欄位。如果選取了二進位欄位或日期欄位，則必須針對每一個項目個別執行欄位屬性的轉換。這會減緩整體處理程序的速度，特別是針對較大的清單。

二進位欄位
getInclude0300AuxiliaryStoragePool()
getInclude0500SaveSize()
getInclude0500SaveSizeMultiplier()
getInclude0500SaveSequenceNumber()
getInclude0600DaysUsedCount()
getInclude0700Size()
getInclude0700SizeMultiplier()

日期欄位
getInclude0300CreateDateTime()
getInclude0300ChangeDateTime()
getInclude0500SavedDateTime()
getInclude0500RestoredDateTime()
getInclude0500SaveActiveDateTime()
getInclude0600LastUsedDateTime()
getInclude0600ResetDateTime()

3.3 DFU Bean 中產生程式碼

當 FormManager、ListManager 或 RecordIOManager Bean 產生程式碼時，進度指示器會出現數次，視針對條件類別所產生的方法數而定。

在產生程式碼期間，請勿嘗試關閉 Bean 的「內容」視窗，因為這會造成「視覺化組合編輯程式」終止。若為 FormManager 或 ListManager，則 recordIOManager 內容的值會在產生程式碼完成時變更，且可以在那時關閉「內容」視窗。

4.0 提示與秘訣

4.1 執行時間檔案

下列 .jar 與 .zip 檔案可用於執行 VisualAge for Java 以外的範例與應用程式。這些檔案可以在 'eab\runtime30' 目錄中取得：

JT400.JAR (AS/400 Toolbox for Java)
JT400MRI.ZIP（AS/400 Toolbox for Java 類別的轉換文字）
AS400UT.JAR（在 package com.ibm.ivj.et400.util 與
com.ibm.ivj.et400.util.awt 中提供類別）

這些 Toolbox .jar 檔案也可以在 'eab\runtime30' 目錄中找到：

DATA400.JAR
JT400PROXY.JAR
JT400SERVLET.JAR
JUI400.JAR
UITOOLS.JAR
UTIL400.JAR
X4J400.JAR
JT400ACCESS.ZIP
UTILITIES.ZIP

請檢查「常見問題」以取得如何在 OS/400 上使用 AS/400 Toolbox for Java 的相關資訊，您可以參閱 http://www-1.ibm.com/servers/eserver/iseries/toolbox/faq.htm。

4.2 部署有 DFU Bean 的 VCE 應用程式

如果您想要部署在「視覺化組合編輯程式」中建立且含有 DFU Bean 的應用程式，則必須匯出應用程式的類別與資源。當應用程式含有 DFU Bean 時，「視覺化組合編輯程式」會在應用程式的專案中產生 .sos 檔作為資源。您可以在 \VisualAge for Java\ide\project_resources\<application project name>\<application package name> 中找到 .sos 檔案。

4.3 除錯

「除錯」與「啟動 OLT 檢視器」功能表項目只有在系統上已安裝了 Distributed Debugger 時才能運作。

Distributed Debugger 是與 VisualAge for Java 分開安裝。若要安裝它，請返回 VisualAge for Java 安裝程式，並選取要安裝 Distributed Debugger。

5.0 AS/400 Java 網站

http://www-3.ibm.com/software/awdtools/vajava/etoolkit/index.html 網站含有最新 AS/400 Java 特性的更新、提示、秘訣與相關資訊。

若要瞭解 IBM AS/400 Toolbox for Java 的其餘相關資訊，請探訪下列網站：
http://www-1.ibm.com/servers/eserver/iseries/toolbox/index.html

6.0 文件

大部份的 Enterprise Toolkit for AS/400 (ET/400) 說明因為轉換而有所變更。請參閱英文說明，以取得最新版本的說明。
只以英文記錄的 ET/400 特性包括：
- DFU Bean：FormManager、ListManager 與 RecordIOManager。 DFU Bean 是一組類別，可以擴充程式碼支援以存取一或多個 AS/400 資料庫檔案。這些 Bean 可以讓您對映 GUI 套表、表格與 AS/400 資料庫清單，並操作（擷取、新增、更新與刪除）資料庫記錄。
- 「物件清單」Bean： ET400List 與 AS400eList。「物件清單」Bean 提供存取 AS/400 物件名稱的方法。這些 Bean 可以讓您設定列示內容，以便選取想要的物件清單類型。物件清單類型包括檔案庫清單、檔案庫中的檔案清單或系統上使用者 ID 的清單。內容設定可以用來存取許多不同類型的物件清單。
- 新 JFormatted Bean（新增至現存的 JFormatted Bean）：JFormattedTable、 JFormattedTableColumn、JFormattedTextFieldCellEditor、
  JFormattedComboBoxCellEditor 與 JFormattedLabelCellRenderer。
- 新的「登入」對話框。
- 「編譯」與「執行」對話框中的新選項。
- 啟動「ET/400 常駐程式」可以讓您避免在存取及使用「引導精靈」、動作對話框或內容對話框時，重複登入同一個 AS/400 一次以上。
自前次轉換 ET/400 說明後，已新增了下列概念：
- "「資料檔公用程式 (DFU)」Bean"
- "「物件清單」Bean"
已新增下列作業：
- "啟動及停止「ET/400 常駐程式」"
- "啟動「OLT 檢視器」進行除錯"
已新增下列參照：
- "FormManager bean"
- "ListManager bean"
- "RecordIOManager bean"
- "RecordIOManager 內容"
- "程式呼叫注意事項"
- "JFormattedTable bean"
- "JFormattedTableColumn bean"
- "JFormattedTextFieldCellEditor bean"
- "JFormattedComboBoxCellEditor bean"
- "JFormattedLabelCellRenderer bean"
- "ET400List bean"
- "AS400eList bean"
已新增專屬於新 DFU、「物件清單」與 JFormatted Bean 的範例。
下列概念已變更：
- 在 "JFormatted Bean" 中，已新增 JFormattedTable、JFormattedTableColumn、JFormattedTextFieldCellEditor、JFormattedComboBoxCellEditor 與 JFormattedLabelCellRenderer Bean 的相關資訊。
下列參照已變更：
- "顯示檔案注意事項"
- "顯示檔案關鍵字"
自前次轉換 ET/400 說明後，已移除下列特性：
- 不再有「建立子檔案引導精靈」，並已移除對建立子檔案或使用「建立子檔案引導精靈」的所有參照。
自前次轉換 ET/400 說明後，已移除下列作業：
- "建立子檔案類別"
自前次轉換 ET/400 說明後，已移除下列參照：
- "子檔案的記錄 I/O 注意事項"
自前次轉換 ET/400 說明後，已移除下列範例：
- "建立 Java 從屬站/伺服器應用程式"
- "顯示姓名與電話號碼清單"
- "取得及顯示子檔案中的資料"
- "大量輸入子檔案資料"
- "隱藏子檔案中的直欄"
- "取得子檔案中的記錄"
- "取得資料庫檔案的欄位名稱與說明"
- "設定子檔案外觀"
- "新增、移除及插入子檔案記錄"
- "設定子檔案選取模式"
- "AS/400 Toolbox for Java（示範程式）"

WebSphereTM Development Tools for iSeries V5.1 版本注意事項

目錄

版次 V5.1 的元件

工作站基本要求

硬體基本需求

軟體基本需求

移轉程序

WebSphere^TM Development Tools for iSeries V5.1 版本注意事項