This document covers the following topics:
The system requirements for the current version of Natural are now listed in the Installation documentation.
Natural for Windows is now installed using the Software AG Installer. For more information, see the Installation documentation.
Note:
Natural no longer provides a file server installation. As
of this version, you can only install Natural on a local hard drive on a
Windows system.
The environment variables NATDIR and
NATVERS are no longer required for starting
Natural.
The Natural utilities which have used these environment variables have
been adapted. The Object Handler now provides
NATROOT as a new valid input value.
Natural now determines from which directory it has been started and
automatically uses the appropriate local configuration file
(natural.ini). By default,
natural.ini is located in the Etc
directory which is located within the Natural installation directory. If
required, you can still set the environment variables
NATDIR and NATVERS,
for example, to simplify the start of Natural in your environment or to ensure
compatibility with your existing batch files in the Natural Version 8.3 environment.
With Natural for Windows Version 8.3.1, a different compiler version was used to build and test Natural: Microsoft Visual Studio 2010. See also Compiler Used to Build Natural in the Installation documentation.
Applications that were created with Natural for Windows Version 3.1 and above can be executed with Version 8.3.
The utility SYSEXT provides the following
new application programming interface (API):
| API | Description |
|---|---|
USR8208 |
This API terminates an EntireX Broker of
version 5 or above by using the Command and Information Service of EntireX
Broker. It also returns version information on the EntireX Broker and the
Command and Information Service itself. For older versions, the same method as
in USR2075N is used.
|
The return code handling of batch Natural processing has been changed:
A TERMINATE nnn statement now
causes nnn to be always set as the return code of a
Natural run.
The return code set by a TERMINATE statement now
overrides the return code 61 which is set due to a runtime error.
Error message NAT9987 now appears in the file identified by Natural
parameter CMPRINT if a Natural run was stopped by a
TERMINATE statement.
Review your batch procedures and check whether there are dependencies related to the above mentioned changes.
A new exit code 91 is available. It is issued when a connection to the Natural Web I/O Interface is not available. See also Natural Exit Codes in the Operations documentation.
To improve the migration of Natural applications, the sequence in which
the system command CATALL
catalogs the Natural objects has been changed. The following table compares the
new sequence with the old sequence as used in Version 6.3.
| New Sequence as of Version 8.3.1 | Old Sequence in Version 6.3 | |
|---|---|---|
| 1 | DDMs | DDMs |
| 2 | Global data areas | Global data areas |
| 3 | Local data areas | Local data areas |
| 4 | Parameter data areas | Parameter data area |
| 5 | Copycodes * | Classes |
| 6 | Texts * | Maps |
| 7 | Functions | Dialogs |
| 8 | Subprograms | Subroutines |
| 9 | Subroutines | Subprograms |
| 10 | Helproutines | Functions |
| 11 | Maps | Adapters |
| 12 | Adapters | Helproutines |
| 13 | Programs | Programs |
| 14 | Classes | |
| 15 | Dialogs |
* Copycodes and texts are processed as of Version 8.3.
Natural Development Server is now released with the same version number as Natural for Windows.
The following changes and enhancements are provided with Natural Development Server Version 8.3.1.
A new optional start option is available which defines the types of clients which are permitted to connect to the server:
-c[lient][=]<type>
where <type> can be one of the following:
| Type | Description |
|---|---|
NAT |
Only Natural for Windows (Natural Studio) clients are permitted to connect to this server. |
ONE |
Only NaturalONE clients are permitted to connect to this server. |
ANY |
Both Natural for Windows (Natural Studio) and NaturalONE clients are permitted to connect to this server. |
If this start option is not specified, the server will use
ANY as the default. If a client which is not permitted tries to
connect to the server, error NAT7742 will be issued, indicating
that the current IDE is not permitted.
See also Starting the Development Server in the Natural Development Server documentation for Windows, which is available separately.
The file NDVSERVER.LOG (located in the subdirectory Natural\Prof), which is used to terminate the started Natural development servers, has been renamed to NDVSERVER.PRU. Existing entries inside the NDVSERVER.LOG file are not migrated to NDVSERVER.PRU.
Natural RPC (Remote Procedure Call) is available as a separate subcomponent of Natural. It has its own version number. This measure takes into account that Natural RPC is a cross-platform component and makes it possible to provide new Natural RPC versions independent of new Natural versions for the various platforms supported.
With Natural Version 8.3.1, an enhanced Natural RPC Version 6.3.4.9 is delivered. This version only contains error corrections. New functionality is not provided.
The following enhancements are provided with Natural Security Version 8.3.1.
- Password History
The field User password history in Library and User Preset Values > User Profile Items can now be set to asterisk (*) to allow the activation of password history for individual users.
- Batch ETID
The security profiles for users of types A, P, M and E provide a new ETID Batch field. This field is used to specify an ETID for a Natural batch-mode session, if this is to be different from the one used for an online session. See Components of a User Profile in the Natural Security documentation for more information.
- Additional Options - Groups/Members
The Groups/Members field is now also available for users other than groups in the user maintenance functions Add User, Copy User and Modify User.
- Copy With Links
The Copy Library function, when used with the With Links option, now handles DDMs correctly as documented.
- Copy Function Enhanced
The function Copy Link to All Special Links (function code
CU) has been enhanced and renamed; in addition to copying a DDM's links, it now also copies a DDM profile to all special links. See Copy Profile/Link to All Special Links in the Natural Security documentation for details.
- User ID "DBA"
If environment protection is active, the user ID "DBA" may be used to log on to the library SYSSEC, even if the environment is undefined. This makes it possible to define new environments.
- SYSOBJH
A new Xref option is provided to control how Predict cross-reference data related to objects processed with the SYSOBJH utility are handled. See Additional Options under Protecting Utilities in the Natural Security documentation for more information.
With Natural Development Server Version 8.3.1, a new start option is provided which defines the types of clients permitted to connect to the server. This option is also supported by Natural Security. The new Natural Security option Natural client access can be set in library preset values, user profiles (types Administrator, Person and Group), library profiles and special link profiles. It defines the types of clients permitted to connect to the server.
Possible values are:
| Value | Description |
|---|---|
| N | Only Natural for Windows (Natural Studio) clients are permitted to connect to this server. |
| O | Only NaturalONE clients are permitted to connect to this server. |
| A | Default. Both Natural for Windows (Natural Studio) and NaturalONE clients are permitted to connect to this server. |
| P | Natural for Windows (Natural Studio) and NaturalONE clients are not permitted to connect to this server. |
If a client which is not permitted tries to connect to a library, error
NAT7742 will be issued, indicating that the current IDE is not
permitted.
The MOVE ALL statement is now documented with the
MOVE statement: see
Syntax 9 - MOVE
ALL. As a result, you can no longer select MOVE
ALL from the Quick Reference selection box of the
Statements
overview page.
The LIST COUNT system command is now documented with the
LIST system
command: see Syntax
Overview and
Displaying
Numbers and Sizes of Objects. As a result, you can no
longer select LIST COUNT from the Quick
Reference selection box of the
System
Commands overview page.
The features to be removed which have been announced in the Release Notes for Version 6.3 are no longer available with Version 8.3:
Remote debugging is no longer supported. Instead, you will have to use the debugger of NaturalONE. Using the NaturalONE debugger, it is possible, for example, to debug Natural RPC applications or to debug workplace applications which have been created with Natural for Ajax.
Up to Natural Version 6.2 for Windows, a debugger was delivered which was not integrated in Natural Studio. This debugger was named "old debugger" in the Natural Version 6.3 documentation. This old debugger is no longer supported. The corresponding documentation has been removed.
Instead, you can use the integrated debugger which was introduced with Natural Version 6.2. See the Debugger documentation for further information.
SYSWEB is no longer supported. It is no longer delivered
on the product CD.
The interface SYSWEB3 is now to be used instead of
SYSWEB. If you have not already done so, you have to update your
programs written for SYSWEB to run with the SYSWEB3
interface. See Migrate
Natural Web Interface SYSWEB to SYSWEB3 in the
Web Technology documentation for further information.
The external sort program SyncSort is no longer supported.
The Natural Reporter is no longer part of the Natural installation. For Natural for Windows customers, the Natural Reporter is now only available for download.
Natural now determines from which directory it has been started.
Therefore, the Natural profile parameter NATVERS has
been removed.
The Natural profile parameter XADB was not used
and has therefore been removed.
The utilities SYSPAUL and SYSTRANS are no longer delivered with Natural. Thus, it is no longer possible to install these utilities by issuing the corresponding system commands for the first time. Use the Object Handler instead.
Remote debugging is no longer supported. Therefore, the profile
parameters RDACTIVE, RDNODE and RDPORT
are no longer required. They will be removed with a future version of
Natural.
Natural is now installed with the Software AG Installer. Therefore, the Natural Installer utility is no longer required. It will be removed with a future version of Natural.