Release Information for Natural Version 9.3.4

This document covers the following topics:


Changes and Enhancements

Syntax and Compiler Enhancements

Enhanced Precision Support with Entire Connection and Transfer Types

Natural Runtime has been enhanced to support enhanced precision for N and P fields in conjunction with Entire Connection for file transfer. This enhancement introduces support for Entire Connection Protocol Version 4, enabling both TRANSFER and ENTIRE CONNECTION file transfer types to use the new protocol. For more information, see Parameter Reference > NCFVERS - NCF File Protocol Version.

Note
The documentation wrongly showed a default setting of 3 for the NCFVERS profile parameter. This has been corrected. The default setting is still 2.

Enhanced Definitions of Hexadecimal and Unicode Hexadecimal Constants

The definitions of hexadecimal and Unicode hexadecimal constants have been enhanced to allow spaces and commas to be used to separate the bytes (double bytes in the case of Unicode) from each other. This provides better flexibility in structuring the hexadecimal values and improves readability.

Examples:

UH’C1C2,C3C4,C5C6’ or UH’F1F2F3F4 F5F6F7F8’

H’C1C2,C3C4,C5C6’ or H’F1F2 F3F4F5 F6F7’

For more information, see Programming Guide > Field Definitions > User-Defined Constants.

Enhanced COMPRESS Statement to Allow Spacer Element

The COMPRESS statement has been enhanced to support the use of the spacer element “nX”. This allows you to insert up to 40 blanks between two fields.

Example:

COMPRESS 'Error' 1X #ERR 1X 'came from DB file (' #DBID '/' #FNR ')' INTO #T LEAVING NO SPACE

 

Result in #T:

'Error 1234 came from DB file (10/32)'

For more information, see Statements > COMPRESS.

Enhanced MOVE EDITED Statement

The MOVE EDITED statement has been enhanced to allow the use of the wildcard character ? in the input edit mask for operand2. This allows you to ignore the additional characters in the input contents of operand1.

For more information, see Statements > MOVE > Edit Masks with MOVE EDITED (Edit Mask Specified with operand2).

New System Variable *CPU-TIMEX

A new system variable *CPU-TIMEX is introduced to measure process time with a higher precision. This system variable returns CPU time used by the current Natural process in microseconds precision.

For more information on this new system variable, see System Variables > Application-Related System Variables > *CPU-TIMEX.

Natural Security

The following enhancements are provided with Natural Security Version 9.3.4:

Separation of Password and Passphrase Flags

Natural Security now separates password and passphrase flags, ensuring that password and passphrase settings are evaluated independently.

The key changes are:

  • Option Renaming
    The User password history option in General Options has been renamed to User password / passphrase history.

  • PF5 Key (PHist) Functionality
    When User password / passphrase history is activated, users can press PF5 (PHist) to modify the history flag.

    Editable: Only flag values Y or * can be modified.

    Restricted: The Maximum number of stored passwords / passphrases parameter cannot be changed via PF5.

  • User Preset Values
    When User password / passphrase history is activated, the following parameters under User Preset Values become strictly read-only and contain the same value as User password / passphrase history:

    • User password history

    • Maximum number of stored passwords

    • User passphrase history

    • Maximum number of stored passphrases

  • Terminology Standardization
    References to "password phrase" across Natural Security have been changed to "passphrase" for consistency.

Password Phrase Support without ICU Handler

You can now log on using a password phrase without the ICU handler.

Note
The password phrase history is affected if it exists.

Application Programming Interfaces (APIs)

Natural Security has upgraded its Application Programming Interfaces documentation and improved code clarity and navigation.

  • Improved Documentation Structure
    Clearer overviews of example programs and explicit listings of functions used within them.

  • Comprehensive Parameter Details
    Example programs now clearly define parameter types, including Input, In/Out, Output, and Unused parameters.

  • Enhanced Filtering Options
    The Natural Security Application Programming Interfaces screen now allows users to filter content directly by Example, Interface, or Description.

  • SYSSEC Library Modernization
    Cleaned up the SYSSEC library by removing outdated TXT* text modules.

Natural Web I/O Interface

By default, the Natural Web I/O Interface service starts the application which is requested by the client, without further checks. With the AllowedApplications configuration value, you can restrict this to a defined list of applications. For more information, see Restricting the Applications Which Can Be Started in the Natural Web I/O Interface documentation.

Natural Development Server

The following enhancement is provided with Natural Development Server Version 9.3.4:

New NDV Server Startup Parameter -logging

Natural Development Server is enhanced to support console logging of both server and activities performed by connected clients. This functionality is enabled through the new -logging startup parameter.

For more information about the usage, see Natural Development Server for Linux and Cloud > Operating Natural Development Server > Starting the Development Server.

Natural RPC (Remote Procedure Call)

With Natural Version 9.3.4, an enhanced Natural RPC Version 9.3.4 is delivered. With this, the following Natural RPC-specific application programming interface (API) is new in the SYSEXT system library:

API Task Description
USR9204N (new) Send command to RPC server

The RPC API sends a send-command request with the sequence number to the EntireX Broker.

