Preparing the NATURAL Environment

Topics:

In order to be able to access Adabas databases from Natural programs, you must set up the Adabas environment. For details, see Using the Adapter for Adabas.

You must then perform several operating system-specific tasks to set up the Natural environment itself.

Modifying Model Files

z/OS:

Model files with the jcl extension are supplied in the home/etc directory. They contain jobs to be executed on the mainframe. You must modify these file by supplying correct values in all lines marked with <-- characters.

  • IWAYNATB. Installs the supporting NATURAL program IWAYNATB in the Adabas NATURAL file that contains library SYSEXT. This program is used in synonym creation.

    You can change the library and/or program name. However, the new name(s) must be changed correspondingly in the natbdbs.acx file.

    If you choose a non-SYSEXT library, you must either place the SYSEXT library in the NATURAL profile steplib list or concatenate the new library with the SYSEXT library.

  • IWAYIVPB. Installs the example NATURAL program IWAYIVPB and local data areas. IWAYTSTI/IWAYTSTO define input/output buffers processed by the program. You can install these NATURAL objects in any NATURAL library.

    You can change the program name, however, if you rename data areas, you must change the names correspondingly in the program IWAYIVPB source code. These objects are used to verify synonym creation.

Windows and UNIX:

Model files with the natural extension are supplied in the home/etc directory. These files must be processed by the SAG NATURAL utility SYSTRANS.

  • IWAYNATB. You must install the Natural program in the library SYSEXT. This program is used in synonym creation.

    You can change the library and/or program name. However, the new name(s) must be changed correspondingly in the natbdbs.acx file.

    If you choose a non-SYSEXT library, you must either place the SYSEXT library in the NATURAL profile steplib list or concatenate the new library with the SYSEXT library.

  • IWAYIVPB. You must install the Natural program along with the supporting data areas to any library (SYSTEM is default). IWAYTSTI/IWAYTSTO data areas define input/output buffers processed by the program.

    You can change the program name, however, if you rename data areas, you must change the names correspondingly in the program IWAYIVPB source code. These objects are used to verify synonym creation.

Setting Up the NATURAL Environment

On z/OS:

Prior to configuring the Adapter for NATURAL using the Web Console, you must edit the IRUNJCL that is used to initiate the server by allocating the following database and Natural load libraries to the server STEPLIB:

//IRUNJCL     PROC
//STEPLIB  DD DISP=SHR,DSN=EDABXV.SRV71.HOME.LOAD
//         DD DISP=SHR,DSN=SAGLIB.NAT314.LOAD
//         DD DISP=SHR,DSN=ADABAS.V742.LOAD

Alternatively, if the server is started from USS using edastart, export STEPLIB from the edastart file, as follows:

export STEPLIB=SAGLIB.NAT314.LOAD:ADABAS.V713.LOAD

On Windows:

Add Natural directory to the PATH.

On UNIX:

Execute the sagenv script as follows to set the environment:

. <SAG-root-directory>/sagenv

Either sagenv or sagenv.new is generated during Natural installation and setup. For details, refer to the SoftwareAG Natural documentation.

Maintaining the NATURAL Parameter File on Windows and UNIX

Use the SAG-provided utility, natparm, to maintain the NATURAL parameter file. It is good practice to create a copy of the standard system parameter file and use this copy to run the adapter. The name of the new file is stored as part of the connection information.

The parameter file must contain the following data channels and work file definitions:

Input Data Channels:

  • value for CMOBJIN - %EDATEMP%\cmsynin
  • value for CMSYNIN - %EDATEMP%\cmsynin
  • value for CMPRINT - %EDATEMP%\cmprint

Work Files:

  • value for CMWKF31 - %EDATEMP%\cmwkf31 (Type=SAG)
  • value for CMWKF32 - %EDATEMP%\cmwkf32 (Type=SAG)

You must set the parameter ENDMSG ON to verify the Natural program execution.

WebFOCUS

Feedback