High Level Assembler-Codeänderungen erstellen

Wenn Sie die Quelle anzeigen, können Sie die Gliederungsansicht verwenden, um im Code des Programms effizient zu navigieren und den Code zu durchsuchen. Wenn Sie die Elemente in dieser Ansicht ansehen, können Sie sich eine Vorstellung davon machen, wie das Programm im Allgemeinen funktioniert und auf einfache Weise zu relevanten CSECT-, DSECT-, MACRO-Anweisungen sowie Verzweigungsbezeichnungen navigieren. Wir haben uns bewusst dafür entschieden, nicht jedes Symbol einzubeziehen, denn in großen Assembler-Programmen würde die Gliederungsansicht zu unübersichtlich werden. Anweisungen zum Anpassen der in der Gliederung angezeigten Informationen finden Sie hier.

Informationen zur Verwendung

Sie können die Gliederungsansicht nur verwenden, nachdem Sie eine Datei oder ein Programm geöffnet haben. Wenn die Gliederungsansicht nicht bereits erweitert ist, können Sie sie öffnen, indem Sie auf Anzeigen > Ansicht öffnen > Gliederung klicken.

Sie können diese Ansicht zu folgenden Zwecken verwenden:

• Schnelles Erkennen von CSECT-, DSECT- und MACRO-Anweisungen über die Symbole in der Gliederungsansicht

• Wechseln zu einer gewünschten Position im Code durch Klicken auf die Abschnittsübersicht in der Ansicht

• Sortierung nach Position, Name oder Typ

• Suche nach IDs in der Gliederung durch Drücken der Tastenkombination Strg+Umschalttaste+O (Windows) oder Cmd+Umschalttaste+O (Mac) im Editorfenster

Wenn Sie den Cursor über das Programm bewegen, werden die Gliederungsknoten automatisch ausgewählt. Um diese und andere Funktionen in Zusammenhang mit der Gliederungsansicht ein- und auszuschalten, bewegen Sie den Mauszeiger über die obere rechte Ecke der Gliederungsansicht. Sie können die Option ... sehen, auf die Sie klicken können, um mehrere Optionen zu suchen, um Ihre Gliederungsansicht zu organisieren, wie z. B. 'Cursor folgen', 'Nach Typ filtern' und 'Nach Name sortieren, 'Position' und 'Typ'.

Wenn Sie Code eingeben, stellt der Codevervollständigungsvorschlag eine passende Liste zur Verfügung, aus der Sie Operationen und Beschriftungen auswählen können. Die Codevervollständigung für Symbole funktioniert derzeit nur in einer einzigen Datei. Es wird daran gearbeitet, diese Funktion auf mehrere Dateien zu erweitern.

Informationen zur Verwendung

Der Vorschlag zur Codevervollständigung wird automatisch angezeigt, wenn Sie Eingaben in einem geeigneten Kontext vornehmen.

Sie können die Kurzinfos für Operationen und Operanden anzeigen, indem Sie den Mauszeiger über die Operation oder den Operanden bewegen.

Informationen zur Verwendung

Kurzinfos zu Operationen und Operanden sind standardmäßig aktiviert. Bewegen Sie einfach den Mauszeiger über eine Operation oder einen Operanden. Wenn der Operand oder die Operation definiert ist, wird eine Kurzinfo angezeigt.

Um eine Vorschau des Inhalts einer COPY-Anweisung anzuzeigen, bewegen Sie den Mauszeiger über den Copybook-Namen. Wenn das Copybook nicht aufgelöst werden kann, wird der Copybook-Name zur Warnung gelb unterstrichen. Wenn Sie Copybooks auflösen möchten, müssen Sie spezielle Einstellungen festlegen. Konkret geht es umDer Abschnitt zopeneditor.propertygroups der Datei 'settings.json' muss festgelegt werden. Lesen Sie den Abschnitt unten, um zu erfahren, wie Sie diese Einstellung festlegen.

Informationen zur Verwendung

Sie müssen den Dateipfad zu den Copybooks oder Include-Dateien in Ihren Einstellungen angeben, um die Referenzen aufzulösen. Wenn kein Dateipfad angegeben ist oder die Copybooks oder Include-Dateien im angegebenen Dateipfad nicht gefunden werden, wird ein Fehler (rote verschnörkelte Linie) angezeigt.

Um dies zu beheben, fügen Sie den Dateipfad zu den Referenzen im Abschnitt zopeneditor.propertygroups Ihrer settings.json-Einstellungen wie folgt hinzu.

1. Öffnen Sie Ihre Einstellungen:

   • Windows: Datei > Benutzervorgaben > Einstellungen

   • Mac: Code > Benutzervorgaben > Einstellungen

2. Erweitern Sie auf der linken Seite der geöffneten Schnittstelle 'Einstellungen' den Eintrag Erweiterungen aus der Liste der Kategorien und klicken Sie auf IBM Z Open Editor. Klicken Sie in den Einstellungen für IBM Z Open Editor unter Eigenschaftsgruppen auf In settings.json bearbeiten, um die Datei settings.json zu öffnen.

3. Bearbeiten Sie die Datei settings.json, um Dateipfade für Ordner anzugeben, die Copybooks oder Include-Dateien im Feld Syslib enthalten. Sie können den Mauszeiger über die Feldnamen (z. B. name, type) bewegen, um Details zu der Art der Informationen anzuzeigen, die für jedes Feld erwartet werden.

   Sie können sich auf die Beispiele und die unterstützten Muster in Eigenschaftsgruppen festlegen beziehen.

4. Speichern Sie die Datei settings.json, indem Sie Datei > Speichern wählen.

