WebSphereTM Development Tools for iSeries V5.1 README 檔

本文件包含 WebSphere Development Tools for iSeries 產品的先決條件資訊。此外，它也包含了產品的相關限制，以及說明文件中所沒有包含的資訊。

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

版本注意事項文件說明產品元件、詳細的系統需求與移轉實務，以及 VisualAge(R) for Java(TM) 版本 3.5.3 Enterprise Toolkit for AS/400(R) Release Notes。

目錄

文件變更

重要事項：如何選擇性安裝或移除元件
「修改」精靈可讓您新增或移除元件。具有文字「選取要修改的元件」的頁面應含有此說明： 

若要新增遺漏的元件，請確定已選取其勾選框。
若要移除元件，請清除其勾選框。
在安裝後如何新增或移除元件一節的「安裝注意事項」中有完整的說明。

VisualAge RPG (VARPG)

對於 V5.1，VARPG GUI 設計者解說已更新且含有下列的新解說資訊：

對此線上說明沒有進行任何其它更新。

尚未更新 HTML 及 PDF 版本的 VARPG 出版品。 如此，它們所含的下列資訊不正確：

DLL 及 LINKAGE 關鍵字不是在下列「語言敏感性」解說的關鍵字清單中：

這些關鍵字也不在表格 33 中。原型、程序介面及參數關鍵字是在 VisualAge RPG Language Reference 出版品中。

下列的組件屬性已新增至 VisualAge RPG。
組件 屬性 類型 說明 有效的
作業
Code
子檔案 EditColumn 數值 傳回為了編輯而開啟的資料格直欄號碼。 getatr
EditIndex 數值 傳回為了編輯而開啟的資料格橫列號碼。 getatr
EditText 文字 傳回被編輯的資料格目前編輯的文字。
傳回空字串，若沒有為編輯所開啟的資料格。		 getatr
下列「子檔案」屬性是用於變更顯示「子檔案」資料直欄的次序。 「資料直欄」是指「筆記本」內容中，「欄位清單」頁的指定時間所指定的直欄次序 （「資料直欄」是使用 ColNumber 屬性指定）。「檢視直欄」是指直欄顯示的次序 （「檢視直欄」是使用新 ViewColumn 屬性指令）。依預設值，資料直欄與檢視直欄是相同的。 如果使用者移動直欄的顯示位置，則只會變更檢視直欄。
MapViewCol 數值 當設定為 1 時，這會顯示子檔案與依據屬性 ColNumber 及 ViewColumn 重新排列的直欄。ColNumber 已設定為要移動的資料直欄號碼， 且 ViewColumn 設定為目的地直欄。請注意：沒有切換直欄。檢視直欄會在必要時向右或左移位。 setatr
ViewColumn 數值 設定為 MapViewCol 目的地直欄。 setatr
對映資料直欄 2 到檢視直欄 4 的程式碼範例 
C     Eval      %Setatr('FRA000000B':'SUBF':'ColNumber')=2
C     Eval      %Setatr('FRA000000B':'SUBF':'ViewColumn')=4
C     Eval      %Setatr('FRA000000B':'SUBF':'MapViewCol')=1
DColFRVCol 數值 傳回對應到 ViewColumn 指定直欄的資料直欄。 getatr
取得檢視直欄 4 資料直欄的程式碼範例 
C     Eval      %Setatr('WIN':'SBF':'ViewColumn')=4
C     Eval      DataCol4 = %Getatr('WIN':'SBF':'DCOLFRVCOL')
VColFRDCol 數值 傳回對應到 ColNumber 指定直欄的檢視直欄。 getatr
取得資料直欄 4 檢視直欄的程式碼範例 
C     Eval      %Setatr('WIN':'SBF':'ColNumber')=4
C     Eval      ViewCol4 = %Getatr('WIN':'SBF':'VCOLFRDCOL')
SortAsc 數值 設定為升序排序子檔案資料的資料直欄。 setatr
排序第 3 直欄升序的程式碼範例 
C     Eval      %Setatr('WIN':'SBF':'SortAsc')=3
SortDesc 數值 設定為降序排序子檔案資料的資料直欄。 setatr
排序第 3 直欄降序的程式碼範例 
C     Eval      %Setatr('WIN':'SBF':'SortDesc')=3
視窗 PrintAsIs 文字 列印影像與維護層面比例。 setatr
影像 PrintAsIs 文字 列印影像與維護層面比例。 setatr
靜態文字 DropValue 數值 設定為 1 表示容許捨棄作業變更標籤值。設定為 0 表示避免在捨棄後變更值。預設值為 1。 例如，靜態文字部份的標籤為「傳送郵件」，且會指示使用者將電子郵件位置拖放到標籤上以啟動傳送電子郵件的對話框。 將 DropValue 設為 0，使標籤不會變更為電子郵件位址。 setatr
筆記本頁 OnTop 數值 設定為 1 表示將指定頁變更為現行頁。 先前，使用者將筆記本組件的 "PageNumber" 設定為 N，以便讓第 N 頁成為現行頁。 當頁面已設定為隱藏時，此方法會造成混亂，因為執行時間會從筆記本組件中刪除頁面。 （當頁面已重新設定為可見時，執行時間會將它新增回筆記本。） 例如，如果執行下列程式碼： 
C            EVAL	   %SetAtr('frame':'page3':'visible')=0
C            EVAL          %SetAtr('frame':'notebook':'PageNumber')=3
則現行頁是第 4 頁（現在現行頁是第 3 頁，因為原來的第 3 頁已被刪除）。
使用者現在可以使用此行將第 4 頁設定為現行頁： 
C            EVAL          %SetAtr('frame':'page4':'OnTop')=1
沒有使用索引號碼，可以更清楚哪一頁是現行頁。
GETATR 可以用來取得筆記本頁中 OnTop 屬性的值。如果該頁是現行頁，則會傳回 1， 否則會傳回 0。 		setatr
getatr

