2 20 2 Create or Re Create a Field Reference File

2.20.2 Create (or Re-Create) a Field Reference File

If the option to create or re-create a field reference file is chosen from the field control menu this screen is displayed:

DC@P218001          Create System Field Reference File                      Submit this job  . . . . . . . . . . . . . . . . .  YES   YES, NO                                                                               Using Job name   . . . . . . . . . . . . . . . . .  XXXXXXXXXX                Job description  . . . . . . . . . . . . . .  *LIBL/QBATCH        Job queue  . . . . . . . . . . . . . . . . .  *JOBD        Output queue   . . . . . . . . . . . . . . .  *LIBL/QPRINT                                                                          Create field reference file named  . . . . . . . .  FLDREF                    In library named   . . . . . . . . . . . . .  QGPL                                                                                       Produce source listings  . . . . . . . . . . . . .  NO    YES, NO             Fnn=Help  Fnn=Exit  Fnn=Cancel  Fnn=Messages

 

Input Options

These input options apply to creating a field reference file:

Submit This Job

Job Name

Job Description

Job Queue

Output Queue

Create Field Reference File Named

Specifies the name of the field reference file that is to be created or re-created. Pre-filled to FLDREF. Can be changed as desired. LANSA checks that the name supplied is a valid file name.

In Library Named

Specifies the name of the library in which the field reference file is to be created or re-created. Pre-filled to QGPL. Can be changed as desired. Special value *LIBL (search library list) is NOT acceptable. LANSA checks that name supplied is a valid library name, but does not check that the library actually exists. Specification of a non-existent library will cause the batch job to fail. Error messages in the job log will indicate the cause of the failure.

Produce Source Listings

Indicates whether the DDS (data description specifications) used to create the field reference file should be printed. Allowable values are:

YES	Produce the DDS source listings.
NO	Do not produce DDS source listings.

 

LANSA will attempt to delete the named field reference file in the library specified before attempting to create a new field reference file. It may be necessary to authorize the LANSA owner profile to delete any existing field reference file(s).

Creation of a field reference file with a large number of fields (> 1000) may take an extended period of time. In such cases the batch job should be scheduled for overnight or off-peak execution.