In this section: |
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.
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.
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.
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.
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.
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.
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.
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:
Work Files:
You must set the parameter ENDMSG ON to verify the Natural program execution.
iWay Software |