Version 6.3.13 for Windows
 —  Parameter Reference  —

DBGAT - Debug Attach Server for NaturalONE

This Natural profile parameter is intended for use with NaturalONE. It is used with an external Natural application. This is an application for which the sources are stored in a NaturalONE project, but which is started directly from Natural. For detailed information on how to debug external Natural applications, see the NaturalONE documentation.

This profile parameter can be used to activate the debug attach mechanism of NaturalONE, to define the name and port of the debug attach server, and to define a client ID which identifies the NaturalONE project to be debugged.

Possible settings See DBGAT Parameter Syntax.
Default setting none Subparameter defaults, see DBGAT Parameter Syntax.
Dynamic specification yes See below.
Specification within session no  
Application programming interface no  

DBGAT Parameter Syntax

The parameter syntax is as follows:

DBGAT=(syntax-element=value,...)

Important:
Spaces are not allowed in the syntax. The optional syntax elements are separated from each other using commas.

Where:

Syntax Element Value Explanation
ACTIVE ON

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

If ACTIVE is not specified, the corresponding value defined in the Configuration Utility is used as the default.

OFF
HOST 1 - 64 characters

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

If HOST is not specified, the corresponding value defined in the Configuration Utility is used as the default.

PORT 0 - 65535

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

If PORT is not specified, the corresponding value defined in the Configuration Utility is used as the default.

CLID 1 - 64 characters

The client ID of the NaturalONE project that is to be debugged.

If CLID is not specified, the corresponding value defined in the Configuration Utility is used as the default.

If no client ID is specified at all, neither with this parameter nor in the Configuration Utility, the unique client ID which is automatically generated for the NaturalONE project is used.

Example

DBGAT=(ACTIVE=ON,HOST=myhost,PORT=9999)

Top of page