Installation and Compatibility

License File

A product license file for Natural is required.

A product license file for Natural is required. In addition, product license files are required for Natural Batch for zIIP, Natural for CICS for zIIP, Natural for Com-plete for zIIP and Natural for IMS for zIIP, if installed.

For information on Software AG's mainframe product licensing, see the Software AG Mainframe Product Licensing documentation.

Changes to Installation

This section describes the changes in the installation process of base Natural and the Natural add-on products released with this Natural version.

The sections indicated for more information are contained in the Natural Installation documentation, unless otherwise noted.

System Maintenance Aid: Readme File

For installation guidance and information on new or changed System Maintenance Aid (SMA) parameters and Natural features, you can view the product-specific Readme files by using the appropriate SMA function.

Start of instruction setTo view a product-specific Readme

  • From the product list on an SMA Maintenance screen, execute the RM (Show Readme File) command for the required product(s).

Changes to ICU Data Libraries

The ICU data libraries provided as Natural load modules with ICS (International Components for Unicode for Software AG) have changed due to the new ICU version (see also ICU Version Upgrade):

ICS 2.2.1 / ICS 2.2.2 Library Name ICS 3.1.1 does not support Data Libraries
ICSDT58E ---
ICSDT58J ---
ICSDT58X (not for z/VSE and BS2000) ---

ICSDT58X is not supplied for z/VSE, nor BS2000. However, you can create a user-defined ICU data library (see Customizing the ICU Data Library) or use single ICU data items as described in the Unicode and Code Page Support documentation.

For details on ICU data libraries, see the relevant section in the Unicode and Code Page Support documentation.

For the changes in installation steps, see the Installation Procedure for z/OS, z/VSE and BS2000 in Installing International Components for Unicode for Software AG in the Installation documentation.


This section provides the latest information for this Natural release regarding compatibility with earlier versions of Natural for Mainframes as well as with Natural on other platforms.

For information regarding Software AG product compatibility with IBM platforms and any IBM requirements for Software AG products, please review the Product Compatibility for IBM Platforms web page at

Special-Purpose Zaps

The following table lists Natural Version 8.2 Zaps and the special purposes they support:

Zap Special Purpose
NA93189 Suppress NAT3145 error information Suppress extra L2 calls to Adabas after a NAT3145 error has occurred.

If this Zap is applied, the application programming interface USR8202N no longer provides extended information on the NAT3145 error message.

NA93228 Migrate old maps Provide option to migrate Natural Version 4 maps that contain erroneous numeric field definitions to Natural Version 8.2.
NA95017, NA95018, NA95019, NA95020, NA95021 and NA95022 Support for the Arabic shaped format Keeps the shaped format of Arabic characters produced in a previous Natural version.
NA95038 Resolve problems (RSP=46) during Natural mainframe calls to Adabas LUW Resolve problems that can arise when Natural calls Adabas on Linux, UNIX or Windows from a mainframe platform: an unexpected RSP=46 can occur if a READ loop at the level 1 (*LEVEL=1) ends with an End-of-File (RSP=3) and is executed multiple times. This occurs because Natural on the mainframe does not send a final RC command to release the Adabas Format Buffer if the READ receives RSP=3.
NA96036 Define Arabic comma as special character The Arabic comma is not defined as a special character in Natural.

If this Zap is applied, the Arabic comma is treated as a special character.

NA97176 Support for the Arabic shaped format Correct mirroring error of characters like bracket signs.

Using ICS Version 3.1.1 with the Natural Development Server on z/OS (Batch)

If ICS Version 3.1.1 is used with a Natural Development Server on z/OS in batch mode the ICS load library must be added to the STEPLIB concatenation in the NDV startup job.

Additionally, if the Natural Development Server is configured to impersonate the NDV clients (SECURITY_MODE=IMPERSONATE or SECURITY_MODE=LOCAL) the ICS load library must be added to the Sdefined to the program class "**" of RACF

ralt program ** addmem('ICS311 load library'//NOPADCHK) uacc(read)