Using Portus with Natural

Define a Natural Service manually

1. Add a new Portus Service, specifying the following:

   
   • A Service name
   • Select a driver of type "Natural" from the dropdown list

   • For "Service Identification and Options":

     • The Natural Library name in the "Library" field
     • The Natural subprogram name in the "Program" field
     Note: For Mainframe Natural only the Program name is to be entered, because the library is specified on the driver, not the individual Service

Create Service(s) and DataView(s) from Natural sources or a SYSOBJH unload file

In addition to the manual approach described in detail in the Data Views section, Services and DataView(s) for Portus can be generated/imported from SYSOBJH extracts or directly from Natural sources.

For a detailed description of the process refer to the Service Creation section

Prepare the Natural environment on Linux / UNIX

Using Portus in an environment protected by Natural Security (NSC)

• Specify a valid LOGON <library>,<userid>,<password> in the STACK parameter of the parameter module used with the Portus Natural driver.
• Library SYSEXT must be defined as a STEPLIB to library SYSSOA.

Defining the driver

In the Portus View, select the server you want to define a Natural driver for, right-click and select the "Add Driver" context function.

From the Driver Configuration Dialog select "Natural_Driver"

The following values are preset, change as required:

Only the Driver DLL parameter is to be entered as is, you are free to choose any Driver Name you wish, set the SBCS codepage and MBCS codepage parameters according to your local or internationalization requirements.

Click the Save button, you will now be asked to (optionally) enter Natural initialization parameters, for example PARM=MYPARM to use a Natural parameter module other than NATPARM.

Click the Save button again, the newly defined driver will appear in the Driver Properties section.

When "Show (post-setup) Driver Information" has been selected, the following information box will be shown, and allow the extraction of the SYSOBJH file containing the Portus Natural interface- and example programs.

Loading the Portus Natural system- and demo programs on Linux / UNIX

The following steps are required to load the Portus Service creation and demo programs in a Linux / Unix environment

• Start the Natural Configuration Utility (natparm)

• For the specific Natural Parameter file to be used when accessing Natural from Portus (default: “NATPARM”), select "Edit" -> “Natural Execution Configuration”

  

• Select “Steplibs”

  

• Define library “SYSEXT” as a “Steplib Extension”

  

• Press the “return” key to save the Steplib modification(s), then use the “Esc” key to close all windows.

  Select “File” -> “Save” to preserve the adjusted Steplib setting

  
• Quit the Natural Configuration Utility with “File” -> “Exit”.

• Before entering Natural to load the Portus system- and demo-programs the environment variable WRKF3 needs to be set to allocate work file 3 for the “Natural Object Handler”

  

  Here, as an example, the work file name is defined as “natwork3.sag” in the current working directory.

• Start Natural, tab to the “Direct” entry on the main menu, enter “SYSOBJH” to start the Natural Object Handler:

  

• Select the Object Handler “Load” function

  

• Select “Load objects from Natural work file(s)”

  

• Enter the Portus OBJH “Work file” name and select “Portable work file” and “Set additional options”

  

• Either enter a “Report file” name, or deselect the “Write report” option

  

• Hit the “return” key a number of times, the following screen will finally indicate what Object handler operation will be carried out:

  

• Hit the “return” key once again, the Portus Natural system- and demonstration objects will be loaded, the following message indicates the completion of the load operation.

  

• Press the Enter ( = return ) key again, and one more time to quit the load function, followed by the “Esc” key to terminate the Natural Object Handler.

  

Prepare the Natural environment on Windows

Using the Portus in an environment protected by Natural Security (NSC)

• Specify a valid LOGON <library>,<userid>,<password> in the STACK parameter of the parameter module used with the Portus Natural driver.
• Library SYSEXT must be defined as a STEPLIB to library SYSSOA.

Defining the driver

In the Portus View, select the server you want to define a Natural driver for, right-click and select the "Add Driver" context function.

From the Driver Configuration Dialog select "Natural_Driver"

The following values are preset, change as required:

Only the Driver DLL parameter is to be entered as is, you are free to choose any Driver Name you wish, set the SBCS codepage and MBCS codepage parameters according to your local or internationalization requirements.

Click the Save button, you will now be asked to (optionally) enter Natural initialization parameters, for example PARM=MYPARM to use a Natural parameter module other than NATPARM.

Click the Save button again, the newly defined driver will appear in the Driver Properties section.

