DSM/Tape Catalog User's Guide

Using TAPECATALOG DEFINE Attributes
DSM/Tape Catalog User’s Guide — 520233-008
6 - 9
TAPECATALOG DEFINE Attribute Descriptions
PHYSICAL is ignored by Backup and Restore 2.0.
See also the LOGICAL attribute on page 6-7.
POOL pool-name
is the logical name of the DSM/TC pool used to select scratch tapes. The default is
the name set by the MEDIACOM ALTER MEDIADEFS command on the node
named by AVRSYSTEM or the system named in DEVICE. If neither is specified,
the default is the local node. Use this attribute only when CATALOG ON and USE
OUT are specified.
If the value for pool-name was created as an excluded pool from the system
search space, you must use the DEVICE option to name a tape drive to mount the
scratch tape on. For this case, the tape cannot be premounted.
RECFORM { F | FIXED | U | UNDEFINED }
specifies the record format of the tape file.
F or FIXED specifies fixed-length records. If you select this format, you must
specify a BLOCKLEN value that is a multiple of the RECLEN value.
U or UNDEFINED specifies that the record format be of undefined length (the
default for ANSI tapes).

For an ANSI or IBM-MVS labeled tape, these defaults are assumed:
RECFORM U, RECLEN 0, and BLOCKLEN as configured for the tape drive. If
you specify BLOCKLEN, RECFORM, and RECLEN for an output labeled tape,
label fields are generated with those values.

BLOCKLEN, RECFORM, and RECLEN cannot be used for tapes specified as
LABELS BACKUP, LABELS BYPASS, and LABELS OMITTED. For more
information, see the LABELS attribute on page
6-7.
RECLEN record-length
specifies the record length written to the t
ape file. For ANSI or IBM-MVS labeled
tapes with fixed-length records, the default RECLEN value is as configured for the
tape drive by SYSGEN. For tapes with undefined record lengths, the default
RECLEN value is 0. RECLEN is ignored by Backup and Restore 2.0.
RETENTION { number-of-days | PERMANENT }
specifies the length of time to retain a tape file after its creation date:
number-of-days is a number from 0 through 9999. This value is translated to an
expiration date and written in the tape’s label and in the tape file’s catalog entry.
PERMANENT specifies that the tape file is kept indefinitely. A permanent retention
can be subsequently changed to a date in the catalog entry by a MEDIACOM
ALTER TAPEFILE command with the EXPIRATION or RETENTION options. The
file is then retained until the date in the catalog entry expires.