Natural für Attached-Debugging vorbereiten


Einleitung

Dieses Dokument liefert Informationen, wie Sie den Debug Attach Server (DAS) aktivieren können, um das Debugging einer externe Natural-Anwendung mittels NaturalONE durchzuführen.

Eine externe Natural-Anwendung läuft in einer Natural-Umgebung, speichert aber ihren Quellcode in einem NaturalONE-Project. Der Debug Attach Server (DAS) wird benutzt, um auf ein NaturalONE-Project zuzugreifen.

Weitere Informationen zur Benutzung des Debug Attach Server (DAS) siehe NaturalONE-Dokumentation.

Voraussetzungen für Attached Debugging

Damit Sie aus einer Natural-Sitzung heraus auf den NaturalONE-Debugger zugreifen können, müssen folgende Voraussetzungen erfüllt sein:

  • Die Natural-Sitzung läuft in einer z/OS-, z/VSE- oder BS2000-Umgebung.

  • NaturalONE ist installiert.

  • Der Natural Development Server ist installiert und die installierte Version muss verbundenes Debugging unterstützen.

  • Das Modul NATADvrs (oder NCIADvrs für eine CICS-Session auf z/OS) wird aus der Natural Development Server Library generiert und die Natural-Sitzung kann darauf zugreifen.

  • Der Profilparameter DBGAT ist angegeben.

  • Der Profilparameter RCA ist auf NATATDBG gesetzt.

  • Der Profilparameter RCALIAS ist auf (NATATDBG,NATADvrs) gesetzt, für CICS auf z/OS auf (NATATDBG,NCIADvrs).

  • Der Debug Attach Server (DAS) läuft und kann über TCP/IP adressiert werden. Der DAS wird mit NaturalONE als NATDAS.EXE-Datei ausgeliefert.

Ausführliche Informationen zu den oben erwähnten Natural-Profilparametern, siehe Parameter-Referenz-Dokumentation.

Beispiel für z/OS Batch

Eine Natural-Batch-Anwendung soll mit NaturalONE auf Programmfehler untersucht werden. Der DAS-Server ist unter dem TCP/IP-Namen DASSERV verfügbar und empfängt am Port 50882. Der NaturalONE-Debugger hat sich beim Debug Attach Server mit der Client ID FRED identifiziert. Die angebundene Debug-Schnittstelle befindet sich in der Library DSN NDVvrs.LOAD:

//NATBAT  EXEC PGM=NATBATvr
//STEPLIB DD   DISP=SHR,DSN=NATvrs.LOAD
//        DD   DISP=SHR,DSN=NDVvrs.LOAD
//CMPRMIN DD   *
RCA=NATATDBG,RCALIAS=(NATATDBG,NATADvrs)
DBGAT=(ACTIVE=ON,HOST=DASSERV,PORT=50882,CLID=FRED)
/*

Beispiel für z/VSE Batch

Eine Natural-Batch-Anwendung soll mit NaturalONE auf Programmfehler untersucht werden. Der DAS-Server ist unter dem TCP/IP-Namen DASSERV verfügbar und empfängt am Port 50882. Der NaturalONE-Debugger hat sich beim Debug Attach Server mit der Client ID FRED identifiziert. Die angebundene Debug-Schnittstelle befindet sich in der Library PRD.NATvrs.LIBRARY:

// DLBL NATvrs,'PRD.NATvrs.LIBRARY'
// LIBDEF PHASE,SEARCH=(NATvrs.NATvrs,NATvrs.NDVvrs,...)
// EXEC  NATBATvr,SIZE=(NATBATvr,120K),PARM='SYSRDR'
RCA=NATATDBG,RCALIAS=(NATATDBG,NATADvrs)
DBGAT=(ACTIVE=ON,HOST=DASSERV,PORT=50882,CLID=FRED)
/*

Beispiel für BS2000

Eine Natural-Batch-Anwendung soll mit NaturalONE auf Programmfehler untersucht werden. Der DAS-Server ist unter dem TCP/IP-Namen DASSERV verfügbar und empfängt am Port 50882. Der NaturalONE-Debugger hat sich beim Debug Attach Server mit der Client ID FRED identifiziert. Die angebundene Debug-Schnittstelle befindet sich in der Library NDVvrs.MOD:

/LOGON                          
/SYSFILE SYSOUT=ATDEBUG.OUT     
/SYSFILE SYSLST=ATDEBUG.LST     
/FILE ADAPARM,DDLNKPAR          
/FILE NATvrs.MOD,LINK=BLSLIB01  
/FILE NDVvrs.MOD,LINK=BLSLIB02  
/FILE CMPRMIN.RMDBG,LINK=CMPRMIN
/FILE DBGTRACE.NATBATCH,LINK=DBGTRACE
/START-EXE-PROG F-F=*LI-E(L=NATvrs.MOD,EL=NATBATvr,TYPE=L)
...

Die dynamische Parameterdatei CMPRMIN.RMDBG enthält folgende Natural-Parametereinstellungen:

RCA=NATATDBG,RCALIAS=(NATATDBG,NATADvrs),
DBGAT=(ACTIVE=ON,CLID=FRED,HOST=DASSERV,PORT=50882)