Bevor Sie den Debugger für Ihre Anwendung ausführen können, müssen Sie verschiedene Schritte auf der Maschine mit System z abschließen.
Informationen zu diesem Vorgang
Diese Schritten umfassen Folgendes:
Vorgehensweise
- Wenden Sie sich an Ihren Systemadministrator, um sicherzustellen, dass Debug Tool for z/OS ausreichend Speicher zur Verfügung steht, um Ihre Anwendung und den Debugger auszuführen. Das Ändern der Regionsgröße (z. B. REGION=0M) kann dabei helfen, sicherzustellen, dass ausreichend Speicher vorhanden ist. Stellen Sie außerdem sicher, dass die Jobklasse, die von Ihrer Anwendung ausgeführt wird, in dieser Regionsgröße ausgeführt werden kann und dass sie die für die Ausführung der Debugsitzung benötigte Zeit zulässt.
- Wenn Sie ein Debugging für eine CICS-Transaktion ausführen, müssen die Speichergröße, die Transaktionsunterstützung und der Dateizugriff durch einen CICS-Administrator festgelegt werden. Wenn Debug Tool installiert und in Ihrer CICS-Region verfügbar gemacht wurde, sollten diese Schritte bereits ausgeführt worden sein. Wenden Sie sich an Ihren CICS-Administrator, falls diese Einstellungen geändert werden müssen. Weitere Informationen finden Sie im Kapitel Adding support for debugging under CICS in "Debug Tool for z/OS Customization Guide".
- Stellen Sie sicher, dass Sie auf die ausführbare Datei (SEQAMOD) von IBM® Debug Tool for z/OS zugreifen können und eine entsprechende Leseberechtigung haben.
- Stellen Sie sicher, dass Sie auf die Quelle der kompilierten Einheit zugreifen können, für die Sie den Debugger ausführen. Die Quelle für die Sie Zugriff benötigen, hängt von der Programmiersprache, den Compileroptionen und der Compilerversion ab. Im Abschnitt Preparing your program for debugging in "Debug Tool for z/OS User's Guide" wird für die einzelnen Programmiersprachen beschrieben, auf welche Dateien Sie Zugriff benötigen.
- Stellen Sie sicher, dass Sie die IP-Adresse oder den Hostnamen (einschließlich der Portnummer) der Maschine kennen, auf der die Debuggerbenutzerschnittstelle ausgeführt wird. Sie benötigen diese Informationen, wenn Sie die Laufzeitoptionen TEST schreiben, mit denen eine Debugsitzung gestartet wird. Wenn Sie die IP-Adresse der Clientmaschine in der Debuggerbenutzerschnittstelle abrufen möchten, wechseln Sie zur Ansicht "Debug" und klicken Sie rechts neben dem Dämonsymbol auf den Abwärtspfeil . Wählen Sie dann im Menü Workstation-IP abrufen aus. Das Dialogfenster "Workstation-IP abrufen" wird geöffnet, in dem die aktuelle IP-Adresse der Clientmaschine angezeigt wird. Sie können die IP-Adresse in diesem Dialogfenster auswählen, sie kopieren und in eine JCL einfügen.
Anmerkung: Wenn die Workstation mehrere LAN-Adapter hat oder sich ein Router bzw. ein virtuelles privates Netz (Virtual Private Network, VPN) zwischen der Workstation und dem Server befindet, werden in diesem Dialog möglicherweise mehrere IP-Adressen aufgelistet. Sie müssen möglicherweise alle IP-Adressen ausprobieren, um die Adresse zu finden, die der Server verwenden kann.
- Stellen Sie sicher, dass die IP-Adresse im Parameter TCPIP& der Laufzeitoption TEST mit der TCP/IP-Adresse der Maschine übereinstimmt, auf der der Debugger für Compilersprachen ausgeführt wird. Stellen Sie außerdem sicher, dass die im Parameter TCPIP& verwendete Portnummer der Laufzeitoption TEST mit der Portnummer (oder dem Bereich der Portnummern, die auf der Vorgabenseite "Debugdämon" im Feld Dämonport angegeben sind) übereinstimmt, die von der Debuggerschnittstelle verwendet wird.
Der Debuggerdämon ist standardmäßig an Port 8001 empfangsbereit. Wenn Sie die Debug-IP-Adresse und -Portnummer für System z festlegen möchten, verwenden Sie den Parameter TCPIP& in der Laufzeitoption TEST an der Position Vorgabendatei (im Format TCPIP&TCPIP-Workstation-IDE%-Port-ID:).
Sie können den Dämonport oder den Portbereich der Benutzerschnittstelle im Dialogfenster "Dämonport ändern" oder in den Debuggervorgaben festlegen.
- Stellen Sie sicher, dass Sie die entsprechenden Anweisungen im Abschnitt Starting Debug Tool in "Debug Tool for z/OS User's Guide ausgeführt haben. In diesem Abschnitt werden Anweisungen zum Starten von Programmen bereitgestellt, die in verschiedenen Umgebungen ausgeführt werden.
- Beim Debugging von Assemblercode müssen Sie den Befehl LOADDEBUGDATA (LDD) für alle Kompilierungseinheiten verwenden, für die Sie den Debugger ausführen möchten. (Verwenden Sie den Befehl, um EQALANGX zu laden.)
- Wenn Sie den Debugger für Compilersprache unter Windows® Server 2008 ausführen, stellen Sie sicher, dass Sie entweder eine "Neue Regel" hinzufügen oder "Eingehende Verbindungen" aktivieren, um es dem Port (üblicherweise 8001) zu ermöglichen, durch die Firewall hindurch zu kommunizieren.