Version 4.2.6 for Mainframes (Update)
 —  Operations  —

Using a Natural Parameter Module

This document provides information on how to assemble a Natural parameter module.

The following topics are covered:

For details of the individual profile parameters, refer to the Parameter Reference documentation.


Using the Default Natural Parameter Module NATPARM

The default Natural parameter module NATPARM contains a set of predefined parameters that are sufficient for most environments. The module is delivered in source form to enable you to change it according to your requirements.

Top of page

Creating a New Natural Parameter Module

Instead of using or modifying the default Natural parameter module, you can create one or several alternative Natural parameter modules for various purposes which can be loaded as appropriate using the Natural profile parameter PARM and whose use can be restricted to certain users (See Restricting the Use of a Parameter Module).

Start of instruction setTo create a new (alternative) Natural parameter module

  1. Assemble the macro NTPRM (see also Assembler Macro Coding Conventions below).

  2. Add one or more of the optional parameter macros (see below).

If more than one parameter macro is specified, the NTPRM macro must be specified first; any other macros after the NTPRM macro can be specified in any order.

Note:
It is not necessary to create separate parameter modules for batch and teleprocessing modes of operation. Those parameters which are not applicable to the environment in which Natural is executed are ignored.

Top of page

NTPRM Macro - Create a Natural Parameter Module

The NTPRM macro must be assembled in order to create a Natural parameter module.

Generally, you can use the default values of the profile parameters in the NTPRM macro. If any of the default values do not suit your requirements, you can overwrite them with your own values.

For a description of the individual profile parameters, refer to Parameter Reference documentation.

NTPRM Syntax

The syntax for this macro is:

NTPRM parameter=value,...

Assembler Macro Coding Conventions

Assembler macro coding conventions must be adhered to when changing parameter values, for example,

Top of page

Restricting the Use of a Parameter Module

You can add the macro NTUSER to a parameter module to restrict its use to certain users.

Start of instruction setTo restrict the use of a parameter module

  1. Add the macro NTUSER to the parameter module.

  2. In this macro, define the IDs of those users who are to be enabled to use that parameter module.

Only these users will be allowed to specify the name of that parameter module with the profile parameter PARM.

Top of page

Using Macros in a Natural Parameter Module

A Natural parameter module contains the macro NTPRM in first place. In addition, you can specify the following macros in any order.

Macro Function
NTALIAS External names of non-Natural programs.
NTBPI Buffer pool initialization.
NTCCTAB Printer escape sequence definition.
NTCFICU Enables Unicode support for various Unicode settings.
NTCMPO Compilation options.
NTCSTAT Programs statically linked to Natural.
NTDB Database types and options.
NTDS Define size of storage buffer
NTDYNP Control use of dynamic parameters.
NTEDBP Software AG editor buffer pool definitions
NTFILE See NTLFILE > Old NTFILE Macro Syntax
NTLFILE Specification of logical files.
NTOPRB Database open/close processing.
NTOPT Control of Natural Optimizer Compiler.
NTPRINT Print file assignments.
NTPRM Create a Natural Parameter Module
NTRPC Handling of remote procedure calls.
NTSCTAB Scanner characters.
NTSORT Control of sort program.
NTSYS Define and activate a set of dynamic profile parameters.
NTTAB Standard output character translation.
NTTABA1 EBCDIC-ASCII translation.
NTTABA2 ASCII-EBCDIC translation.
NTTABL "SYS" library output translation.
NTTAB1 Alternative output translation.
NTTAB2 Alternative input translation.
NTTF Translation of database ID/file number.
NTTRACE Define components to be traced.
NTUSER Restrict use of profile parameter strings and modules.
NTUTAB1 Lower-case/upper-case translation.
NTUTAB2 Upper-case/lower-case translation.
NTWEBIO Enable or disable the rendering of certain features of the Natural Web I/O Interface display.
NTWORK Work files assignments.
NTXML Activate PARSE XML and REQUEST DOCUMENT statements.

Top of page