i-Projektteildateien kompilieren

Informationen zu diesem Vorgang

Sie können eine oder mehrere Teildateien gleichzeitig in einem i-Projekt kompilieren, die entweder an einen Stapeljob übergeben oder sofort kompiliert werden. Beim Kompilieren werden standardmäßig zuerst alle Änderungen, die in dem Projekt vorgenommen wurden, von der Workbench auf den IBM® i-Server gestellt, und dann die ausgewählten Teildateien kompiliert. Sie können die Erstellungs- und Kompilieroptionen in den Einstellungen für die i-Projekte ändern. Die folgenden beiden Optionen sind verfügbar: Alle geänderten Ressourcen in dem Projekt mit Push übertragen (Standardoption) und Ausgewählte Ressourcen mit Push übertragen, sofern sie Änderungen enthalten.
Gehen Sie wie folgt vor, um eine einzelne Teildatei zu kompilieren:
  1. Erweitern Sie Ihr i-Projekt, bis die Teildatei angezeigt wird, die kompiliert werden soll.
  2. Klicken Sie mit der rechten Maustaste, wählen Sie Ferne Aktionen aus und wählen Sie dann eine der folgenden Aktionen aus:
    • Kompilieren, um die Teildatei ohne Bedienerführung zu kompilieren. Die Teildatei wird mit dem aktuellen Kompilierbefehl für ihren Quellentyp kompiliert.
    • Kompilieren (Bedienerführung), um die Teildatei mit Bedienerführung zu kompilieren, d. h., um zusätzliche Parameter anzugeben.
    • Kompilierbefehl auswählen, um einen bestimmten Befehl als aktuellen Befehl für diesen Quellentyp zu definieren.
    • Mit Kompilierbefehlen arbeiten, um zugeordnete Kompilierbefehle hinzuzufügen, zu ändern oder zu löschen.
Gehen Sie wie folgt vor, um mehrere Teildateien zu kompilieren:
  1. Erweitern Sie Ihr i-Projekt, bis die Teildateien angezeigt werden, die kompiliert werden sollen.
  2. Wählen Sie die Teildateien aus, indem Sie die Taste "Strg" gedrückt halten und auf jede Teildatei klicken.
  3. Klicken Sie mit der rechten Maustaste, wählen Sie Ferne Aktionen aus und wählen Sie dann eine der folgenden Aktionen aus:
    • Kompilieren, um einen Kompilierbefehl für jede ausgewählte Teildatei entsprechend der Reihenfolge zu übergeben, die auf ihrem Typ basiert. (Diese Reihenfolge kann mit den Einstellungen wie unten erwähnt geändert werden. Siehe Einstellungen für Kompilierreihenfolge ändern unten auf dieser Seite.) Die Teildateien werden dann mit dem aktuellen Kompilierbefehl für ihren Quellentyp kompiliert.
    • Mit Kompilierbefehlen arbeiten, um zugeordnete Kompilierbefehle hinzuzufügen, zu ändern oder zu löschen.

Nächste Schritte

Stapelbetrieb oder Direktmodus:

  • Wenn Sie im Stapelbetrieb kompilieren, werden alle ausgewählten Teildateien in einem einzelnen Stapeljob kompiliert. Der Fortschritt des übergebenen Jobs wird in der Sicht "Jobstatus" angezeigt.
  • Wenn Sie im Stapelbetrieb kompilieren und OPTION(*EVENTF) in Ihren Kompilierbefehlen verwenden, werden die Kompilierfehler in einer kombinierten Ereignisdatei zusammengestellt, die nach der Ausführung der Aktion abgerufen werden kann. Sie können die Compilerfehler abrufen, indem Sie mit der rechten Maustaste auf die Jobkennung in der Sicht Jobstatus klicken und Taskaktionen > Fehler abrufen auswählen.
  • Wenn Sie im Direktmodus kompilieren, werden die Kompilierbefehle fortlaufend übergeben. Alle Kompilierfehler werden in einem separaten Register für jede Teildatei in der Fehlerliste angezeigt.