下列「組件」事件已新增到 VisualAge RPG。
組件 事件 說明
圖形 Popup 新增新事件
筆記本頁 SelPending 當使用者按一下另一頁時， 此事件的信號為現行頁。例如，此事件的動作次常式可以檢查是否已輸入所有必要輸入。 如果沒有，則傳回 "NODEFAULT"，使 VARPG 執行時間引擎不會切換到另一頁。這會免除停用其它頁或讓它們隱藏的必要性。程式碼範例如下： 
 C     NBP_1         BEGACT    SELPENDING    FRA_1
 C                   if        %getatr('FRA_1':'cusno':'text')=*blank
 C     *msg0001      dsply                   rc1               9 0      Display an error message;
 C                   eval      RC='*NODEFAULT  '
 C                   else
 C                   eval      RC='*DEFAULT    '
 C                   endif
 C                   ENDACT    RC

WebSphere Studio for iSeries

如需 IBM WebSphere Studio for iSeries 的特定先決條件與限制相關資訊，請參閱 WebSphere Studio README 與 ReadMe 3.5 FixPack 2 檔案。您可以從 Windows「開始」功能表中選取「程式集> IBM WebSphere Development Tools for iSeries> IBM WebSphere Studio for iSeries」，以檢視這些注意事項。

關於 BiDi 支援
WebSphere Studio for iSeries 中的每一個 DTC 現在具有指定文字方向的 directionality 屬性內容。此內容是在控制內容的「一般」頁中。選項如下：
LTR文字方向是由左至右
RTL文字方向是由右至左
NONE文字方向是語言的預設值

此外，「子檔案」在「欄位內容」頁中也有每一個欄位的 'directionality' 屬性。 「子檔案」之「一般」頁下的 'directionality' 屬性會定義如何排列直欄/欄位。 「欄位內容」內容頁中的 'directionality' 屬性會定義如何提交欄位的文字。

