IBM WebSphere Development Studio Client für iSeries, Version 6.0.1, Migrationshandbuch
iSeries: Migration vorbereiten
Diese Informationen beschreiben, wie Sie Ihre Projekte von früheren
Versionen von IBM WebSphere Development
Studio Client für iSeries nach WebSphere Development Studio Client für iSeries Version 6.0.1 und WebSphere Development Studio Client Advanced Edition für iSeries Version 6.0.1 migrieren. Das Produkt
unterstützt die Migration von Versionen 5.1 und 5.1.2. Dieses Handbuch stellt auch
Tipps zur Migration von älteren Versionen zur Verfügung.
Die Migration ist sehr oft aufgrund einer Änderung in der zugrunde liegenden Technologie
von einem Release zu einem anderen Release erforderlich. Beispielsweise können neue Standards
in der Webanwendungsverzeichnisstruktur die Reorganisation Ihrer Projekte von einem Release
zu einem anderen Release erfordern.
Im Allgemeinen ist die Migration nahtlos und transparent. Sie müssen nur Ihren
vorhandenen Arbeitsbereich verwenden und die Arbeit mit Ihren Projekten mit der neuen
Version oder der neuen Stufe des Produkts fortsetzen. In seltenen Fällen ist die Migration
nach der Anwendung eines Service-Packs erforderlich.
In einigen Sonderfällen, die sich auf Java-Tools, Webtools und die Anpassung
von WebFacing-Projekten beziehen, müssen Sie unter Umständen ein Migrationstool
verwenden oder einige zusätzliche manuelle Schritte ausführen.
In allen Fällen werden Sie in einer Nachricht informiert, wenn eine
Migration erforderlich ist.
Die neueste Version dieses Dokuments ist im Web
verfügbar (ftp://ftp.software.ibm.com/as400/products/ad/wdt400/v601/migr/migrenu.html).
Die Readme-Datei enthält
Informationen zu Vorbedingungen, zu Einschränkungen des Produkts und Informationen, die in
der Dokumentation nicht enthalten sind. Informationen zur Installation von WebSphere Development
Studio Client für iSeries befinden sich im Installationshandbuch.
Mehrere Produktversionen verwalten
Der Installationsprozess deinstalliert nicht automatisch Version 5.0, 5.1 oder
5.1.2, sondern erlaubt stattdessen die Koexistenz der beiden Versionen auf einem einzelnen System.
Es wird empfohlen, vor der Deinstallation von Development Studio
Client für iSeries
Version 5.0, 5.1 oder 5.1.2 die Position Ihres Arbeitsbereichs der Version 5 zu
notieren und eine Sicherungskopie des Arbeitsbereichs zu erstellen. Wenn Sie Ihren
Arbeitsbereich nicht sichern, verlieren Sie möglicherweise Ihre Projekte der
Version 5. (Standardmäßig werden diese Projekte nicht deinstalliert oder gelöscht.)
Ab Version 6.0.1 wird in einigen Instanzen, wie beispielsweise WebFacing,
die Migration von Projekten der Versionen 4.0 und 5.0 aufgrund von zusätzlichen
Funktionen, die Development Studio Client hinzugefügt wurden, nicht
unterstützt. Ausführliche Informationen befinden sich in WebFacing-Projekte migrieren.
Arbeitsbereich lokalisieren
Arbeitsbereich in Version 5.1.2 lokalisieren
Gehen Sie wie folgt vor, um die Position Ihres Arbeitsbereichs der
Version 5.1.2 zu bestimmen:
- Haben Sie beim Installieren von Version 5.1.2 die Standardposition
akzeptiert, befindet sich Ihr Arbeitsbereich im Verzeichnis X:\Dokumente &
Einstellungen\Ihre Benutzer-ID\Eigene Dokumente\IBM\wdsc\workspace; dabei ist X das Laufwerk, auf dem sich Ihr Windows-Installationsverzeichnis befindet.
- Befindet sich Ihr Arbeitsbereich nicht an der Standardposition, suchen Sie
nach einem Verzeichnis mit dem Namen .metadata. Jedes
Verzeichnis workspace enthält ein Verzeichnis metadata; das Verzeichnis, in dem
.metadata erscheint, ist in der Regel Ihr Arbeitsbereich.
- Gehen Sie wie folgt vor, um die Position einer einzelnen Ressource zu
lokalisieren, wie beispielsweise ein Projekt (in diesem Handbuch finden Sie
weitere Informationen zur Migration verschiedener Typen von Projekten):
- Wechseln Sie in der Workbench der Version 5.1.2 zur Sicht "Navigator":
Klicken Sie Fenster > Sicht anzeigen > Andere an. Erweitern Sie Basis und wählen Sie Navigator aus. Klicken Sie OK an.
- Klicken Sie mit der rechten Maustaste den Namen der Ressource an und wählen
Sie Merkmale aus.
- Klicken Sie im linken Teilfenster Info an.
Die Position der Ressource wird im rechten Teilfenster angezeigt.
Arbeitsbereich in Version 5.1 lokalisieren
Gehen Sie wie folgt vor, um die Position Ihres Arbeitsbereichs der
Version 5.1 zu bestimmen:
- Haben Sie beim Installieren von Version 5.1 die Standardposition
akzeptiert, befindet sich Ihr Arbeitsbereich im Verzeichnis X:\Dokumente &
Einstellungen\Ihre Benutzer-ID\Eigene Dokumente\IBM\wdsc\workspace; dabei ist X das Laufwerk, auf dem sich Ihr Windows-Installationsverzeichnis befindet.
- Befindet sich Ihr Arbeitsbereich nicht an der Standardposition, suchen Sie
nach einem Verzeichnis mit dem Namen .metadata. Jedes
Verzeichnis workspace enthält ein Verzeichnis metadata; das Verzeichnis, in dem
.metadata erscheint, ist in der Regel Ihr Arbeitsbereich.
- Gehen Sie wie folgt vor, um die Position einer einzelnen Ressource zu
lokalisieren, wie beispielsweise ein Projekt (in diesem Handbuch finden Sie
weitere Informationen zur Migration verschiedener Typen von Projekten):
- Wechseln Sie in der Workbench der Version 5.1 zur Sicht "Navigator":
Klicken Sie Fenster > Sicht anzeigen > Andere an. Erweitern Sie Basis und wählen Sie Navigator aus. Klicken Sie OK an.
- Klicken Sie mit der rechten Maustaste den Namen der Ressource an und wählen
Sie Merkmale aus.
- Klicken Sie im linken Teilfenster Info an.
Die Position der Ressource wird im rechten Teilfenster angezeigt.
Arbeitsbereich in Version 5 lokalisieren
Gehen Sie wie folgt vor, um die Position Ihres Arbeitsbereichs der
Version 5 zu bestimmen:
- Haben Sie beim Installieren von Version 5 die Standardposition
akzeptiert, befindet sich Ihr Arbeitsbereich im Verzeichnis X:\Dokumente &
Einstellungen\Ihre Benutzer-ID\Eigene Dokumente\IBM\wdsc\workspace; dabei ist X das Laufwerk, auf dem sich Ihr Windows-Installationsverzeichnis befindet.
- Befindet sich Ihr Arbeitsbereich nicht an der Standardposition, suchen Sie
nach einem Verzeichnis mit dem Namen .metadata. Jedes
Verzeichnis workspace enthält ein Verzeichnis metadata; das Verzeichnis, in dem
.metadata erscheint, ist in der Regel Ihr Arbeitsbereich.
- Gehen Sie wie folgt vor, um die Position einer einzelnen Ressource zu
lokalisieren, wie beispielsweise ein Projekt (in diesem Handbuch finden Sie
weitere Informationen zur Migration verschiedener Typen von Projekten):
- Wechseln Sie in der Workbench der Version 5 zur Sicht "Navigator":
Klicken Sie Fenster > Sicht anzeigen > Andere an. Erweitern Sie Basis und wählen Sie Navigator aus. Klicken Sie OK an.
- Klicken Sie mit der rechten Maustaste den Namen der Ressource an und wählen
Sie Merkmale aus.
- Klicken Sie im linken Teilfenster Info an.
Die Position der Ressource wird im rechten Teilfenster angezeigt.
Arbeitsbereich in Version 4 lokalisieren
Gehen Sie wie folgt vor, um die Position Ihres Arbeitsbereichs der Version 4 zu bestimmen:
- Haben Sie beim Installieren von Version 4.0 die Standardposition
akzeptiert, befindet sich Ihr Arbeitsbereich im Verzeichnis X:\WDSC\WSSD\workspace; dabei ist X das Laufwerk, auf dem Sie das Produkt installiert haben.
- Befindet sich Ihr Arbeitsbereich nicht an der Standardposition, suchen Sie
(vom Menü "Start" aus) nach einem Verzeichnis mit dem Namen .metadata;
jedes Verzeichnis workspace enthält ein Verzeichnis metadata. Wenn
Sie ein Verzeichnis .metadata gefunden haben, überprüfen Sie das Verzeichnis; dieses Verzeichnis
ist ein Kandidat für Ihren Arbeitsbereich.
- Gehen Sie wie folgt vor, um die Position einer einzelnen Ressource zu
lokalisieren, wie beispielsweise ein Projekt (in diesem Handbuch finden Sie
weitere Informationen zur Migration verschiedener Typen von Projekten):
- Wechseln Sie in der Workbench der Version 4.0 zur Sicht "Navigator": Klicken Sie Perspektive > Sicht anzeigen > Andere an. Erweitern
Sie Basis und wählen Sie
Navigator aus. Klicken Sie OK an.
- Klicken Sie mit der rechten Maustaste den Namen der Ressource an und wählen
Sie Merkmale aus.
- Klicken Sie im linken Teilfenster Info an.
Die Position der Ressource wird im rechten Teilfenster angezeigt.
Arbeitsbereich nach Installationsabschluss angeben
- Beim Starten des Produkts der Version 6.0 (Start > Programme > IBM Rational > WebSphere Development Studio Client für iSeries) wird ein Fenster des Startprogramms
für den Arbeitsbereich geöffnet, in dem Sie das Verzeichnis angeben können, das für die Sitzung
verwendet werden soll. Geben Sie die Verzeichnisposition Ihres Arbeitsbereichs der Version 5.1
oder 5.1.2 in diesem Fenster an.
- Werden Sie aufgefordert zu bestätigen, dass die Konvertierung in das neue
Arbeitsbereichsformat erfolgen soll, klicken Sie OK
an.
Andere wichtige Informationen suchen
Benötigen Sie genaue Informationen zu den Auswirkungen, die die
Migration auf Version 6.0 möglicherweise auf Ihren Arbeitsbereich oder Ihre
Projekte der aktuellen Version hat, können Sie die zutreffenden Abschnitte des
Migrationshandbuchs lesen, das zusammen mit dem Rational Software Developer Platform-Basisprodukt zur Verfügung gestellt wird.
Die Speicherposition dieses Handbuchs ist von der Edition von WebSphere Development Studio Client für iSeries abhängig, die Sie auf
Ihrem System installiert haben.
Haben Sie das Produkt in der Standardposition installiert, ist das Handbuch nach der
Installation beispielsweise auch im folgenden Pfad verfügbar:
- C:\Programme\IBM\Rational\SDP\6.0\radi_prod\migrate.html
- C:\Programme\IBM\Rational\SDP\6.0\rwdi_prod\migrate.html
Zusätzliche, neu dokumentierte Informationen und Dokumente der technischen Unterstützung
zur Migration von WebSphere Development Studio Client für iSeries-Projekten finden Sie auch
im Web.
iSeries: Bestimmte Typen von Projekten migrieren
Sind Sie zur Migration Ihres V5.1.x-Arbeitsbereichs bereit, starten Sie WebSphere Development Studio Client für iSeries mit Ihrem
alten Arbeitsbereich. Im Statusanzeigefeld wird bestätigt, dass Ihre Projekte automatisch
migriert werden.
Anmerkungen: Während der Migration des Arbeitsbereichs wird
ein Dialogfenster "Fehler" mit der folgenden Nachricht geöffnet: Workbench-Layout konnte nicht
wiederhergestellt werden. Grund: Beim Wiederherstellen der Workbench sind Fehler
aufgetreten. Die Fehlernachrichten haben keinen Einfluss auf die erfolgreiche
Migration des Arbeitsbereichs. Achten Sie auf den Namen der Perspektive, die nicht
wiederhergestellt werden konnte, indem Sie die Schaltfläche Details im Fehlerdialogfenster anklicken. Klicken Sie dann OK an, um das Dialogfenster zu schließen.
Gehen Sie wie folgt vor, um die Perspektive wiederherzustellen:
- Schließen Sie die Perspektive, indem Sie Fenster ->
Perspektive schließen auswählen.
- Öffnen Sie die Perspektive erneut, indem Sie Fenster ->
Perspektive öffnen auswählen.
Die folgenden Abschnitte beschreiben die Schritte, die bei der Migration von verschiedenen
Typen von Projekten in WebSphere Development Studio Client für iSeries berücksichtigt werden müssen.
Projekte mit Dateien migrieren, die von den Assistenten für Datenbankwebseiten
und JavaBean-Webseiten generiert wurden
Generierte Dateien erfordern ein Java-Paket für JDK 1.4.
Sie müssen ein Java-Paket angeben, wenn Sie mit Projekten arbeiten,
die Seiten und .java-Dateien enthalten, die mit den Assistenten für Datenbankwebseiten
und JavaBean-Webseiten generiert wurden, aber bei der Erstellung kein Paket angegeben
haben. Stellen Sie für Code, der zuvor generiert wurde, die .java-Dateien in ein
Paket. Aktualisieren Sie dann die JSP-Dateien sowie die Importanweisungen und
Klasseninformationen. Aktualisieren Sie in der Datei web.xml des Projekts den
Eintrag servlet-class.
Programmaufruf-JavaBeans migrieren
Programmaufruf-JavaBeans in iSeries Java- und Webprojekten von
Version 5.1 oder 5.1.2 auf Version 6.0.1 migrieren
Dieser Abschnitt beschreibt die Migration von Programmaufruf-JavaBeans, die
in Development Studio Client für iSeries Version 5.1 oder 5.1.2 erstellt wurden, auf Version 6.0.1.
In Version 6.0.1 stellt der Assistent für Programmaufruf die PCML-Datei
für eine Programmaufruf-JavaBean in das JavaBean-Paket. Dies ist eine Änderung gegenüber früheren
Versionen. Wenn Sie eine Programmaufruf-JavaBean aus einer vorhandenen PCML-Datei, die sich nicht
in dem JavaBean-Paket befindet, erneut erstellen, können Sie diese PCML-Datei löschen, nachdem der
Assistent die erneute Erstellung der Programmaufruf-JavaBean beendet hat.
Anmerkung:
In Version 6.0.1 können Sie
einen Web-Service für
iSeries-Programm mit dem Assistenten für Web-Services direkt aus ILE RPG- oder COBOL-Quelle
oder aus PCML-Dateien erstellen. Sie müssen nicht den Assistenten für Programmaufruf und
den Assistenten für Web-Services ausführen.
Programmaufruf-JavaBeans in einem Java-Projekt migrieren
- Beim Starten des Produkts der Version 6.0.1 (Start
> Programme > IBM Rational > WebSphere Development Studio Client für iSeries) wird ein Fenster des Startprogramms
für den Arbeitsbereich geöffnet, in dem Sie das Verzeichnis angeben können, das für die Sitzung
verwendet werden soll. Geben Sie die Verzeichnisposition Ihres Arbeitsbereichs der Version 5.x an.
- Werden Sie aufgefordert zu bestätigen, dass die Konvertierung in das neue Benutzerschnittstellenformat
erfolgen soll, klicken Sie OK an.
- Entfernen Sie die .jar-Laufzeitdateien, indem Sie den Java-Erstellungspfad für
das Projekt ändern:
- Klicken Sie mit der rechten Maustaste das Java-Projekt an und wählen Sie Merkmale aus.
- Wählen Sie im linken Teilfenster Java-Erstellungspfad aus.
- Wählen Sie die Registerkarte Bibliotheken und dann die
folgenden JAR-Dateien aus und klicken Sie Entfernen an, um die
Dateien aus dem Klassenpfad zu entfernen:
WDSC_HOME/plugins/com.ibm.etools.iseries.toolbox_5.1.0/runtime/jt400.jar
WDSC_HOME/plugins/com.ibm.etools.iseries.webtools_5.1.0/lib/iwdtrt.jar
WDSC_ECLIPSE_HOME/plugins/org.apache.xerces_4.1.3/xercesImpl.jar/
j2ee.jar
4. Führen Sie den Assistenten für Programmaufruf für alle PCML-Dateien
erneut aus. Haben Sie ein Standardpaket verwendet, müssen
Sie einen Paketnamen in Version 6.0.1 angeben.
Die neu generierten JavaBeans und die PCML-Datei befinden sich in
dem angegebenen Paket. Sie können die alten JavaBeans und die alte PCML-Datei in dem Standardpaket
löschen.
Programmaufruf-JavaBeans in einem Webprojekt migrieren
Wenn Sie ein Benutzer von Programmaufruf-Service-Beans sind, sollten Sie wissen,
dass in Version 6.0.1 der Assistent für Programmaufruf immer eine .config-Datei generiert. Hierbei kann es sich um eine benutzerdefinierte Datei oder um die Standarddatei defaultPCW.config handeln. Sie sollten den Assistenten für Laufzeitkonfiguration nicht mehr
verwenden. Für alle Webprojekte vor Version 6.0.1 werden im unten beschriebenen Migrationsschritt für
Webtools-Projekte Informationen aus der Datei web.xml des Projekts abgerufen, und es wird automatisch
eine Datei defaultPCW.config erstellt, wenn sie noch nicht vorhanden
ist. Ab hier basiert die Laufzeitkonfiguration für Programmaufruf auf den Daten in
der .config-Datei und nicht auf den Daten der Datei web.xml.
- Beim Starten des Produkts der Version 6.0.1 (Start
> Programme > IBM Rational > WebSphere Development Studio Client für iSeries) wird ein Fenster des Startprogramms
für den Arbeitsbereich geöffnet, in dem Sie das Verzeichnis angeben können, das für die Sitzung
verwendet werden soll. Geben Sie die Verzeichnisposition Ihres Arbeitsbereichs der Version 5.1
oder 5.1.2 in diesem Fenster an.
- Werden Sie aufgefordert zu bestätigen, dass die Konvertierung in das neue
Benutzerschnittstellenformat erfolgen soll, klicken Sie
OK an.
- (Optionaler Schritt: Verwenden Sie den J2EE-Migrationsassistenten, um von J2EE-Ebene
1.2 auf eine höhere J2EE-Ebene zu migrieren.)
- Löschen Sie iwdtrt.jar und jt400.jar aus dem Ordner WEB-INF\lib.
- Führen Sie den Assistenten für Programmaufruf für alle PCML-Dateien erneut
aus. Neue Service-Bean und PCML-Dateien werden in dem angegebenen Paket
erstellt. Löschen Sie alle alten PCML-Dateien aus dem Webprojekt.
- Führen Sie den Assistenten für Web-Services für die Service-Bean erneut aus.
Code, der vom Assistenten
für Web-Services generiert wurde, erfordert die manuelle Migration und Bereinigung. Diese
Migration gilt nur für die Web-Service-JavaBeans selbst. Lesen Sie die Informationen
zur Migration Ihrer Web-Services in den Abschnitten zu den Web-Services im Migrationshandbuch,
das zusammen mit Ihrem Rational Software Developer Platform-Basisprodukt zur Verfügung gestellt
wird (Andere wichtige Informationen suchen enthält Links zu diesem Handbuch).
Programmaufruf-JavaBeans in iSeries Java- und Webprojekten von
Version 5.0 auf Version 6.0.1 migrieren
Dieser Abschnitt beschreibt die Migration von Programmaufruf-JavaBeans,
die in Development Studio Client für iSeries Version 5.0 erstellt wurden, auf Version 6.0.1.
Anmerkung:
In Version 6.0.1 können Sie
einen Web-Service für
iSeries-Programm mit dem Assistenten für Web-Services direkt aus ILE RPG- oder COBOL-Quelle
oder aus PCML-Dateien erstellen. Sie müssen nicht den Assistenten für Programmaufruf und
den Assistenten für Web-Services ausführen.
Programmaufruf-JavaBeans in einem Java-Projekt migrieren
- Beim Starten des Produkts der Version 6.0.1 (Start
> Programme > IBM Rational > WebSphere Development Studio Client für iSeries) wird ein Fenster des Startprogramms
für den Arbeitsbereich geöffnet, in dem Sie das Verzeichnis angeben können, das für die Sitzung
verwendet werden soll. Geben Sie die Verzeichnisposition Ihres Arbeitsbereichs der Version 5.0 in diesem
Fenster an.
- Werden Sie aufgefordert zu bestätigen, dass die Konvertierung in das neue
Benutzerschnittstellenformat erfolgen soll, klicken Sie
OK an.
- Entfernen Sie die .jar-Laufzeitdateien, indem Sie den Java-Erstellungspfad für
das Projekt ändern:
- Klicken Sie mit der rechten Maustaste das Java-Projekt an und wählen Sie Merkmale aus.
- Wählen Sie im linken Teilfenster Java-Erstellungspfad aus.
- Wählen Sie die Registerkarte Bibliotheken und dann die
folgenden JAR-Dateien aus und klicken Sie Entfernen an, um die
Dateien aus dem Klassenpfad zu entfernen:
WDSC_HOME/plugins/com.ibm.etools.iseries.toolbox_5.0.0/runtime/jt400.jar
WDSC_HOME/plugins/com.ibm.etools.iseries.webtools_5.0.0/lib/iwdtrt.jar
WDSC_ECLIPSE_HOME/plugins/org.apache.xerces_4.0.7/xercesImpl.jar/
j2ee.jar
4. Führen Sie den Assistenten für Programmaufruf für alle PCML-Dateien
erneut aus. Wählen Sie auf der Seite "Authentifizierung konfigurieren" des Assistenten
die Option Konfigurationsdatei generieren ab.
Programmaufruf-JavaBeans in einem Webprojekt migrieren
In den folgenden Abschnitten wird die Migration des Inhalts
des Ordners mit Webinhalten, des Java-Quellenordners und des Webprojektordners beschrieben.
Führen Sie folgende Schritte aus, um den Inhalt des
Ordners mit Webinhalten zu migrieren:
- Beim Starten des Produkts der Version 6.0.1 (Start > Programme > IBM Rational > WebSphere Development Studio Client für iSeries) wird das Fenster des Startprogramms
für den Arbeitsbereich geöffnet, in dem Sie das Verzeichnis angeben können, das für die Sitzung
verwendet werden soll. Verwenden Sie die Standardposition als Arbeitsbereich.
- Wechseln Sie in die Ressourcenperspektive.
- Erstellen Sie ein neues dynamisches Webprojekt mit dem Namen und der Servletversion Ihres
vorhandenen Webprojekts der Version 5.0. Suchen Sie Ihre Servletversion in der Datei
.websettings Ihres vorhandenen Projekts der Version 5.0 und suchen Sie nach einem Tag jsp-level. Lautet der Wert für "jsp level" 1.2, setzen Sie die Servletversion auf
2.3. Andernfalls setzen Sie die Servletversion auf 2.2. Klicken Sie Fertig stellen an. Wechseln Sie nicht in die Webperspektive, wenn Sie aufgefordert werden.
- Wählen Sie den Ordner mit Webinhalten des neu erstellten Projekts aus, klicken Sie mit der
rechten Maustaste und wählen Sie Importieren aus dem Kontextmenü aus.
- Wählen Sie Dateisystem als Importquelle aus und klicken Sie
Weiter an. Klicken Sie den Knopf Durchsuchen an und wählen
Sie den Ordner mit Webinhalten (Standardname Web Content) des vorhandenen
Webprojekts der Version 5.0 aus. Klicken Sie OK an.
- Wählen Sie den Ordner mit Webinhalten aus, aber markieren Sie nicht das
Kästchen. Klicken Sie Alles auswählen an. Wählen Sie im rechten
Fenster eine der Dateien ab und wählen Sie dann dieselbe Datei erneut aus. Dies hat den
Effekt, dass alles unter dem Ordner mit Webinhalten importiert wird, aber der Ordner mit
Webinhalten selbst nicht importiert wird.
- Wählen Sie die Optionen Nur ausgewählte Ordner erstellen und Vorhandene Ressourcen ohne Warnung überschreiben aus und klicken Sie Fertig stellen an. Der Ordner mit Webinhalten des neu erstellten Projekts
sollte jetzt ähnliche Ressourcen und eine ähnliche Ordnerstruktur wie der Ordner mit Webinhalten
der Version 5.0 enthalten.
Führen Sie folgende Schritte aus, um den Inhalt des
Java-Quellenordners zu migrieren:
- Wählen Sie den Java-Quellenordner des neu erstellten Projekts aus, klicken Sie mit der
rechten Maustaste und wählen Sie Importieren aus dem Kontextmenü aus.
- Wählen Sie Dateisystem als Importquelle aus und klicken Sie
Weiter an. Klicken Sie den Knopf Durchsuchen an und wählen
Sie den Java-Quellenordner (Standardname: Java Source) des vorhandenen Webprojekts der Version 5.0 aus. Klicken Sie OK an.
- Wählen Sie den Java-Quellenordner aus, aber markieren Sie nicht das
Kästchen. Klicken Sie Alles auswählen an. Wählen Sie im rechten
Fenster eine der Dateien ab und wählen Sie dann dieselbe Datei erneut aus. Dies hat den
Effekt, dass alles unter dem Java-Quellenordner importiert wird, aber der Java-Quellenordner
selbst nicht importiert wird.
- Wählen Sie die Optionen Nur ausgewählte Ordner erstellen und Vorhandene Ressourcen ohne Warnung überschreiben aus und klicken Sie Fertig stellen an. Der Java-Quellenordner des neu erstellten Projekts
sollte jetzt ähnliche Ressourcen und eine ähnliche Ordnerstruktur wie der Java-Quellenordner der Version 5.0 enthalten.
Führen Sie folgende Schritte aus, um den Inhalt des
Webprojektordners zu migrieren:
- Wählen Sie jetzt das neu erstellte Projekt aus, klicken Sie mit der rechten Maustaste
und wählen Sie Importieren aus dem Kontextmenü aus.
- Wählen Sie Dateisystem als Importquelle aus und klicken Sie
Weiter an. Klicken Sie den Knopf Durchsuchen an und wählen
Sie das vorhandene Webprojekt der Version 5.0 aus.
- Wählen Sie den Projektordner im linken Fenster aus und klicken Sie Alles auswählen an. Wählen Sie im rechten Fenster eine der Dateien ab und wählen Sie
dann dieselbe Datei erneut aus. Wählen Sie im linken Fenster den Ordner mit Webinhalten
und den Java-Quellenordner
ab. Dies hat den Effekt, dass alles unter dem Webprojektordner importiert wird, aber der Ordner
mit Webinhalten und der Java-Quellenordner sowie der
Webprojektordner selbst nicht importiert werden.
- Wählen Sie im rechten Fenster die folgenden Dateien ab, wenn sie in der Liste erscheinen:
- \WebContent\.classpath
- \WebContent\.project
- \WebContent\.websettings
- \WebContent\.serverPreference
Diese Dateien enthalten Informationen zu dem Projekt, die zur
Entwicklungszeit erforderlich sind. Die Informationen können nicht auf Version 6.0.1
migriert werden. Die Dateien werden daher bei Bedarf erneut erstellt.
- Wählen Sie die Optionen Nur ausgewählte Ordner erstellen und Vorhandene Ressourcen ohne Warnung überschreiben aus und klicken Sie Fertig stellen an. Der neu erstellte Webprojektordner sollte jetzt ähnliche
Ressourcen und eine ähnliche Ordnerstruktur wie der Webprojektordner der Version 5.0 enthalten.
- (Optionaler Schritt: Verwenden Sie den J2EE-Migrationsassistenten, um von J2EE-Ebene
1.2 auf eine höhere J2EE-Ebene zu migrieren.)
- Löschen Sie iwdtrt.jar und jt400.jar aus dem Ordner WEB-INF\lib.
- Führen Sie den Assistenten für Programmaufruf für alle PCML-Dateien erneut
aus.
Diese Migration gilt nur für Service-Beans selbst. Lesen Sie die Informationen
zur Migration Ihrer Web-Services in den Abschnitten zu den Web-Services im Migrationshandbuch,
das zusammen mit Ihrem Rational Software Developer Platform-Basisprodukt zur Verfügung gestellt
wird (Andere wichtige Informationen suchen enthält Links zu diesem Handbuch).
Programmaufruf-JavaBeans in iSeries Java- und Webprojekten von
Version 4.0 auf Version 6.0.1 migrieren
Dieser Abschnitt beschreibt die Migration von Programmaufruf-JavaBeans,
die in Development Studio Client für iSeries Version 4.0 erstellt wurden, auf Version 6.0.1.
Anmerkung:
In Version 6.0.1 können Sie
einen Web-Service für
iSeries-Programm mit dem Assistenten für Web-Services direkt aus ILE RPG- oder COBOL-Quelle
oder aus PCML-Dateien erstellen. Sie müssen nicht den Assistenten für Programmaufruf und
den Assistenten für Web-Services ausführen.
Programmaufruf-JavaBeans in einem Java-Projekt migrieren
- Beim Starten des Produkts der Version 6.0.1 (Start
> Programme > IBM Rational > WebSphere Development Studio Client für iSeries) wird ein Fenster des Startprogramms
für den Arbeitsbereich geöffnet, in dem Sie das Verzeichnis angeben können, das für die Sitzung
verwendet werden soll. Geben Sie die Verzeichnisposition Ihres Arbeitsbereichs der Version 4.0 in diesem
Fenster an.
- Werden Sie aufgefordert zu bestätigen, dass die Konvertierung in das neue
Benutzerschnittstellenformat erfolgen soll, klicken Sie
OK an.
- Entfernen Sie die .jar-Laufzeitdateien, indem Sie den Java-Erstellungspfad für
das Projekt ändern:
- Klicken Sie mit der rechten Maustaste das Java-Projekt an und wählen Sie Merkmale aus.
- Wählen Sie im linken Teilfenster Java-Erstellungspfad aus.
- Wählen Sie die Registerkarte Bibliotheken und dann die
folgenden JAR-Dateien aus und klicken Sie Entfernen an, um die
Dateien aus dem Klassenpfad zu entfernen:
ECLIPSE_HOME/plugins/com.ibm.etools.iseries.toolbox/runtime/jt400.jar
ECLIPSE_HOME/plugins/com.ibm.etools.iseries.webtools/lib/wdt400rt.jar
ECLIPSE_HOME/plugins/com.ibm.etools.websphere.runtime/lib/j2ee.jar
ECLIPSE_HOME/plugins/com.ibm.etools.websphere.runtime/lib/xerces.jar
- Führen Sie den Assistenten für Programmaufruf für alle PCML-Dateien erneut
aus. Wählen Sie auf der Seite "Authentifizierung konfigurieren" des Assistenten die
Option Konfigurationsdatei generieren ab.
Diese Migration gilt nur für die Programmaufruf-JavaBeans selbst. Code, der
vom Assistenten für Programmaufruf generiert wurde, erfordert die manuelle
Migration und Bereinigung.
Programmaufruf-JavaBeans in einem Webprojekt migrieren
Führen Sie folgende Schritte aus, um den Inhalt des
Ordners mit Webinhalten zu migrieren:
- Beim Starten des Produkts der Version 6.0.1 (Start > Programme > IBM Rational > WebSphere Development Studio Client für iSeries) wird das Fenster des Startprogramms
für den Arbeitsbereich geöffnet, in dem Sie das Verzeichnis angeben können, das für die Sitzung
verwendet werden soll. Verwenden Sie die Standardposition als Arbeitsbereich.
- Wechseln Sie in die Ressourcenperspektive.
- Erstellen Sie ein neues dynamisches Webprojekt mit dem Namen und der Servletversion Ihres
vorhandenen Webprojekts der Version 4.0. Suchen Sie Ihre Servletversion in der Datei
.websettings Ihres vorhandenen Projekts der Version 4.0 und suchen Sie nach einem Tag jsp-level. Lautet der Wert für "jsp level" 1.2, setzen Sie die Servletversion auf
2.3. Andernfalls setzen Sie die Servletversion auf 2.2. Klicken Sie Fertig stellen an. Wechseln Sie nicht in die Webperspektive, wenn Sie aufgefordert werden.
- Wählen Sie den Ordner mit Webinhalten des neu erstellten Projekts aus, klicken Sie mit der
rechten Maustaste und wählen Sie Importieren aus dem Kontextmenü aus.
- Wählen Sie Dateisystem als Importquelle aus und klicken Sie
Weiter an. Klicken Sie den Knopf Durchsuchen an und wählen
Sie den Ordner mit Webinhalten (Standardname webApplication) des vorhandenen Webprojekts der Version 4.0 aus. Klicken Sie OK an.
- Wählen Sie den Ordner mit Webinhalten aus, aber markieren Sie nicht das
Kästchen. Klicken Sie Alles auswählen an. Wählen Sie im rechten
Fenster eine der Dateien ab und wählen Sie dann dieselbe Datei erneut aus. Dies hat den
Effekt, dass alles unter dem Ordner mit Webinhalten importiert wird, aber der Ordner mit
Webinhalten selbst nicht importiert wird.
- Wählen Sie die Optionen Nur ausgewählte Ordner erstellen und Vorhandene Ressourcen ohne Warnung überschreiben aus und klicken Sie Fertig stellen an. Der Ordner mit Webinhalten des neu erstellten Projekts
sollte jetzt ähnliche Ressourcen und eine ähnliche Ordnerstruktur wie der Ordner mit Webinhalten
der Version 4.0 enthalten.
Führen Sie folgende Schritte aus, um den Inhalt des
Java-Quellenordners zu migrieren:
- Wählen Sie den Java-Quellenordner des neu erstellten Projekts aus, klicken Sie mit der
rechten Maustaste und wählen Sie Importieren aus dem Kontextmenü aus.
- Wählen Sie Dateisystem als Importquelle aus und klicken Sie
Weiter an. Klicken Sie den Knopf Durchsuchen an und wählen
Sie den Java-Quellenordner (Standardname: source)
des vorhandenen Webprojekts der Version 4.0 aus. Klicken Sie OK an.
- Wählen Sie den Java-Quellenordner aus, aber markieren Sie nicht das
Kästchen. Klicken Sie Alles auswählen an. Wählen Sie im rechten
Fenster eine der Dateien ab und wählen Sie dann dieselbe Datei erneut aus. Dies hat den
Effekt, dass alles unter dem Java-Quellenordner importiert wird, aber der Java-Quellenordner
selbst nicht importiert wird.
- Wählen Sie die Optionen Nur ausgewählte Ordner erstellen und Vorhandene Ressourcen ohne Warnung überschreiben aus und klicken Sie Fertig stellen an. Der Java-Quellenordner des neu erstellten Projekts
sollte jetzt ähnliche Ressourcen und eine ähnliche Ordnerstruktur wie der Java-Quellenordner der Version 4.0 enthalten.
Führen Sie folgende Schritte aus, um den Inhalt des
Webprojektordners zu migrieren:
- Wählen Sie jetzt das neu erstellte Projekt aus, klicken Sie mit der rechten Maustaste
und wählen Sie Importieren aus dem Kontextmenü aus.
- Wählen Sie Dateisystem als Importquelle aus und klicken Sie
Weiter an. Klicken Sie den Knopf Durchsuchen an
und wählen Sie das vorhandene Webprojekt der Version 4.0 aus.
- Wählen Sie den Projektordner im linken Fenster aus und klicken Sie Alles auswählen an. Wählen Sie im rechten Fenster eine der Dateien ab und wählen Sie
dann dieselbe Datei erneut aus. Wählen Sie im linken Fenster den Ordner mit Webinhalten
und den Java-Quellenordner
ab. Dies hat den Effekt, dass alles unter dem Webprojektordner importiert wird, aber der Ordner
mit Webinhalten und der Java-Quellenordner sowie der
Webprojektordner selbst nicht importiert werden.
- Wählen Sie im rechten Fenster die folgenden Dateien ab, wenn sie in der Liste erscheinen:
- \WebContent\.classpath
- \WebContent\.project
- \WebContent\.websettings
- \WebContent\.serverPreference
Diese Dateien enthalten Informationen zu dem Projekt, die zur
Entwicklungszeit erforderlich sind. Die Informationen können nicht auf Version 6.0.1
migriert werden. Die Dateien werden daher bei Bedarf erneut erstellt.
- Wählen Sie die Optionen Nur ausgewählte Ordner erstellen und Vorhandene Ressourcen ohne Warnung überschreiben aus und klicken Sie Fertig stellen an. Der neu erstellte Webprojektordner sollte jetzt ähnliche
Ressourcen und eine ähnliche Ordnerstruktur wie der Webprojektordner der Version 5.0 enthalten.
- (Optionaler Schritt: Verwenden Sie den J2EE-Migrationsassistenten, um von J2EE-Ebene
1.2 auf eine höhere J2EE-Ebene zu migrieren.)
- Löschen Sie wdt400rt.jar und wdt400tb.jar aus dem Ordner WEB-INF\lib.
- Führen Sie den Assistenten für Programmaufruf für alle PCML-Dateien erneut aus.
- Diese Migration gilt nur für Service-Beans selbst.
Ab Version 5.1 müssen die JavaBeans in einem benannten Paket generiert
werden, bevor Sie den Assistenten für Web-Services aufrufen. Code, der vom Assistenten
für Web-Services generiert wurde, erfordert die manuelle Migration und Bereinigung.
Diese Migration gilt nur für die Web-Service-JavaBeans selbst. Lesen Sie die Informationen
zur Migration Ihrer Web-Services in den Abschnitten zu den Web-Services im Migrationshandbuch,
das zusammen mit Ihrem Rational Software Developer Platform-Basisprodukt zur Verfügung gestellt
wird (Andere wichtige Informationen suchen enthält Links zu diesem Handbuch).
WebFacing-Projekte migrieren
Version 6.0.1 des IBM WebFacing Tools bietet Erweiterungen für die Interoperabilität
mit 5250-Anwendungen, die nicht webfähig sind. Diese 5250-Anwendungen können in einem Browser
ausgeführt werden, sie sind jedoch auf zwei Laufzeitverbindungen nur zu Testzwecken
eingeschränkt. Um interagierende Anwendungen in der Produktion einzusetzen, müssen Sie
das IBM WebFacing Deployment Tool für WebSphere Development Studio
Version 6.0.1 (5725-N52) anfordern.
Wichtig:
Ab WebSphere Development
Studio Client für iSeries Version 6.0.1 wird die Migration von WebFacing-Projekten der
Versionen 4.0 und 5.0 nicht mehr unterstützt. Informationen zur Migration von Projekten
auf Version 6.0.1 befinden sich in
WebFacing-Assistent zum Importieren verwenden und in den
Dokumenten der technischen IBM Unterstützung.
Haben Sie einen vorhandenen
Arbeitsbereich, der mit Version 5.1 oder einer neueren Version erstellt wurde, können Sie den
Arbeitsbereich mit Version 6.0.1 öffnen, und die WebFacing-Projekte können wie vorhanden ausgeführt werden. Die Anzeige des Projekts
ist jedoch möglicherweise nicht vollständig. Beispielsweise werden die Satz-JSP-Dateien und einige
Darstellungsdateien aus einigen Vorgängerreleases in einer Baumstruktursicht der Version 6.0.1 erst
angezeigt, wenn Sie Ihre Projekte erneut konvertiert haben. Beim ersten Konvertieren einer DDS-Datei wird die Projektstruktur
aktualisiert, um das neue Layout widerzuspiegeln, das in 5.1.2 erstellt wurde. Beispielsweise werden
neue JAR-Laufzeitdateien und Schablonendateien importiert. Dies erfolgt auf die
gleiche Art und Weise wie beim Importieren Ihres Projekts mit dem Assistenten zum
Importieren.
WebFacing-Assistent zum Importieren verwenden
Haben Sie WebFacing-Projekte aus WebSphere Development
Studio Client Version 5.1.x oder aus einer späteren Version, können Sie diese mit Hilfe des Assistenten zum
Importieren auf WebSphere Development Studio Client für iSeries Version 6.0.1 migrieren. Führen Sie diese Schritte aus:
- Wählen Sie Datei > Importieren aus.
- Wählen Sie WebFacing-Projekte aus. Klicken
Sie Weiter an.
- Suchen Sie mit Durchsuchen nach dem Ordner, der
die WebFacing-Projekte enthält, die auf Version 6.0.1 migriert werden sollen. Klicken Sie Weiter an.
Anmerkung:
Erfolgt ein Upgrade auf Version 6.0.1, bleiben WebFacing-Projekte
in Ihrem ursprünglichen Verzeichnis workspace verfügbar.
- Erfolgt die Migration von Development Studio Client 5.1 oder 5.1.2, lesen Sie
die Abschnitte zum Lokalisieren Ihres Arbeitsbereichs unter Mehrere Produktversionen verwalten.
- Alle WebFacing-Projekte, die der Assistent findet, werden im Teilfenster
Gefundene WebFacing-Projekte aufgelistet. Wählen Sie
die Projekte aus, die importiert werden sollen. Der Assistent
erstellt eine EAR-Datei für das Projekt. Eine EAR-Datei ist eine J2EE
Enterprise Application Archive-Datei. Standardmäßig verwendet die EAR-Datei den
Namen Ihres WebFacing-Projekts und fügt _EAR an den Namen
an. Möchten Sie einen anderen Namen verwenden oder fassen Sie mehrere Projekte in einer
einzigen EAR-Datei zusammen, können Sie den Namen im Feld Enterprise
Application-Projekt ändern.
- Klicken Sie Fertig stellen an, um das Projekt auf
Version 6.0.1 des Arbeitsbereichs zu migrieren.
- Um das Projekt in der WebFacing-Perspektive anzuzeigen, wählen Sie
Fenster > Perspektive öffnen > WebFacing aus.
Manuelle Schritte, wenn Ihr Projekt angepasste Dateien enthält
Die ursprünglichen Dateien haben neue Namen mit dem folgenden Format:
Dateiname +_601_bak.
Hatten Sie Ihr WebFacing-Projekt angepasst, müssen Sie unter Umständen Ihre Anpassungen
aus den ursprünglichen Dateien in die folgenden Dateien mischen:
- PageBuilder.jsp
- CmdKeys.jsp
- logon.jsp
- index.html
- War das vorherige Projekt Struts-fähig, müssen die
Struts-Konfigurationsdateien (struts-config.xml) aktualisiert werden.
- Verwendete das vorherige Projekt Web Site Designer, müssen die folgenden
Dateien aktualisiert werden:
- \WebContent\index.jsp
- \WebContent\INV1.jsp
- \WebContent\INV2.jsp
- \WebContent\theme\WFB_blue.jtpl
iSeries-Webprojekte migrieren
Die folgenden Methoden können verwendet werden, um iSeries-Webprojekte zu migrieren:
- Migration von iSeries-Webprojekten unter Verwendung eines vorhandenen
Arbeitsbereichs von WebSphere Development
Studio Client Version 5.1.x
Bei dieser Migration müssen Sie Ihren vorhandenen Arbeitsbereich
in der Workbench in Version 6.0.1 verwenden und die Migrationsroutine der iSeries-Webtools ausführen.
- Migration von iSeries-Webprojekten unter Verwendung eines vorhandenen
Projekts von WebSphere Development
Studio Client Version 5.0
Bei dieser Migration müssen
Sie den Projektinhalt aus dem Dateisystem importieren und dann die Migrationsroutine der
iSeries-Webtools
ausführen.
- Migration von iSeries-Webprojekten unter Verwendung eines vorhandenen
Projekts von WebSphere Development
Studio Client Version 4.0
Bei dieser Migration müssen
Sie den Projektinhalt aus dem Dateisystem importieren und dann die Migrationsroutine der
iSeries-Webtools
ausführen.
Wichtig:
Stellen Sie sicher, dass alle Serverinstanzen gestoppt
werden, bevor Sie mit der Migration fortfahren.
iSeries-Webprojekte von Version 5.1.x auf Version 6.0.1 migrieren
Die folgenden Informationen beschreiben die Migration von iSeries-Webprojekten von Development Studio Client für iSeries Version 5.1.x
auf WebSphere Development Studio Client für iSeries Version 6.0.1.
Die Migrationsaktivitäten umfassen die folgenden Phasen:
- Migration von Projekten unter Verwendung eines vorhandenen
Arbeitsbereichs der Version 5.1.x
- Migration des Inhalts von iSeries-Webprojekten
- Adressierung von Fehlern und Warnungen, die infolge der Migration generiert wurden
Phase 1: Migration von Projekten
unter Verwendung eines vorhandenen Arbeitsbereichs der Version 5.1.x
In Version 6.0.1 können die Standardordnernamen für Webinhalte und Java-Quelle für neue Webprojekte über eine Seite mit Einstellungen
konfiguriert werden. Die Standardnamen sind jetzt WebContent und JavaSource. Diese Standardnamen
werden nur für neue Webprojekte verwendet. Webprojekte, die in Versionen vor Version 6.0.1 erstellt
wurden, können weiterhin mit den alten Namen verwendet werden.
- Beim Starten des Produkts der Version 6.0.1 (Start > Programme > IBM Rational > WebSphere Development Studio Client für iSeries) wird das Rational Software Developer Platform-Fenster
geöffnet, in dem Sie das Verzeichnis angeben können, das für die Sitzung
verwendet werden soll. Geben
Sie die Verzeichnisposition Ihres Arbeitsbereichs der Version 5.1.x in diesem Fenster an.
- Werden Sie aufgefordert zu bestätigen, dass die Konvertierung in das neue
Benutzerschnittstellenformat erfolgen soll, klicken Sie
OK an.
- Optional: Klicken Sie im Hauptmenü Fenster >
Einstellungen an. Erweitern Sie im linken Teilfenster Webtools und
wählen Sie Neues J2EE-Projekt aus. Definieren Sie im rechten
Teilfenster die Einstellungen für Ihre Standardordnernamen.
Sie können die Quellenordnernamen für Projekte der
Version 5.1.x in Version 6.0.1 manuell ändern, indem Sie mit der rechten Maustaste
den Ordnernamen in der Sicht "Projektexplorer" anklicken und "Refactoring"
auswählen und dann Umbenennen anklicken. Die
Aktion "Umbenennen" benennt die Ordnernamen um und legt den Java-Erstellungspfad
für die Webprojekte der Version 5.1.x fest. Wenn Sie die JavaSource- und
WebContent-Ordnernamen in Version 6.0.1 umbenennen möchten, müssen alle automatisierten
Erstellungsscripts, die Sie haben, manuell mit den neuen Ordnernamen aktualisiert werden.
Optional: Webprojekte nach Struts 1.1 konvertieren
Haben Sie Struts 1.1 Betaversion 2-Webprojekte in IBM WebSphere Studio Application Developer Version
5 erstellt, können Sie sie nach Struts 1.1 konvertieren. Dies ist jedoch
nicht erforderlich, da Struts 1.1 Betaversion 2 noch unterstützt wird.
Gehen Sie wie folgt vor, wenn Sie Struts 1.1 Betaversion 2-Webprojekte haben,
die nach Struts 1.1 konvertiert werden sollen:
- Erstellen Sie ein neues Struts 1.1-Webprojekt mit dem Namen Struts11. Damit
wird ein geeigneter Zugriff auf die Struts 1.1-Artefakte zur Verfügung gestellt,
die während der Konvertierung der realen Projekte erforderlich sind. Anschließend
können Sie dieses Projekt löschen.
- Führen Sie für jedes Struts 1.1 Betaversion 2-Projekt, das nach Struts
1.1 konvertiert werden soll, die folgenden Schritte aus:
- Löschen Sie die folgenden .jar-Dateien aus dem Verzeichnis Web Content/WEB-INF/lib Ihres Projekts: commons-*.jar und struts.jar.
- Kopieren Sie die folgenden .jar-Dateien aus dem Verzeichnis Struts11/WebContent/WEB-INF/lib in das Verzeichnis Web Content/WEB-INF/lib Ihres Projekts: commons-*.jar und struts.jar.
- Löschen Sie die folgenden .tld-Dateien aus dem Verzeichnis Web Content/WEB-INF Ihres Projekts: struts-*.tld.
- Kopieren Sie die folgenden .tld-Dateien aus dem Verzeichnis Struts11/WebContent/WEB-INF in das Verzeichnis Web Content/WEB-INF Ihres Projekts: struts-*.tld.
Phase 2: Migration des Inhalts von
iSeries-Webprojekten
Um den Inhalt eines iSeries-Webtoolsprojekts zu migrieren, gehen Sie wie
folgt vor:
- Klicken Sie mit der rechten Maustaste den Projektnamen in der Sicht
"Projektnavigator" der Webperspektive an und wählen Sie
Merkmale aus. Wählen Sie in der linken Anzeige
Funktionen des Webprojekts aus. Wählen Sie in der
Liste Verfügbare Funktionen des Webprojekts die
Option Struts aus, sofern diese noch nicht ausgewählt ist. Klicken
Sie OK an. Klicken Sie im Fenster "Funktionen des Webprojekts" Fertig
stellen an, um die standardmäßige Struts-Version (1.1) zu akzeptieren.
Anmerkung:
Wird dieser Schritt nicht ausgeführt, werden Sie in einem
Fenster aufgefordert, Struts-Unterstützung hinzuzufügen.
- Wichtig: An diesem Punkt müssen Sie das Projekt schließen und erneut
öffnen, um eine Ausnahmebedingung zu verhindern, die sich auf das Löschen von
Ressourcen bezieht, und um sicherzustellen, dass das Projekt auf keinen Servern
ausgeführt wird.
- Klicken Sie mit der rechten Maustaste den Projektnamen in der
Webperspektive an und wählen Sie Migrieren > iSeries-Webtoolsprojekt aus. Das Fenster "Migration bestätigen" zeigt
an, dass die Projektstruktur und der Projektinhalt migriert werden.
- Um den Prozess fortzusetzen, klicken Sie OK
an. In einem Fenster wird der Fortschritt der Migration angezeigt.
- Nach Abschluss der Migration zeigt eine Nachricht die Ergebnisse an.
- Wurde der Migrationsprozess erfolgreich abgeschlossen, ist keine weitere
Aktion erforderlich. Wurde der Migrationsprozess mit Fehlern oder Warnungen
beendet, fahren Sie mit Phase 3: Adressierung von Fehlern
und Warnungen, die infolge der Migration generiert wurden fort.
- Der Migrationsprozess führt die folgenden Aktionen aus:
- Er aktualisiert iSeries-Webkomponenten, Tag-Bibliotheken und JavaScript-Dateien (und aktualisiert alle JSP-Dateien entsprechend).
- Er regeneriert Dateien, die sich auf die Webinteraktion beziehen, auf der
Basis des Struts-Gerüsts aus den .wit-Dateien, und aktualisiert Laufzeitdateien
für die Webinteraktion.
- Er fügt Unterstützung für neue iSeries-Webtoolsfunktionen hinzu, die
in Version 6.0.1 verfügbar sind.
Phase 3: Adressierung von Fehlern
und Warnungen, die infolge der Migration generiert wurden
Treten während des Migrationsprozesses Fehler auf, wird ein Fenster
geöffnet, das angibt, dass Fehler oder Warnungen aufgetreten sind. Die
Migrationsprotokolldatei Projektname_MigrationDetails.txt,
die die Fehler beschreibt und die sich unter dem Projektnamen in der Webperspektive
befindet, wird ebenfalls geöffnet.
Der Abschnitt "Migrationsergebnis" am Anfang der Migrationsprotokolldatei
gibt den Gesamtstatus der Migration an und verweist auf eine Onlineversion der Tabelle
mit Warnungen und Fehlern weiter unten mit Beschreibungen und Korrekturmaßnahmen. Siehe Warnungen und Fehlernachrichten bei der Migration von Webprojekten.
iSeries-Webprojekte von Version 5.0 auf Version 6.0.1 migrieren
Die folgenden Informationen beschreiben die Migration von iSeries-Webprojekten von Development Studio Client für iSeries Version 5.0
auf WebSphere Development Studio Client für iSeries Version 6.0.1.
Die Migrationsaktivitäten umfassen die folgenden Phasen:
- Migration von Projekten unter Verwendung eines vorhandenen Webprojekts der
Version 5.0 in dem Dateisystem
- Migration des Inhalts von iSeries-Webprojekten
- Adressierung von Fehlern und Warnungen, die infolge der Migration generiert wurden
Phase 1: Migration eines vorhandenen Projekts der Version 5.0 in dem Dateisystem
auf Version 6.0.1
In Version 6.0.1 können die Standardordnernamen für Webinhalte und Java-Quelle für neue Webprojekte über eine Seite mit Einstellungen
konfiguriert werden. Die Standardnamen sind jetzt WebContent und JavaSource. Diese Standardnamen
werden nur für neue Webprojekte verwendet. Webprojekte, die in Versionen vor Version 6.0.1 erstellt
wurden, können weiterhin mit den alten Namen verwendet werden.
Führen Sie folgende Schritte aus, um den Inhalt des
Ordners mit Webinhalten zu migrieren:
- Beim Starten des Produkts der Version 6.0.1 (Start > Programme > IBM Rational > WebSphere Development Studio Client für iSeries) wird das Fenster des Startprogramms
für den Arbeitsbereich geöffnet, in dem Sie das Verzeichnis angeben können, das für die Sitzung
verwendet werden soll. Verwenden Sie die Standardposition als Arbeitsbereich.
- Wechseln Sie in die Ressourcenperspektive.
- Erstellen Sie ein neues dynamisches Webprojekt mit dem Namen und der Servletversion Ihres
vorhandenen Webprojekts der Version 5.0. Suchen Sie Ihre Servletversion in der Datei
.websettings Ihres vorhandenen Projekts der Version 5.0 und suchen Sie nach einem Tag jsp-level. Lautet der Wert für "jsp level" 1.2, setzen Sie die Servletversion auf
2.3. Andernfalls setzen Sie die Servletversion auf 2.2. Klicken Sie Fertig stellen an. Wechseln Sie nicht in die Webperspektive, wenn Sie aufgefordert werden.
- Wählen Sie den Ordner mit Webinhalten des neu erstellten Projekts aus, klicken Sie mit der
rechten Maustaste und wählen Sie Importieren aus dem Kontextmenü aus.
- Wählen Sie Dateisystem als Importquelle aus und klicken Sie
Weiter an. Klicken Sie den Knopf Durchsuchen an und wählen
Sie den Ordner mit Webinhalten (Standardname: Web Content) des vorhandenen
Webprojekts der Version 5.0 aus. Klicken Sie OK an.
- Wählen Sie den Ordner mit Webinhalten aus, aber markieren Sie nicht das
Kästchen. Klicken Sie Alles auswählen an. Wählen Sie im rechten
Fenster eine der Dateien ab und wählen Sie dann dieselbe Datei erneut aus. Dies hat den
Effekt, dass alles unter dem Ordner mit Webinhalten importiert wird, aber der Ordner mit
Webinhalten selbst nicht importiert wird.
- Wählen Sie im rechten Fenster die folgenden Dateien ab, wenn sie in der Liste erscheinen:
- \WebContent\WEB-INF\struts-*.tld
- \WebContent\WEB-INF\lib\struts.jar
- \WebContent\WEB-INF\lib\commons-*.jar
- \WebContent\WEB-INF\lib\jdbc2_0-stdext.jar
- Wählen Sie die Optionen Nur ausgewählte Ordner erstellen und Vorhandene Ressourcen ohne Warnung überschreiben aus und klicken Sie Fertig stellen an. Der Ordner mit Webinhalten des neu erstellten Projekts
sollte jetzt ähnliche Ressourcen und eine ähnliche Ordnerstruktur wie der Ordner mit Webinhalten
der Version 5.0 enthalten.
Führen Sie folgende Schritte aus, um den Inhalt des Java-Quellenordners zu migrieren:
- Wählen Sie den Java-Quellenordner des neu erstellten Projekts aus, klicken Sie mit der
rechten Maustaste und wählen Sie Importieren aus dem Kontextmenü aus.
- Wählen Sie Dateisystem als Importquelle aus und klicken Sie
Weiter an. Klicken Sie den Knopf Durchsuchen an und wählen
Sie den Java-Quellenordner (Standardname: Java Source) des vorhandenen Webprojekts der Version 5.0 aus. Klicken Sie OK an.
- Wählen Sie den Java-Quellenordner aus, aber markieren Sie nicht das
Kästchen. Klicken Sie Alles auswählen an. Wählen Sie im rechten
Fenster eine der Dateien ab und wählen Sie dann dieselbe Datei erneut aus. Dies hat den
Effekt, dass alles unter dem Java-Quellenordner importiert wird, aber der Java-Quellenordner
selbst nicht importiert wird.
- Wählen Sie die Optionen Nur ausgewählte Ordner erstellen und Vorhandene Ressourcen ohne Warnung überschreiben aus und klicken Sie Fertig stellen an. Der Java-Quellenordner des neu erstellten Projekts
sollte jetzt ähnliche Ressourcen und eine ähnliche Ordnerstruktur wie der Java-Quellenordner der Version 5.0 enthalten.
Führen Sie folgende Schritte aus, um den Inhalt des
Webprojektordners zu migrieren:
- Wählen Sie jetzt das neu erstellte Projekt aus, klicken Sie mit der rechten Maustaste
und wählen Sie Importieren aus dem Kontextmenü aus.
- Wählen Sie Dateisystem als Importquelle aus und klicken Sie
Weiter an. Klicken Sie den Knopf Durchsuchen an und wählen
Sie das vorhandene Webprojekt der Version 5.0 aus.
- Wählen Sie den Projektordner im linken Fenster aus und klicken Sie Alles auswählen an. Wählen Sie im rechten Fenster eine der Dateien ab und wählen Sie
dann dieselbe Datei erneut aus. Wählen Sie im linken Fenster den Ordner mit Webinhalten
und den Java-Quellenordner
ab. Dies hat den Effekt, dass alles unter dem Webprojektordner importiert wird, aber der Ordner
mit Webinhalten und der Java-Quellenordner sowie der
Webprojektordner selbst nicht importiert werden.
- Wählen Sie im rechten Fenster die folgenden Dateien ab, wenn sie in der Liste erscheinen:
- \WebContent\.classpath
- \WebContent\.project
- \WebContent\.websettings
- \WebContent\.serverPreference
Diese Dateien enthalten Informationen zu dem Projekt, die zur
Entwicklungszeit erforderlich sind. Die Informationen können nicht auf Version 6.0.1
migriert werden. Die Dateien werden daher bei Bedarf erneut erstellt.
- Wählen Sie die Optionen Nur ausgewählte Ordner erstellen und Vorhandene Ressourcen ohne Warnung überschreiben aus und klicken Sie Fertig stellen an. Der neu erstellte Webprojektordner sollte jetzt ähnliche
Ressourcen und eine ähnliche Ordnerstruktur wie der Webprojektordner der Version 5.0 enthalten.
Artefakte alter Struts-Stufen entfernen
- Klicken Sie mit der rechten Maustaste WebContent/WEB-INF/web.xml an. Wählen Sie
Öffnen mit > Editor für Implementierungsdeskriptor aus.
- Gehen Sie zur Registerkarte Servlets.
- Entfernen Sie den Servleteintrag, der dem Aktionsservlet der Servletklasse
org.apache.struts.action zugeordnet ist (Standardname action.
Phase 2: Migration des Inhalts von
iSeries-Webprojekten
Um den Inhalt eines iSeries-Webtoolsprojekts zu migrieren, gehen Sie wie
folgt vor:
- Klicken Sie mit der rechten Maustaste den Projektnamen in der Sicht
"Projektnavigator" der Webperspektive an und wählen Sie
Merkmale aus. Wählen Sie in der linken Anzeige
Funktionen des Webprojekts aus. Wählen Sie in der
Liste Verfügbare Funktionen des Webprojekts die
Option Struts aus, sofern diese noch nicht ausgewählt ist. Klicken
Sie OK an. Klicken Sie im Fenster "Funktionen des Webprojekts" Fertig
stellen an, um die standardmäßige Struts-Version (1.1) zu akzeptieren.
Anmerkung:
Wird dieser Schritt nicht ausgeführt, werden Sie in einem
Fenster aufgefordert, Struts-Unterstützung hinzuzufügen.
- Wichtig: An diesem Punkt müssen Sie das Projekt schließen und erneut
öffnen, um eine Ausnahmebedingung zu verhindern, die sich auf das Löschen von
Ressourcen bezieht, und um sicherzustellen, dass das Projekt auf keinen Servern
ausgeführt wird.
- Klicken Sie mit der rechten Maustaste den Projektnamen in der
Webperspektive an und wählen Sie Migrieren > iSeries-Webtoolsprojekt aus. Das Fenster "Migration bestätigen" zeigt
an, dass die Projektstruktur und der Projektinhalt migriert werden.
- Um den Prozess fortzusetzen, klicken Sie OK
an. In einem Fenster wird der Fortschritt der Migration angezeigt.
- Nach Abschluss der Migration zeigt eine Nachricht die Ergebnisse an.
- Wurde der Migrationsprozess erfolgreich abgeschlossen, ist keine weitere
Aktion erforderlich. Wurde der Migrationsprozess mit Fehlern oder Warnungen
beendet, fahren Sie mit Phase 3: Adressierung von Fehlern
und Warnungen, die infolge der Migration generiert wurden fort.
- Der Migrationsprozess führt die folgenden Aktionen aus:
- Er aktualisiert iSeries-Webkomponenten, Tag-Bibliotheken und JavaScript-Dateien (und aktualisiert alle JSP-Dateien entsprechend).
- Er regeneriert Dateien, die sich auf die Webinteraktion beziehen, auf der
Basis des Struts-Gerüsts aus den .wit-Dateien, und aktualisiert Laufzeitdateien
für die Webinteraktion.
- Er fügt Unterstützung für neue iSeries-Webtoolsfunktionen hinzu, die
in Version 6.0 verfügbar sind.
Phase 3: Adressierung von Fehlern
und Warnungen, die infolge der Migration generiert wurden
Treten während des Migrationsprozesses Fehler auf, wird ein Fenster
geöffnet, das angibt, dass Fehler oder Warnungen aufgetreten sind. Die
Migrationsprotokolldatei Projektname_MigrationDetails.txt,
die die Fehler beschreibt und die sich unter dem Projektnamen in der Webperspektive
befindet, wird ebenfalls geöffnet.
Der Abschnitt "Migrationsergebnis" am Anfang der Migrationsprotokolldatei
gibt den Gesamtstatus der Migration an und verweist auf eine Onlineversion der Tabelle
mit Warnungen und Fehlern weiter unten mit Beschreibungen und Korrekturmaßnahmen. Siehe Warnungen und Fehlernachrichten bei der Migration von Webprojekten.
Bei der 5.0.x.-Migration sollten Sie zusätzlich zu den Migrationswarnungen
in der Protokolldatei beachten, dass das Attribut für die maximale Länge
(maxLength) für die Webkomponente "Texteintrag" nicht mehr unterstützt wird. Dies
kann Auswirkungen auf die visuelle Darstellung Ihrer Webseiten haben.
iSeries-Webprojekte von Version 4.0 auf Version 6.0.1 migrieren
Die folgenden Informationen beschreiben die Migration von iSeries-Webprojekten von Development Studio Client für iSeries Version 4.0
auf WebSphere Development Studio Client für iSeries Version 6.0.1.
Die Migrationsaktivitäten umfassen die folgenden Phasen:
- Migration von Projekten unter Verwendung eines vorhandenen Webprojekts der
Version 4.0 in dem Dateisystem
- Migration des Inhalts von iSeries-Webprojekten
- Adressierung von Fehlern und Warnungen, die infolge der Migration generiert wurden
Phase 1: Migration eines vorhandenen Projekts der Version 4.0 in dem Dateisystem
auf Version 6.0.1
In Version 6.0.1 können die Standardordnernamen für Webinhalte und Java-Quelle für neue Webprojekte über eine Seite mit Einstellungen
konfiguriert werden. Die Standardnamen sind jetzt WebContent und JavaSource. Diese Standardnamen
werden nur für neue Webprojekte verwendet. Webprojekte, die in Versionen vor Version 6.0.1 erstellt
wurden, können weiterhin mit den alten Namen verwendet werden.
Führen Sie folgende Schritte aus, um den Inhalt des
Ordners mit Webinhalten zu migrieren:
- Beim Starten des Produkts der Version 6.0.1 (Start > Programme > IBM Rational > WebSphere Development Studio Client für iSeries) wird das Fenster des Startprogramms
für den Arbeitsbereich geöffnet, in dem Sie das Verzeichnis angeben können, das für die Sitzung
verwendet werden soll. Verwenden Sie die Standardposition als Arbeitsbereich.
- Wechseln Sie in die Ressourcenperspektive.
- Erstellen Sie ein neues dynamisches Webprojekt mit dem Namen und der Servletversion Ihres
vorhandenen Webprojekts der Version 4.0. Suchen Sie Ihre Servletversion in der Datei
.websettings Ihres vorhandenen Projekts der Version 4.0 und suchen Sie nach einem Tag jsp-level. Lautet der Wert für "jsp level" 1.2, setzen Sie die Servletversion auf
2.3. Andernfalls setzen Sie die Servletversion auf 2.2. Klicken Sie Fertig stellen an. Wechseln Sie nicht in die Webperspektive, wenn Sie aufgefordert werden.
- Wählen Sie den Ordner mit Webinhalten des neu erstellten Projekts aus, klicken Sie mit der
rechten Maustaste und wählen Sie Importieren aus dem Kontextmenü aus.
- Wählen Sie Dateisystem als Importquelle aus und klicken Sie
Weiter an. Klicken Sie den Knopf Durchsuchen an und wählen
Sie den Ordner mit Webinhalten (Standardname webApplication) des vorhandenen Webprojekts der Version 4.0 aus. Klicken Sie OK an.
- Wählen Sie den Ordner mit Webinhalten aus, aber markieren Sie nicht das
Kästchen. Klicken Sie Alles auswählen an. Wählen Sie im rechten
Fenster eine der Dateien ab und wählen Sie dann dieselbe Datei erneut aus. Dies hat den
Effekt, dass alles unter dem Ordner mit Webinhalten importiert wird, aber der Ordner mit
Webinhalten selbst nicht importiert wird.
- Wählen Sie die Optionen Nur ausgewählte Ordner erstellen und Vorhandene Ressourcen ohne Warnung überschreiben aus und klicken Sie Fertig stellen an. Der Ordner mit Webinhalten des neu erstellten Projekts
sollte jetzt ähnliche Ressourcen und eine ähnliche Ordnerstruktur wie der Ordner mit Webinhalten
der Version 4.0 enthalten.
Führen Sie folgende Schritte aus, um den Inhalt des Java-Quellenordners zu migrieren:
- Wählen Sie den Java-Quellenordner des neu erstellten Projekts aus, klicken Sie mit der
rechten Maustaste und wählen Sie Importieren aus dem Kontextmenü aus.
- Wählen Sie Dateisystem als Importquelle aus und klicken Sie
Weiter an. Klicken Sie den Knopf Durchsuchen an und wählen
Sie den Java-Quellenordner (Standardname: source)
des vorhandenen Webprojekts der Version 4.0 aus. Klicken Sie OK an.
- Wählen Sie den Java-Quellenordner aus, aber markieren Sie nicht das
Kästchen. Klicken Sie Alles auswählen an. Wählen Sie im rechten
Fenster eine der Dateien ab und wählen Sie dann dieselbe Datei erneut aus. Dies hat den
Effekt, dass alles unter dem Java-Quellenordner importiert wird, aber der Java-Quellenordner
selbst nicht importiert wird.
- Wählen Sie die Optionen Nur ausgewählte Ordner erstellen und Vorhandene Ressourcen ohne Warnung überschreiben aus und klicken Sie Fertig stellen an. Der Java-Quellenordner des neu erstellten Projekts
sollte jetzt ähnliche Ressourcen und eine ähnliche Ordnerstruktur wie der Java-Quellenordner der Version 4.0 enthalten.
Führen Sie folgende Schritte aus, um den Inhalt des
Webprojektordners zu migrieren:
- Wählen Sie jetzt das neu erstellte Projekt aus, klicken Sie mit der rechten Maustaste
und wählen Sie Importieren aus dem Kontextmenü aus.
- Wählen Sie Dateisystem als Importquelle aus und klicken Sie
Weiter an. Klicken Sie den Knopf Durchsuchen an
und wählen Sie das vorhandene Webprojekt der Version 4.0 aus.
- Wählen Sie den Projektordner im linken Fenster aus und klicken Sie Alles auswählen an. Wählen Sie im rechten Fenster eine der Dateien ab und wählen Sie
dann dieselbe Datei erneut aus. Wählen Sie im linken Fenster den Ordner mit Webinhalten
und den Java-Quellenordner
ab. Dies hat den Effekt, dass alles unter dem Webprojektordner importiert wird, aber der Ordner
mit Webinhalten und der Java-Quellenordner sowie der
Webprojektordner selbst nicht importiert werden.
- Wählen Sie im rechten Fenster die folgenden Dateien ab, wenn sie in der Liste erscheinen:
- \WebContent\.classpath
- \WebContent\.project
- \WebContent\.websettings
- \WebContent\.serverPreference
Diese Dateien enthalten Informationen zu dem Projekt, die zur
Entwicklungszeit erforderlich sind. Die Informationen können nicht auf Version 6.0.1
migriert werden. Die Dateien werden daher bei Bedarf erneut erstellt.
- Wählen Sie die Optionen Nur ausgewählte Ordner erstellen und Vorhandene Ressourcen ohne Warnung überschreiben aus und klicken Sie Fertig stellen an. Der neu erstellte Webprojektordner sollte jetzt ähnliche
Ressourcen und eine ähnliche Ordnerstruktur wie der Webprojektordner der Version 4.0 enthalten.
Phase 2: Migration des Inhalts von
iSeries-Webprojekten
Um den Inhalt eines iSeries-Webtoolsprojekts zu migrieren, gehen Sie wie
folgt vor:
- Klicken Sie mit der rechten Maustaste den Projektnamen in der Sicht
"Projektnavigator" der Webperspektive an und wählen Sie
Merkmale aus. Wählen Sie in der linken Anzeige
Funktionen des Webprojekts aus. Wählen Sie in der
Liste Verfügbare Funktionen des Webprojekts die
Option Struts aus, sofern diese noch nicht ausgewählt ist. Klicken
Sie OK an. Klicken Sie im Fenster "Funktionen des Webprojekts" Fertig
stellen an, um die standardmäßige Struts-Version (1.1) zu akzeptieren.
Anmerkung:
Wird dieser Schritt nicht ausgeführt, werden Sie in einem
Fenster aufgefordert, Struts-Unterstützung hinzuzufügen.
- Wichtig: An diesem Punkt müssen Sie das Projekt schließen und erneut
öffnen, um eine Ausnahmebedingung zu verhindern, die sich auf das Löschen von
Ressourcen bezieht, und um sicherzustellen, dass das Projekt auf keinen Servern
ausgeführt wird.
- Klicken Sie mit der rechten Maustaste den Projektnamen in der
Webperspektive an und wählen Sie Migrieren > iSeries-Webtoolsprojekt aus. Das Fenster "Migration bestätigen" zeigt
an, dass die Projektstruktur und der Projektinhalt migriert werden.
- Um den Prozess fortzusetzen, klicken Sie OK
an. In einem Fenster wird der Fortschritt der Migration angezeigt.
- Nach Abschluss der Migration zeigt eine Nachricht die Ergebnisse an.
- Wurde der Migrationsprozess erfolgreich abgeschlossen, ist keine weitere
Aktion erforderlich. Wurde der Migrationsprozess mit Fehlern oder Warnungen
beendet, fahren Sie mit Phase 3: Adressierung von Fehlern
und Warnungen, die infolge der Migration generiert wurden fort.
- Der Migrationsprozess führt die folgenden Aktionen aus:
- Er aktualisiert iSeries-Webkomponenten, Tag-Bibliotheken und JavaScript-Dateien (und aktualisiert alle JSP-Dateien entsprechend).
- Er regeneriert Dateien, die sich auf die Webinteraktion beziehen, auf der
Basis des Struts-Gerüsts aus den .wit-Dateien, und aktualisiert Laufzeitdateien
für die Webinteraktion.
- Er fügt Unterstützung für neue iSeries-Webtoolsfunktionen hinzu, die
in Version 6.0 verfügbar sind.
Phase 3: Adressierung von Fehlern
und Warnungen, die infolge der Migration generiert wurden
Treten während des Migrationsprozesses Fehler auf, wird ein Fenster
geöffnet, das angibt, dass Fehler oder Warnungen aufgetreten sind. Die
Migrationsprotokolldatei Projektname_MigrationDetails.txt,
die die Fehler beschreibt und die sich unter dem Projektnamen in der Webperspektive
befindet, wird ebenfalls geöffnet.
Der Abschnitt "Migrationsergebnis" am Anfang der Migrationsprotokolldatei
gibt den Gesamtstatus der Migration an und verweist auf eine Onlineversion der Tabelle
mit Warnungen und Fehlern weiter unten mit Beschreibungen und Korrekturmaßnahmen. Siehe Warnungen und Fehlernachrichten bei der Migration von Webprojekten.
Zusätzliche Überlegungen zur Migration
Zusätzlich zu den Migrationsfehlern, die in der oben beschriebenen Protokolldatei aufgelistet
sind, müssen Sie auch die folgenden Punkte beachten (sofern zutreffend):
- Stellen Sie sicher, dass Sie eine neue Version des Subdateiserviceprogramms
QDTSSFL auf Ihren iSeries-Host zurückspeichern. Dieses Serviceprogramm ist zum Bearbeiten
des Subdateibenutzeradressbereichs mit den Subdatei-APIs erforderlich.
Anweisungen zum Zurückspeichern des Serviceprogramms befinden sich unter
dem Hilfethema "Subdateiserviceprogramm QDTSSFL". Klicken Sie Hilfe > Inhaltsverzeichnis der Hilfetexte an. Klicken Sie dann Referenz
> Benutzerschnittstellenreferenz > iSeries-Webanwendungen > iSeries-Webkomponenten
> Subdatei-APIs an.
- Der Datenformatbereich, der von einem Hostprogramm für eine Webkomponente
"Kombiniertes Feld" zurückgegeben wird, kann jetzt eines von zwei Formaten haben. Daher
müssen Sie möglicherweise Ihr Programm ändern, um das gewünschte Datenformatergebnis
in dem kombinierten Feld zu erhalten. Weitere Informationen zu Datenformaten
enthält der Abschnitt "Registerkarte Daten" in der Onlinehilfe unter
Referenz > Benutzerschnittstellenreferenz
> iSeries-Webanwendungen > iSeries-Webkomponenten > Webkomponente "Kombiniertes Feld".
Zusätzlich zu den Migrationswarnungen, die in der Protokolldatei aufgelistet
sind, die in Phase 4 beschrieben wurde, sollten Sie die folgenden Änderungen
beachten, die die visuelle Darstellung Ihrer Webseiten beeinflussen können:
- Die folgenden Merkmale der Entwurfszeitsteuerangabe für Tabellen
werden in der entsprechenden Webkomponente "Tabelle" nicht mehr
unterstützt:
- Zellenauffüllung
- Zellenabstand
- Rahmengröße
- Ausrichtung
- Tabellenbreite
- Tabellenhöhe
- Die Merkmale "Zellenvordergrund" und "Zellenhintergrund" eines Tabellen-DTC
gelten nicht individuell für die Spaltenfarben einer Webkomponente "Tabelle".
Die Farbe, die für alle Spalten verwendet wird, ist die Farbe, die für die
erste Spalte der Tabelle definiert ist.
- Die Merkmale "Sichtbare Breite", "Großschreibung" und "Lesezugriff", die
einer Spalte "Eingabefeld" in einem Tabellen-DTC zugeordnet sind, werden in der
entsprechenden Spalte "Texteintrag" in einer Webkomponente "Tabelle" nicht
unterstützt.
- Der Knopf zum Zurückblättern, der Knopf zum Vorblättern und der Knopf für
Auswahlspalte im Subdatei-DTC werden in der entsprechenden Webkomponente
"Tabelle" nicht unterstützt.
- Feldnamenwerte, die in DTCs angegeben wurden, werden in Namenswerte in den entsprechenden
Webkomponenten migriert. Alle Punkte (.) werden in dem Namenswert durch
Unterstreichungszeichen (_) ersetzt. Außerdem kann das erste Zeichen des
Feldnamens für ein DTC im Namenswert für die entsprechende Webkomponente in
Kleinbuchstaben konvertiert werden.
- Sie können nicht mehr ein Webkomponentenattribut zur Laufzeit ändern, wenn eine
angegebene Bedingung auftritt. Wenn Sie mit der Registerkarte für die
DTC-Laufzeitattribute eine Bedingung definiert haben, die (wenn sie eintritt) ein
DTC-Attribut zur Laufzeit ändert (beispielsweise eine Änderung in der Schriftgröße),
wird das entsprechende Webkomponentenattribut nicht mehr geändert, wenn diese Bedingung
auftritt.
Warnungen und Fehlernachrichten bei der Migration von Webprojekten
Fehlercode |
Beschreibung |
Aktion |
E100 |
Während der Migration der JSP-Datei ist ein unbestimmter
Fehler aufgetreten. |
Beheben oder adressieren Sie alle anderen Fehler oder
Warnungen in der Migrationsprotokolldatei und führen Sie das Migrationstool
erneut aus. |
E101 |
Für eine iSeries-Webkomponente in der JSP-Datei liegt ein
Fehler vor. |
Beheben Sie den Fehler in der iSeries-Webkomponente. |
E200 |
Die Verarbeitung der .wit-Datei hatte einen unbestimmten
Fehler zur Folge. |
Klicken Sie die fehlerhafte .wit-Datei doppelt an, um den
Assistenten für Webinteraktion aufzurufen. Durchlaufen Sie
alle Seiten des Assistenten und führen Sie alle erforderlichen Änderungen durch. Klicken
Sie "Fertig stellen" an. |
E201 |
Ein oder mehrere Webkomponentennamen, die auf den in dieser
Interaktion verwendeten Seiten definiert sind, sind ungültig. |
Klicken Sie die fehlerhafte .wit-Datei doppelt an, um den
Assistenten für Webinteraktion aufzurufen. Ein Fenster, das angibt, dass
Webkomponentennamen ungültig sind, wird geöffnet, und Sie werden gefragt, ob die Namen geändert
werden sollen. Klicken Sie Ja an. Nehmen Sie alle erforderlichen Änderungen
vor. Für alle Webkomponenten, die geänderte Eingabe- oder Ausgabeparameter haben, geben Sie
die Optionen "Name in Sitzung", "In Sitzung sichern" und "Verbinden" an. Durchlaufen Sie
alle Seiten des Assistenten und führen Sie alle erforderlichen Änderungen durch. Klicken Sie "Fertig stellen"
an. |
E202 |
Für einen in dieser Interaktion definierten Ausgabeparameter
war der Wert für "Nachrichtenanzeiger" auf "wahr" gesetzt. Die erweiterte
Nachrichtenbehandlung hat sich in diesem Release entscheidend geändert. Sie
müssen die Optionen zur Nachrichtenbehandlung erneut definieren. |
Klicken Sie die fehlerhafte .wit-Datei doppelt an, um den
Assistenten für Webinteraktion aufzurufen. Setzen Sie auf der Seite
"Ausgabeparameter den Ausgabefeldern zuordnen und mit den Feldern verbinden"
den Wert für den Nachrichtenanzeiger auf "wahr". Sie können jetzt den Knopf sehen;
klicken Sie den Knopf an und definieren Sie die Nachrichtensteuerungsspezifikationen. |
E300 |
Beim Verarbeiten des DTC und/oder der resultierenden
iSeries-Webkomponente
ist ein unbestimmter Fehler aufgetreten. |
Beheben oder adressieren Sie alle anderen Fehler oder
Warnungen in der Migrationsprotokolldatei. Benennen Sie die
Migrationsprotokolldatei um und führen Sie das Migrationstool erneut aus. |
E301-E302 |
Das Merkmal der Entwurfszeitsteuerangabe für Druckknöpfe und
"Nächste/Vorherige" wird nicht mehr unterstützt. Das Attribut für die Knopfart der Webkomponente
"Knopf" wird mit "Übergeben" definiert. |
Erstellen Sie mit Hilfe des Assistenten für Webinteraktion
eine Interaktion, um die Seite, die den Knopf Nächste/Vorherige enthielt, als
Eingabe-JSP-Seite und die Zielseite des Knopfs "Nächste" als Ausgabe-JSP-Seite
anzugeben. In Version 4.0 wurde der Knopf Nächste/Vorherige mit mehreren
Eingabeseiten verwendet. Klicken Sie Hilfe >
Inhaltsverzeichnis der Hilfetexte an, um das Hilfesystem zu öffnen. Klicken Sie dann Referenz > Benutzerschnittstellenreferenz > iSeries-Webanwendungen > Mehrere Eingabe- und Ausgabeseiten an. |
E400 |
Während der Migration der Codegenerierungsschablonendatei
ist ein unbestimmter Fehler aufgetreten. |
Stellen Sie sicher, dass die Codegenerierungsschablonen nicht
schreibgeschützt sind. Adressieren Sie alle anderen Fehler oder
Warnungen in der Migrationsprotokolldatei und führen Sie das Migrationstool
erneut aus. |
E401 |
Die Codegenerierungsschablonendatei wurde angepasst.
Verwenden Sie die neuere Version der Schablone. |
Stellen Sie sicher, dass die Anpassungen, die Sie an der älteren Version
der Schablone vorgenommen haben, auch an der neueren Version der Schablone vorgenommen wurden.
Beispielsweise muss der angepasste Inhalt in <Position_des_Arbeitsbereichs>\metadata\ plugins\com.ibm.etools.iseries. webtools\iseriesPgmCallAction.
template.bak korrekt in <Position_des_Arbeitsbereichs>\metadata\ plugins\com.ibm.etools.iseries. webtools\iseriesPgmCallAction.
template eingefügt werden. |
Warncode |
Beschreibung |
Aktion |
W100 |
Für eine iSeries-Webkomponente auf der JSP-Seite liegt eine
Warnung vor. |
Adressieren Sie die Warnung für die iSeries-Webkomponente. |
W300 |
Ein Listenfenster oder ein kombiniertes Feld enthielt mehr
als ein Zeichen für das Merkmal "Begrenzer". Das erste im Merkmal "Begrenzer"
gefundene Zeichen wird für das entsprechende Attribut für den Begrenzer der
iSeries-Webkomponente
verwendet. |
Stellen Sie sicher, dass für alle Optionen der Webkomponente
"Auswahlfenster" oder "Kombiniertes Feld" die Attribute für den Namen und den Wert
korrekt definiert sind. |
W301-W302 |
Ein Listenfenster oder ein kombiniertes Feld enthielt das
Vorauswahlzeichen * in einem Datenmerkmal [Schlüssel] oder [Wert]. |
Stellen Sie sicher, dass für alle Optionen der Webkomponente
"Auswahlfenster" oder "Kombiniertes Feld" die Attribute für den Namen und den Wert
korrekt definiert sind. |
W303 |
Alle Radioknopf-DTCs in einer JSP-Datei, die dasselbe
Merkmal "Gruppenname" haben, werden jetzt als eine Option einer Webkomponente
"Radioknopfgruppe" angezeigt. Die auf der Registerkarte "Schriftart" und auf
der Registerkarte "Farbe" definierten Merkmale für den ersten auf der JSP-Seite
gefundenen Radioknopf werden als die Attribute für die Farbe und die Schriftart
für die Radioknopfgruppe verwendet. Das heißt, die Merkmale auf der
Registerkarte "Farbe" und der Registerkarte "Schriftart" gehen für nachfolgende
Radioknöpfe in derselben Gruppe verloren. |
Stellen Sie sicher, dass die Radioknopfgruppe wie gewünscht
auf der JSP-Seite angezeigt wird, indem Sie die zugehörige JSP-Datei auswählen
und die Datei auf dem Server ausführen. Stellen Sie sicher, dass die Attribute
für die Schriftart und die Farbe für die Radioknopfgruppe wie gewünscht
erscheinen, indem Sie die zugehörige JSP-Datei auswählen und auf dem Server
ausführen. |
W304 |
Das Merkmal "Bezeichnung" für den Druckknopf wird nicht mehr
unterstützt. Das Merkmal "Wert" für den Druckknopf wurde dem Attribut
"Bezeichnung" der zugehörigen Webkomponente "Knopf" zugeordnet. Der Text, der
auf der Webkomponente "Knopf" angezeigt wird, ist nicht mit dem Text für die
Entwurfszeitsteuerangabe "Druckknopf" identisch. |
Ändern Sie den Wert des Attributs "Bezeichnung", wenn der
auf der Webkomponente "Knopf" angezeigte Text nicht geeignet ist. |
W305 |
Die Entwurfszeitsteuerangabe "Subdatei" oder "Tabelle"
wird jetzt außerhalb des HTML-Tags FORM angezeigt. Eine Webkomponente "Tabelle" kann nicht innerhalb
eines HTML-Tags FORM angezeigt werden. War der Typ der Entwurfszeitsteuerangabe "Subdatei",
ist die entsprechende iSeries-Webkomponente eine Webkomponente "Tabelle". |
Stellen Sie sicher, dass die Webkomponente "Tabelle" wie
gewünscht auf der JSP-Seite angezeigt wird. |
W306-W320 |
Ein DTC-Ereignismerkmal wird nicht mehr unterstützt.
- W306 - OnDblClick
- W307 - OnMouseDown
- W308 - OnMouseOut
- W309 - OnMouseOver
- W310 - OnSelect
- W312 - OnChange für Radioknöpfe
- W313 - OnChange für Markierungsfelder
- W314 - OnMouseUp
- W315 - OnKeyDown für Radioknöpfe
- W316 - OnKeyPress für Radioknöpfe
- W317 - OnKeyUp für Radioknöpfe
- W318 - OnKeyDown für Druckknöpfe
- W319 - OnKeyPress für Druckknöpfe
- W320 - OnKeyUp für Druckknöpfe
|
Definieren Sie, falls erforderlich, die zugehörige Aktion
mit einem anderen Ereignis. |
W321 |
Für die Webkomponente war ein Attribut definiert, das nicht
mehr unterstützt wird, da 1) das zugehörige CSS-Attribut von den meisten
Browsern nicht unterstützt wird 2) das zugehörige HTML-Attribut bereits in
HTML 4.0 veraltet ist und von den meisten Browsern nicht unterstützt wird. |
Keine. |
Bemerkungen
Die vorliegenden Informationen wurden für Produkte und Services entwickelt,
die auf dem deutschen Markt angeboten werden. Möglicherweise bietet
IBM die in dieser Dokumentation beschriebenen Produkte, Services oder Funktionen in
anderen Ländern nicht an. Informationen über die gegenwärtig im jeweiligen Land
verfügbaren Produkte und Services sind beim IBM Ansprechpartner erhältlich. Hinweise auf IBM Lizenzprogramme
oder andere IBM Produkte bedeuten nicht, dass nur Programme, Produkte oder Services von IBM verwendet werden können. Anstelle der
Produkte, Programme oder Services können auch andere ihnen äquivalente Produkte, Programme oder
Services verwendet werden, solange diese keine gewerblichen oder andere Schutzrechte der
IBM verletzen. Die
Verantwortung für den Betrieb von Fremdprodukten, Fremdprogrammen und
Fremdservices liegt beim Kunden.
Für die in diesem Handbuch beschriebenen Erzeugnisse und Verfahren kann es
IBM Patente oder Patentanmeldungen geben. Mit der Auslieferung dieser
Dokumentation ist keine Lizenzierung dieser Patente verbunden.
Lizenzanforderungen sind schriftlich an folgende Adresse zu richten (Anfragen
an diese Adresse müssen auf Englisch formuliert
werden):
IBM Europe
Director of Licensing
92066 Paris La Defense Cedex
France
Trotz sorgfältiger Bearbeitung können technische Ungenauigkeiten oder
Druckfehler in dieser Veröffentlichung nicht ausgeschlossen werden. Die Angaben
in diesem Handbuch werden in regelmäßigen Zeitabständen aktualisiert. Die
Änderungen werden in Überarbeitungen oder in Technical News Letters (TNLs)
bekannt gegeben. IBM
kann ohne weitere Mitteilung jederzeit Verbesserungen
und/oder Änderungen an den in dieser Veröffentlichung beschriebenen Produkten
und/oder Programmen vornehmen.
Verweise in diesen Informationen auf Websites anderer Anbieter dienen
lediglich als Benutzerinformationen und stellen keinerlei Billigung des Inhalts
dieser Websites dar. Das über diese Websites verfügbare Material ist nicht
Bestandteil des Materials für dieses
IBM Produkt. Die Verwendung dieser Websites geschieht auf eigene Verantwortung.
Werden an IBM Informationen eingesandt, können diese beliebig verwendet
werden, ohne dass eine Verpflichtung gegenüber dem Einsender entsteht.
Lizenznehmer des Programms, die Informationen zu diesem Produkt wünschen mit
der Zielsetzung: (i) den Austausch von Informationen zwischen unabhängigen,
erstellten Programmen und anderen Programmen (einschließlich des vorliegenden
Programms) sowie (ii) die gemeinsame Nutzung der ausgetauschten Informationen
zu ermöglichen, wenden sich an folgende Adresse:
Lab Director
IBM Canada Ltd. Laboratory
8200 Warden Avenue
Markham, Ontario, Canada L6G 1C7
Die Bereitstellung dieser Informationen kann unter Umständen von bestimmten
Bedingungen - in einigen Fällen auch von der Zahlung einer Gebühr - abhängig
sein.
Die Lieferung des im Handbuch aufgeführten Lizenzprogramms sowie des
zugehörigen Lizenzmaterials erfolgt im Rahmen der IBM Kundenvereinbarung, der
Internationalen Nutzungsbedingungen der IBM für
Programmpakete oder einer äquivalenten Vereinbarung.
Alle Informationen zu Produkten anderer Anbieter stammen von den Anbietern
der aufgeführten Produkte, deren veröffentlichten Ankündigungen oder anderen
allgemein verfügbaren Quellen. IBM hat diese Produkte nicht getestet und kann
daher keine Aussagen zu Leistung, Kompatibilität oder anderen Merkmalen machen.
Fragen zu den Leistungsmerkmalen von Produkten anderer Anbieter sind an den
jeweiligen Anbieter zu richten.
Diese Veröffentlichung enthält Beispiele für Daten und Berichte des
alltäglichen Geschäftsablaufes. Sie sollen nur die Funktionen des
Lizenzprogrammes illustrieren; sie können Namen von Personen, Firmen, Marken
oder Produkten enthalten. Alle diese Namen sind frei erfunden; Ähnlichkeiten
mit tatsächlichen Namen und Adressen sind rein zufällig.
COPYRIGHTLIZENZ
Diese Veröffentlichung enthält Musteranwendungsprogramme, die in
Quellensprache geschrieben sind. Sie dürfen diese Musterprogramme kostenlos
kopieren, ändern und verteilen, wenn dies zu dem Zweck geschieht,
Anwendungsprogramme zu entwickeln, verwenden, vermarkten oder zu verteilen, die
mit der Anwendungsprogrammierschnittstelle konform sind, für die diese
Musterprogramme geschrieben werden. Diese Beispiele wurden nicht unter allen
denkbaren Bedingungen getestet. Daher kann IBM die Zuverlässigkeit, Wartungsfreundlichkeit
oder Funktion dieser Programme weder zusagen noch gewährleisten.
Kopien oder Teile der Musterprogramme bzw. daraus
abgeleiteter Code müssen folgenden Copyrightvermerk beinhalten:
(Name Ihrer Firma) (Jahr). Teile des vorliegenden Codes wurden aus
Musterprogrammen der IBM Corp.
abgeleitet. (C) Copyright IBM Corp. 2000, 2005. Alle
Rechte vorbehalten.
Informationen zur Programmierschnittstelle
Informationen zur Programmierschnittstelle sollen den Benutzer bei der
Erstellung von Anwendungssoftware unter Verwendung dieses Programms
unterstützen.
Allgemeine Programmierschnittstellen erlauben es Ihnen, Anwendungssoftware
zu schreiben, die die Services der Tools dieser Programme nutzen.
Diese Informationen können jedoch auch Diagnose-, Änderungs- und
Optimierungsinformationen enthalten. Diagnose-, Änderungs- und
Optimierungsinformationen werden zur Verfügung gestellt, um Sie beim Testen
Ihrer Anwendungssoftware zu unterstützen.
Warnung: Verwenden Sie diese Diagnose-, Änderungs-
und Optimierungsinformationen nicht als Programmierschnittstelle, da sie
Änderungen unterliegen!
Marken und Servicemarken
Folgende Namen sind in gewissen Ländern Marken der International Business
Machines Corporation:
Java und alle Java-basierten Marken und Logos sind in gewissen Ländern
Marken oder eingetragene Marken von Sun Microsystems, Inc.
Rational ist in gewissen Ländern eine Marke der International Business
Machines Corporation und der Rational Software Corporation.
Andere Namen von Unternehmen, Produkten oder Services können
Marken oder Servicemarken anderer Unternehmen sein.
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.