CREATED, ACCESSED, UPDATED, and ANYUPDATED Requests

The CREATED, ACCESSED, UPDATED, and ANYUPDATED requests copy files that have been created, accessed, or updated during a specified period.

Syntax

<created/accessed/updated/anyupdated request> 

──┬─ CREATED ────┬─────────────────────────────────────────────────────►
  ├─ ACCESSED ───┤
  ├─ UPDATED ────┤
  └─ ANYUPDATED ─┘
  ┌◄───────────────────────────────────────────────────┐
►─┴─┬─/1\─┬─ BEFORE <timestamp> ─────────────────────┬─┴───────────────┤
    │     ├─ AFTER ──<timestamp>─────────────────────┤
    │     └─ BETWEEN ──<timestamp>── ─ ──<timestamp>─┤
    └─<filecopy modifier>────────────────────────────┘
Note: If you do not specify BEFORE, AFTER, or BETWEEN then FILECOPY uses: 
AFTER today @ 0000

Explanation

Components of the CREATED, ACCESSED, UPDATED, and ANYUPDATED Requests provides an explanation for the components of the syntax diagram.

Table 24. Components of the CREATED, ACCESSED, UPDATED, and ANYUPDATED Requests

Component

Explanation

CREATED

Copies files whose creation date (the date the file was first locked on disk) is less than the BEFORE timestamp value, greater than or equal to the AFTER timestamp value, or between the two timestamps specified by the BETWEEN option.

ACCESSED

Copies files whose date of last access (the date the file was last opened for input or output) is less than the BEFORE timestamp value, greater than or equal to the AFTER timestamp value, or between the two timestamps specified by the BETWEEN option.

UPDATED

Copies files whose timestamp value is within the specified time range or whose ALTERDATE and ALTERTIME values are within the specified time range. The attributes contain the date and time that the file was last closed after being written to and are less than the BEFORE timestamp value, greater than or equal to the AFTER timestamp value, or between the two timestamps specified by the BETWEEN option.

ANYUPDATED

For each file, FILECOPY takes the largest of TIMESTAMP, ALTERDATE and ALTERTIME, ATTMODIFYDATE and ATTMODIFYTIME, and COPYDESTDATE and COPYDESTTIME and checks if that value is within the range you specify with the BEFORE, AFTER, or BETWEEN modifiers.

<timestamp>

Indicates a particular date in the format mm/dd/yy or mm/dd/yyyy, such as 04/26/99 or 04/26/1999. If you do not specify a timestamp, the program uses the TODAY value and performs checking with the AFTER option.

The @ <integer> portion of the <timestamp> is required if you do not specify a <date>.

If you do not specify the @ <integer> portion of the timestamp, the program uses a value of zero (0), except in the second timestamp in the BETWEEN option, when it uses a value of 2359.

<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 or tape

  • Other control information.

The <filecopy modifier> must contain a FILES, INCLUDE, or EXCLUDE file specification.


Prev  Up  Next
FILECOPY Task Requests  Home  ADDED and ALLFILES Requests