Use this file-level keyword to specify the name of the file from which field descriptions are retrieved.
The format of the keyword is:
REF([library-name/]database-file-name [record-format-name])
REF supplies the field attributes from a previously defined record format. Specify the file name once in the REF keyword instead of on several REFFLD keywords if each field description refers to the same file. To refer to more than one file, use the REFFLD keyword. You can specify the REF keyword only once.
The database-file-name is a required parameter value for this keyword. The library-name and the record-format-name are optional.
If you do not specify the library-name, the library list (*LIBL) in effect at file creation time is used. Specify a record-format-name as a parameter value for this keyword if there is more than one record format. If you do not specify the record-format-name, each record format is searched sequentially. The first occurrence of the field name is used. For information on how the choice of REF and REFFLD keywords controls these searches, see Appendix A, When to Specify REF and REFFLD Keywords for DDS Files.
You can specify a Distributed Data Management (DDM) file on this keyword.
When using a DDM file, the database-file-name and library-name are the DDM file and library names on the source system. The record-format-name is the record format name in the remote file on the target system.
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.