COPY-VOLUME-CATALOG Create copy of the current MAREN catalogs

Privilege                ADA, administrator without domains

The COPY-VOLUME-CATALOG statement allows the MAREN administrator to create a copy of the current volume catalog without the aid of utilities and without having to close the MAREN catalog (CLOSE-MAREN-FILES).

The copy of the volume catalog can also be incorporated in the backups, and is therefore available for any restore operations that prove necessary.

Format

COPY-VOLUME-CATALOG                                                                                                                 Alias: CPVC

TO-FILE = *MARENCVC / <filename 1..54>

,TO-CATALOG-VERSION = *CURRENT / *V81 ¹

¹The operand value *V81 is obsolete. It can still be specified for compatibility reasons.

Operands

TO-FILE =
File name of the copy of the volume catalog.

TO-FILE = *MARENCVC
The file name and any special file attributes of the backup copy have already been specified using the command ADD-FILE-LINK LINK-NAME = MARENCVC.

TO-FILE = <filename 1..54>
File name of the copy of the volume catalog.

TO-CATALOG-VERSION = *CURRENT
The copy of the volume catalog is created in the format of the current catalog.

Notes

• For performance reasons, the statement should only be executed in direct access on the system with the MAREN catalog.

• If the file specified in the TO-FILE operand does not exist, it is created on public disks with the attributes BUFFER-LENGTH=STD(SIZE=1) and SPACE=RELATIVE(180,180). If it does exist, it is overwritten without prior warning, provided the file attributes allow this.

• If the output file is to possess special attributes, the ADD-FILE-LINK command must first be entered with the link name MARENCVC. The file attributes specified when this command is issued are taken into consideration when the output file is created. In particular, the BLOCK-CONTROL-INFO=*WITHIN-DATA-BLOCK operand must be specified.

• Since the MAREN catalog is usually open when a backup is created in the data center and is therefore not included in this backup, it is advisable to make a copy of the volume catalog before starting the backup run. If the volume catalog were then to be destroyed because of a disk error, it can be restored using the copy and the logging files of the MAREN catalog (see description of the UPDATE-MAREN-CATALOG statement on "UPDATE-MAREN-CATALOG Update the MAREN catalog").

Example

//copy-volume-catalog to-file=backup.marencat
%  MARM119 FILE ':TQA2:$TSOS.BACKUP.MARENCAT' WITH 216 RECORDS CREATED
%  MARM170 STATEMENT '//COPY-VOLUME-CATALOG' PROCESSED

The current volume catalog is backed up in the BACKUP.MARENCAT file.