Ignoring Record Formats

If a record format in an externally described file is not to be used in a program, you can use the IGNORE keyword to make the program run as if the record format did not exist in the file. For logical files, this means that all data associated with that format is inaccessible to the program. Use the IGNORE keyword on a file description specifications for the externally described file as shown in Figure 159.

The file must have more than one record format, and not all of them can be ignored; at least one must remain. Except for that requirement, any number of record formats can be ignored for a file.

Once a record-format is ignored, it cannot be specified for any other keyword (SFILE, RENAME, or INCLUDE), or for another IGNORE.

Ignored record-format names appear on the cross-reference listing, but they are flagged as ignored.

To indicate that a record format from an externally described file, is to be ignored, enter the keyword and parameter IGNORE(record-format name) on the file description specification in the Keyword field. Remember that even if the file is qualified, you do not use the qualified form of the name with the IGNORE or INCLUDE keywords.

Alternatively, the INCLUDE keyword can be used to include only those record format names that are to be used in a program. All other record formats contained in the file will be excluded.

Figure 159. IGNORE Keyword for Record Formats in an Externally Described File
*.. 1 ...+... 2 ...+... 3 ...+... 4 ...+... 5 ...+... 6 ...+... 7 ...+... *
FFilename++IPEASFRlen+LKlen+AIDevice+.Keywords+++++++++++++++++++++++++++++
 *
 *  Assume the file ITMMSTL contains the following record formats:
 *  EMPLNO, NAME, ADDR, TEL, WAGE.  To make the program run as if only the
 *  EMPLNO and NAME records existed, either of the following two methods
 *  can be used:
 *
FITMMSTL   UF   E           K DISK    IGNORE(ADDR:TEL:WAGE)
 *
 *  OR:
 *
FITMMSTL   UF   E           K DISK    INCLUDE(EMPLNO:NAME)
 *


[ Top of Page | Previous Page | Next Page | Contents | Index ]