DSM/Tape Catalog Operator Interface (MEDIACOM) Manual

MEDIACOM Commands
DSM/Tape Catalog Operator Interface (MEDIACOM) Manual—429828-010
2-178
VOLCAT Command
VOLCAT Command
Some MEDIACOM commands need a volume catalog name even though the
commands’ VOLCAT option is not required. When a VOLCAT option is not used, those
commands use a default name.
At the beginning of a MEDIACOM session, the default volume catalog name is the
name set by the ALTER MEDIADEFS command executed in a prior session. If that
name is not the one you want, you can define a new one for the current session with
the VOLCAT command. The name set by VOLCAT remains in effect until another
VOLCAT command is issued or the session ends.
Use the ENV command to retrieve the current session default name. Use INFO
MEDIADEFS to retrieve the default name set by ALTER MEDIADEFS.
\node.volume-catalog-name
is the volume catalog name to use as the default name. Include \node when the
volume catalog is not on your current default node.
Example
An ENV command entered as the first command of a MEDIACOM session displays:
MC> ENV
Tape Drive NO SESSION DEFAULT SET
File Catalog \SKY.FILE_CATALOG_SKY
Volume Catalog \SKY.MASTER_TAPE_CATALOG
Pool TAPES_FOR_SKY
Volume \SKY.$OPRVOL.OPR
Unload ON
You want a different volume catalog than \SKY.MASTER_TAPE_CATALOG as the
default name, so use the VOLCAT command to set a new one. (For this example,
assume there is a second volume catalog on \STAR.)
MC> VOLCAT \STAR.TAPE_CATALOG_2
MC> ENV
Tape Drive NO SESSION DEFAULT SET
File Catalog \SKY.FILE_CATALOG_SKY
Volume Catalog \STAR.TAPE_CATALOG_2
Pool TAPES_FOR_SKY
Volume \SKY.$OPRVOL.OPR
Unload ON
Note. You can think of a VOLCAT command as temporarily overriding the volume catalog
name defined by ALTER MEDIADEFS. A volume catalog name set by ALTER MEDIADEFS is
changed only by a subsequent ALTER MEDIADEFS command.
VOLCAT [ \node.]volume-catalog-name