The command transports a subprogram or an RPC command with the sequence number for an RPC server (or all sequence numbers of an RPC service).

The EntireX Broker 11.0 with CIS version 13 or higher is required.

For more information, see Natural RPC > Operating a Natural RPC Environment > Sending Command to RPC Server.

Utilities

Configuration Utility

The maximum number of users for the Natural buffer pool has increased from 5000 to 9999. These are stored as MAXUSERS in the Local Configuration file. For more information, see Local Configuration File > Buffer Pool Assignments.

SYSEXV Utility

The SYSEXV utility is now using a character mode interface instead of dialogs for better compatibility with other platforms. Examples using dialogs can still be started from SYSEXV.

The SYSEXV utility now provides all example programs demonstrating the use of Natural features introduced in the current or any previous version of Natural. The examples can now be grouped by Category or Version, or listed alphabetically by Member names. You can also specify a search string in the Search field so that only the examples containing the string in the member’s name, version, category or description are displayed.

New example programs have been added for the following features:

  • Enhanced COMPRESS with spacer element

  • System variable *CPU-TIMEX

  • Enhanced hexadecimal constants

  • Enhanced MOVE EDITED with wildcard character

  • System variable *UUID

  • Extended store clock system variable *TIMESTMPX

  • System variable *EDITOR

For more information, see Utilities > SYSEXV Utility.

Buffer Pool Monitor

The Natural Buffer Pool Monitor (NATBPMON) can now be used to detect and unblock a possibly deadlocked or otherwise stalled system if the problem is related to processes hanging while waiting (potentially endlessly) for a system file or buffer pool lock to become available. A new LOCKS command has been added to identify lock holders and/or blocking reader processes.

For more information, see Operations > Using the Command Line Version of the Buffer Pool Monitor (NATBPMON).

Application Programming Interfaces

The following Natural application programming interfaces (APIs) are new in the SYSEXT system library or have changed:

API Task Description
USR6002N Get the current values of internal counters

The MADIO-CUR parameter provides the current Adabas call counter and is defined using the (I4) format. It now supports the full (I4) value range, instead of (I2) value range.

USR8207N Maintain the number of DBMS calls, MAXCL and MADIO parameters

The new API USR8207N is the successor to API USR1068N.

All parameters are defined using the (I4) format. The MADIO and MAXCL parameters return values in the range of 30 through 32767 only.

The DBMS-CALLS parameter (Adabas call counter) supports the (I4) value range.

USR9178N Maintain local store clock value

The new copycode USR9178W returns a date-time value with microseconds in the following format:

yyyy-mm-dd hh:ii:ss.ffffff

where ffffff is the time fraction in microseconds.

The copycode is used with the INCLUDE statement:

INCLUDE USR9178W 'DATE-TIME'

whereby DATE-TIME is defined as (A26). The result looks like:

	2026-03-09 09:11:51.268138

The example program USR9178P has been extended to show the usage of the new copycode.

USR9301N Get buffer usage statistics

The API returns the size of Natural buffers like USIZE.

Using Natural Studio

Using Help

Natural Studio's context-sensitive help (invoked by pressing F1 or choosing the Help button) now opens the corresponding topic on the online documentation site in your default web browser instead of the local Windows HTML Help (.chm) file.

The documentation location is configurable using the DOC_URL_PREFIX setting in NATURAL.INI, allowing you to specify an alternative documentation site, for example, in restricted network environments.

For more information, see Using Natural Studio > Using Help.

Notice of Future Changes

The following will be changed in upcoming releases of Natural:

Natural Business Services / Natural Construct

Natural Business Services (NBS) will be discontinued as a single package and packaged together with Natural Construct (CST) with the next release.

Transition Period Logon

Support for the Transition Period Logon parameter (General Options) will be discontinued in the upcoming release of Natural Security (scheduled for October 2027). It is supported up to version 9.2.5 and will be removed in subsequent versions on z/OS.

If Transition Period Logon is currently active (value Y) in your FSEC, please migrate your required library, user, and DDM definitions to Natural Security before the support ends.

Library definitions can be added via:

  • Administrator Services using the Definition of Undefined Libraries function. For more information, see Natural Security > Administrator Services.

  • The PGMLI001 example program (SYSSEC library) or the NSCLI API. For more information, see Natural Security > Application Programming Interfaces.

  • The ADD command in SYSSEC Library Maintenance. For more information, see Natural Security > Library Maintenance.

User definitions can be added via:

  • The PGMUS001 example program (SYSSEC library) or the NSCUS API. For more information, see Natural Security > Application Programming Interfaces.

  • The ADDM (Add Multiple Users) or ADD commands in SYSSEC User Maintenance. For more information, see Natural Security > User Maintenance.

DDM definitions can be added via:

Natural Native Interface

Support for Natural Native Interface (NNI) functionality will be discontinued with the next release of Natural for Windows. Natural 9.3.4 is the last version that supports this functionality.

If you are still using NNI functionality, consider using Natural API Server on Linux as an alternative solution.

Removed Features

Natural for Tamino

The Natural for Tamino functionality as well as API USR6007N (“Get information on last error in Tamino database”) have been removed with this version of Natural.