A multifile catalog entry is one with a file sequence number greater than 1. Multifile catalog entries are generated automatically when a multifile tape is created. However, these catalog entries are not deleted automatically.
To put it more clearly:
In the case of a multifile tape with four files, the third file is rewritten. The fourth file is thus no longer available. The multifile catalog entry with FSEQ=4 is thus invalidated, but is not automatically deleted. It can be removed by means of the DELETE-VOLUME-ENTRY statement.
With the release of a tape, at the very latest, all associated multifile catalog entries are deleted.
Format
DELETE-VOLUME-ENTRY Alias: DLVE | ||
|
Operands
VOLUME = <vsn>
Archive number of the tape whose multifile catalog entry is to be deleted from the MAREN catalog.
FILE-SEQUENCE = <integer 2..9999>
Defines which file sequence number of the specified archive number is to be deleted. All catalog entries with a file sequence number higher than the one specified here are deleted.
Example
//delete-volume-entry volume=asr101,file-seq=2
|
The catalog entry of tape asr101 with file sequence number 2 is deleted from the MAREN catalog. Any catalog entries with higher file sequence numbers are likewise deleted.