DSM/Tape Catalog Operator Interface (MEDIACOM) Manual

MEDIACOM Commands
DSM/Tape Catalog Operator Interface (MEDIACOM) Manual—429828-010
2-60
ALTER TAPEFILE Command (Super Group or
SECURITY-MEDIA-ADMIN Only)
LOGICAL { logical | ALL }
refers to which copy of a tape set created from a parallel BACKUP or a parallel
BACKCOPY to change. (When such tape sets are created, the first copy is
cataloged as logical copy 1 and the second copy as logical copy 2.)
When only one tape set is created by the Backup utility (T9074) or BACKCOPY, it
is cataloged as logical copy 1.
This option specifies which logical copy is associated with tape-file-id:
logical
changes the tape file entry for logical copy 1 or logical copy 2. Specify
logical as 1 or 2. The default is 1.
BOTH
changes the tape file entries for logical copy 1 and logical copy 2.
PHYSICAL { physical | ALL }
refers to the sequential order in which backup tape sets were created by BACKUP
and BACKCOPY.
Two identical tape sets created by a parallel BACKUP or a parallel BACKCOPY
have the same physical copy number but different logical copy numbers (1 and 2).
This option specifies which physical copy is associated with tape-file-id:
physical
changes the tape file entry based on a physical copy number. Specify
physical as a number in the range 1 through 99. The default is 1.
If physical refers to a pair of tape sets from a parallel BACKUP or parallel
BACKCOPY, only the entry for logical copy 1 of the pair is changed if you do
not use the LOGICAL option with the PHYSICAL option.
ALL
changes the tape file entry for all physical copies. If there are pairs of tape sets
from a parallel BACKUP or parallel BACKCOPY, only entries for logical copy 1
of the pair are changed unless you use LOGICAL ALL with PHYSICAL ALL.
RETENTION { number-of-days | PERMANENT }
is the number of days past the creation date of the tape file to keep its catalog
entry. This value is translated to a new expiration date that replaces the current
expiration date in the entry. To apply the same retention period to all unexpired
entries of the files on the tape set, use the VOLUMESET option with RETENTION.