© Copyright International Business Machines Corporation 2000, 2007. All rights reserved.US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
1.0 關於這個版本
2.0 安裝資訊
2.1 硬體需求
2.2 軟體需求
2.3 其他需求
2.4 安裝指示
2.4.1 將 WebSphere Development Studio Client .0.0.1 版當成一項更新來安裝
2.4.2 下載本端安裝的修正套件
2.5 解除安裝修正套件
3.0 這個版本的修正程式
4.0 已知的限制、問題和暫行解決方法
4.1 資料工具文件內含不受支援功能的參照
4.2 當在 WebSphere Application Server 上呼叫 Axis Web 服務時，發生內部伺服器錯誤「SAXException: 檔案倉促結束」
4.3 在 Linux 作業系統上，J2C 的「相同輸入及輸出」範例鏈結無法運作
4.4 啟用網站導覽的靜態 Web 專案轉換成動態 Web 專案失敗，發生異常狀況
4.5 發佈含有多個來源目錄的 EJB 失敗，發生錯誤
4.6 在 Installation Manager 1.0.0.2 版中，不支援回復特性
5.0 IBM WebSphere 軟體支援中心
6.0 注意事項和商標
此修正套件包含 IBM® WebSphere® Development Studio Client for iSeries 7.0 版的修正程式。
當您的電腦上已安裝 IBM WebSphere Development Studio Client for iSeries 7.0 時， 此修正套件可以當成一項更新來安裝，也可以在您安裝 IBM WebSphere Development Studio Client for iSeries 7.0 版時同時安裝。
如果要檢視這個 Readme 檔的最新版本，請造訪： http://download.boulder.ibm.com/ibmdl/pub/software/awdtools/wdsc/v7/7001/documents/readme/readme.html
另外，也請參閱這個產品 7.0 版的版本注意事項，以瞭解它的新特性以及發行時已知的任何限制或問題。 7.0 版的版本注意事項位於： http://download.boulder.ibm.com/ibmdl/pub/software/awdtools/wdsc/v7/70/documents/readme/readme.html
這一節說明這個修正套件的安裝需求及特定安裝指示。
如需 WebSphere Development Studio Client for iSeries 7.0 版的安裝資訊， 包括安裝必備項目，請參閱線上安裝手冊，位置如下： http://download.boulder.ibm.com/ibmdl/pub/software/awdtools/wdsc/v7/70/documents/install_instruction/install.html。
安裝這個修正套件沒有其他處理器或記憶體需求；不過，可能會有額外的磁碟空間需求，這取決於您是同時安裝 WebSphere Development Studio Client 7.0 版和這個修正套件， 或您是將這個修正套件當作一項更新來安裝：
（選用）如果您選擇將這項更新下載成本端安裝的壓縮檔，需要大約 335 MB 來儲存和擷取壓縮檔。
這一節說明安裝 WebSphere Development Studio Client for iSeries 7.0.0.1 版的其他軟體需求；如果要查看 WebSphere Development Studio Client 7.0 的安裝需求，請參閱安裝手冊。
必須先安裝 IBM Installation Manager 1.0.0.2 版，才能安裝此修正套件。 在 Installation Manager 中，如果沒有將安裝和更新期間搜尋連結的儲存庫的這項預設行為停用， 當您試圖以舊版的 Installation Manager 來更新或安裝套件時，IBM Installation Manager 1.0.0.2 版會自動安裝在電腦上。
如需 Installation Manager 1.0.0.2 版的相關資訊，請參閱 http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/v7/im/1002/docs/readme/readme.html
通常都需要能夠存取網際網路，因為 Installation Manager 預設會直接從 WebSphere Development Studio Client 7.0 版的 IBM 更新儲存庫中尋找和安裝這項更新。
重要事項：安裝 WebSphere Development Studio Client 時，它的更新儲存庫的位置會自動內嵌在 Installation Manager 中。 如果要讓 Installation Manager 搜尋預設更新儲存庫，您必須在「儲存庫」喜好設定頁面中，選取在安裝和更新期間，搜尋鏈結的儲存庫這項喜好設定。 依預設，會選取這項喜好設定。
如果要從另一個儲存庫位置安裝這個修正套件（例如，修正套件在共用磁碟機、HTTP 或 HTTPS 伺服器上），您必須在 Installation Manager 中新增儲存庫位置。 如果要新增儲存庫位置，請執行下列動作：
下列是安裝此更新項目常見的兩種方式：
更新項目預設是直接從 IBM 更新儲存庫中安裝；但也可以透過下載來安裝。如需詳細資料，請參閱下列 WebSphere Development Studio Client 7.0.0.1 版的特定安裝指示。
2.4.1 將 WebSphere Development Studio Client 7.0.0.1 版當成一項更新來安裝
請利用安裝產品的相同使用者帳戶來安裝修正套件。
限制：
如果要尋找 WebSphere Development Studio Client 7.0.0.1 版並當成一項更新來安裝，請執行下列動作：
您可以下載含有 WebSphere Development Studio Client 7001 版修正套件的壓縮檔；從壓縮檔中擷取出來的檔案會形成修正套件的儲存庫。 您可以從自己電腦上的儲存庫安裝這個修正套件，也可以將儲存庫複製到共用磁碟機、HTTP 或 HTTPS 伺服器中。
如果要下載和安裝這個修正套件，請完成下列步驟：
附註：
從本端儲存庫更新的過程中，Installation Manager 可能會提示您輸入 WebSphere Development Studio Client 7.0 版的儲存庫位置。
如果您是從光碟或其他媒體安裝產品，使用更新特性前，必須將它們備妥。
雖然文件提到了「解除安裝套件」精靈中的回復特性，但 Installation Manager 1.0.0.2 版並未啟用這項特性。 因此，如果您安裝了 WebSphere Development Studio Client 7.0 版，又將它更新至 7.0.0.1 版，便無法利用「解除安裝套件」精靈，將它回復到 7.0 版。
如果要回復到 WebSphere Development Studio Client 7.0 版，您必須解除安裝整個套件。 單一解除安裝程序會移除 7.0 版套件和升級的 7.0.0.1 版套件。 解除安裝之後，您可以重新安裝 7.0 版套件。
在解除安裝 WebSphere Development Studio Client 7.0.0.1 版之前，請執行下列步驟：
如果要解除安裝 WebSphere Development Studio Client 7.0.0.1 版，請執行下列動作：
如需 WebSphere Development Studio Client 的其他解除安裝指示，請參閱安裝手冊，或參閱 Installation Manager 線上說明。
這個版本修正了下列 APAR：
關於所有 WebSphere Development Studio Client APAR，請參閱：http://www-1.ibm.com/support/search.wss?rs=3239&lang=en&loc=en_US&r=10&cs=utf-8&rankfile=0&cc=&spc=&stc=&apar=include&q1=5722WDS03+OR+5722WDS04+OR+5722WDS05+OR+5722WDS05+OR+5722WDS06+OR+5722WDS07+OR+5722WDS08+OR+5722WDS09&q2=7.0.0.1&Go.x=0&Go.y=0&sort=desc&tc=SSZND2&dc=DB550+D100&dtm
這個版本已修正了 7.0 版版本注意事項所列出的下列已知限制或問題：
如需這個版本最新的修正程式清單，請參閱此 Readme 檔的更新版本： http://download.boulder.ibm.com/ibmdl/pub/software/awdtools/wdsc/v7/7001/documents/readme/readme.html。
關於 WebSphere Development Studio Client for iSeries 7.0 版的更新項目、限制和已知的問題，IBM 支援中心網站提供了 TechNotes 形式的說明文件，網址如下： http://www.ibm.com/software/awdtools/wdt400/support。
當發現和解決限制和問題時，「IBM 軟體支援中心」團隊會更新知識庫。 透過搜尋知識庫，您可以快速對遭遇到的問題找到暫行解決方法或解決方案。WebSphere Development Studio Client for iSeries 網站 Self Help 區段中的 Technotes 鏈結會啟動即時「支援中心」知識庫的自訂查詢。 如果要縮小搜尋範圍，請在搜尋詞彙中指定 V7。 如果要建立您自己的查詢，請移至「IBM 軟體支援中心」網站的 Advanced search 頁面。
4.1 資料工具文件內含不受支援功能的參照
在資訊中心的「開發資料存取應用程式」區段中，稱為「常式和 JAR 檔部署」的主題，不正確地參照了支援部署 Java™ 儲存程序之 JAR 檔的功能。
JAR 檔部署不受支援，應該忽略這項參照。 這個主題的其餘資訊正確。4.2 當在 WebSphere Application Server 上呼叫 Axis Web 服務時，發生內部伺服器錯誤「SAXException: 檔案倉促結束」
當呼叫「Web 服務精靈」在 WebSphere Application Server 伺服器上所建立的 Axis Web 服務時，可能會出現「(500) 內部伺服器錯誤」，伺服器主控台會有下列訊息：
org.apache.axis.InternalException: org.apache.axis.ConfigurationException: org.xml.sax.SAXException: 嚴重錯誤：URI=null Line=-1: 檔案倉促結束。
發生這個錯誤是因為 Web 專案 WebContent/WEB-INF 目錄中的 server-config.wsdd 檔是空的。
暫行解決方法：在 WebSphere Application Server 上建立 Axis Web 服務之前，請先選擇一個非預設位置來作為 Web 專案的 Java 輸出目錄。
如果要變更 Java 輸出目錄，請執行下列動作：
- 在「專案瀏覽器」視圖中，用滑鼠右鍵按一下 Web 專案，選取「內容」。
- 在「內容」視窗的左窗格中，按一下 Java 建置路徑。
- 按一下原始檔標籤。
- 在「建置路徑來源資料夾」頁面中，選取容許輸出資料夾作為來源資料夾勾選框，然後將預設輸出資料夾項目改成不是 WebProject/WebContent/WEB-INF/classes，其中 WebProject 是 Web 專案的名稱。 例如，將輸出資料夾改成 WebProject/output/classes。
4.3 在 Linux 作業系統上，J2C 的「相同輸入及輸出」範例鏈結無法運作
有一項錯誤只有在 Linux 作業系統上執行應用程式時，才會發生。 當您開啟說明 > 範例展示區 > 技術範例 > J2C Java Bean 技術範例 > 相同輸入及輸出範例，且按一下「匯入範例」(WAS 6.0) 鏈結時，會出現錯誤。 這時並不會開啟匯入精靈，主控台會出現「空值指標異常狀況」訊息：
GalleryWizardAction 發生異常狀況：java.lang.NullPointerException
wizard = com.ibm.etools.project.interchange.generic.CustomProjectInterchangeImportWizard
java.lang.NullPointerException
at com.ibm.etools.project.interchange.generic.CustomProjectInterchangeIm portWizard$1.getAllProjectMap(Unknown Source)
at com.ibm.etools.project.interchange.generic.CustomProjectInterchangeIm portWizard$1.doAddPages(Unknown Source)
at com.ibm.etools.emf.workbench.ui.wizard.datamodel.WTPWizard.addPages(U nknown Source)
at org.eclipse.jface.wizard.WizardDialog.createContents(Unknown Source)
at org.eclipse.jface.window.Window.create(Unknown Source)
at org.eclipse.jface.dialogs.Dialog.create(Unknown Source)
at com.ibm.samplegallery.GalleryWizardAction$RunnableWizardDelegate.run( Unknown Source)
at org.eclipse.swt.widgets.RunnableLock.run(Unknown Source)
at org.eclipse.swt.widgets.Synchronizer.runAsyncMessages(Unknown Source)
at org.eclipse.swt.widgets.Display.runAsyncMessages(Unknown Source)
at org.eclipse.swt.widgets.Display.readAndDispatch(Unknown Source)
at org.eclipse.ui.internal.Workbench.runEventLoop(Unknown Source)
at org.eclipse.ui.internal.Workbench.runUI(Unknown Source)
at org.eclipse.ui.internal.Workbench.createAndRunWorkbench(Unknown Sourc e)
at org.eclipse.ui.PlatformUI.createAndRunWorkbench(Unknown Source)
at org.eclipse.ui.internal.ide.IDEApplication.run(Unknown Source)
at org.eclipse.core.internal.runtime.PlatformActivator$1.run(Unknown Sou rce)
at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.runAppli cation(Unknown Source)
at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.start(Un known Source)
at org.eclipse.core.runtime.adaptor.EclipseStarter.run(Unknown Source)
at org.eclipse.core.runtime.adaptor.EclipseStarter.run(Unknown Source)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)
at java.lang.reflect.Method.invoke(Unknown Source)
at org.eclipse.core.launcher.Main.invokeFramework(Unknown Source)
at org.eclipse.core.launcher.Main.basicRun(Unknown Source)
at org.eclipse.core.launcher.Main.run(Unknown Source)
at org.eclipse.core.launcher.Main.main(Unknown Source)暫行解決方法： 請選取「匯入範例」(WAS 6.1) 鏈結，它會在 WebSphere Application Server 6.0 或 6.1 上運作。
4.4 啟用網站導覽的靜態 Web 專案轉換成動態 Web 專案失敗，發生異常狀況
當您試圖將啟用網站導覽的靜態 Web 專案轉換成動態 Web 專案（在「專案瀏覽器」視圖中選取專案，然後從「專案」功能表中選取轉換成動態 Web 專案）時，轉換會失敗， 且會出現下列異常狀況：「無法移除 org.eclipse.wst.common.modulecore.ModuleCoreNature 本質，因為它是 com.ibm.etools.siteedit.WebSiteNature 本質的必備項目」。
原因：將靜態 Web 專案（啟用網站導覽）轉換成動態 Web 專案的內部程序需要移除有相依本質 (WebSiteNature) 的專案本質 (ModuleCoreNature)。
暫行解決方法：如果要順利轉換專案，請先利用下列步驟來編輯靜態 Web 專案的 .project 檔：現在，您可以將專案順利轉換成動態 Web 專案。
- 按一下視窗 > 開啟視景 > 其他 > 資源。這時會開啟「資源」視景。
- 在「導覽器」視圖中，展開專案資料夾，開啟專案的 .project 檔。依預設，這時會開啟 XML 編輯器。
- 在「設計」視圖中，展開 projectDescription 節點，再展開本質節點。
- 選取 com.ibm.etools.siteedit.WebSiteNature 本質，然後按一下滑鼠右鍵來選取移除。 這時會從本質節點中刪除 com.ibm.etools.siteedit.WebSiteNature。
- 儲存 .project 檔。
4.5 發佈含有多個來源目錄的 EJB 失敗，發生錯誤
如果您試圖發佈包含多個來源資料夾的 EJB 專案（例如，有替代來源資料夾的註解專案）發佈會失敗，會出現錯誤。
「主控台」視圖可能會出現類似下列範例的錯誤：
[1/11/07 15:28:36:906 PST] 00000027 SystemErr R
*** ERROR ***: Thu Jan 11 15:28:36 PST 2007 org.eclipse.jst.j2ee.commonarchivecore.internal.exception.OpenFailureException: IWAE0023E 無法在 EAR 檔 "C:\v7001workspaces\7001Week2\AuctionV60EAR" 中開啟模組檔 "AuctionV60EJB.jar"
巢狀異常的堆疊追蹤：
org.eclipse.jst.j2ee.commonarchivecore.internal.exception.OpenFailureException: IWAE0006E 保存檔不是有效的 EJB JAR 檔，因為找不到部署描述子（區分大小寫）：META-INF/ejb-jar.xml暫行解決方法： 請利用下列步驟來編輯 looseconfig.xmi 檔（產生的檔案）：
如果伺服器仍在執行中，請重新啟動伺服器，使變更生效。
- 在您的電腦上，導覽至工作區目錄，在編輯器中開啟 /.metadata/.plugins/com.ibm.etools.wrd.websphere/looseconfigurations/EAR project name/looseconfig.xmi 檔，其中 EAR project name 是您的 EAR 專案的名稱。
- 將 binariesPath 和 resourcesPath 這兩個路徑屬性改成參照 EJB jar 檔的 "ejbModule"，而不是 "gen/src"。
- 儲存變更。
現在，您應該能夠順利發佈 EJB。
4.6 在 Installation Manager 1.0.0.2 版中，未啟用回復特性
在 Installation Manager 1.0.0.2 版中，並未啟用「解除安裝套件」精靈的回復特性和無聲自動安裝的 rollback 指令。 因此，您無法回復至先前安裝的套件版本。
比方說，如果您安裝了 WebSphere Development Studio Client 7.0 版，又將它更新至 7.0.0.1 版，便無法利用這個精靈或指令，將它回復到 7.0 版。
暫行解決方法：如果要回復到較早的套件版本，您必須解除安裝整個套件。 單一解除安裝程序會移除 7.0 版套件和升級的 7.0.0.1 版套件。 解除安裝之後，您必須重新安裝 7.0 版套件。
IBM WebSphere 軟體支援中心提供您技術協助。
關於在需要支援時所需的聯絡資訊和準則或參考資料，請閱讀 IBM 軟體支援手冊。
關於常見問題、已知的問題和修正程式清單，以及其他支援資訊，請造訪 IBM WebSphere 軟體支援中心網站。
關於 WebSphere 軟體產品新聞、事件和其他資訊，請造訪 IBM WebSphere 軟體網站。
在聯絡「IBM WebSphere 軟體支援中心」之前，請先收集說明問題所需要的背景資訊。 向 IBM 軟體支援中心專家描述問題時，請務必明確且提供所有相關的背景資訊，讓專家能夠有效地解決問題。 為了節省時間，請先回答下列問題：
- 問題發生時，您正在執行什麼軟體版本？
- 問題是否有相關的日誌、追蹤資料或訊息？
- 您能夠讓問題重現嗎？如果可以，需要執行什麼步驟？
- 問題有暫行解決方法嗎？如果有的話，請準備描述暫行解決方法。
在新聞群組公佈問題
若要在新聞群組上公佈您的問題，請使用下列資源：
新聞伺服器：
建議的新聞群組：
- ibm.software.websphere.studio400
其他建議的討論區：
© Copyright IBM Corporation 2007. All Rights Reserved.
這項資訊是專為了在美國提供的產品和服務而開發的，在其他國家，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 本產品的資料內容，如果要使用這些網站的資料，您必須自行承擔風險。
如果本程式的獲授權人為了 (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 Corporation 在美國及/或其他國家或地區的商標：
- ClearCase
- IBM
- i5/OS
- iSeries
- Rational
- System i
- WebSphere
Java 和所有以 Java 為基礎的商標是 Sun Microsystems, Inc. 在美國及/或其他國家或地區的商標。
Microsoft 和 Windows 是 Microsoft Corporation 在美國及/或其他國家或地區的商標。
UNIX 是 The Open Group 在美國及其他國家或地區的註冊商標。
Linux 是 Linus Torvalds 在美國及/或其他國家或地區的註冊商標。
其他公司、產品或服務名稱可能是第三者的商標或服務標記。