DBGAT - Debug Attach Server for NaturalONE

#### Search Results

Search

# DBGAT - Debug Attach Server for NaturalONE

This Natural profile parameter allows debugging of an external Natural application with NaturalONE.

Possible settings | See DBGAT Parameter Syntax.
Default setting | none | See also the default settings of the subparameters in DBGAT Parameter Syntax.
Dynamic specification | yes | This parameter can only be specified dynamically.
Specification within session | no |
Application programming interface | no |

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

This section covers the following topics:

- DBGAT Parameter Syntax

- Example of DBGAT Parameter

## DBGAT Parameter Syntax

The `DBGAT` parameter is specified as follows:

`DBGAT=(subparameter=value,...`)

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

Where:

Subparameter | Value | Description
--- | --- | ---
`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 (2500 is the default).
`CLID` | 1 - 64 characters | 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.
`SSL` | `ON` | The communication to the debug attach server uses SSL/TLS encryption.
`OFF` | The communication to the debug attach server does not use SSL/TLS encryption.
`TLS` | `ON` | See description for `SSL`.
`OFF`
`VERIFY` | `ON` | Natural will verify the SSL/TLS connection to the debug attach server. Natural will first search the CA certificate in the das.client.ca.crt file stored in the location of the Natural binary. If the file does not exist, Natural will try to search in the `SSL_CERT_FILE` environment variable or `SSL_CERT_DIR` for the CA certificate location (OpenSSL standard).
`OFF` | Natural will not verify the SSL/TLS connection.

## Example of DBGAT Parameter

    DBGAT=(ACTIVE=ON,HOST=MYHOST,PORT=9999,CLID=MYCLIENTID,SSL=ON,VERIFY=ON)

### On this page

- DBGAT Parameter Syntax
- Example of DBGAT Parameter