
ADD Command
3-6 User Reference
Connectivity Systems, Inc.—Copyright © 2006
Use Pursuant to Company Instructions
ADD Command
Description ADD creates a new version to a controlled dataset. For tape versions, the
volume serial number must not be in the BIM-EPIC Catalog unless the
ESER parameter is used. See below for information describing the ESER
parameter.
Note:Note:
You can use CATALOG to create a new BIM-EPIC dataset definition
(EDD) for a previously uncontrolled dataset. See “
CATALOG
Command” for additional information.
When a version is added that resides on an FSI Faketape device or if the
version is a TSIDOFL-created tape backup (not an offload) of a Start
Track 1 DSN, ADD must be followed by RETAIN. See the “
RETAIN
Command” for additional information.
You can use ADD to add a new version that was created outside
BIM-EPIC control or to recatalog a deleted version. Once a dataset is
controlled, all new versions created under BIM-EPIC are added to the
DSN Catalog automatically.
BIM-EPIC resequences version numbers as you add new versions. For
example, if you add a new version, the previous version 1 becomes
version 2, version 2 becomes version 3, and so on. To add more than one
version in a specific sequence, you must add the oldest version first and
the newest version last.
It is possible for some versions of a tape dataset to have standard labels,
while other versions are unlabeled. When you add a tape version to the
DSN Catalog, the entry automatically receives the label type specified in
the “owning” EDD. If a particular tape label type differs from the label
for the specified EDD, use UPDATE to temporarily modify the EDD
label type, then use ADD to add the new tape version. When the version
has been added, you can change the EDD back to the previous label type.
If an Automated Cartridge Library (ACL) is supported, ADD sets the tape
volume to non-scratch status in the ACL inventory. This is done because
the version is in “active” status in the BIM-EPIC catalog.
!
WARNING:
If the VTOC entry for a disk dataset has been deleted, ADD does
not recreate it. As long as the VTOC entry is deleted, that disk
space is free and can be reused for another dataset. If this occurs,
do the following tasks:
Ensure that the disk space, previously occupied by the
VTOC, has not been reused.
Comentarios a estos manuales