Overview of Configuration File Parameters

This document provides information on the parameters that can be set in the global and local configuration files. 

+------------------------------------------------------------------------------+
¦File             Edit             Configuration             Search            ¦
+----------------------------------+---------------------------+---------------+
                                   ¦ Global Configuration File ¦                
                                   ¦ Local Configuration File  ¦                
                                   +---------------------------+

The configuration files can only be modified by an administrator. They should only be changed with the Configuration Utility.

After a new Natural installation, the default administrator names are SAG and DBA. For these administrators, the Configuration menu is available. The administrator SAG or DBA can then add further administrators to the local configuration file as defined in the section Administrator Assignments.

The following topics are covered below:

Global Configuration File

This parameter group contains the following categories:

Database Management System Assignments

The parameters which apply to the database management system assignments are grouped under the following headings:

DBMS Assignments

A table is shown which is used to define the database ID with which the database is mapped in the DDM.

When DBMS assignments have already been defined, they are shown in the table.

DBID

The database ID.

Note:
If you are using DDMs where the database ID is set to "0", a separate entry where the database ID is also set to "0" must exist, with the corresponding database type specified. This entry is used at compilation time in order to generate the corresponding database statements into the generated program (GP).

Type

Since the types of all databases which are to be accessed by Natural must be defined in the global configuration file, specify one of the following values for each database ID:

Value Description
ADA/ADA2

Adabas database server (this is the default).

See also Adabas Database Management Interfaces ADA and ADA2 in the Programming Guide.

SQL Any SQL database that can be accessed using Entire Access, which is Software AG's common interface to various SQL database systems.
XML Tamino database server.

Important:
You must not define a database type for a DBID which has already been assigned to a system file in the global configuration file (see System Files). If you do so, an error message will be issued at Natural startup, indicating an inconsistency in the system file setting and an error when reading the database assignments.

At compilation time, the profile parameter UDB is not used to determine the database type. UDB is only used at runtime to determine the database type. The database types must be the same at compilation time and at runtime.

Parameter

Applies only to databases of the following types:

Type Description
ADA/ADA2

If your database type is ADA or ADA2, you can choose between two access methods:

  • If you leave the parameter string empty, the classic access method via ADALNK is used. This is the default.

  • Alternatively, you can specify an ADATCP connect string here, instructing Natural to connect to Adabas via TCP/IP.

See Natural and Adabas Access in the Database Management System Interfaces documentation for further information

SQL If your database type is SQL, specify the string (DBMS parameter) that is to be used to establish the connection to the database system with which you want to work. See Natural and Entire Access in the Database Management System Interfaces documentation for further information on how to access SQL-type database systems.
XML If your database system is XML (Tamino), enter the URL of the Tamino database including the name of the collection which is to be accessed in this database. See Natural for Tamino in the Database Management System Interfaces documentation for further information on how to access Tamino databases.

DBMS Tracing

The settings for Adabas Trace, SQL Trace and XML Trace are for error diagnostics reasons. They should only be filled out when requested by Software AG support. Software AG support will provide valid values in this case.

SQL Assignments

