Open System Services Management and Operations Guide (G06.30+, H06.08+, J06.03+)

created on systems running J06.03 and later J-series RVUs, H06.08 and later H-series RVUs,
and G06.29 and later G-series RVUs are created as Version 3 catalog filesets.
To upgrade a fileset catalog file:
1. Determine whether the fileset is mounted by using the SCF STATUS FILESET command.
2. If the fileset is mounted, stop the fileset by using the procedure described under “Stopping
(Unmounting) a Fileset” (page 151).
3. Enter the following SCF command for the fileset:
DIAGNOSE FILESET filesetname, UPGRADE
filesetname
specifies the fileset to have its catalog file upgraded so that it can support current OSS features.
4. As soon as the upgrade operation is complete on the fileset catalog file, use the SCF START
FILESET command for the fileset. Note that the root fileset must be started before any other
fileset can be started.
All mounted filesets can be stopped in one operation by using the wildcard character * in place
of a fileset name in the SCF STOP command. To run the SCF DIAGNOSE FILESET command on
multiple filesets, use the CPU option to begin the process for each fileset on a different processor.
Moving and Removing OSS Catalog Files
OSS catalog files cannot be moved or purged with standard OSS or Guardian file-system
commands; you must use the Guardian Catalog Volume Tool (CVT) utility.
CVT is useful in cases such as:
• You can purge old catalog files once you have decided that an FSCK repair operation was
successful and the old files are no longer needed.
• In the rare case of a double media failure, you can still perform a partial catalog recovery by
restoring the latest backup copy of the catalog file and running the SCF DIAGNOSE FILESET
command with the REPAIR ALL option.
The Guardian RESTORE utility cannot open files on OSS catalog subvolumes, but you can
restore the catalog to another subvolume and then use CVT to move the restored catalog to
the OSS catalog subvolume.
CVT also enables you to:
• Move catalog files between subvolumes on the same disk volume
• Move catalog files onto and off of ZX0 subvolumes
• Save a current catalog in the same manner that FSCK does when it saves an existing catalog
and creates a new one
• Make a saved catalog the current catalog for a fileset
• Purge catalog files saved by FSCK
CVT is an unlicensed privileged program and, therefore, can be run only by the super ID (which
is 255,255 in the Guardian environment, 65535 in the OSS environment). CVT is restartable; if
it fails while moving or purging a catalog file, you can restart it using the same command.
Running CVT
Run CVT using the following command at a TACL prompt.
RUN $vol.ZOSS.CVT [ HELP | ? ]
[ PURGE SERIAL serialno [ IN subvolume ] ]
[ RENAME files1 [ TO ] files2 ]
Managing and Repairing Fileset Catalog Files 171