在「Web 交談精靈」的「程式呼叫定義」頁中， 已新增新屬性 bidistringtype。選項說明如下。
字串類型
文字類型		 方向 對稱
交換		 數值
形狀		 文字
形狀
預設值 非 BiDi 資料 (LTR) 的預設字串類型
ST4 視覺化 LTR 否 Nominal Shaped
ST5 隱含 LTR 是 Nominal Nominal
ST6 隱含 RTL 是 Nominal Nominal
ST7 視覺化 上下文 LTR 否 Nominal Nominal
ST8 視覺化 RTL 否 Nominal Shaped
ST9 視覺化 RTL 是 Nominal Shaped
ST10 隱含 上下文 LTR 是 Nominal Nominal
ST11 隱含 上下文 LTR 是 Nominal Nominal
註：每一個 CCSID 都有預設的 CDRA 字串類型，定義一組 BiDi 旗號。在 BiDi 字串中執行轉換並使用這些常數時， 參數字串類型一定應是 ST5 (LTR)、ST6 (RTL)、ST10 (Contextual LTR) 或 ST11 (Contextual RTL)。

關於兩個新欄位
「公佈精靈」的第一頁有兩個新欄位 WAS 應用程式伺服器名稱與 WAS servlet 引擎名稱。它們的預設值是 Wdt400AppServer 及 Wdt400ServletEngine，是先前已寫死在程式中的。

關於欄位標籤變更
「公佈精靈」的第一頁有一個標籤為 WAS 節點名稱的欄位， 之前的標籤為 XML 節點名稱。在公佈精靈中指定 WAS 節點名稱時， 請使用您在管理主控台中看到的節點名稱。

Distributed Debugger 與 Object Level Trace

如需 IBM Distributed Debugger 與 Object Level Trace 的特定先決條件與限制相關資訊， 請參閱 IBM Distributed Debugger and Object Level Trace Release Notes。您可以從 Windows「開始」功能表中選取「程式集> IBM WebSphere Development Tools for iSeries> IBM Distributed Debugger> README」，以檢視這些版本注意事項。

已知的問題及解決方案

JDK 注意事項
IBM Java 2 Software Development Kit (J2SDK), Standard Edition v1.2.2 已隨附於此產品中。 J2SDK 包含 JavaDocs。 如果您選擇使用其他 JDK，則其版本必須是 1.2 或較新版本， 以確保 Java 程式碼所有元件的機能。

若要使用不同的 JDK，請決定它的 JRE (Java 執行環境, Java Runtime Environment) 起始目錄。 在 CODE 編輯器中，請輸入命令SET GLOBAL.JREHOME x:\dir，其中 x:\dir 是 JRE 的起始目錄。 例如：SET GLOBAL.JREHOME C:\JDK1.2\JRE。

如果您計畫要使用 VisualAge RPG Media 元件，則請安裝 Java Media Framework API。

VisualAge RPG 的 GUI 設計者及 Java 外掛程式
Netscape Navigator 及 Microsoft 的 Internet Explorer 目前都不支援 VisualAge RPG 所使用之相同層次的 J2SDK。 因此，用 VisualAge RPG 的「GUI 設計者」建立出來的 applet 不會直接以這二種瀏覽器執行。 若要在這兩種瀏覽器上執行 VisualAge RPG applet， 您必須先安裝 Java 外掛程式 1.2（內含於 J2SDK）。 您可以從 The Source for Java Technology 網站下載 J2SDK，網址是 java.sun.com。

VisualAge RPG IFS 名稱
一律使用 1 到 8 個字元長且沒任何空格的 IFS 目錄名稱。

說明的問題
WebSphere Development Tools for iSeries 使用 VisualAge Help System 以透過 web 瀏覽器來遞送其線上說明資訊。 如果您在啟動、使用或搜尋解說時發生問題， 可以使用安裝媒體中的問題解決文件。把 CD 1 或 DVD 放進它的磁碟機並使用 Windows Explorer 開啟 x:\install\help\helpyyy\helpTroubleshooting.htm 檔案，其中 x 是磁碟機字母，yyy 是語言碼，如下所示：
LanguageCodeLanguageCodeLanguageCodeLanguageCodeLanguageCode
German deu English enu Spanish esp French fre Italian ita
Japanesejpn Koreankor Portugese
(Brazilian)		bra Chinese
(Simplified)		chs Chinese
(Traditional)		cht
安裝後，疑難排解文件即位於產品目錄 install\help 中。

