Version 4.2.6 for Mainframes
 —  Installation  —

Installing the Software AG Editor

The Software AG Editor is an optional feature that represents basic functionality within Natural, which is exclusively used by several Natural subproducts and other Software AG products.

The following topics are covered:

For details on the following topics, see also the documentation listed below:

Notation vrs or vr: If used in the following document, the notation vrs or vr stands for the relevant version, release, system maintenance level numbers. For further information on product versions, see Version in the Glossary.


Prerequisites

Installation Modules

As the Software AG Editor is an integral part of Natural, it can only be installed together with the current Natural version; that is, the version it is supplied with. The installation modules are provided as part of the Natural installation datasets.

Software AG Editor as an Alternative to the Natural Program Editor

If you want to use the Software AG Editor as an alternative to the Natural program editor, you still need to have Natural ISPF installed and to set your editor profile appropriately. For detailed information, see Editor Profile in the Natural Editors documentation.

Using SMA

If you install the Software AG Editor by using SMA, you must set a flag to Y (yes). This flag is called:

Platform: Requirement:
z/OS or z/VSE SAG-EDITOR
BS2000/OSD The installation of the Software AG editor takes place automatically when installing Natural for BS2000/OSD.

Top of page

Support of a z/OS Parallel Sysplex Environment

To support a z/OS Parallel Sysplex environment, that is, to be able to switch the z/OS host during a Natural session, the Software AG Editor must run without a buffer pool.

For this purpose, the profile parameter EDPSIZE (described in the Natural Parameter Reference documentation) is supplied where you can specify the size of an auxiliary editor buffer pool. All editor data are kept in the user storage thread. The total editor work space per user is limited by the EDPSIZE parameter. No editor work file is required. The RECOVER mechanism of the Software AG Editor is not supported.

Top of page

Migrating from Previous Versions

Since the RECOVER mechanism from Software AG Editor is upward compatible, you can continue using a buffer pool work file from previous versions. It is possible to share buffer pools and their work files between Versions 4.1 and 4.2.

If you want to use Version 4.1 and Version 4.2 editor work files concurrently in the same region, you have to use different logical dataset names. To define the dataset names, use the parameter DDNAME in the Natural parameter module.

Top of page

Installation Procedure under z/OS and z/VSE

The installation procedure for the integrated Software AG Editor under z/OS and z/VSE consists of the following steps:

Step 1: Adapt the Editor Buffer Pool Parameter Macro NTEDBP

Step 2: Allocate the Editor Work File

Step 3: Format the Editor Work File

Step 4: Modify the Start-Up JCL and Subsystem Definitions

Step 5: Adapt all Natural Parameter Modules

Step 6: Define a Global Editor Buffer Pool

Step 7: Relink Natural with the Software AG Editor

Top of page

Installation Procedure under BS2000/OSD

The installation procedure for the integrated Software AG Editor under BS2000/OSD consists of the following steps:

Step 1: Adapt the Natural Parameter Macro NTEDBP

Step 2: Adapt all Natural Parameter Modules

Step 3: Allocate and Format the Editor Work File E.FRM.EDITWORK

Step 4: Modify the Start-Up Procedures for your Natural Nuclei

Step 5: Start the Global Editor Buffer Pool

Step 6: Relink Natural with the Software AG Editor

Top of page

Installation Procedure under CMS

The installation procedure for the integrated Software AG Editor under CMS consists of the following steps:

Step 1: Adapt the Natural Parameter Module

Step 2: Relink Natural with the Software AG Editor

Top of page

Installation Verification for the Software AG Editor

Once you have installed the editor, you can verify the installation.

Invoke Natural and enter SYSEDT on the command line.

The Natural utility SYSEDT displays all buffer pool parameters and usage statistics; see SYSEDT Utility - Editor Buffer Pool Administration in the Natural Utilities documentation.

To be able to test the full operation of the Software AG Editor, a subproduct (for example, Natural ISPF) must be installed which uses its functionality.

Top of page