The GUARDFILE = <file title> modifier causes the FILENAMES request of FILEDATA to report only on the files guarded or controlled by the specified guard file. Because family substitution is not applied for either the input guard file title or the guard file titles associated with the files, you should provide the exact guard file title, including the usercode and the family name, to ensure proper matching with guarded files.

FILEDATA also checks for existence of the specified guard file. Warning messages such as “GUARDFILE DOES NOT EXIST” and “GUARDFILE IS NOT VISIBLE” are displayed to caution you about potential errors with the requested guard file. Despite such warnings, any files that are guarded or controlled by the specified guard file are still reported.

If no files are found to be guarded by the specified guard file, the output is the following:

TOTAL SEGMENTS SHOWN = 0

GUARDFILE is invalid with the CONTAINER and TAPE modifiers.