DSM/Tape Catalog User's Guide

Using TAPECATALOG DEFINE Attributes
DSM/Tape Catalog User’s Guide — 520233-008
6 - 10
TAPECATALOG DEFINE Attribute Descriptions
With CATALOG ON specified, if you do not use the EXPIRATION or RETENTION
attributes, the default is the retention value 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.
You cannot use RETENTION and EXPIRATION in the same DEFINE, and you
cannot use RETENTION with USE IN.
TAPEMODE { STARTSTOP | STREAM }
specifies how a cartridge tape drive writes records to an output tape:

STARTSTOP specifies to write the records one at a time.

STREAM specifies to write the records continuously.
When this attribute is not used for a cartridge tape, the default of the tape device is
used.
If TAPEMODE is specified, only cartridge-type tape drives should be used. If a
noncartridge-type tape drive is selected using the DEVICE attribute, an error is
returned, and the tape request fails. TAPEMODE is ignored by Backup and
Restore 2.0.
USE { EXTEND | IN | OUT }
specifies how the tape file is to be used:

EXTEND specifies to add records to the end of the tape file. If more than one
file is on the tape, the file to add data to must be the last file on the tape. (The
FILEID and FILECAT attributes can be used to define which tape file you want
and which file catalog to search for its catalog entry.) Use EXTEND only when
LABELS ANSI or LABELS IBM are specified.

IN specifies to read the file from tape. (Use the FILEID and FILECAT attributes
to define which tape file you want and which file catalog to search for its
catalog entry.)

OUT specifies to write the file to tape. (Use the VOLCAT and POOL attributes
to define the source of output tapes. Use the FILEID and FILECAT attributes to
define the name of the tape file and file catalog in which to catalog it.)
You cannot use this attribute when LABELS BYP
ASS or LABELS OMITTED is
specified.
If you are converting from a TAPE DEFINE, USE OPENFLAG is not supported in a
TAPECATALOG DEFINE.
VERSION { version | NEW }
specifies a version of tape-file-id within one generation. For more information
on tape-file-id, see the FILEID attribute on page 6-6.