The tables for the SQL assignments are grouped under the following headings:

  • SQL Date/Time Conversion
    This table is used to specify the conversion masks for Entire Access.

    As Natural has only one specific time format, you must decide how this format should be interpreted in the context of SQL database access. There are several possibilities, however, there is only one possibility per SQL-type DBID which can be specified here.

    DBID

    Cannot be edited. Entries for the SQL-type databases defined in the DBMS Assignments table (see above) are automatically provided.

    Mask

    The value specifies the configuration for Entire Access. It also specifies the format used to retrieve the SQL information for DATE, TIME and DATETIME into fields of Natural data format A. The mask should match the RDBMS-specific configuration for the DATE, TIME or DATETIME character string representation.

    Date

    This mask (usually a sub-string of the Mask value) specifies the character string representation into which the fields of Natural data format D are converted during update or retrieval of SQL DATE columns.

    Time

    This mask (usually a sub-string of the Mask value) specifies the character string representation into which the fields of Natural data format T are converted during update or retrieval of SQL TIME or DATETIME columns.

    Remark

    You can enter your remarks here, for example, to document how the SQL DATE and TIME character string representation is configured on the database site.

    For database systems that support a common data type both for date and for time, the hash character (#) can be used in the mask to skip non-relevant portions of DATETIME strings. For example, the following settings of the masks may be appropriate for the Microsoft SQL Server which supports a common DATETIME data type for date and time values: 

    Mask = YYYYMMDD HH:II:SS
Date = YYYYMMDD
Time = #########HH:II:SS

  • SQL Authorization
    This table is used to specify user IDs and passwords for an automatic login to an SQL database.

    DBID

    Cannot be edited. Entries for the SQL-type databases defined in the DBMS Assignments table (see above) are automatically provided.

    Auto Login

    When selected, a non-interactive login is performed to the database by using the values from this table row. Furthermore, the evaluations of the environment variables SQL_DATABASE_LOGIN, SQL_DATABASE_USER, SQL_DATABASE_PASSWORD, SQL_OS_USER and SQL_OS_PASSWORD are suppressed.

    Type

    To define the kind of authentication to be performed for this DBID, specify one of the following values:

    Value Description
    DB Database authentication.
    OS Operating system authentication.
    DB_OS Both, database authentication and operating system authentication.

    Please note that it depends on the database system which kind of authentication is available. Furthermore, there are restrictions concerning operating system authentication in Entire Access. See the Entire Access documentation for a more detailed description.

    DB User

    The user ID for database authentication.

    DB Password

    The password for database authentication.

    OS User

    The user ID for operating system authentication.

    OS Password

    The password for operating system authentication.

XML Assignments

A table is shown which is used to specify user IDs and passwords for an automatic login to a Tamino database.

DBID

Cannot be edited. Entries for the XML-type databases defined in the DBMS Assignments table (see above) are automatically provided.

Auto Login

When selected, a non-interactive login is performed to the database by using the values from this table row. Furthermore, the evaluations of the environment variables XML_DB_USER, XML_DB_PASSWORD, XML_HTTP_USER and XML_HTTP_PASSWORD are suppressed.

DB User

The user ID for Tamino database authentication.

DB Password

The password for Tamino database authentication.

HTTP User

The user ID for web server authentication.

HTTP Password

The password for web server authentication.

Dictionary Server Assignments

With dictionary servers, you can access free rules and automatic rules maintained in Predict once you have access to Predict on a mainframe or Linux host.

Note:
A dictionary server (also referred to as Predict server) can be any Natural RPC server running in the same environment that Predict is installed in.

You can assign so-called dictionary servers (a free rule server and an automatic rule server) to one common logical server name. It is possible to define more than one logical server name where each name represents a different pair of free rule server and automatic rule server. The servers to be assigned can be located on different nodes.

In the global configuration file, you define all dictionary servers that are available for selection in the parameter file. The name of the logical server that is to be used must then be defined in the parameter file. See Remote Dictionary Access in the Overview of Profile Parameters.

You can specify the following information:

Name

Specify the name for a logical dictionary server.

Free Rules

Specify the server name and node name for the server that is to be used for remote access to Predict free rules.

Automatic Rules

Specify the server name and node name for the server that is to be used for remote access to Predict automatic rules.

HTTP Client Parameter Settings

The following parameters are used to define the name and port number for the HTTP server.

Option See the Parameter Reference for a description of this profile parameter
HTTP proxy address to use PROX
HTTP proxy port number PROXPORT
Do not use proxy for addresses NOPROX
HTTPS proxy address to use SSLPRX
HTTPS proxy port number SSLPRXPT
Do not use SSL proxy for addresses NOSSLPRX

Natural Version-independent Operating System Files

You can specify a directory common to all installed Natural versions, which is to contain operating system-specific work files and temporary files used by all these Natural versions. These files are required for synchronization purposes and must not be deleted or modified by a Natural Administrator.

Note:
If you use the system directory for temporary files, ensure that no automatic procedures regularly delete the contents.

Printer Profiles

Printer profiles are used for printing additional reports, for hard copies, and for batch output generation. They recognize particular Natural field attributes and insert the appropriate control sequences (see below) as defined in the profile.

With the ability to translate Natural field attributes into escape sequences, you can control your printer in various ways by using the correct profile name. You can address the print features of a given device by using simple attributes in Natural programs.

Each profile that you define can be assigned to a Natural report number either statically by using the Configuration Utility (see Device/Report Assignments), or dynamically by using the DEFINE PRINTER statement within a Natural program.

The following sections explain the parameters that apply to the printer profiles:

Printer Profiles

The following is a list of the defined printer profiles.

C

The single-letter command to be applied. The following commands are available.

Command

Description

E

Edits an existing printer profile. This command opens the NOM Printer Profile or TTY Printer Profile page, depending on the method specified.

D

Deletes an existing (or as yet unnamed) printer profile.

I

Inserts a new (initially unnamed) printer profile.

U

Undoes any changes made to an existing printer profile.
Name

The name of the printer profile.

Method

Specify the print method for this printer profile. Or press PF2 to select the print method from a list.

Method

Description

NOM

Prints to an Entire Output Management container file without using the spool of the operating system. Refer to the Entire Output Management documentation for details.

If you want to use this method, you have to specify all required information on the NOM Printer Profile page, accessible via the E (Edit) command described above.

TTY

Print data (text files) are sent directly to the spooler "as is". Any printer command sequences need to be specified explicitly, either dynamically (as program data) or statically (via a printer profile). As such, the application has full control over the command sequences.

This is a low-level print method that by-passes the printer driver. If you want to use this method, you have to specify all required information on the TTY Printer Profile page, accessible via the E (Edit) command described above.

NOM Printer Profiles

The caption contains the name of the NOM printer profile displayed. You can specify the following information:

Config block

Name of the OPO (Open Print Option) configuration block.

Meta file

Path and name of the OPO XML meta file.

Refer to the Entire Output Management documentation for details.

TTY Printer Profiles

The caption contains the name of the TTY printer profile displayed. You can specify the following information:

External character set

Optional.

Example:

If a printer's character set is different from the system character set, or if you wish to preserve Unicode data by outputting the data in UTF-8 format, then an external character set must be defined.

State Server Configurations

State server configurations define the state servers that are available to Natural/HA.

Multiple state server configurations can be defined, but only one is active for the lifetime of any particular Natural/HA session, as determined by the STATESRV profile parameter. The active state server configuration is the one used for storage of the saved Natural/HA sessions in an HA (High Availability) environment.

The state server configurations define the type of state server, its location, and any other parameters. Two types of state server are available:

REDIS© State Servers
File System Servers

The following sections explain the parameters that apply to the state server configurations:

State Servers

The following is a list of the defined state server configurations.

C

The single-letter command to be applied. The following commands are available.

Command

Description

E

Edits a state server configuration. This command opens the REDIS© State Server or File System State Server page, depending on the driver specified.

D

Deletes an existing (or ,as yet, unnamed) state server configuration.

I

Inserts a new (initially unnamed) state server configuration.

U

Undoes any changes made to an existing state server configuration.

Name

The name of the state server configuration.

Driver

Specify the driver for this state server configuration, which directly determines the state server type. Or press PF2 to select the driver from a list.

Driver

Description

NATREDIS

Specifies a REDIS© state server.

If you want to use this method, you have to specify all required information on the REDIS© State Server page, accessible via the E (Edit) command described above.

NATFSYSD

Specifies a file system state server, which is a directory in the file system.

By default, the HA_FILESHARE directory, if specified, is used, otherwise an alternative location can be chosen via the File System State Server page, accessible via the E (Edit) command described above.

REDIS© State Server

The caption contains the name of the REDIS© state server configuration being displayed. You can specify the following information:

Host name

Optional.

Specifies the name of the host on which REDIS© is running. If not specified, "localhost" is assumed.

Port number

Specifies the port number on which REDIS© is running.

The default value of 0 is assumed to imply the use of the standard port number (6379 for unencrypted connections, or 6380 for SSL/TLS connections).

Password

Optional.

Specifies the REDIS© password if one has been configured on the server side.

Connection timeout

Specifies the connection timeout in milliseconds. The default value of 0 indicates that the connection does not time out, which can result in the connection attempt hanging indefinitely (e.g., if the host/port information contains a typo).

Use SSL/TLS

Specifies whether an SSL/TLS encrypted connection is to be used.

The default value of OFF specifies an unencrypted connection, in which case all the remaining parameters listed below are not relevant.

Verify server

Only relevant for SSL/TLS connections.

Specifies whether the server certificate(s) should be verified.

The default value of ON indicates that an error should be returned if server certificate verification fails for any reason, which is the recommended behavior. However, setting this value to OFF allows verification failures to be explicitly ignored (e.g., temporarily during testing).

CA file or directory

Optional.

Only relevant for SSL/TLS connections.

Specifies the path to the CA (certificate Authority) file or directory containing the certificates needed for server verification in PEM format. In the former case, the file typically contains multiple certificates. In the latter case, the PEM files in the directory each contain one certificate and it is necessary to create symbolic links via the openssl rehash <directory> command before the directory can be used. If this field is left empty, OpenSSL will attempt to use the certificate path or directory with which it has been configured, which can be overridden by the environment variables SSL_CERT_FILE (for CA file) or SSL_CERT_DIR (for CA directory). Please refer to the OpenSSL documentation for further information.

Client certificate file

Optional.

Only relevant for SSL/TLS connections.

Specifies the path to a PEM file containing the client certificate file chain. This parameter is only needed if the server only allows specific clients and therefore needs to check their identity. In this case, both this and the Client private key file parameter need to be specified.

Client private key file

Optional.

Only relevant for SSL/TLS connections.

Specifies the path to a PEM file containing the client’s private key. This parameter is only needed if the server only allows specific clients and therefore needs to check their identity. In this case, both this and the Client certificate file parameter need to be specified.

Server name indication

Optional.

Only relevant for SSL/TLS connections.

In some cases, multiple hosts share the same IP address. Therefore, the required host name needs to be separately passed to the server. This extra information is referred to as Server Name Indication (SNI). In practice, this is often the same value as for the Host name parameter (see above), though this is not guaranteed to be the case.

File System State Server

The caption contains the name of the file system state server configuration being displayed. You can specify the following information:

Location

Optional.

Specifies the path to the directory to be used.

NDV Environment Assignments

When you choose this function, the currently defined ports are shown in a window. When you edit a port number (by entering "E" next to the port number and pressing ENTER), the environment assignments are shown. You can also choose <CREATE>, which is shown at the top of the window, to add environment assignments for further ports.

You can assign user-specific environments for any Natural development server (NDV). To do so, use the following syntax in the Environment column: 

VARIABLE=VALUE[;VARIABLE=VALUE]...

Example:

+----------------- Environment settings for NDV port <1234> ------------------+
¦ C User     Environment                                                      ¦
¦   USER1    MYWRKFILE=/natural/prog/user1;NDVSESSION=naturalins              ¦
¦   USER2    MYWRKFILE=/natural/prog/user2;NDVSESSION=naturaltr;NAT_TRACE=1   ¦
¦   USER3    MYWRKFILE=/natural/prog/user3;NDVSESSION=naturalsql              ¦
¦                                                                             ¦

In the above example, 3 user environments for the server started on port 1234 are defined. The environment variable MYWRKFILE defines the path of a Natural work file. This environment variable can then be used in the Work Files section of a parameter file to define the location of the work file, depending on the defined user.

The variable NDVSESSION specifies the Natural image to be loaded when a mapping to the server takes place. It is only known by the Natural development server.

Suppose Natural Studio is mapping to a Natural development server with port 1234 and user ID USER2: the server loads naturaltr as the Natural session and any Adabas call of a started application will be traced. Work files defined with MYWRKFILE will be written to the location /natural/prog/user2.

For information on how to configure a Natural development server under Linux, see the Natural Development Server for Linux documentation.

Printer Profiles

Printer profiles are used for printing additional reports, for hard copies and for batch output generation. They recognize particular Natural field attributes and insert the appropriate control sequences (see below) as defined in the profile.

With the ability to translate Natural field attributes into escape sequences, you can control your printer in various ways by using the right profile name, and you can use the print features of a given device by using simple attributes in Natural programs.

Each profile that you define can be assigned to a Natural report number either statically by using the Configuration Utility (see Device/Report Assignments), or dynamically by using the DEFINE PRINTER statement within a Natural program.

The parameters which apply to the printer profiles are arranged on the following pages:

Printer Profiles

You can specify the following information:

Name

The name of the printer profile.

Method

Specify the print method for this printer profile. Or press PF2 to select the print method from a list.

Method Description
NOM Prints to an Entire Output Management container file without using the spool of the operating system. Refer to the Entire Output Management documentation for details. If you want to use this method, you have to specify all required information on the NOM Printer Profiles page.
TTY Print data (text files) are sent directly to the spooler "as is". Any printer command sequences need to be specified explicitly, either dynamically (as program data) or statically (via a printer profile). As such, the application has full control over the command sequences. This is a low-level print method that by-passes the printer driver. If you want to use this method, you have to specify all required information on the TTY Printer Profiles page.

NOM Printer Profiles

You can specify the following information:

Profile name

Specify the name of a new printer profile. Or press PF2 to select a defined printer profile from a list.

Config block

Name of the OPO (Open Print Option) configuration block.

Meta file

Path and name of the OPO XML meta file.

Refer to the Entire Output Management documentation for details.

TTY Printer Profiles

You can specify the following information:

Profile name

Specify the name of a new printer profile. Or press PF2 to select a defined printer profile from a list.

External character set

Optional. An external character set must be defined, for example, if a printer's character set is different from the system character set, or if you wish to preserve Unicode data by outputting the data in UTF-8 format.

You can specify the name of the external character set. If the name is "UTF-8", the data are converted into UTF-8 format. Otherwise, any name can be used, but it must agree with the name used in the character translation table definition in the file NATCONV.INI. For example, if the internal character set name (as defined near the top of the NATCONV.INI file) is "ISO8859_1" and you define "FRED" as the name of the external character set in the printer profile, a section with the following name must be defined in the file NATCONV.INI, otherwise no character translation is performed: 

[ISO8859_1 -> FRED]

Note that, in the non-UTF-8 case, the data are first converted from the in-memory format (UTF-16) into the system code page, prior to any NATCONV.INI-based translation being applied.

For further information on the NATCONV.INI file, see Support of Different Character Sets with NATCONV.INI in the Operations documentation.

Trigger / Leading command / Trailing command

You can specify whether commands to be triggered at job, page or field level.

Option Description
Trigger
A triggering event controls the level on which specified printer control sequences are to be applied. The names of the available triggering events are listed below. Specify the name of a triggering event in the Trigger field to display the associated leading and trailing control sequences. You can also press PF2 to select a triggering event from a list.
JOB Use this triggering event if you want your control sequences to apply to an entire print job. The specified control sequences will represent the job header and/or job trailer respectively.
PAGE Use this triggering event if you want the control sequences to apply to each physical output page. The specified control sequences will then represent the page headers and/or page trailers respectively.
FIELD Use this triggering event if you want the control sequences to apply to each field (regardless of its AD, CD or PM attributes).
AD and CD These triggering events stand for specific attributes of the session parameters AD (attribute definition) and CD (color definition). Use these triggering events if you want the control sequences to be applied at field level only. Any field in a Natural program with corresponding attributes will then cause these control sequences to take effect. See the Parameter Reference for details on these session parameters.
PM=I Use this triggering event if you want the control sequences to apply to each field with an opposing print direction to that of the page. See the session parameter PM (print mode) and the terminal command %V (control of print mode) for more information.
Leading command The leading control sequence is inserted immediately before the triggering event (for example, to define a job header or to set attributes for field representation).
Trailing command The trailing control sequence is inserted immediately after the triggering event (for example, to define a job trailer or to reset attributes previously set).

For each control sequence, you can specify the control characters in either alphanumeric or hexadecimal format.

Notes:

  1. Blank characters must always be specified in hexadecimal format (^20). If they were entered directly, they would be confused with the blanks used to delimit tokens in the configuration file.
  2. The escape character must always be specified in hexadecimal format (^1b) because this is a non-printable character.

Example

This example shows the PCL command for setting a proportional character spacing in both alphanumeric and hexadecimal format. The escape character "^1b", which must always be specified in hexadecimal format, corresponds to the decimal value 27.

Alphanumeric format:

^1b(s1P

Hexadecimal format:

^1b^28^73^31^50

System Files

A list of existing Natural system file assignments is shown.

The paths for all possible system files (that is: for all possible DBID/FNR combinations) are defined in the global configuration file. These must be valid paths which indicate the physical location of the system files on the disk.

You can specify the following information:

DBID

The database ID.

FNR

The file number.

Alias name

This feature applies when working in a remote development environment (SPoD) with Natural for Windows.

When you specify an alias name for a system file, this name is shown in Natural Studio's library workspace.

Path

The path to the system file.

The DBID/FNR combination for each defined system file can then be defined in the parameter file. See System Files in the Overview of Profile Parameters.

Local Configuration File

This parameter group contains the following categories:

Administrator Assignments

You can specify whether a user is to be a Natural administrator or a configuration administrator. The following combinations are possible: 

+----- Administrator Assignments -----+
¦ C User Name  Administrator          ¦
¦              NATURAL CONFIGURATION  ¦
¦   NAT1          Y          Y        ¦
¦   NAT2          Y          N        ¦
¦   NAT3          N          Y        ¦
¦   NAT4          N          N        ¦

  • When a user is defined as both Natural administrator and configuration administrator (Y/Y), the user can modify all parameter files as well as the global and local configuration files. When such a user invokes the Configuration Utility, "(Config)" is shown in the right-hand corner of the screen (instead of the user ID).

    Note:
    Only Natural administrators can be defined as configuration administrators. However, when a user is defined only as a configuration administrator (N/Y), the above information applies. This is handled as if the user has been defined as both Natural administrator and configuration administrator (Y/Y).

  • When a user is defined only as a Natural administrator (Y/N), the user can modify all parameter files. The Configuration menu is not shown; thus, modification of the configuration files is not possible. When such a user invokes the Configuration Utility, "(Admin)" is shown in the right-hand corner of the screen (instead of the user ID).

  • When a user is neither defined as a Natural administrator nor as a configuration administrator (N/N), the user can only modify his own parameter file. When such a user invokes the Configuration Utility, the user ID is shown in the right-hand corner of the screen.

Buffer Pool Assignments

A table is shown which is used to define buffer pools. See also Natural Buffer Pool in the Operations documentation.

Note:
When parameters are changed, it is strongly recommended to restart the buffer pool, as a new session might not be able to connect to the buffer pool otherwise.

You can specify the following information:

BP Name

The name of the Natural buffer pool. The name can be up to 8 characters long. The name of the default buffer pool is NATBP. See also BPID in the Parameter Reference.

Caution:
Do not delete the default buffer pool NATBP, as it is possible that Natural may not function properly anymore.

BP Size

The size of the Natural local buffer pool. This setting is used during startup of the Natural buffer pool by the NATBPSRV server to create a global shared memory segment of the specified size.

Possible settings: 1 - 1024 MB.

Default setting for additional buffer pools: 1.

Maximum Users

The maximum number of users that can have simultaneous access to the buffer pool. This number determines the sizes of some internal tables stored inside the shared memory during startup.

Possible settings: 1 - 5000.

Default setting: 20.

Directory Entries

The number of directory entries. This value is used by the NATBPSRV server during the start of the buffer pool. If the maximum value has been reached, this value is automatically increased.

In case of a read-only buffer pool this value can be ignored because the number of directory entries is calculated on the basis of the preload list when the buffer pool is started.

Possible settings: 10 - 999999.

Default setting: 10.

Shared Memory Key

The shared memory key for the IPC facilities that the buffer pool is using. Ask your Linux administrator to supply the value for this key.

Important:
The shared memory key must be unique across your entire Linux system.

Semaphore Key

The semaphore key for the IPC facilities that the buffer pool is using. Ask your Linux administrator to supply the value for this key.

Important:
The semaphore key must be unique across your entire Linux system.

Read Only

When set to "ON", this is a special buffer pool which only allows read access. In this case, the value for the semaphore key is ignored.

For further information, see Read-Only Buffer Pool in the Operations documentation.

Alternate BP Name

For a read-only buffer pool, it is possible to define the name of an alternate buffer pool. The alternate buffer pool must also be a read-only buffer pool.

For further information, see Alternate Buffer Pool in the Operations documentation.

Installation Assignments

You can specify the following:

Path to parameter (PARM_PATH)

The location of the Natural parameter files.

Path to user profiles (PROFILE_PATH)

The location of the Natural user profiles.

Global configuration file (CONFIG_NAME)

The name and location of the global configuration file (default name is NATCONF.CFG).

Natural error file directory (ERROR_FILES)

The location of the Natural error files.

Natural I/O conversion table (NATCONV)

The name of the file which contains the character translation tables used with the internal character set ISO-8859-1. By default, this file is called NATCONV.INI. See Support of Different Character Sets with NATCONV.INI in the Operations documentation for further information.

Natural TMP directory (TMP_PATH)

The location of Natural temporary output.

Binary load path (NATEXTLIB)

The location of binary libraries of further Software AG products using Natural.

Terminal database (NATTCAP)

The name of the database which contains the descriptions of the terminal capabilities for each terminal type supported by Natural. See Natural Termcap (NATTERMCAP) Utility in the Utilities documentation for further information.

HA file share path (HA_FILESHARE)

Optional.

If specified, this directory will be used to share data between backend servers in a Natural/HA (High Availability) environment, where some information (such as sort files, print files and work files without path information) that would otherwise be written to the Natural TMP directory is written to this directory instead. In addition, work file or print file paths can be defined to be relative to this directory (e.g., $HA_FILESHARE/data/WRK01.SAG).

Note:
In a Natural/HA production environment, this directory should not only be accessible to all backend servers, but should also be highly available (e.g., an NFS mount in the Cloud), so as not to become a single point of failure.

Text file path (TXT_PATH)

The location of messages, choices and help texts used by the editors and by the Natural Termcap utility.

External keyphrase file (EXTKEY_NAME)

Optional.

If specified, this parameter specifies a path to a text file, the first (or only) line of which contains an arbitrary plaintext keyphrase (of which only up to a maximum of 64 characters are significant). Some information (e.g., REDIS© passwords, or saved Natural/HA sessions by default) is stored in encrypted form. The encryption depends on this external keyphrase (if any). The consequence of this is that, without knowledge of your external keyphrase, nobody (not even Software AG) can use or decrypt any of your encrypted data. Furthermore, even with the external keyphrase, there is no UI or API in Natural that allows the user to output the plain text corresponding to an arbitrary cipher text.

Note:
If you change the external keyphrase, or start or stop using one, any encrypted information stored in the configuration files needs to be re-encrypted. A convenient way of doing this is to start the Configuration Utility (natparm) as configuration administrator. It should then detect the key change and ask if you wish to re-encrypt the encrypted data. If you agree to do so, it will prompt for the old keyphrase. Once the old keyphrase (or empty string if no external keyphrase was previously in use) has been entered, the data will be re-encrypted in memory. Agree to save the changes to file when prompted to do so when exiting the utility. This update mechanism is not mandatory. It is always possible to manually re-enter the plain text data that needs to be re-encrypted (e.g., the REDIS© passwords), so that it is encrypted using the new external keyphrase.

User-defined libraries

The location of user-defined Natural libraries.

Instead of defining a specific path (for example: $NATDIR/<version>/lib/<mylib>), you can define an environment variable (for example: $NATUSER) and use it standalone or embed this variable in the path (for example: /opt/softwareag/Natural/<version>/lib/$NATUSER). At runtime, the path will be used with the currently valid environment variable (for example: <mylib>).

Note:
If you want to specify several libraries, you have to separate the names with a colon, for example userlib1:userlib2:userlib3.

Note:
. When you press TAB after having specified a valid path, the path is automatically expanded.