Sie können die Einstellung für Stapelbetrieb oder Direktmodus auf der Einstellungsseite für den Erstellungsstil ändern. Klicken Sie im Workbench-Menü auf Fenster > Einstellungen. Erweitern Sie dann i-Projekte und wählen Sie Erstellung und Kompilierung aus. Beachten Sie das Markierungsfeld für Kompilierungen als Stapeljobs ausführen. Falls ausgewählt, werden Kompilierungen aus i-Projekten in einem Stapeljob übergeben. Falls abgewählt, werden Kompilierungen im Direktmodus ausgeführt.

Einstellungen für Kompilierreihenfolge ändern:

Werden mehrere Quellenteildateien gleichzeitig kompiliert, entspricht die Reihenfolge, in der die Quellenteildateien kompiliert werden, der Sortierfolge der Teildateitypen auf der Einstellungsseite für die IBM i-Befehlsausführung. Um auf diese Einstellungsseite zuzugreifen, klicken Sie im Workbench-Menü auf Fenster > Einstellungen. Erweitern Sie dann Ferne Systeme > IBM i und klicken Sie auf Befehlsausführung. In dem Bereich Teildateitypen in dieser Reihenfolge kompilieren können Sie verschiedene Teildateitypen auswählen und die Teildateitypen in der Hierarchieliste nach oben oder unten verschieben.

Projekterstellungen anpassen, die den Erstellungsstil "CL-Programm" verwenden:

Soll eine Erstellung übergeben werden, nachdem die Teildatei COMPILE.CLLE manuell generiert oder editiert wurde, klicken Sie mit der rechten Maustaste auf das Projekt und klicken Sie dann auf Ferne Aktionen > Erstellung übergeben. Die Teildatei COMPILE.CLLE wird kompiliert und die Teildatei BIND.CLLE (falls vorhanden) wird ebenfalls kompiliert. Das Programm COMPILE wird dann ausgeführt. Das Programm BIND (falls vorhanden) wird nach dem Programm COMPILE ausgeführt, aber nur dann, wenn während der Ausführung des Programms COMPILE keine Kompilierfehler gefunden wurden. Dies wird durch Überprüfen des Werts der Umgebungsvariablen QRB_NUMBER_FAILED bestimmt. Soll das Programm BIND auch dann ausgeführt werden, wenn Kompilierfehler vorhanden sind, können Sie diese Umgebungsvariable auf 0 am Ende des Programms COMPILE setzen oder einfach die Anweisungen entfernen, die es aktualisieren.

Das Erstellen oder Ändern von Dateien stellt ein Problem dar, da kein Parameter *REPLACE für die Befehle zum Erstellen von Dateien vorhanden ist. Diese erfordern möglicherweise eine angepasste Erstellungsprozedur. Benutzer können COMPILE.CLLE ändern, so dass entweder generierte Dateien vor ihrer erneuten Erstellung gelöscht werden, oder ein Test CHKOBJ verwendet wird, um einen anderen Befehl auszuführen (beispielsweise CHGPF an Stelle von CRTPF). Logische Dateien, die über diese physischen Dateien erstellt werden, verhindern möglicherweise beliebige Änderungen, so dass sie eventuell zuerst gelöscht werden müssen.

Enthalten die physischen Dateien Daten, müssen Benutzer möglicherweise spezielle Vorsichtsmaßnahmen treffen, damit diese Daten erhalten bleiben. Eine Möglichkeit besteht darin, die alte Datei umzubenennen und dann den Inhalt wieder in die generierte Datei zu kopieren, wobei die Felder während des Kopiervorgangs abgeglichen werden.

Anmerkung: Es wird empfohlen, dass physische Dateien, logische Dateien und Programmdateien in ihren eigenen Projekten separat gehalten werden, damit sie separat erstellt werden können. Alle Projekte können derselben Bibliothek zugeordnet werden.

Wenn Sie eine angepasste Teildatei COMPILE.CLLE schreiben, stellen Sie sicher, dass Sie deren automatische Generierung für dieses Projekt in den Projektmerkmalen inaktivieren.


Feedback