WebSphere Studio for iSeries：呼叫子檔案 DTC API
當使用者主電腦程式需要呼叫 Websphere Studio for iSeries 子檔案 DTC API 時， 需要主電腦服務程式 QGPL/QDTSSFL.SRVPGM。

對於安裝

  1. 安裝步驟需要具有 *ALLOBJ 及 *SAVSYS 權限的主電腦 ID。
  2. 從工作站將 qdtssfl.sav 儲存檔傳送到 iSeries 主電腦 QGPL 檔案庫：
    1. 開啟指令提示視窗
    2. 變更為 qdtssdfl.sav 的來源目錄 x:\WDT400\Studio35\Affinity， 其中 x:\WDT400 是產品的安裝磁碟機與目錄。
    3. 輸入這些指令：
      ftp iSeriesHost
      cd QGPL
      binary
      put qdtssfl.sav QDTSSFL（假設已建立 QDTSSFL SAVFILE，例：CRTSAVF FILE(QGPL/QDTSSFL)）
  3. 從儲存檔中復置 QDTSSFL SRVPGM 至 QGPL 檔案庫：
    RSTOBJ OBJ(*ALL) SAVLIB(QGPL) DEV(*SAVF) SAVF(QGPL/QDTSSFL) RSTLIB(QGPL)

對於開發環境

  1. 請確定 QGPL 是在檔案庫清單中。
  2. 連結對 QGPL\QDTSSFL.SRVPGM 發出「子檔案 DTC API」呼叫的使用者程式

對於執行時間環境，請確定 QGPL 檔案庫是在檔案庫清單中。

V5.1 之前版次使用者的注意事項：

  1. 所有鏈結到 QSYS\QDTSSFL.SRVPGM 的現存程式已重新鏈結到新 QGPL\QDTSSFL.SRVPGM。
  2. 在上述所有現存程式重新鏈結到新 SRVPGM 後，即可在 QSYS 檔案庫中安全地移除 QDTSSFL.SRVPGM V5.1 之前的版本。

從 Enterprise Toolkit for iSeries 使用範例
為了使用在 ET/400 中提供的範例，您必須復置 ADTSLAB 檔案庫。若是 WebSphere Development Studio for iSeries V5R1，則此檔案庫是位於 QPDA。

CODE 中被截斷的顯示訊息
有時，在「CODE 編輯器」中的長訊息會被截斷。請選取訊息，然後按一下「說明」或按下 F1 以察看整個訊息。

瀏覽器問題

WebSphere Development Tools 的某些元件需要使用 Internet Explorer 作為瀏覽器（請參閱「版本注意事項」中的軟體基本要求）。部份 Netscape 問題的說明如下。請使用 Internet Explorer 作為您的預設瀏覽器，以避免這些限制與問題。

Windows 2000 中的 Netscape 搜尋
在部份 Windows 2000 機器上使用 Netscape（版本 4.5 到 4.74，其它版本也有可能）有一些已知的問題，可能會造成搜尋線上說明的速度非常緩慢。當您在這些版本的 Netscape 中提出套表時，Netscape 應用程式會使用機器上大部份可用的處理器循環，直到收到遠端系統的回應。在執行遠端搜尋（例：搜尋網站）時，這通常不是問題。但是，因為產品的搜尋程式是在您自己的本端機器上執行，如果 Netscape 使用這麼多的 CPU 時間，則此情況表示只剩下非常少的 CPU 時間可供搜尋程式執行搜尋使用。結果，應該在一秒內傳回結果的搜尋動作，在 Windows 2000 上可能需要數分鐘的時間。

您可以在每一次提出搜尋後，選取不同的非 Netscape 視窗，即可避免此效能問題。這通常會造成 Netscape 在等待回應時停止使用過多的 CPU 循環，且在執行此視窗切換後，通常會在一秒鐘內顯示搜尋結果。

另外，您可以使用 Microsoft Internet Explorer 來檢視說明。使用此瀏覽器不會發生效能問題。

Netscape Navigator 不一致
Netscape Navigator 不符合 HTML 4 的標準。由 WebSphere Studio for AS/400 產生的網頁及以 Netscape Navigator 顯示的網頁都有下表中所述的 DTC 問題。如果使用的是 Internet Explorer，則不會發生這些問題。

