File Selection Qualifiers

This page describes DCL command qualifiers that allow you to select certain files for command execution.

/BACKUP

Modifies the time value provided with the /BEFORE or the /SINCE qualifier. The /BACKUP qualifier selects files according to the date of their most recent backup (rather than by the creation, expiration, or modification date).

/BEFORE

Selects only those files dated prior to the specified time. You can specify time as absolute time, as a combination of absolute and delta times, or as one of the following keywords:

• BOOT
• LOGIN
• TODAY (default)
• TOMORROW
• YESTERDAY

Specify the /CREATED (default) or the /MODIFIED qualifier to indicate the time attribute to be used as the basis for selection.

/BY_OWNER

Selects files whose owner's UIC matches the UIC specified. The default UIC is that of the current process.

/CREATED

Modifies the time value specified with the /BEFORE or the /SINCE qualifier. The /CREATED qualifier selects files according to the date they were created (rather than by the backup, expiration, or modification date).

/EXPIRED

Modifies the time specified with the /BEFORE or the /SINCE qualifier. The /EXPIRED qualifier selects files according to their expiration dates rather than by the backup, creation, or modification date. (The expiration date is set with the SET FILE/EXPIRATION_DATE command.) By default, files are selected according to their creation date.

/MODIFIED

Modifies the time value specified with the /BEFORE or the /SINCE qualifier. The /MODIFIED qualifier selects files according to the dates on which they were last modified, rather than by the backup, creation, or expiration date.

/SINCE

Selects only those files dated on or after the specified time. You can specify time as absolute time, as a combination of absolute and delta times, or as one of the following keywords:

• BOOT
• LOGIN
• TODAY (default)
• TOMORROW
• YESTERDAY

Specify the /CREATED (default) or the /MODIFIED qualifier to indicate the time attribute to be used as the basis for selection. The /CREATED qualifier is the default.