<replace statement>

── REPLACE ─┬───────────────────────────────────────┬──────────────────►
            │ ┌◄──────────────────────────────────┐ │
            └─┴─┬─ & ───┬─┬─/1\─┬─ COMPARE ─────┬─┴─┘
                └─ AND ─┘ │     └─ VERIFY ──────┤
                          ├─/1\─┬─ CATALOG ─────┤
                          │     └─ BACKUP ──────┤
                          ├─/1\─ REPORT ────────┤
                          ├─/1\─ SELECT ────────┤
                          └─/1\─┬─ DSONERROR ───┤
                                └─ WAITONERROR ─┘
►─┬────────────────────────────────────┬───────────────────────────────►
  │     ┌◄────────── , ──────────┐     │
  └─ [ ─┴─┬─ /1\ ── FROMSTART ─┬─┴─ ] ─┘
          └─ /1\ ── NFT ───────┘
►─<copy request>─┬─────────────────────────────┬───────────────────────►
                 └─ [ ──<task identifier>── ] ─┘
►─┬──────────────────────────────────────┬─────────────────────────────┤
  │ ┌◄─────────────────────────────────┐ │
  └─┴─ ; ──<task attribute assignment>─┴─┘

Explanation

The REPLACE statement enables you to replace existing copies of files on disk with new copies of those files. The REPLACE statement is similar to the COPY statement, except that REPLACE copies only those files that you specify for which there are already existing copies on the destination disk or disks.

You cannot use the REPLACE statement to copy files to tape or CD-ROM.

For a detailed explanation of the <copy request> syntax, refer to the COPY or ADD Statement.

Example

The following example copies files under the directory SYMBOL/= from the tape SYMTAPE to disk SYMBOLS and to PACK. For each destination, library maintenance copies only those SYMBOL files from the tape that already have existing versions on the destination. These existing versions are replaced with new copies from the SYMTAPE.

REPLACE & VERIFY SYMBOL/= FROM SYMTAPE TO PACK,
                                       TO SYMBOLS (PACK);