IBM Developer Workbench 9.1.0.2 版 - 版本注意事項
目錄
1.0 關於本版次
2.0 安裝資訊
3.0 注意事項及商標
1.0 關於本版次
Developer Workbench 9.1.0.2 版包含 9.1 版的加強功能及修正程式。
返回目錄。
1.1 本版次的新增功能。
Developer Workbench 9.1.0.2 版提供下列新增功能：
- DB2 for z/OS 第 9 版的支援：
- 您可以在「資料庫瀏覽器」中建立 JDBC 與 DB2 for z/OS 第 9 版之間的連線。
- 您可以使用工作台來建立、測試及部署在資料開發專案中針對 DB2 for z/OS 第 9 版的下列常式類型：
- SQL 原生儲存程序，包括多個原生儲存程序版本
- SQL 外部儲存程序
- Java (JDBC 及 SQLJ) 儲存程序
- SQL 純量使用者定義的函數
- 您可以使用工作台來開發針對 DB2 for z/OS 第 9 版的 Java 儲存程序，視 JAR 檔中的類別而定，
而非在其中部署儲存程序的 JAR 檔。您可以將 JAR 檔匯入資料開發專案，以在本端編譯及包裝此類型的
Java 儲存程序。您也可以使用工作台來部署 JAR 檔，或捨棄資料庫伺服器中的 JAR 檔，以及從「資料
庫瀏覽器」檢視已部署 JAR 檔的內容。
- 您可以使用工作台中已整合的儲存程序除錯器，來除錯針對 DB2 for z/OS 第 9 版的儲存程序。
- OLE DB 及 XML UDF 的已翻譯文件及使用者介面文字。如需建立 OLE DB 或 XML UDF 之前必須先完成的部分必備步驟相關資訊，請參閱這些版本注意事項的文件更正一節。
- 支援副檔名為 .db2 且包含 SQL 陳述式及 Script 的檔案。除了副檔名為 .sql 及 .ddl 的檔案之外，您還可以編輯及匯入副檔名為 .db2 的 SQL 檔。
- 支援針對 SQLJ 儲存程序建立單一資料包。若要建立單一資料包，請在「部署常式」精靈的連結選項欄位中，指定隔離層次。
- 支援儲存具有錯誤的常式。當您在「常式編輯器」中儲存包含錯誤的常式時，可以看到一則訊息，顯示程式碼發生錯誤，但您還是可以儲存內含錯誤的程式碼，以保留您的作業結果。
返回目錄。
1.2 產品修正歷程
已修正 9.1 或 9.1.0.1 版的下列已知問題：
- 刪除專案之前，請先關閉屬於該專案的已開啟常式及 SQL 編輯器。若沒有關閉已開啟的常式及 SQL 編輯器，雖然還是會刪除專案及其內容，但會出現錯誤訊息。
- 如果您正在除錯呼叫第二個 Java 儲存程序的 Java 儲存程序，則無法除錯第二個儲存程序。您無法進入巢狀儲存程序，且系統會忽略設定在巢狀儲存程序中的所有岔斷點。此限制適用於 DB2 UDB for Linux, UNIX and Windows。
1.3 已知的限制及問題
此版本包含下列已知的限制及問題。
- 一般
-
- 若要在 Red Hat Enterprise Linux 3 上啟動 Developer Workbench，請將
export MOZILLA_FIVE_HOME=<location of mozilla> 新增至 /opt/IBM/DWB/V9.1/dwb_prod/shortcut_dwb。
- 若您定義包含 XML 資料但未包括主要索引鍵的表格，則在表格編輯器中更新 XML 直欄時會失敗。您必須將主要索引鍵或唯一索引新增至包含 XML 資料的表格。
- 只有與 DB2 for Linux, UNIX and Windows 第 9 版連線相關聯的資料開發專案，才支援在 XQuery 建置器中開發 XQuery。
- 在「資料庫瀏覽器」中建立聯合伺服器之後，新建的伺服器不會自動顯示在「已定義的伺服器」資料夾中。您必須重新整理資料夾，才能看到新的伺服器。
- 在 Linux 上，若您的系統使用 JDK 1.4.1 作為其預設 JDK，則結束 DWB 時，可能不會關閉 Developer Workbench 程序。若要避免此問題，請使用 DWB 提供的 JDK：
/opt/IBM/DWB/V9.1/dwb_prod/eclipse/jdk/bin。
- 常式開發
-
- 不支援將使用者定義的類型 (UDT) 作為常式的參數。
- 針對 DB2 for z/OS 資料庫的使用者定義的函數無法使用 Visual Explain。針對 z/OS 使用者定義的函數，工作台僅支援表示式，而不支援陳述式。
- 首次在資料開發專案中建立常式時，「新建儲存程序」精靈、「新建使用者定義的函數」精靈或常式編輯器可能無法使用 Visual Explain 選項。若要暫時解決此問題，請先關閉然後再重新開啟工作區，如此便會啟用 Visual Explain 選項。
- 使用 Ant 部署功能來部署儲存程序或使用者定義的函數時，若您的類別路徑中沒有 tools.jar 檔，則可能會出現下列訊息：
找不到 tools.jar。原預期可在 F:\jre\1.4.2\lib\tools.jar 中找到。忽略此訊息。tools.jar 是 Java Runtime Environment (JRE) 的一部分，而非 Ant 部署功能的一部分。
- 若要使用 Ant 部署，從檔案系統部署針對 DB2 UDB for iSeries 的 Java 儲存程序，您必須確定系統類別路徑中有 jt400.jar。
- 建立 Java 儲存程序並變更方法名稱時，在編輯器中按一下滑鼠右鍵然後按一下儲存的動作並不會作用。若要儲存更新的儲存程序，請按一下檔案 > 儲存。
- 如果試圖遵照 DeployInstructions.txt 中的指示來部署匯出的儲存程序，則可能會收到錯誤訊息，指出：
...[createsp] 無法連線至目標資料庫。[createsp]
com.ibm.db2.jcc.DB2Driver...若要暫時解決此問題，請確定您的系統類別路徑中有 db2jcc.jar 及適當的授權檔。
- 刪除資料開發專案之前，請先關閉屬於該專案的已開啟常式及 SQL 編輯器。若沒有關閉已開啟的常式及 SQL 編輯器，雖然還是會刪除專案及其內容，但會出現錯誤訊息。
- 部署或執行 Java 儲存程序時，可能會看到
無法載入類別錯誤。若 RAD 第 7 版與 DB2 伺服器之間的 JDK 版本不符，且 DB2 伺服器的 JDK為下一個層次，便會發生此錯誤。若要防止此錯誤，則應在針對使用 JDK 層次 1.4 的伺服器部署 Java 儲存程序時，在「部署常式」精靈的編譯選項欄位中，指定 "-source 1.4" 選項。(例如，DB2 Universal Database for Linux, UNIX, and Windows 第 8.2 版伺服器)。一般會使用適當的編譯選項 "-source JDK level " 來符合資料庫伺服器上的 JDK 層次。
- 如果您在不同的伺服器之間拖放儲存程序或 UDF (例如，從 DB2 UDB for Linux, UNIX, and Windows 伺服器拖放到 DB2 UDB for z/OS 伺服器)，則會在拖放作業期間，看到一則有關兩個伺服器之間存在某些不相容的警告訊息。如果您繼續執行該作業，然後嘗試開啟儲存程序或 UDF，則可能會看到錯誤。
- 如果 DB2 UDB for Linux, UNIX, and Windows 8.2 版伺服器缺少 JCC 驅動程式擷取錯誤訊息文字時所需的必備儲存程序 (SYSIBM.SQLCAMESSAGECCSID)，則針對該伺服器執行「SQL 側寫」時可能會發生空值指標異常狀況。若要暫時解決此問題，您可以建立與伺服器的連線，而不設定 retrieveMessagesFromServerOnGetMessage=true。
- 監視 SQL 程序的執行作業期間，系統會針對在程序中發出的 DML 陳述式 (例如，INSERT、SELECT、DELETE 及 UPDATE) 產生側寫事件。然而，不會以決定論形式為程序化陳述式產生事件，以指定變數及控制結構，例如 WHILE 或 IF。因此，不會為了這些程序化陳述式擷取調整資料。
- 儲存程序除錯器
-
- 連線至 UNIX DB2 伺服器之後，新增岔斷點或在除錯模式中執行時，會發生逾時異常狀況。
- 若儲存程序的名稱同時含有英文和中文字元，則無法針對該儲存程序執行除錯器。
- 僅動態 Java 儲存程序支援監視表示式。其不受 SQL 及 SQLJ 儲存程序支援。
- 若岔斷點不是位於可執行陳述式 (例如 SET) 的第一個記號上，則除錯器便不會在岔斷點上停止。此外，它也不會停在 DECLARE CONTINUE、CLOSE CURSOR 或 ROLLBACK 上。
- 如果您正在除錯 Java 儲存程序，且選取「終止」動作，則除錯階段作業可能需要花數分鐘的時間才能完全終止。在此時間期間啟動的新除錯階段作業可能不會正常運作。
- 如果您正在除錯從其他 SQL 或 Java 儲存程序呼叫的 Java 儲存程序，則跳回按鈕會失效。若要暫時解決此問題，您可以在呼叫中儲存程序的下一行上新增岔斷點，然後按一下回復，回到呼叫中的儲存程序。
- 當 Java 儲存程序呼叫其他儲存程序，然後您再回到 Java 儲存程序時，您可能會停在一些中間的 Java 程式碼中。若要暫時解決此問題，請使用跳回按鈕，回到 Java 儲存程序堆疊框。
- 除錯 Java 儲存程序時，若得到
等待封包時發生逾時錯誤，請嘗試增加 Java 逾時設定。若要增加 Java 逾時設定，請按一下工作台功能表列中的視窗 > 喜好設定。展開 Java 節點，再按一下除錯。在「除錯」喜好設定頁面上，增加通訊逾時區段中的除錯器逾時 (毫秒) 值。建議您至少增加到預設值的兩倍。
- 除錯 Java 儲存程序時，如果您使用變更值動作來修改具有空字串值的變數，則編輯對話中的確定按鈕可能會失效。若要啟用按鈕，請選取輸入評估圓鈕，將值設為非空白字串 (例如，'a')，然後選取輸入字面文字圓鈕。如此便可使用確定按鈕。
- 除錯 Java 儲存程序時，如果沒有看到區域變數，表示可能已經在未指定 -g 編譯器選項的情況下，部署了儲存程序。部署 Java 儲存程序時，請務必指定 -g 編譯器選項。
- 若在「變數」視圖中看到「堆疊框無效」的訊息，請跳至「除錯」視圖，按一下堆疊框上方的執行緒物件，然後按一下堆疊框。這應該會重新整理「變數」視圖，而且應該不會再出現錯誤。
- 對在 DB2 UDB for iSeries 5.4 版上執行的 SQLJ 儲存程序進行除錯時，正在執行的現行行不會對應於顯示在「除錯」視圖的已指出 SQLJ 來源行，除非您已套用 iSeries PTF，其會更新 linemap 以對應至 SQLJ 來源而非 Java 原始程式。
- 未辨識階段作業管理程式逾時的除錯器喜好設定。這些喜好設定設成如下：按一下視窗 > 喜好設定，展開執行/除錯節點，再按一下 DB2 儲存程序除錯器。修改階段作業管理程式逾時 (分鐘) 欄位。
- 除錯器無法處理在 DB2 for Linux, UNIX, and Windows 上有大量變數的儲存程序。變數的數量上限為 200。
- 在除錯階段作業中移動游標：在某些情況下，當程序中有多個變數宣告，您必須按好幾次進入副程序或跳過副程序，來移動到下一行。
例如，您必須連按兩下這一行：DECLARE v_dept、v_actdept CHAR(3)；以及按三下這一行：DECLARE v_bonus、v_deptbonus、v_newbonus DECIMAL(9,2)；您按的次數必須等於變數宣告的數量。
- 如果您針對 Java 儲存程序啟動除錯階段作業，並加入岔斷點，然後再停用岔斷點，岔斷點仍為啟用狀態。若要暫時解決此問題，啟動新的除錯階段作業時，應先移除所有的舊岔斷點，然後再加入新的岔斷點。
- 在某些情況下，使用多個資料開發專案時，在試圖除錯儲存程序時可能會看到一則訊息，指出「找不到儲存程序 PROCNAME。程序可能已從工作區中刪除」或「找不到來源」。
- 若在終止 Java 儲存程序的除錯階段作業之後，立刻除錯 SQL 儲存程序，除錯器可能會顯示「使用者定義的函數 ... 已被使用者岔斷」。若要暫時解決此問題，請重試除錯 SQL 儲存程序。
1.4 文件更正
- 在「針對常式使用 Visual Explain」主題中，有一個關於 Visual Explain 支援哪些伺服器的說明是不正確的。下列作業系統及伺服器可支援 Visual Explain：
-
Visual Explain 可在 Windows(R) 平台上使用。支援下列伺服器：
- DB2 UDB for Linux, UNIX, and Windows 8.2 版
- DB2 for Linux, UNIX, and Windows 第 9 版
- DB2 UDB for z/OS 第 7 版及第 8 版
- 需要具備下列必備項目，才能用 Developer Workbench 建立 OLE DB UDF：
-
- DB2 UDB for Linux, UNIX, and Windows 第 8 版本或更新版本。
- OLE DB 2.0 或更新版本，可從 Microsoft 網站中取得，網址為：http://www.microsoft.com。若試圖在未安裝 OLE DB 的情況下呼叫 OLE DB 表格函數，DB2(R) 便會發出 SQLCODE -465、SQLSTATE 58032，原因碼 35。如需系統需求以及可供資料來源使用之 OLE DB Provider 的相關資訊，請參閱資料來源文件。如需 OLE DB 規格，請參閱 Microsoft OLE DB 2.0 Programmer's Reference and Data Access SDK, Microsoft Press, 1998。
- db2olefn.dll 必須登錄到您的電腦上。若要登錄此 DLL 檔，請在指令行上輸入 regsvr32 DB2installdir\sqllib\function\db2olefn.dll，其中 DB2installdir 是安裝 DB2 的根目錄。
- 需要具備下列必備項目，才能用 Developer Workbench 建立 XML UDF：
-
- DB2 UDB for Linux, UNIX, and Windows 第 8 版本或更新版本。
- 若要在處理之前先在 XML 文件上執行 XSL 轉換，則必須為 DB2 XML Extender 啟用您的目標資料庫。
啟用 DB2 XML Extender 時，便可在目標資料庫上使用資料庫引擎所提供的 XSLTransform UDF，以執行 XSL 轉換。若為本端資料庫，則會自動啟用 DB2 XML Extender。若要為 XML Extender 啟用遠端資料庫，請在指令行上，從
DB2installdir\sqllib\bin 目錄輸入 dxxadm enable_db sample，其中 sample 是目標資料庫，而 DB2installdir 是您安裝 DB2 的目錄。
- 在「資料庫瀏覽器」中離線作業時，無法使用下列動作。「資料庫瀏覽器的離線作業限制」主題中遺漏了此訊息：
- 設定 before 及 after 執行 SQL 陳述式，以及透過執行設定功能表動作，設定 input 或 inout 參數。
- 針對現行伺服器除錯儲存程序。
返回目錄。
2.0 安裝資訊
2.1 軟硬體需求
硬體需求
- 磁碟空間：50 MB
- 記憶體：512 MB (建議 1 GB)
軟體需求
-
- Microsoft Windows 2000 Server 與 Professional、Microsoft Windows 2003
Server 及 Microsoft XP Professional
- Red Hat Enterprise Linux 3 及 SUSE Linux Enterprise Server 9
返回目錄。
本節說明如何使用「Developer Workbench 產品更新程式」來安裝 IBM Developer Workbench 9.1.0.2 版。提供此修正套件作為更新程式。您可以直接從 IBM 更新伺服器下載此修正套件。然而，您也可以下載內含此修正套件的 ZIP 檔，以進行本端安裝。下列各節說明安裝此修正套件的方法。
- 如果您已透過「更新管理程式」，利用按一下說明 > 軟體更新 > 管理配置的方式，或者修改 feature.xml 檔的方式，停用所有產品功能，則必須先重新啟用已停用的功能，才能安裝此修正套件。
使用安裝 IBM Developer Workbench 的相同使用者帳戶來安裝修正套件。
限制：
- 安裝此修正套件時，無法開啟 IBM Developer Workbench。
- 在 Windows(R) 作業系統上，您必須使用具有「管理者」專用權的帳戶。在 Linux(R) 作業系統上，則必須使用 root 使用者帳戶。
若要安裝修正套件，請完成下列步驟：
- 啟動「Developer Workbench 產品更新程式」：
- 在 Windows 作業系統上，按一下開始 > 程式集 > IBM DB2 Developer Workbench > DWB 產品更新程式。
- 在 Red Hat Enterprise Linux 3.0 (GNOME 桌面環境) 上，開啟主功能表，然後按一下程式設計 > DWB 產品更新程式。
- 在 SuSE Linux Enterprise Server 9.0 (K 桌面環境) 上，開啟主功能表，然後按一下 IBM DB2 Developer Workbench > DWB 產品更新程式。
附註：在 Red Hat Enterprise Linux 3.0 及 SuSE Linux Enterprise Server 9.0 上，如果您使用預設之外的桌面環境，則產品捷徑可能不會出現在預設位置。
- 按一下尋找更新資料。
- 根據預設值，會選取所有可用的更新資料。請務必選取 IBM Developer Workbench 9.1.0.2 版。
要訣：若要檢視此更新的說明，請按一下該更新。說明會顯示在「詳細資訊」窗格中。
- 按一下安裝更新資料。
- 若要接受授權合約並繼續安裝，請按一下確定。
視電腦處理器的速度、RAM 的數量以及網際網路的連線速度而定，更新程式可能需要一段時間來下載與安裝。
安裝完成之後，「Developer Workbench 產品更新程式」會在「已安裝的產品」頁面上列示已安裝的更新項目。
- 關閉「Developer Workbench 產品更新程式」。
- 使用
-clean 選項重新啟動 Developer Workbench，讓變更生效。例如：eclipse -clean。
您可以直接從 IBM 更新伺服器安裝此修正套件；然而，它也可供下載。在下列情況下，您可能會想要下載並安裝修正套件：
- 網際網路的連線速度很慢或不穩定，且想要使用可回復下載的下載管理程式。
- 無法順利透過防火牆存取現存的 IBM 更新伺服器。
- 希望先下載修正套件，再於稍後進行安裝。
若要下載及安裝修正套件，請完成下列步驟：
- 從 ftp://ftp.software.ibm.com/software/data/db2/udb/developerworkbench/91/zips/dwb_9102.zip 下載修正套件。
- 將修正套件解壓縮到暫時目錄，例如 C:\temp。
- 如需安裝指示，請導覽至 C:\temp\dwbfp2\，然後開啟 install_local_9102.html。
如需產品新訊、事件、支援及其他資訊，請參閱 DB2 首頁，網址為：http://www-306.ibm.com/software/data/db2/9/。
3.0 注意事項及商標
3.1 注意事項
本資訊是針對 IBM 在美國所提供之產品與服務開發出來的，而在其他國家中，
IBM 不見得有提供本書中所提的各項產品、服務、或功能。要知道在您所在之區是否可用到這些產品與服務時，
請向當地的 IBM 服務代表查詢。本書在提及 IBM 的產品、程式或服務時，不表示或暗示只能使用 IBM 的產品、程式
或服務。只要未侵犯 IBM 的智慧財產權，任何功能相當的產品、程式或服務都可以取代 IBM 的產品、程式或服務。不過，其他非 IBM 產品、程式、或服務在運作上的評價與驗證，其責任屬於使用者。
在這本書或文件中可能包含著 IBM 所擁有之專利或專利申請案。本書使用者並不享有前述專利之任何授權。您可以用書面方式來查詢授權，來函請寄到：
IBM Director of Licensing IBM Corporation 500 Columbus Avenue Thornwood, NY 10594
U.S.A.
下列段落若與該國之法律條款抵觸，即視為不適用：
IBM 僅以現狀提供本書，而不提供任何明示或默示之保證 (包括但不限於可售
性或符合特定效用的保證)。若有些地區在某些交易上並不允許排除上述保證，則該排除無效。
本資訊中可能會有技術上或排版印刷上的訛誤。因此，IBM 會定期修訂；
並將修訂後的內容納入新版中。同時，IBM 得隨時改進並 (或) 變動本書中所提及的產品及 (或) 程式。
本出版品中任何對非 IBM 網站的敘述僅供參考，IBM 對該網站並不提供保證。該 Web 站上的資料，並非本 IBM 產品所用資料的一部分，因使用該 Web 站造成之損害，由 貴客戶自行負責。
本程式之獲授權者若希望取得相關資料，以便使用下列資訊者可洽詢 IBM。其下列資訊指的是： (1) 獨立建立的程式與其他程式 (包括此程式) 之間更換資訊的
方式 (2) 相互使用已交換之資訊方法若有任何問題請聯絡：
IBM Corporation
J46A/G4
555 Bailey Avenue
San Jose, CA 95141-1003
U.S.A.
上述資料之取得有其特殊要件，在某些情況下必須付費方得使用。
IBM 基於雙方之「IBM 客戶合約」、「IBM 國際程式授權合約」或任何同等合約之條款，提供本書中所說的授權程式與其所有適用的授權資料。
本書所提及之非 IBM 產品資訊，係一由產品的供應商，或其出版的聲明或其他公開管道取得。IBM 並未測試過這些產品，也無法確認這些非 IBM 產品的執行效能、
相容性、或任何對產品的其他主張是否完全無誤。如果您對非 IBM 產品的性能有任何的疑問，
請逕向該產品的供應商查詢。
有關 IBM 未來動向的任何陳述，
僅代表 IBM 的目標而已，並可能於未事先聲明的情況下有所變動或撤回。
此資訊包含日常企業運作所使用的資料和報告的範例。
為求儘可能地完整說明，範例包括了個人、公司、品牌和產品的名稱。
這些名稱全為虛構，如有雷同，純屬巧合。
3.2 商標
IBM、Derby、Rational、DB2 Universal Database 及 zSeries 是 IBM 公司在美國及 (或) 其他國家的商標或註冊商標。
Java 及所有與 Java 有關的商標是 Sun Microsystems, Inc. 在美國及 (或) 其他國家的商標。
Linux 是 Linus Torvalds 在美國及 (或) 其他國家的著作權。
Microsoft、Windows 2000、Windows 2003 及 Windows XP 是 Microsoft Corporation 在美國及 (或) 其他國家的商標。
其他公司、產品或服務名稱可能為其他公司的商標或服務標誌。
返回目錄。