You are here: LANSA for i User Guide > 2. Fields > 2.20 Field Reference File > 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.