
	Version 8.2.3 for Mainframes	SEARCH CONTENTS \| PDF BOOKS \| HOME UP PREV NEXT

— 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 corresponds to the macro NTLFILE in the Natural parameter module NATPARM.

Possible settings	See LFILE Parameter Syntax.
Default setting	none
Dynamic specification	yes	This parameter can only be specified dynamically. In the Natural parameter module `NATPARM`, the macro `NTLFILE` is 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`
Application programming interface	`USR2004N` (recommended)

Notes:

LFILE and NTFILE can be used for Software AG products which have their own system files (for example, Con-nect, Natural Review) 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.
LFILE can also be used to define a so-called scratch-pad file with logical file number 212; see also the profile parameter ROSY, Natural Scratch-Pad File in the Operations documentation, and Defining a Scratch-Pad File in the Installation for z/OS, Installation for BS2000/OSD and Installation for z/VSE documentation.

The following topics are covered below:

LFILE Parameter Syntax
NTLFILE Macro Syntax
Old NTFILE Macro Syntax
Example of LFILE Parameter
Examples of NTLFILE Macro

LFILE Parameter Syntax

The LFILE parameter is specified as follows:

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

Where:

Syntax Element	Value	Explanation
`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`	1 - 8 characters.	Password and cipher key are only required if the database file has been password-protected and/or ciphered using the Adabas security feature.
`cipher-key`	8 numerical digits.
`options`	`RO`	Flag for read-only access.

Note:
To define different logical files, the LFILE parameter must be specified multiple times (separated by a comma or a blank); see Example of LFILE Parameter.

NTLFILE Macro Syntax

In contrast to the old NTFILE macro described below, which has keyword subparameters, the NTLFILE macro has positional subparameters (similar to the LFILE parameter). It is specified as follows:

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

Notes:

For an explanation of the syntax elements and for possible values, see LFILE Parameter Syntax.
To define different logical files, the LFILE parameter or the macro NTLFILE must be specified several times; see Examples of NTLFILE Macro.

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

Example of LFILE Parameter

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

Examples of NTLFILE Macro

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

SEARCH CONTENTS | PDF BOOKS | HOME UP PREV NEXT