EXPIRED Request

The EXPIRED request copies files that are older than a particular date.

Syntax

<expired request>

            ┌◄─────────────────────────────────┐
── EXPIRED ─┴─┬─/1\─ AFTER ──<timestamp>─────┬─┴───────────────────────┤
              │                ┌◄──────────┐ │
              ├─ SAVECONSTANT ─┴─<integer>─┴─┤
              └─<filecopy modifier>──────────┘

Explanation

Components of the EXPIRED Request provides an explanation for the components of the syntax diagram.

Table 26. Components of the EXPIRED Request

Component

Explanation

EXPIRED AFTER <timestamp>

Copies files whose last access date plus the minimum of the SAVEFACTOR and the SAVECONSTANT values of each file is less than or equal to the timestamp. The default value for SAVECONSTANT is 60.

If you do not specify a value for the AFTER timestamp, FILECOPY extracts the TODAY value from the system, and performs checking based on the AFTER option.

EXPIRED SAVECONSTANT <integer>

Overrides the SAVEFACTOR value of each file if the value of SAVECONSTANT is less than the value of SAVEFACTOR. The algorithm used for EXPIRED is as follows:

LASTACCESSDATE + MIN(SAVEFACTOR,SAVECONSTANT) LEQ AFTER date

In this algorithm, LASTACCESSDATE is the date the file was last accessed.

Normally, FILECOPY uses the SAVECONSTANT value to determine the EXPIRED condition for all files that have a SAVEFACTOR value of zero (0). The SFACTORZERO option causes FILECOPY to use the zero SAVEFACTOR of a file to determine whether the file is expired. Refer to “FILECOPY Options” later in this section for more information.

The default value of SAVECONSTANT is 60. You can alter the default by recompiling FILECOPY after you change the define DEFAULTSFOVERIDE in SYMBOL/FILECOPY. The SAVECONSTANT option enables the system to define when a file has expired instead of permitting each file to define its expiration date.

<filecopy modifier>

Provides the following:

  • The names and kinds of disks from which files are to be copied

  • The names of the files and directions from which FILECOPY should select files for copying

  • The name and kind of the output disk, tape, or CD-ROM

  • Other control information