The CTSSYNC utility processes the following commands:
VERIFY
NOVERIFY
BULK
NOBULK
FORCE
NOFORCE
EJECT{,vvvvvv{-vvvvvv}}
PROTECT{,vvvvvv{-vvvvvv}}
SCRATCH{,vvvvvv{-vvvvvv}}
PRIVATE{,vvvvvv{-vvvvvv}}
SYNC{,vvvvvv{-vvvvvv}}
EXPORT{,llllll{-llllll}} {,destination}
IMPORT{,pppppp} {,llllll{-llllll}} {,ooooooooo}
Where:
volume serial number (real or virtual)
volume serial number for a logical (virtual) tape
volume serial number for a physical (container) tape
IMPORT option either SCRATCH or PRIVATE
The VERIFY command instructs the system to verify that the volume serial number is defined in the 3495/3494 LCS database prior to executing any further commands. If NOVERIFY is specified, the LCS commands are issued even if the cartridge does not reside in the 3495/3494 LCS database. VERIFY is the default.
COPY,POOL[,pp] where pp is the physical volume pool that contains the logical volumes to export.
The BULK command instructs any following EJECT commands to be sent to the bulk location. The NOBULK command instructs all following EJECT commands to be sent to the convenience location. If neither BULK nor NOBULK was specified prior to an EJECT command, the utility defaults to the bulk location.
The FORCE command instructs the program to execute any following SYNC commands unconditionally, regardless of the current use attribute in the TCDB. The NOFORCE command causes SYNC commands to be processed only if the use attribute in the TCDB does not match the volume status in the tape database, or if TCDB or Library Manager show an error indicator. NOFORCE is the default.
The EJECT command instructs the 3495/3494 robotic device to eject the specified VOLSERs. Depending upon whether a BULK or NOBULK command was issued prior to the EJECT command, the cartridge is ejected to either the bulk or the convenience location.
The PROTECT, SCRATCH, and PRIVATE commands all change the status of the specified VOLSERs. The SCRATCH command changes the status to scratch, while the PROTECT and PRIVATE commands change the status to private within the 3495/3494 LCS database. This affects which cartridges are selected to satisfy SCRATCH requests and which cartridges are added to any auto cartridge loaders (ACLs) located inside the 3495/3494 robotic device. There is no difference between PROTECT and PRIVATE.
The SYNC command causes the specified VOLSERs to be synchronized between the tape management database and the 3495/3494 LCS database. If the status is different, the tape management database is assumed to be correct. This is the default if no specific command is specified.
The EXPORT command causes the specified LOGICAL VOLSERs to be written to the export list volume (a logical volume residing in the same library as the volumes to be exported). After all volumes have been written to the export list volume, the OAM LCS schedules the list to be exported.
The DESTINATION sub-parameter can only be included on the EXPORT control statement and is optional. If included, all virtual volumes with the same destination will be stacked together on a single physical volume. If a list of 50 virtual volumes to be exported had been supplied; and 25 had one destination and the other 25 had a different destination, then the first 25 would be stacked together on one set of physical volumes and the other 25 would be stacked on a different set of physical volumes. However, this value is not sent to the CBRUXEJC exit during eject processing nor is it tracked in the TCDB or the tape management catalog.
The IMPORT command causes the specified LOGICAL VOLSERs to be written to the import list volume; that is, a logical volume residing in the same library as the volumes to be imported. After all volumes have been written to the import list volume, the OAM LCS schedules the list to be imported. Only 1 EXPORT or IMPORT can be scheduled at a time. Subsequent EXPORTs or IMPORTs will be shown as errors by CTSSYNC.
SCRATCH and PRIVATE are optional sub-parameters that can be included on the IMPORT control statement if the specific virtual volumes are specified. PRIVATE, the default, indicates that the specified virtual volume should be copied back into cache inside the 3494/VTS completely; that is, the virtual volume is copied. If SCRATCH is specified, then the specified virtual volume is assumed to be in scratch status and only the VOL1/HDR1/HDR2 records are copied back into cache. While this reduces the time to complete the IMPORT process, those virtual volumes cannot be made un-scratched because the data on them no longer resides inside the 3494/VTS.
The ABDLMT keyword parameter is used to set a return code limit at which CTSSYNC will ABEND. After CTSSYNC has completed all other processing and is about to terminate, the numeric value of ABDLMT is compared with the highest return code from any command. If that return code is greater than or equal to the ABDLMT, CTSSYNC abends with a U0006 and a reason code equal to the return code. The default is ABDLMT=99. ABDLMT can be specified:
Performs like the SYNC command but does not call to update the OAM. Also, both the TCDB (VOLCAT) and the Library Manager (LM) database are compared with the TMC. If the status of the volume is not synchronized in all three data bases or catalogs, an error is reported to both the SYSPRINT and ERREPORT DD statements.
Performs like the EXPORT command except that the exported volumes are copied, not moved. List the VOLSERs to be exported below the COPY command in the SYSIN DD.
Note: Specify the POOL parameter before you export the volumes.
Specifies the physical volume pool that contains the logical volumes to export. This command is only used with the COPY command.
|
Copyright © 2014 CA.
All rights reserved.
|
|