DBGAT - Debug Attach Server for NaturalONE

This Natural profile parameter allows debugging of an external Natural application from a z/OS or z/VSE host with NaturalONE. DBGAT corresponds to the NTDBGAT macro in the Natural parameter module.

Possible settings See DBGAT Parameter Syntax.
Default setting none  
Dynamic specification yes  
Specification within session no  

For detailed information on how to debug external Natural applications, see the NaturalONE documentation.

This section covers the following topics:


DBGAT Parameter Syntax

The DBGAT parameter is specified as follows:

DBGAT=(keyword-subparameter=value,...)

Where:

Keyword Subparameter Value Explanation
ACTIVE ON

ON means that the debug attach mechanism is active. The Natural runtime is ready for debugging.

OFF
HOST 1 - 64 characters

Name of the debug attach server that is to be connected.

PORT 0 - 65535

Number of the port to which the debug attach server listens.

CLID 1 - 64 characters

Client ID of the NaturalONE project that is to be debugged.

TRACE 1 - 8 hexadecimal digits

Trace level for attached debugging.

See also Trace Level.

Trace Level

Each bit of TRACE represents certain trace information as indicated in the following table:

Bit Information
00000001 Trace error events.
00000002 Trace main events, such as attach debug initialization and termination.
00000008 Dump internal storage areas.
00000004 Trace detailed events, such start and end of functions with return code.
00000010 Dump request and reply buffers in EBCDIC.
00000020 Dump request and reply buffers in ASCII.
00000040 Request processing main events.
00000080 Request processing detailed events.

You can combine different trace options, for example, TRACE=00000007 traces error events, main events and detailed events.

NTDBGAT Macro Syntax

The NTDBGAT macro is specified as follows:

         NTDBGAT ACTIVE=value,                                          *
               HOST=value,                                              *
               PORT=value,                                              *
               CLID=value,                                              *
               TRACE=value

Example of DBGAT Parameter

DBGAT=(ACTIVE=ON,HOST=MYHOST,PORT=9999,CLID=MYCLIENTID,TRACE=00000097)

Example of NTDBGAT Macro

         NTDBGAT ACTIVE=ON,                                            *
               HOST=MYHOST,                                            *
               PORT=50882,                                             *
               TRACE=00000097