Artefakt zu Rational Team Concert hinzufügen

Das Hinzufügen eines Artefakts zu Rational Team Concert bedeutet, ein mit Rational Developer für System z erstelltes Artefakt zu verwenden und dieses für die Quellcodeverwaltung von Rational Team Concert verfügbar zu machen.

Für dieses Beispiel wird zunächst mit Rational Developer für System z ein COBOL-Programm erstellt und zu Ihrem Repository für Quellcodeverwaltung in Rational Team Concert hinzufügt. Das Hinzufügen von Membern partitionierter Dateien aus Rational Developer für System z zu Rational Team Concert erfolgt mit dem Assistenten Member als zFiles gemeinsam nutzen.

Führen Sie die folgenden Schritte aus. (Diese Schritte verwenden zur Veranschaulichung Beispiele aus dem Lernprogramm.)

  1. Wählen Sie in der Ansicht 'Ferne Systeme' das erstellte COBOL-Programm im Ladeabschnitt des Beispiels aus, klicken Sie mit der rechten Maustaste und wählen Sie PDS-Member erstellen aus.
    Menü des Remote System Explorer mit der Option 'PDS-Member erstellen'
  2. Geben Sie im Feld Member-Name in der Anzeige Neuer PDS-Member einen Namen ein und klicken Sie auf Fertigstellen. Für dieses Beispiel erhielt das neue Programm den Namen Goodbye.
    Anzeige 'PDS-Member erstellen' mit dem neuen COBOL-Programmnamen 'Goodbye' im Feld 'Member-Name'
    Das neue COBOL-Programm wird in demselben Datensatz angezeigt wie das Programm HELLO.cbl.
    Remote System Explorer mit dem neuen Programm 'GOODBYE.cbl' in demselben Datensatz wie 'HELLO.cbl'
  3. Fügen Sie das neue Programm Ihrem MVS-Unterprojekt hinzu, indem Sie es aus der Ansicht 'Ferne Systeme' in das Unterprojekt in der Ansicht 'z/OS-Projekte' ziehen.
    Ansicht 'z/OS-Projekt' mit dem neuen Programm 'GOODBYE.cbl' in demselben MVS-Unterprojekt wie 'HELLO.cbl.' Das neue Programm zeigt nicht denselben Dekorator wie das vorhandene Programm, weil es noch nicht der Quellcodeverwaltung von Rational Team Concert unterliegt
    Anmerkung: Das neue Programm BGREEN.BLD.COBOL(GOODBYE.cbl) verfügt nicht über denselben Gold-File-Dekorator wie BGREEN.BLD.COBOL(HELLO.cbl), weil es noch nicht der Quellcodeverwaltung von Rational Team Concert unterliegt.
Führen Sie die folgenden Schritte aus, um das Programm zur Quellcodeverwaltung von Rational Team Concert hinzuzufügen:
  1. Klicken Sie im MVS-Unterprojekt in der Ansicht 'z/OS-Projekte' mit der rechten Maustaste auf BGREEN.BLD.COBOL(GOODBYE.cbl) und wählen Sie zComponent > Member als zFiles gemeinsam nutzen aus.
    Ansicht 'z/OS-Projekte' mit dem Menü zur Auswahl von 'Member als zFiles gemeinsam nutzen'
  2. Standardmäßig ist der Name des Programms, das hinzugefügt werden soll, in der ersten Anzeige des Assistenten Member als zFiles gemeinsam nutzen bereits ausgewählt. Klicken Sie auf Weiter.
  3. Wählen Sie das zComponent-Projekt für das neue Programm aus und klicken Sie auf Weiter. Sie können auch ein zComponent-Projekt erstellen. Für dieses Beispiel wird jedoch das Projekt verwendet, das in COBOL-Anwendung mit dem Rational Build Agent und Ant mit Enterprise Extensions kompilieren erstellt wurde.
    Anzeige 'zComponent-Projekt auswählen' mit dem vorhandenen zComponent-Projekt und der Option zum Erstellen eines zComponent-Projekts
  4. Wählen Sie in der Anzeige zComponent-Projekt im Jazz-Repository gemeinsam nutzen die Komponente aus, die das Programm HELLO.cbl enthält. Klicken Sie auf Weiter.
    Anzeige 'zComponent-Projekt im Jazz-Repository gemeinsam nutzen' mit Jazz-Repository und -Komponente in einem vorhandenen Repository-Arbeitsbereich
  5. Klicken Sie in der Anzeige 'Build-Kontext definieren' auf Durchsuchen und wählen Sie eine Build-Definition aus. Wählen Sie für dieses Beispiel Mortgage-Team-Build aus.
    Anzeige 'Build-Definition auswählen' mit der Build-Definition 'Mortgage-Team-Build'
    Klicken Sie auf OK > Weiter. Die Build-Definition wird dem Repository-Arbeitsbereich von Rational Team Concert zugeordnet.
    Anmerkung: Nachdem Sie den Assistenten zFiles in z/OS laden oder Member als zFiles gemeinsam nutzen ausgeführt und eine Build-Definition für einen Repository-Arbeitsbereich ausgewählt haben, wird die Build-Definition diesem Repository-Arbeitsbereich zugeordnet. In allen nachfolgenden Ausführungen des Assistenten werden die Details der zugeordneten Build-Definition angezeigt, diese können aber nicht geändert werden. Sie können den Build-Kontext löschen, indem Sie die Verbindung aller Member trennen.
  6. Eine Build-Definition gibt in der Regel das Präfix an, das im Team-Build verwendet wird. Um sicherzustellen, dass Sie an Ihren Artefakten isoliert arbeiten können, ändern Sie das in der Build-Definition angegebene Präfix in ein eigenes Präfix. Wählen Sie dazu teamz.scm.dataset.prefix in der Liste Build-Eigenschaften aus und klicken Sie auf Bearbeiten.
  7. Wählen Sie in der Anzeige Eigenschaftstyp auswählen in der Liste der neuen Eigenschaftstypen Zeichenfolge aus und klicken Sie auf OK.
    Anzeige 'Eigenschaftstyp auswählen' mit einer Liste von Optionen für den Typ der neuen Eigenschaft
  8. Ändern Sie den Wert in der Anzeige Eigenschaft für Build-Anforderung bearbeiten von MASAO.BLD in Ihr Präfix und klicken Sie auf OK. (Für dieses Beispiel wurde der Wert in BGREEN.BLD geändert.)
    Anzeige 'Eigenschaft für Build-Anforderung bearbeiten' mit dem geänderten Wert BGREEN.BLD
    Wichtig: Vergewissern Sie sich, dass die Berechtigungsnachweise, die Sie verwendet haben, um die RSE-Verbindung zum Host herzustellen, über die erforderliche Berechtigung zum Erstellen und Modifizieren eines Datensatzes mit dem im Wertefeld angegebenen Präfix verfügen.
  9. Klicken Sie auf Weiter.

