Version 9.6
 —  Administration under IBM i  —

Natural RPC Server Configuration for the IDL Extractor for Natural

This document describes how to configure the Natural RPC Server when using the IDL Extractor for Natural.It covers the following topics:


Natural Steplib Configuration

The Natural IDL Generator server library SYSIDL relies on the following Natural system libraries to function correctly:

Library Function
SYSIDL IDL Extractor for Natural server library
SYSRPC Natural RPC system library
SYSEXT Natural interface library
SYSLIBS Natural system library

Depending on whether the Natural RPC Server is used in a Natural Security environment or not, steplibs are defined differently.

Top of page

Natural RPC Server Configuration when Natural Security is not used

Defining Steplibs when Natural Security is not used

Start of instruction setTo define Steplibs

Installation Notes when Natural Security is not used

Top of page

Natural RPC Server Configuration when Natural Security is used

Defining Steplibs when Natural Security is used

In a Natural Security environment, the required steplibs must be defined in the library profile of:

Natural Security Definitions

In a Natural Security environment, clients using the IDL Extractor for Natural need to be defined in Natural Security with access to

Installation Notes when Natural Security is used

  1. If your Natural user applications supported by the Natural RPC Server need more than four steplibs, a separate Natural Security file FSEC and Natural RPC Server instance must be set up for Natural IDL generation only. You cannot use the same Natural Security file FSEC and Natural RPC Server instance on which your Natural user application is running.

  2. You cannot use the STACK parameter to set steplibs if Natural Security is used.

  3. Under Natural Security, start the Natural RPC Server with LOGONRQ=ON. If this setting conflicts with your Natural user applications, we recommended setting up a separate Natural RPC Server instance for IDL Generation.

Top of page

Natural RPC Server Parameter Configuration

Basically all parameters valid for Natural and Natural RPC Server are valid for use with the IDL Extractor for Natural server library SYSIDL.

The most important Natural RPC Server parameters to be set are:

Parameter Optional/Required Explanation and Notes
SRVNODE=<value> Required The Broker ID.
SRVNAME=<value> Required The server name as defined under SERVER under Broker Attributes.
TIMEOUT=55 Optional Wait timeout for the Natural RPC Server. The default value 55 is suitable for most installations. It can be adapted if necessary.
LOGONRQ=ON Required to be ON if Natural Security is used. Forces clients to log on to Natural libraries.
MADIO=0 Required No limit on DB Calls.
MAXCL=0 Required No limit on PGM Calls.
YSLW=1979 Optional, but recommended to be set. The century of save and compile (catalog) dates of Natural objects may be displayed incorrectly if you do not set a Year Sliding or Fixed Window. We suggest setting a fixed window starting from 1979 on. This ensures a correct century in the range 1979 (first release of Natural programs) up to the year 2078. If this window setting conflicts with your application requirements, consider
  • using a separate RPC server for the server library SYSIDL.

  • using other YSLW settings which may also solve the problem. See your Natural documentation for more information.

Displaying an incorrect century does not have any impact on IDL generation - only the timestamp in the browse dialogs will be incorrect.

You will find the above parameters in your NATPARM module or you can set them dynamically.

See your Natural documentation for more information.

Top of page