DTC 類型 外觀問題 事件問題 屬性問題
輸入欄位 無法置換顏色及背景顏色預設值。 不支援 OnSelect、OnClick、OnDblClick、OnMouseOver、OnMouseDown、OnMouseUp 及 OnMouseOut。 "alignment" 屬性會移動整個欄位，而不只是文字。
不支援 "readonly" 屬性，但此問題可以下列方式修正：
- 選取 DTC
- 顯示「控制內容」對話框
- 選取「事件」標籤
- 按一下 onFocus 事件
- 在 Script 方框中輸入 "this.blur();"。
勾選框 沒有問題 不支援 OnChange。 沒有問題
組合框 無法置換顏色及背景顏色預設值。
字型會被忽略。		 沒有問題 沒有問題
清單框 無法置換顏色及背景顏色預設值。
字型會被忽略。		 沒有問題 沒有問題
MLE 無法置換顏色及背景顏色預設值。
字型會被忽略。
文字會不正確地折至下一行。		 不支援 OnSelect。 沒有問題
按鈕 背景顏色一律是淡灰色。 不支援 OnKeyPress、OnKeyUp、OnKeyDown、OnMouseOut 與 OnMouseOver。 沒有問題
圓鈕 沒有問題 不支援 OnMouseOut、OnMouseOver、OnKeyUp、OnKeyDown、OnKeyPress 與 OnChange。 沒有問題

Internet Explorer 與 AS/400 Toolbox for Java 的說明
使用 Internet Explorer 顯示時，部份 Toolbox for Java 說明頁使用的字集不正確。每一種語言的正確字集如下：
語言 字集名稱
簡體中文 Chinese Simplified(GB2312)
繁體中文 Chinese Traditional(Big5)
Korean Korean
Japanese Japanese(Shift-JIS)

請在瀏覽器視窗中使用這些步驟以為您的語言選取正確的字集。
  1. 按一下功能表列上的「檢視」以開啟下拉清單。
  2. 將游標放在「編碼」上以開啟字集清單。
    1. 如果必要的字集是在此清單中，請按一下它。
    2. 如果必要的字集未列出，請將游標放在「尚有」上以開啟較長的字集清單。
    3. 按一下必要的字集。
每一次使用不正確的字集開啟說明頁時，即必須執行此動作。

Distributed Debugger
當您正在除錯從網頁（由 WebSphere Studio for AS/400 產生）啟動的「程式」或「服務程式」時，「程式」完成或「服務程式」進入點完成並不會造成除錯器終止。這可防止後續的除錯階段作業。若要能夠重新除錯，請使用「停止」按鈕來關閉未執行的除錯階段作業。

Object Level Trace
如果未在 Windows 95 或 Windows 98 上啟動 Object Level Trace，請確定您的環境空間已設定為最大值。在您的 CONFIG.SYS 中找出 SHELL 指引， 然後確定 /E 值已設定為 32768。 例如：SHELL=C:\WINDOWS\COMMAND.COM /p /E:32768

如果在目錄 DbgProf 中的環境檔已受損，則 OLT 檢視器會失敗。如果發生此情況，請刪除 DbgProf 目錄中的所有檔案。每一個使用者有個別的目錄。啟動 OLT 檢視器時，它會重新建立檔案。

OLT 檢視器在第一次啟動或在刪除目錄 DbgProf 中的環境檔案後啟動時，會顯示錯誤「無法開啟 dertrdfl 輸入串流」。此錯誤不會影響 OLT 檢視器的執行方式。

Norton AntiVirus
如果已在 Windows 98 機器上安裝了 Norton AntiVirus，且有任何 WebSphere Development Tools 的組件（如 Debugger 或 Object Level Trace）無法運作，則請停用 Norton Antivirus 並重試。

其他的資訊來源

請探訪我們的「全球資訊網」網頁：

ibm.com/software/awdtools/wdt400/ 按一下「支援」，然後選取「Web 更新的支援下載」下的項目

您也可以使用「IBM 軟體」首頁中的鏈結來取得這些網頁：ibm.com/software/

