CA Dynam for VSE User Guide

DYNCAT Commands
VSELOCK
NO
Indicates that the Catalog file is shared, and enqueuing is
done using the VSE external lock file rather than internal
CA methods.
Indicates that the Catalog is not to be shared.
The default is the specification from the Catalog as backed up.
Example
In the following example, the Catalog will be restored and reorganized, and
the password will be changed to 'SECURITY'.
// JOB INITIAL AND REORG CA Dynam CATALOG
// TLBL IJSYSBK,'CA Dynam BKUP'
// EXEC DYNCAT,SIZE=128K
RESTORE REORG PASSWORD='SECURITY'
/*
/&
Note: You may use RESTORE REORG to increase or decrease the size of the
Catalog to a different extent, device, or device type, modify Catalog
characteristics, improve access performance, and correct any Catalog errors
which may have been noted on the BACKUP function.
In most cases where a problem with the Catalog is indicated, recovery from
audit is not necessary. The RESTORE REORG function was designed in part to
diagnose and correct Catalog errors. If an error is suspected, you should run a
BACKUP and RESTORE REORG, followed by a SCRATCH function. If the
sequence completes successfully, the integrity of the Catalog can be assured.
If you attempt a RESTORE REORG which would result in changing the SHARE
option of the Catalog from SHARE=YES or SHARE=VSELOCK, to SHARE=NO, a
message will be issued warning you that this is being done.
SCRATCH Command
Use the SCRATCH command to return eligible tapes to the scratch pool and
perform internal housekeeping in the Catalog. It should be run at least once
per day. Remember to always perform a BACKUP immediately prior to
performing the SCRATCH.
If you specify the SCRATCH command without any operands, DYNCAT will
produce a group of dataset reports as a by-product. It will also periodically
dequeue the Catalog and wait for a short interval to allow concurrent
processing in other partitions and CPUs to continue. SCRATCH needs a work
file to perform its functions.
Chapter 8: Maintaining the Catalog−DYNCAT Program 8–83