Wenn das neue Programm dem zComponent-Projekt hinzugefügt wird, wird es in einen zFolder gestellt. Dieser zFolder muss einer Dateigruppendefinition zugeordnet sein.

Sie können die Zuordnungen der Dateigruppendefinition ändern. Die für dieses Beispiel verwendete Anzeige zeigt den richtigen Datensatznamen (BGREEN.BLD.COBOL) an, aber eine falsche Repository-Dateigruppendefinition (BMS).

Anzeige 'Datensatzdefinitionen zuordnen' mit der falschen Dateigruppendefinition 'BMS'

Führen Sie die folgenden Schritte aus, um die Zuordnung zu ändern:
  1. Klicken Sie in der Anzeige Datensatzdefinitionen zuordnen auf die Schaltfläche <...> unter Durchsuchen.
  2. Wählen Sie die Dateigruppendefinition COBOL aus und klicken Sie auf OK.
    Anzeige 'Datensatzdefinition auswählen' mit ausgewählter Option 'COBOL' für die Dateigruppendefinition
  3. Sie können Sprachendefinitionen zuordnen, wenn Sie Dateigruppendefinitionen zuordnen. Wenn Sie hier keine Sprachendefinitionen zuordnen, müssen Sie allen Dateien für den Build vor der Ausführung des Builds eine Sprachendefinition zuordnen.
  4. Überprüfen Sie in der aktualisierten Anzeige Datensatzdefinitionen zuordnen, ob die Repository-Dateigruppendefinition richtig ist. Für dieses Beispiel lautet sie COBOL.
    Anzeige 'Datensatzdefinitionen zuordnen' mit der richtigen Repository-Dateigruppendefinition 'COBOL'
  5. Auf der letzten Seite des Assistenten Member als zFiles gemeinsam nutzen haben Sie die Möglichkeit, Member zu kopieren oder zu verschieben. Wenn Sie Kopieren auswählen, bleibt der Member in seiner ursprünglichen Dateigruppe, und an die neue Position, die durch die Dateigruppendefinition und das Präfix angegeben wird, wird eine Kopie gestellt. Wenn Sie Verschieben auswählen, wird der Member verschoben und aus dem ursprünglichen Datensatz gelöscht.
  6. Klicken Sie auf Fertigstellen.

Prüfen, ob die gemeinsame Nutzung erfolgreich war

Vergewissern Sie sich im Projektexplorer, dass das Programm GOODBYE.cbl zum zComponent-Projekt hinzugefügt wurde.
Ansicht 'Projektexplorer' mit 'GOODBYE.cbl' im zComponent-Projekt
Tipp: Wenn der Assistent Member als zFiles gemeinsam nutzen mit einem Fehler endet, öffnen Sie die Datei '.log' im Metadatenordner in Ihrem Eclipse-Arbeitsbereich, um weitere Informationen zu erhalten.

Feedback