DSM/Tape Catalog Operator Interface (MEDIACOM) Manual

MEDIACOM Commands
DSM/Tape Catalog Operator Interface (MEDIACOM) Manual—429828-010
2-35
ALTER DISKFILE Command (Super Group Only)
ALTER DISKFILE Command
(Super Group Only)
Occasionally a disk file written to tape by the Backup utility (T9074) or BACKCOPY
should not be used by RECOVER DISKFILE. Something might be wrong with the disk
file’s data, or the tape might be unreadable where the file was written on the tape. If the
disk files for a backup tape are cataloged, you can keep track of unsuitable disk files by
marking their entries invalid with ALTER DISKFILE. You can list valid and invalid disk
file entries with INFO DISKFILE with the STATUS ALL option.
ALTER DISKFILE changes only the disk file entry or entries specified by the command.
It does not affect the other disk files cataloged for a backup tape. Once a disk file entry
is invalid, it remains in the catalog until the tape file entry it belongs to expires or is
deleted. If you accidentally invalidate the wrong disk file entry, you can change its
status back to valid with a subsequent ALTER DISKFILE command as long as its tape
file entry is still in the catalog.
disk-file-name
is the name of the disk file that was written to tape by the Backup utility (T9074) or
BACKCOPY and cataloged as belonging to tape-file-id. (Disk files written by
the Backup utility (T9074) or BACKCOPY are cataloged as belonging to one tape
file. A tape file entry is made for the tape file ID of the backup tape, and a disk file
entry is made for each disk file name that is included in the tape file. DSM/TC
keeps track of which disk file entries belong to which tape file entry.)
Wild-card characters are permitted in this name.
TAPEFILE tape-file-id
is the tape file ID of the entry that owns the disk file entry for disk-file-name.
Wild-card characters are permitted in this name.
GEN { absolute | ALL }
specifies which generation of the tape file entry to alter:
absolute
changes one generation only. absolute is a number in the range 1 through
32767.
ALTER DISKFILE disk-file-name , TAPEFILE tape-file-id
, GEN { absolute | ALL }
, STATUS { INVALID | VALID }
[ , FILECAT [ \node.]file-catalog-name ]
[ , LOGICAL { logical | ALL } ]
[ , PHYSICAL { physical | ALL } ]