DSM/Tape Catalog User's Guide

Using TAPECATALOG DEFINE Attributes
DSM/Tape Catalog User’s Guide — 520233-008
6 - 6
TAPECATALOG DEFINE Attribute Descriptions
You cannot use RETENTION and EXPIRATION in the same DEFINE, and you
cannot use EXPIRATION with USE IN.
FILECAT [ \node.]file-catalog-name
is the logical name of the file catalog to search for an input tape file or where to
create the entry for an output tape file. Include \node when the file catalog is not
on your current default node. The default is the file catalog 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. If CATALOG is OFF, FILECAT is ignored.
FILEID tape-file-id
specifies the cataloged name of the tape file on an input or output tape. The value
for tape-file-id can be up to 60 characters long. For more information on
permitted characters for tape-file-id, see the DSM/Tape Catalog Operator
Interface (MEDIACOM) Manual.
For input tape files, the rightmost 17 characters of tape-file-id must match the
tape file ID in the tape label. For output tape files, all characters in tape-file-id
are written in the catalog entry, but only the rightmost 17 characters are written in
the tape label.
This attribute is required for all labelled tapes when CATALOG ON is specified.
FILESECT sequence-number
used only for an uncataloged tape file written to two or more tapes. It can be
specified for input tapes with ANSI, IBMBACKUP, BACKUP, or IBM labels. Specify
sequence-number as a number in the range of 1 through 9999. The default is 1.
For more information, see the Guardian Disk and Tape Utilities Reference Manual.
FILESEQ file-order
specifies the order that multiple tape files are written to a volume set. S
pecify
file-order as a number in the range of 1 through 9999 to indicate the relative
position of the file (1 for the first file, 2 for the second file, 3 for the third file, and so
on). This attribute defaults to 1.
You must specify FILESEQ in each DEFINE when writing multiple files to one
volume set. This attribute can be used with ANSI and IBM labeled tapes.
GEN { +1 | absolute | relative }
specifies which generation of a tape file to use. For an input t
ape file, you can use
an absolute or relative generation number. When GEN is not used for an input
tape, the default is -1 (the most recent generation).
For an output tape file, GEN must be +1 or an absolute generation number. If an
absolute generation number is given and that generation already exists in
DSM/TC, a new version of that generation is cataloged and the old version is