Wenn Sie Zowe™ CLI installiert haben, können Sie einen Suchpfad definieren, um Copybooks über das Netz gegen Ihre fernen MVS™-Dateien oder sogar USS-Verzeichnisse (nur COBOL im Moment) aufzulösen.

Um die Datei in einem separaten Editor zu öffnen, drücken Sie Strg+Klicken (Windows) oder Cmd+Klicken (Mac).

Wenn Sie doppelt auf ein Symbol klicken, um den gesamten Namen hervorzuheben, und mit der rechten Maustaste darauf klicken, können Sie die verfügbaren Operationen anzeigen.

Informationen zur Verwendung

• Klicken Sie auf Alle Vorkommen ändern: Strg+F2 (Windows) oder Strg+F2 (Mac)

  Wenn Sie den neuen Namen eingeben, werden alle Vorkommen gleichzeitig geändert.

  HINWEIS: In der Bildlaufleiste auf der rechten Seite des Editors wird jedes Auftreten mit einer Positionsleiste notiert.

• Klicken Sie auf Alle Referenzen suchen: Alt+Umschalttaste+F12 (Windows) oder Option+Umschalttaste+F12 (Mac)

  Auf der linken Seite des Bildschirms wird eine Ergebnisreferenzenansicht für die Variable oder den Absatz angezeigt. Klicken Sie auf ein beliebiges Ergebnis, um zu dieser Position in der Datei zu wechseln.

• Klicken Sie auf Peek-Referenzen: Umschalttaste+F12 (Windows und Mac)

  Dadurch wird eine Ergebnisreferenzenansicht im CodeLens-Feld unterhalb der Variable oder des Absatzes geöffnet. Klicken Sie auf ein beliebiges Ergebnis, um zu dieser Position in der Datei zu wechseln.

  

• Klicken Sie auf Zur Definition wechseln: F12 (Windows und Mac)

  Wechseln Sie zu der Position, an der die Variable oder der Absatz definiert ist. Dadurch wird das Copybook bzw. die Include-Datei geöffnet, falls zutreffend.

• Klicken Sie auf Gehe zu Symbol: Strg+Umschalt+O (Windows) oder Strg+Umschalt+O (Mac)

  Wenn Sie einen Objektnamen in der Suchleiste eingeben oder durch die Elemente blättern, um das Objekt auszuwählen, wird der Cursor an diese Position verschoben.

• Klicken Sie auf Peek-Definition: Alt+F12 (Windows) oder Option+F12 (Mac)

  Dadurch wird ein CodeLens-Feld geöffnet, in dem angezeigt wird, wo die Variable oder der Absatz im Code definiert wurde. Wenn Sie die Tastenkombination Alt+F12 (Windows) oder Option+F12 (Mac) verwenden, wird die Variable oder der Absatzname nur einmal angeklickt, bevor die Direktaufrufe über die Tastatur gedrückt werden. Klicken Sie doppelt auf ein beliebiges Ergebnis, um zu dieser Position in der Datei zu wechseln.

  

Makros in SYS1.MACLIB stehen zur Codevervollständigung zur Verfügung. Wenn Sie Zowe Explorer zusätzlich zu einem z/OS® MVS-System konfiguriert haben, das über ein SYS1.MACLIB-Dataset mit einem gültigen z/OSMF- oder RSE-API-Benutzerprofil verfügt, können Sie ferne Makros in reichhaltigen Kurzinfos voranzeigen. Die Tools folgen den gleichen Regeln wie bei der Auflösung von Include-Dateien, obwohl keine Eigenschaftsgruppen definiert werden müssen.

Um die automatische Suche mit Ihrem standardmäßigen Zowe CLI-Profil zu aktivieren, rufen Sie Benutzervorgaben > Einstellungen auf, erweitern Sie Erweiterungen > IBM Z Open Editor, und wählen Sie die Option Hlasm: Auflösung von Makros aktivieren ("zopeneditor.hlasm.enableResolvingMacros "). Weitere Informationen zur Verwaltung von Vorgaben finden Sie unter Benutzervorgaben festlegen.

Wenn Sie keine Konnektivität haben, empfehlen wir, diese Funktion ausgeschaltet zu lassen; andernfalls versucht der Editor weiterhin, die Datei über Ihr Zowe-CLI-Profil aufzulösen.

Wenn Sie ein anderes Zowe-CLI-Profil als die Standard-RSE-API-oder z/OSMF-Profile verwenden möchten, geben Sie den Namen eines anderen Profils in der "zopeneditor.zowe"-Benutzereinstellung an. Weitere Informationen finden Sie unter RSE-Profile in IBM Z Open Editor einrichten und verwenden.

Die Funktion zur Syntaxprüfung unterstreicht nicht erkannte Anweisungen und Ausdrücke in Rot, was Ihnen dabei hilft, schnelle Korrekturen vorzunehmen und Kompilierungsfehler zu reduzieren. Derzeit werden Syntaxfehler für falsche Leerzeichen in einer Fortsetzungszeile und für nicht aufgelöste Kopieranweisungen angezeigt.

Informationen zur Verwendung

Um alle Syntaxfehler in den geöffneten Dateien anzuzeigen, öffnen Sie die Ansicht "Probleme" über das Menü "Ansicht" oder klicken Sie auf das Symbol für Fehler und Warnung unten in der Statusleiste. Klicken Sie doppelt auf den Listeneintrag, um direkt zum Problem zu gelangen.

Machen Sie Ihre Änderungen rückgängig, indem Sie Strg+Z (Windows) oder Cmd+Z (Mac) drücken. Nehmen Sie den Widerruf für die Änderungen zurück, indem Sie Strg+Umschalttaste+Z (Windows) oder Cmd+Umschalttaste+Z (Mac) drücken.