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.

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.