When "Show (post-setup) Driver Information" has been selected, the following information box will be shown, and allow the extraction of the SYSOBJH file containing the Portus Natural interface- and example programs.

Loading the Portus Natural system- and demo programs on Windows

The following steps are required to load the Portus Service creation and demo programs in a Windows environment

• Start the Natural Configuration utility

  

• For the specific Natural Parameter file to be used when accessing Natural from Portus (default: “NATPARM”), under “Natural Execution Configuration” -> “Steplibs”, add library “SYSEXT” as a “Steplib Extension"

  

• Klick the “Save” button, or select File -> Save

  

• Start Natural Studio, the initial display will be something like this

  

• Import the Portus Natural interface and the demo programs. For this, start the Natural Object Handler – enter the command “SYSOBJH” in Natural Studio's Command line

  

• Select the Load function

  

• Select “Load objects from Natural work file(s)”

  

• Specify (or browse for) the Portus OBJH unload file, check “Portable work file”, select “Use additional options”, click “Next”

  

• click “Next”

  

• Click “Next” to “Load all objects from work file”

  

• Click “Next” again to start the actual load process.

  

• The Portus System- and Demo-programs have been loaded. Click “Next”.

  

• Click “Cancel” to terminate the Object Handler load function

  

• Confirm termination of the Object Handler load function by klicking “Yes”

  

• Dismiss the Object Handler “the Windows way” by clicking the “close” icon in the upper right hand corner.

  

Prepare the Natural environment on the Mainframe

Defining the driver

In the Portus View, select the server you want to define a Natural driver for, right-click and select the "Add Driver" context function.

From the Driver Configuration Dialog select "Natural_Driver", click the Configure button

The following values are preset, change as required:

As the Natural driver requires a number of additional parameters, the dialog will expand and prompt for more input. Again, fill these parameters as required, you are free to choose any Driver Name you wish, set the SBCS codepage and MBCS codepage parameters according to your local or internationalization requirements. Click Save again.

The parameters are as follows

Once saved, the newly defined driver will appear in the Driver Properties section:

When "Show (post-setup) Driver Information" has been selected, the following information box will be shown, and allow the extraction of the INPL oile containing the Portus Natural interface- and example programs.

The Portus server Job / STC

1. Add the Natural load library, or more specifically the load library containing the Natural batch nucleus specified in the driver's NaturalBatchPgm parameter and the modules NATXCAL and NATXCAL4 (contained in the Natural distribution load library), to the Portus server Job's / STC's STEPLIB.
2. You may want to add a CMPRINT DD statement to your server JCL, in case of an error during Natural session initialization or execution Natural will write its error messages to this dataset.
3. Ensure the Portus server region is sufficiently sized to cope for Natural's storage requirements, including the local bufferpool(s) if it is used.

Loading the Portus Natural system- and demo programs on the Mainframe

Any standard Natural INPL job can be used to load the Portus system- and demo-programs from the supplied dataset ASGvrm.INPL, for example (as usual, replace the library names, database parameters etc. to match your environment):

//SMAI061 JOB SAG,MSGLEVEL=1,
//          CLASS=O,MSGCLASS=X,REGION=8M
//*JOBPARM LINES=9999
//*
//* LOAD NATURAL PROGRAMS INTO ADABAS SYSTEMFILE
//* INPL Portus 411 SYSTEM FILE
//*      FROM FILE ASGvrm.INPL
//*
//NATB0100 EXEC PGM=NAT423BA,
//     TIME=1400,COND=(0,LT)
//STEPLIB   DD DSN=SAGLIB.SMALOAD,DISP=SHR
//          DD DSN=SAGLIB.ADA813.LOAD,DISP=SHR
//*
//CMPRMIN   DD *
STACK=INPL
IM=D,INTENS=1,XML=OFF,CFICU=OFF
NAFSIZE=0,DLISIZE=0,DB2SIZE=0,MADIO=0,MAXCL=0,MT=0
AUTO=ON
FUSER=(,8)
//*
//DDPRINT   DD SYSOUT=*
//DDDRUCK   DD SYSOUT=*
//MPMDUMP   DD DUMMY
//SYSUDUMP  DD DUMMY
//DDKARTE   DD DUMMY
//DDCARD    DD *
ADARUN DB=001,DE=3390,SVC=249,MODE=MULTI
//CMPRINT   DD SYSOUT=*
//CMWKF01   DD DSN=ASGvrm.INPL,DISP=OLD
B  
FIN
/* 
//