MAREN records the tapes used by the FDDRL DUMP function (see the manual “FDDRL” [10]) in the MAREN catalog. MAREN also supplies FDDRL with new tapes (automatic allocation of free tapes). The tapes can be retrieved from the MAREN catalog again by the user by means of a file name allocated to FDDRL.
When tapes are restored using the FDDRL statements RELOAD-DISK and RELOAD-PUBSET, the volume type is determined automatically. The user specifies the file name of the backup in the volume catalog using the TAPE=*BY-VOLUME-CATALOG operand. MAREN accesses the volume catalog and ascertains the backup tapes required.
Management in the MAREN catalog
MAREN manages all FDDRL tapes in the MAREN catalog. Only tapes contained in the MAREN catalog can be used in FDDRL backups. If you want to use tapes that are not in the MAREN catalog, the MAREN parameter FOREIGN-TAPE-CHECK must be set to *NO (see the MARENADM statement MODIFY-MAREN-PARAMETERS). A tape list may only contain foreign tapes or tapes from the MAREN catalog. If the list contains tapes from both, the first foreign tape will be rejected.
If the tapes that are password-protected in the MAREN catalog are used, their passwords have to be entered in the task’s password list before the volume is requested (at the latest before the START-JOBS statement is issued) (ADD-PASSWORD).
The following catalog entry fields are updated for the tapes used in the backup:
- FILE-NAME (backup file name, see “MAREN tape set”)
- VOLUME-SEQUENCE (number of the tape in the tape set)
- FIRST-VOLUME (archive number of the first tape in the tape set)
- CREATION-DATE and CREATION-TIME
- EXPIRATION-DATE (calculated on the basis of the specified RETENTION-PERIOD)
- CLOSE-INDICATOR (for valid save tapes CLOSED)
- LAST-CLOSE-DATE and LAST-CLOSE-TIME
- CREATION-CATALOG-ID (catalog ID of the home pubset)
- CREATION-USER-ID (user ID of the backup task)
- CREATION-JOB-NAME (job name of the backup task)
- OPEN-MODE
- RESERVATION-DATE
- USER-ACCESS
- PASSWORD (*NONE, i.e. no password)
MAREN tape set
If several tapes are needed for a recovery unit, they are grouped to form a tape set under one file name (for a definition, see section “File version in the MAREN catalog”). The tapes of a MAREN tape set have the following features:
They all have the same file name (FILE-NAME).
For all tapes, the FIRST-VOLUME catalog entry field contains the archive number of the first tape in the tape set.
The order of the tapes within the tape set is defined by ascending VOLUME-SEQUENCE numbers (from 0001 to 0255) and ascending creation dates (CREATION-DATE and CREATION-TIME).
When the backup is completed, the tapes of the tape set are all marked as valid backup tapes (CLOSE-INDICATOR=CLOSED). The first tape of a tape set is only marked as valid after the backup has been completed successfully. It thus shows that all tapes of a tape set have been successfully created.
Allocation of free tapes
In a backup using the FDDRL statement DUMP-PUBSET, MARENUCP reserves a free tape in the MAREN catalog and allocates it. This also applies in the event of a backup with the FDDRL statement DUMP-DISK with the operand TAPE=*ANY. In the catalog entries for these tapes, the following file name is initially entered for FILE-NAME:
For the single disk recovery unit:
– FDDRL.D.<vsn_1..6> with DUMP-DISK
– FDDRL.P.<catid_1..4>.<vsn_6..6> with DUMP-PUBSET
For the disk set recovery unit:
– FDDRL.D.<vsn_1..6>-1 with DUMP-DISK
– FDDRL.P.<catid_1..4>.<date>.<time>-<disk-set-no> with DUMP-PUBSET
Meaning:
FDDRL.P | Prefix for backing up a pubset disk (in the case of DUMP-PUBSET) |
FDDRL.D | Prefix for backing up single disks |
<catid_1..4> | Pubset ID, 1 to 4 positions (catalog ID) |
<vsn_6..6> | VSN of a pubset disk, 6 positions |
<vsn_1..6> | VSN of a single disk, 1 to 6 positions |
<date> | Date of the backup (format yyyy-mm-dd) |
<time> | Time of the backup (format hhmm00) |
<disk-set-no> | Number of the disk set (depends on NUMBER-OF-DISK-SETS) |
Location
In FDDRL, archive numbers can be requested from a specific location using the LOCATION operand in the DUMP-PUBSET statement.
If the MAREN administrator assigns tapes from a different location to the user by means of a MAREN exit, the specification of the user is ignored.
If the MAREN administrator assigns the user tapes from a different location using the MAREN Location Manager, the system-specific MAREN parameter OVERRULE-LOC decides on the further procedure:
- OVERRULE-LOC=REJECT: the location specified by the user is used (differing locations lead to the reservation being rejected).
- OVERRULE-LOC=YES: the location specified in the MARENLM is used.