This document provides information on activating the debug attach server (DAS) to debug an external Natural application with NaturalONE.
An external application runs in a Natural environment but stores its sources in a NaturalONE project. The DAS is used to access a NaturalONE project.
For more information on using the DAS, refer to the NaturalONE documentation.
The following prerequisites must be met to access the NaturalONE debugger from a mainframe Natural session:
The Natural session runs in a z/OS, z/VSE or BS2000 environment.
NaturalONE is installed.
Natural Development Server is installed and the version installed must support attached debugging.
Module NATADvrs
(or
NCIADvrs
for a CICS session on z/OS) is
generated from the Natural Developmet Server library and can be accessed for
the Natural session.
The profile parameter DBGAT
is specified, see
DBGAT
.
The profile parameter RCA
is set to
NATATDBG
.
The profile parameter RCALIAS
is set to
(NATATDBG,NATADvrs)
, for CICS on z/OS
to (NATATDBG,NCIADvrs)
.
The DAS is running and can be addressed through TCP/IP. The DAS is
shipped with NaturalONE as NATDAS.EXE
file.
For more information on RCA
and
RCALIAS
, refer to the Parameter
Reference documentation.
A Natural batch application is to be debugged with NaturalONE. The DAS
server is available under the TCP/IP name DASSERV
and listens to
port 50882
. The NaturalONE debugger has identified itself to the
DAS with client ID FRED
. The attached debug interface resides in
DSN NDV823.LOAD
:
//NATBAT EXEC PGM=NATBAT82 //STEPLIB DD DISP=SHR,DSN=NAT823.LOAD // DD DISP=SHR,DSN=NDV823.LOAD //CMPRMIN DD * RCA=NATATDBG,RCALIAS=(NATATDBG,NATAD823) DBGAT=(ACTIVE=ON,HOST=DASSERV,PORT=50882,CLID=FRED) /*
A Natural batch application is to be debugged with NaturalONE. The DAS
server is available under the TCP/IP name DASSERV
and listens to
port 50882
. The NaturalONE debugger has identified itself to the
DAS with client ID FRED
. The attached debug interface resides in
the library PRD.NAT823.LIBRARY
:
// DLBL NAT823,'PRD.NAT823.LIBRARY' // LIBDEF PHASE,SEARCH=(NAT823.NAT823,NAT823.NDV823,...) // EXEC NATBAT82,SIZE=(NATBAT82,120K),PARM='SYSRDR' RCA=NATATDBG,RCALIAS=(NATATDBG,NATAD823) DBGAT=(ACTIVE=ON,HOST=DASSERV,PORT=50882,CLID=FRED) /*
A Natural batch application is to be debugged with NaturalONE. The DAS
server is available under the TCP/IP name DASSERV
and listens to
port 50882
. The NaturalONE debugger has identified itself to the
DAS with client ID FRED
. The attached debug interface resides in
the library NDV833.MOD
.
/LOGON /SYSFILE SYSOUT=ATDEBUG.OUT /SYSFILE SYSLST=ATDEBUG.LST /FILE ADAPARM,DDLNKPAR /FILE NAT826.MOD,LINK=BLSLIB01 /FILE NDV833.MOD,LINK=BLSLIB02 /FILE CMPRMIN.RMDBG,LINK=CMPRMIN /FILE DBGTRACE.NATBATCH,LINK=DBGTRACE /START-EXE-PROG F-F=*LI-E(L=NAT826.MOD,EL=NATBAT82,TYPE=L) ...
The CMPRMIN.RMDBG
dynamic parameter file contains the
following Natural parameter settings:
RCA=NATATDBG,RCALIAS=(NATATDBG,NATAD833), DBGAT=(ACTIVE=ON,CLID=FRED,HOST=DASSERV,PORT=50882)