DELETE-VOLUME-ENTRY Delete catalog entry from the MAREN catalog

Privilege                ADA, administrator without domains

This statement deletes a MAREN catalog entry without checking and must therefore be used with care. If the tape is still contained in an archive system, this may cause discrepancies between the archive system’s archive record and the MAREN catalog. The exception is WORM volumes (device type TAPE-U4W). The entries of a written WORM volume can deleted only when PROTECTION-EXPIRATION-DATE has expired. Any not written WORM volume can be deleted from MARENCAT.

Format

DELETE-VOLUME-ENTRY                                                                                                            Alias: DL / DLVE

VOLUME = <vsn> / <c-string 1..6> / <x-string 1..12>

,FILE-SEQUENCE = *ALL / <integer 1..9999>

Operands

VOLUME = <vsn> / c-string 1..6> / <x-string 1..12>
Archive number of the tape whose MAREN catalog entry is to be deleted.

FILE-SEQUENCE =
Defines which file sequence number of the specified archive number is to be deleted.

FILE-SEQUENCE = *ALL
Defines that all existing file sequence numbers of the specified archive number are to be deleted. If a temporarily locked tape with the same archive number exists, its catalog entry is likewise deleted.

FILE-SEQUENCE = <integer 1..9999>
The catalog entry with the file sequence number specified here is deleted.

Example

//delete-volume-entry volume=m5636k
%  MARM106 MAREN CATALOG ENTRY 'M5636K'/'0001' ERASED
%  MARM170 STATEMENT '//DELETE-VOLUME-ENTRY' PROCESSED 

The catalog entry of tape m5636k is deleted from the MAREN catalog with all of its existing file sequence numbers.