Version 4.2.6 for Mainframes (Update)
 —  Parameter Reference  —

LFILE - Logical System File Definition

This Natural profile parameter specifies information concerning the physical database file to be associated with a logical system file for Software AG products.

It can be used for Software AG products which have their own system files (for example, Con-nect and Natural Elite) to specify where such a system file is to be located. Such products use Database ID 255 and a logical file number (FNR) in their data definition modules (DDMs). With the LFILE parameter or the macro NTLFILE, you specify which physical database ID (DBID) and file number (and, if applicable, password and cipher key) are associated with that logical file number.

Natural records the physical file information and uses it for any database calls to Database ID=255 and File number=logical-ID.

Possible settings logical-FNR 1 - 251 Logical file number (LFL). This parameter is mandatory.
physical-DBID 0 - 65535, except 255 Physical database ID (DBID). Database ID 255 is reserved for logical system files for Software AG products.
physical-FNR 1 - 65535 Physical file number (FNR).
password   Must be a setting of 1 to 8 characters. *
cipher-key   Must be a setting of 8 numeric digits. *
options RO For read-only access.
Default setting none
Dynamic specification yes This parameter can only be specified dynamically. In the Natural parameter module NATPARM, the macro NTLFILE must be used instead. It replaces the old macro NTFILE for logical system file definition which is still available, but should not be used any longer.
Specification within session no
Application Programming Interface USR0011N See SYSEXT - Natural Application Programming Interfaces in the Utilities documentation.

* Recommended.

USR2004N *

* Password and cipher key are only required if the database file has been password-protected and/or ciphered using the Adabas security feature.

Note:
LFILE can also be used to define a so-called scratch-pad file with logical file number 212; see also the profile parameter ROSY and refer to Natural Scratch-Pad File in the Operations documentation.

To define different logical files, the LFILE parameter or the macro NTLFILE must be specified several times.

The following topics are covered below:


LFILE Parameter Syntax

The LFILE parameter is specified as follows:

LFILE=(logical-FNR,physical-DBID,physical-FNR,password,cipher-key,RO)

Top of page

NTLFILE Macro Syntax

In contrast to the former NTFILE macro which has keyword subparameters, the NTLFILE macro has positional subparameters (like the LFILE parameter) and is specified as follows:

NTLFILE logical-FNR,physical-DBID,physical-FNR,password,cipher-key,RO

Top of page

Old NTFILE Macro Syntax

For compatibility reasons, the old macro NTFILE is still supported. It is specified as follows:

NTFILE ID=logical-FNR,DBID=physical-DBID,FNR=physical-FNR,PASSW=password,CIPH=cipher-key,OPT=RO

Top of page

Example of LFILE Parameter

LFILE=(180,73,10),LFILE=(251,40,9,TEST99)

Top of page

Example of NTLFILE Macro

Equivalent specification in the Natural parameter module:

NTLFILE 180,73,10
NTLFILE 251,40,9,TEST99

Top of page