Preparing Natural for Attached Debugging

Introduction

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.

Prerequisites for Attached Debugging

The following prerequisites must be met to access the NaturalONE debugger from a mainframe Natural session:

  • The Natural session runs in a z/OS 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 Development 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 detailed information on the profile parameters mentioned above, refer to the Parameter Reference documentation.

Example

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 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)
/*