Redpaper REDP0503 提供有關本產品的完整概觀。請跳至 Redbooks 網站，按一下左訊框的 Redpapers，然後按一下標題 "IBM WebSphere Development Tools for AS/400: An Introduction"。您會看到文件摘要。按一下「線上檢視」，即可讀取 PDF 版本的文件。

使用新聞群組，並張貼您的問題：

新聞伺服器：

news.software.ibm.com

建議的新聞群組：

ibm.software.code400

ibm.software.vajava

ibm.software.varpg

ibm.software.websphere.studio400

如何找到您的「授權合約」

本產品的「授權合約」檔案是在根產品目錄的子目錄 license 中。

注意事項

此資訊是為了提供於 U.S.A 的產品與服務所開發。IBM 不見得會在其他國家提供本文件中所提的各項產品、服務或功能。 要知道在您所在之區是否可用到這些產品與服務時， 請向當地的 IBM 服務代表查詢。本書在提及 IBM 的產品、程式或服務時， 不表示或暗示只能使用 IBM 的產品、程式或服務。只要未侵犯 IBM 的智慧財產權，任何功能相當的產品、程式或服務都可以取 代 IBM 的產品、程式或服務。不過，其它非 IBM 產品、程式、 或服務在運作上的評價與驗證，其責任屬於使用者。

在這本書或文件中可能包含著 IBM 所擁有之專利或專利申請案。本書使用者並不享有前述專利之任何授權。 您可以用書面方式來查詢授權，來函請寄到：

Director of Licensing
Intellectual Property & Licensing
International Business Machines Corporation
North Castle Drive, MD - NC119
Armonk, New York 10504-1785
U.S.A.

下列段落若與該國之法律條款抵觸，即視為不適用：IBM 僅以現狀提供本書，而不提供任何明示或默示之保證 (包括但不限於可售 性或符合特定效用的保證)。若有些地區在某些交易上並不允許排除上述保證， 則該排除無效。

本書中可能會有技術上或排版印刷上的訛誤。因此，IBM 會定期修訂； 並將修訂後的內容納入新版中。同時，IBM 得隨時改進並 (或) 變動本書中所提及的產品及 (或) 程式。

本資訊對於非 IBM 網站的援引只是為了方便而提供，並不對這些網站作任何認可。該些網站上的內容並非本 IBM 產品內容的一部份， 用戶使用該網站時應自行承擔風險。

本程式之獲授權者若希望取得相關資料， 以便使用下列資訊者可洽詢 IBM。 其下列資訊指的是：(1) 獨立建立的程式與其它程式 (包括此程式) 之間更換資訊的方式 (2) 相互使用已交換之資訊方法。 若有任何問題請聯絡：

IBM Canada Ltd.
Department 071
1150 Eglinton Avenue East
Toronto, Ontario M3C 1H7
Canada

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

本書所描述的授權程式及其所有可用的授權著作是由 IBM 所提供， 並受到「IBM 客戶合約」、「國際程式授權合約」或雙方之間任何同等合約條款之規範。

程式設計介面資訊

此文件說明由 IBM WebSphere Development Tools for iSeries 提供的通用程式設計介面與相關指引資訊。

商標與服務標記

下列術語是國際商業機器股份有限公司 (IBM) 在美國、其他國家或兩者的商標或註冊商標：
  • AIX
  • AIXwindows
  • AS/400
  • AS/400e
  • IBM
  • Integrated Language Environment
  • iSeries
  • Operating System/400
  • OS/400
  • RPG/400
  • VisualAge
  • WebSphere

InstallShield 是 InstallShield 公司的商標。

Intel 與 Pentium 是 Intel 公司的註冊商標。

Java 與所有以 Java 為基礎的商標，是 Sun Microsystems, Inc 在美國及／或其他國家的商標或註冊商標。

Netscape Navigator 是 Netscape Communications 公司的商標。

ActiveX、Microsoft、SourceSafe、Visual C++、Visual SourceSafe、Windows、Windows NT、Win32、 Win32s 與 Windows 標誌是 Microsoft 公司在美國、其他國家或兩者的商標或註冊商標。

其他公司、產品與服務程式名稱可能是其他公司的商標或服務標記。